DNF90 服务端与启动器完整源码（含 GM 工具功能增强）

服务端（Go）：
- GM 塞背包/带属性装备发放：在线角色推送 op14 增量物品行，背包实时刷新，无需回角色选择界面
- GM 改金币/改等级：去掉在线拒绝，落库后推送 op14 钱包/op37 等级状态，在线实时刷新
- 等级端点统一切换到新版 GMSetCharacterLevel（自带在线刷新）
- 无限/锁死疲劳模式 + 燃烧疲劳：每房间消耗 2 点、打怪与通关经验双倍
- 燃烧疲劳开关时给所有在线角色推送系统提示（op12 mode 0）
- 深渊史诗掉率：GM 全局倍率 + 城镇增益药剂窗口倍率，真实接入掉落结算

启动器（Python/JS）：
- 标题栏自绘、窗口 1204x717、禁止拖拽改大小、仅最小化/关闭
- GM 工具：疲劳与燃烧、深渊史诗掉率、拍卖行上架（单一定价对齐）
- 拍卖行上架前端对齐服务端单一价格语义，修复 400 报错

pvf/services/builtin_skills/pvfine-npc-shops/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: pvfine-npc-shops
+description: 通过 pvfine MCP 读取和修改 NPC 商店商品、分页、分类、金币价格与材料兑换成本。
+---
+
+# NPC 商店
+
+先定位 NPC，再通过关联标注追踪实际 `.shp` 路径；必要时搜索 `**/*.shp`，用 NPC/商店列表确认 ID。不能猜测 NPC ID 就是商店文件名。
+
+商店商品位于 `sell info/tab/item list` 或 `sell info/tab/category entry/item list`。tab 可重复，category entry 的 id 标识分类；修改前明确目标分页与分类。`[use category]` 关联的分类定义来自 `etc/itemshop/itemshopcategory.etc`，结构是 itemshop category/category name 与 category entry/id、text。未要求时不改共享分类定义。
+
+item list 是商品 ID 列表，不是 ID/数量配对。读取实际 section 及标注后追加/移除目标商品，保留商品顺序与其他分页；新增前验证物品存在，并说明重复商品如何处理。不要把加入商店理解成创建新的物品文件。
+
+金币和材料成本在商品自身文件（通常 .equ/.stk），不是商店列表：
+
+- `[price]` 单个非负整数。删除 price 与显式设 0 含义不同。
+- `[need material]` 以 `材料ID 数量` 成对存储，不能只改前半对或把多个材料改成单值。
+
+用标注关联或物品 lst 联合解析商品，不把 ID 当文件索引。修改物品成本会影响所有引用该物品的商店；用户只想修改单个 NPC 价格时必须说明共享成本的影响，先确认所需效果，不能默改全局商品成本或自行复制物品。
+
+把商店列表与物品成本的相关变更放在同一个脚本预览；涉及名称引用时一并包含 .str 依赖。对同名 tab、同一分类的多个 entry 要显式定位 occurrence，不选第一个充数。应用后同时复查商店列表、商品成本和关联是否正确。
+
+操作前阅读 [MCP 操作流程](references/mcp-workflow.md)，按其查询、验证、预览、应用和保存规则执行。

pvf/services/builtin_skills/pvfine-npc-shops/references/mcp-workflow.md

@@ -0,0 +1,19 @@
+# MCP 操作流程
+
+此 skill 面向正在运行的 pvfine MCP 服务。安装 skill 不会自动配置连接；先在 pvfine「偏好设置 → MCP 服务」启用服务，将连接配置加入 AI 客户端。以下是服务端工具名，客户端可能增加前缀。
+
+1. 调用 `pvf_workspace_info`，确认归档、workspaceId、revision 和 versionLoading。未打开归档时先根据用户指定的本机绝对路径使用 `pvf_archive_open`，传入 workspaceEpoch 作为 expectedWorkspaceEpoch；不擅自丢弃未保存内容。
+2. 查询用 `pvf_search`（mode=path/content）、`pvf_read_file`。查询读取工具传入 workspaceId 与 expectedRevision=revision。read_file 每页最多 100 行，根据 nextLine 继续；搜索按返回分页继续，不能把第一页当作完整结果。
+3. 不清楚字段时用 `pvf_annotation_search`（filePath、section、workspaceId），再以返回的 documentId/rulesRevision 调用 `pvf_annotation_get`。用 `pvf_annotation_explain` 查看当前文件的枚举、字符串引用和关联目标。说明缺失时先读取实际结构，不猜测字段含义。
+4. 编写脚本前读取 `pvf_script_help(topic="types")` 获取当前完整声明，必要时读取 sections/lists/strings 帮助。沙箱只有 `pvf`，没有 Node、网络或本机文件系统；查询通过 `pvf.log(JSON.stringify(result))` 输出，限定文件范围，避免输出整个归档。
+5. 脚本先 `pvf_script_validate(source)`；通过后 `pvf_script_run(workspaceId, expectedRevision, source, label, requestId)`。轮询 `pvf_script_status(taskId)` 至完成，检查日志与诊断，取得 planId。查询脚本无修改时可以没有 planId。
+6. 有变更时用 `pvf_script_preview(planId, cursor, limit)` 看完全部差异，核对文件、字段、旧值、新值与范围。只应用符合用户指令的 changeKey；引用新增 .str 文本时一并选择对应字符串表依赖。调用 `pvf_script_apply(workspaceId, expectedRevision, planId, changeKeys, requestId)` 后用 `pvf_task_status` 等待结束。
+7. 应用仅修改内存工作区。重新获取 workspace_info 并读取验证；用户要求保存时才调用 `pvf_archive_save`。`pvf_archive_save_as` 生成副本，后续保存仍写源归档。最终明确说明修改路径、数值、应用状态和磁盘保存状态。
+
+每个新修改请求使用唯一 requestId；同一次请求的网络重试复用原 ID。遇到 STALE_WORKSPACE 重新查询和生成预览，不用新修订号强行应用旧计划。TASK_BUSY、前端草稿或冲突时先处理阻塞；失败不盲目重试。废弃预览用 pvf_script_discard。
+
+## 脚本读写
+
+文件路径是归档内部路径。`pvf.find(path)` 返回句柄或 null；`file.parse()` 得到文档，`doc.sections(path)` 返回全部同名 section，路径与嵌套参数以当前 types 声明为准。`section.get(i)`/`set(value,i)` 访问零基索引；`values()`/`setValues()` 操作直接值；修改文档后须 `file.write(doc)`。每次先验证 section 数量、长度、类型与旧值，再改目标字段。不要用 setValues 重建含子 section 的复合块。必要时用 file.text()/setText() 做精确的局部文本替换，保留未涉及内容、类型标记和闭合标签。
+
+读取 `<表号::键名>` 用 `getOriStrValue`；修改时按当前 strings API 保留引用语义。ID 不等于文件索引；使用标注关联或 `pvf.lst(path)` 解析路径。新建文件要同步正确 lst 注册，删除文件不会自动注销。MCP 不支持文件集修改。