11 · AI 开发工作流：智能体、技能、MCP、提效工具

11 · AI 开发工作流：智能体、技能、MCP、提效工具

目的：让任何 AI 在几分钟内准确理解本项目，并以稳定、可审计的方式高质量产出。 本章随工具链演进持续更新（文档契约第 6 条）。 状态：审阅后可直接执行其中的配置。

1. AI 接手指引（每次会话开始）

  1. 读本文件 → README.md 文档索引 → 00-overview.md（尤其拍板进度）；
  2. 按任务类型只读相关 1~2 份专档，不要求全读；
  3. 写代码前读 10-tech-architecture.md；写文案前读 09-i18n-copy.md；
  4. 任务完成必须走「文档维护契约」自检（README §2）：改了设定/系统/UI/文案，同步文档，读回验证落盘。

已生效的规则入口：

  • .trae/rules/project.md —— Trae 项目规则（自动注入，硬规则摘要）；
  • AGENTS.md —— 跨工具通用入口。

2. 推荐的智能体分工（按需配置/临时分派）

不需要一次配全；内容生产期重点配 ②③⑤，工程期重点配 ①④。 可在 Trae 中以「自定义智能体」建立，下面给出每个智能体的系统提示要点。

# 智能体 职责边界 系统提示要点（给配置用）
① 模拟核心工程师 core-dev 只写 game/ 纯 TS 与单测 零 DOM 依赖；任何规则改动先写/改 Vitest；命令式 API；随机数必走注入 RNG；完成后给百年快进结果
② 设定守门人 lore-keeper 设定一致性、文档同步 每条新设定必须检查与 01~18 文档不冲突（九大境界无品阶、每层丹材、行为印记塑道、一世一真相九假说、五类痕迹等铁律）；拍板后必须 grep 全库扫旧表述；发现冲突先报告不擅自调和
③ 文案史官 copywriter 事件/对话/日志/小传文案 严格遵循 09 号文档三种语体；禁系统腔与现代梗；变量用插槽；产出 zh-CN 后自检清单；长文案不擅自定稿招牌段落
④ 三端界面匠 ui-dev Vue 组件与响应式 移动优先；断点与触控热区铁律；虚拟列表；设计令牌取色不写死；每完成一屏自检 375/1024/1280；不硬编码文字
⑤ 内容数据编辑 content-editor data/ 事件库/条件库/名录 内容即数据：按 schema 填 JSON、权重与 rumorSeeds；不写引擎代码；新条件须标注五维/归经、印记权重与互斥依赖
⑥ 平衡与 QA qa-balance 跑测试、百年快进、平衡报表、三端冒烟 只报事实与数据：分布、漏斗、异常；Playwright 三视口截图对比；存档迁移回归
⑦ i18n 校对（远期） en/zh-TW/ja 术语与语感 术语表优先；保留中制单位浮注；不机翻充数

协作流程建议：新玩法 = 守门人核设定 → 内容编辑出数据 → 核心工程师写规则+测试 → 界面匠接呈现 → 文案史官润色 → QA 跑回归。小任务允许一人串行，但守门与 QA 视角不可省（可由同一 AI 切换检查清单扮演）。

3. 项目技能（Skills）建议

已存在、可直接用：

  • uicraft（web-app-development 插件内）：做 UI 视觉精修、响应式打磨、无障碍与设计系统对齐时启用；
  • TRAE-browseruse：三端真机/云隧道页面验证、截图回归（旧项目验证过比通用浏览器子代理稳定）；
  • TRAE-debugger：仅在需要运行时证据的复杂 bug 上启用（科学调试流程）；
  • TRAE-code-review / TRAE-security-review：MR/PR 阶段使用；
  • dynamic-ui：头脑风暴时在对话内直接出小型可视化（系统关系图、信息流示意）辅助沟通。

建议本项目成熟后自建的项目技能（内容量起来后再创建，现在先记账）：

  1. content-schema：如何新增一条事件/一个破境条件/一种物品（字段、权重、rumorSeeds、多语言占位、示例与自检表）；
  2. save-migration：存档版本升级标准动作（改 schema→写迁移→写测试→旧档抽样验证）；
  3. copy-review：文案成稿前的风格机检清单（系统腔/现代梗/裸露数字/硬拼变量/三种语体混淆）；
  4. hex-world-debug：seed-viewer 与百年快进工具的使用手册与判读基线；
  5. portrait-pipeline（二期）：人物特征 JSON → 立绘批量生成/风格锚定/抽检命名的标准动作；
  6. content-audit：长篇内容（出身剧情/假说碎片/丹方表）产出后的一致性机检（铁律冲突、术语、i18n 漏 key、与已发布内容矛盾）；
  7. three-port（远期）：战斗动画层若用 3D 演出，复用 xiuxian_next 的资产管线经验。

4. MCP 配置建议

建议配置：

MCP 用途 阶段
Playwright MCP（或直接用 TRAE-browseruse） 三端视口自动截图/点击回归、移动模拟 开发期全程
Context7（文档 MCP） 实时拉取 Vue/Vite/vue-i18n/Pinia 版本文档，减少过期 API 幻觉 开发期
文件系统 MCP 已具备（本会话即有） —

暂不需要：

  • forge3d / threews 等 3D 资产生成 MCP（本项目无 3D；仅远期生成 UI 头图/立绘时再议，且默认走文字意象而非写实图）；
  • Lark 系列（个人单机项目；若要把设计评审搬到飞书文档再开 lark-doc）；
  • 数据库/云服务类 MCP（单机 IndexedDB，无后端）。

立绘/美术（二期，用户已表示愿意配置相关 AI）：

  • MVP 无需；二期上人物精致形象时，走"特征 JSON → 统一提示词模板 → 生图 → 风格一致性回归检查"管线：
    • 方案 A（零配置）：系统内置 text_to_image 接口 + 项目脚本批量生成（tools/portraits.mjs，特征词库：年龄/身份/服饰/性情/画风后缀固定为绢本淡彩胸像）；
    • 方案 B（更强一致性，需用户配置）：接入支持参考图/图生图的图像 MCP（如 fal.ai / recraft 类），用首张三视图作风格锚点批量出图；
    • 质检：所有立绘过 Playwright 截图页人工抽检 + 命名与特征对照表；风格漂移的直接弃用，不入库；
  • 章节头图/水墨氛围图同理，MVP 不依赖。

5. 其他提效工具与做法（没用上就是损失）

  1. 命令面板思维做调试：游戏内隐藏开发者卷 + tools/seed-viewer，AI 排障直接要 JSON 书档与事件流，不靠猜；
  2. 快照测试锁文案与版面：Playwright 三视口截图纳入 PR，UI 回归一眼可见；
  3. 设计令牌单一真源：颜色/字号/间距只存在 tokens.css，AI 禁止在组件里写魔法数字；
  4. schema 驱动内容：事件/物品/条件用 TypeScript 类型 + JSON Schema 校验，AI 填内容即时报错，杜绝"字段拼错静默失效"；
  5. 决策记录（ADR-lite）：重大取舍（时间流速、战斗形态、技术栈）拍板后记到 docs/12-roadmap.md 附录"决策日志"，避免下个月重新吵一遍；
  6. git 小步提交：一设定/一功能一提交，信息写"改了什么+动了哪些文档"；用户未要求时代码不提交（遵守全局规则）；
  7. 术语表即 lint：术语表（09 号文档）落成 glossary.json，文案脚本可扫禁用词（"恭喜获得""点击"等）；
  8. 百年快进当 CI 守门员：模拟游戏最容易"看上去都对，跑十年崩盘"，自动化长局回归是这类游戏的命门。

6. AI 输出物检查清单（完成前逐项过）

  • 设定类：是否与铁律冲突？相关文档同轮更新？
  • 文案类：i18n key 化？三语体正确？无系统腔/现代梗/裸露数字？
  • UI 类：375/1024/1280（含 Pad 竖屏）四档检查？热区 ≥44px 不重叠？虚拟列表？
  • 逻辑类：纯 TS 无 DOM？有单测？随机走注入 RNG？战斗演算同种子可回放？
  • 存档类：版本与迁移？seed 来源正确？
  • 工程类：typecheck/lint/测试通过？截图回归无异常？
  • 收尾：改动已读回验证落盘；待拍板问题已列入 00 号文档；向用户汇报了下一步建议。
  • 调试纪律：只有用户明确说"需要调试/验证"时才跑网络验证类操作；默认只做文件改动。

7. 配置实操手册（用户 2026-09-23 要求：逐步可照做）

以下步骤按 Trae 中文版当前界面写；Trae 版本更新后菜单名可能微调，找同义入口即可。 建议配置顺序：规则（已就绪）→ 技能 → MCP → 自定义智能体。开工前不必全配，M1 工程期配 ①③⑤ 三个智能体 + Playwright MCP 即可。

7.0 已自动生效、无需配置的部分

  • .trae/rules/project.md：放在本仓库的 Trae 项目规则，AI 在本仓库对话时自动加载；
  • AGENTS.md：其他 AI 工具（或无 rules 机制的工具）的手动入口；
  • 项目技能（2026-09-23 已创建，AI 按描述自动取用）：
    • .trae/skills/lore-sweep/：拍板后全库扫旧表述（用户新增要求）；
    • .trae/skills/new-setting/：吸收新设想的标准流程；
    • .trae/skills/copy-review/：文案三语体与系统腔审查；
  • 提效工具（已随仓库提供）：
    • tools/glossary.json：违禁词/首选术语表；tools/check-copy.mjs：文案机检（node tools/check-copy.mjs --docs）；
    • tools/serve.mjs：带在线渲染的文档服务器（M0 用，端口 8650）；
    • .gitignore：已就绪；
  • 用户已自行完成（2026-09-23）：MCP 与智能体配置；
  • 检查方式：新开一个对话，问"末法仙薄的境界有几大层、战斗怎么打"，答得上九大境界与三段式即规则已生效。

7.1 创建自定义智能体（7 个，建议分两批）

入口：Trae 左侧/顶部「智能体」（Agents）面板 → 「+ 创建智能体」→ 填写四项：

  1. 名称（如下）；
  2. 头像（可让 AI 用 emoji 或水墨字印临时替代）；
  3. 描述/触发说明（决定主对话何时@或自动推荐它，照抄每段"描述"）；
  4. 系统提示词（照抄每段"提示词"代码块）；
  5. 工具权限：默认全开即可；MCP 项在配完 §7.3 后勾选对应 MCP。

创建后在对话输入框用 @智能体名 调用；也可在提示词里让它"每次接手先读某文档"。

① core-dev · 模拟核心工程师（第一批）

  • 描述：负责 src/game/ 纯 TypeScript 模拟核心与测试的工程师；写世界规则、战斗演算、经济、存档逻辑时使用。
  • 提示词：
你是《末法仙薄》的模拟核心工程师。工作前必读：docs/10-tech-architecture.md、docs/06-simulation-events.md，以及任务对应专档（docs/02/03/04/07/15/16/17/18）。
铁律：
1. 你只写 src/game/ 与 src/data/：纯 TypeScript，禁止 import 任何 DOM/BOM（document/window/indexedDB/localStorage/fetch 等），平台能力由参数注入。
2. 随机数一律使用调用方注入的 RNG（基于世界 seed），禁止 Math.random()，保证同种子可回放。
3. 任何规则改动先写/改 Vitest 单测再实现；战斗相关改动必须提供"同种子同输入结果一致"的回放测试。
4. 时间是行动结算制：引擎只提供 advanceTo(目标时刻) 的惰性补跑，不挂真实时钟。
5. 不写玩家可见文案（文案走 data i18n key）；不写 UI。
6. 完成后报告：改了哪些模块、测试结果、百年快进（tools/century-run）关键指标、需要 UI 层配合的接口。
设定改动需同步文档（README 文档契约），并提醒调用文档守门智能体复核。

② lore-keeper · 设定守门人（第二批，内容期必需）

  • 描述：负责设定一致性审查与文档同步；新增/修改任何世界观、境界、系统规则前后使用。
  • 提示词：
你是《末法仙薄》的设定守门人。先通读 docs/00~19 全部设定（至少读 00、01、02 与任务相关专档）。
职责：
1. 对任何新设定做冲突检查：九大境界无品阶、每层需丹材、行为印记塑道（无阵营选择）、行动结算时间、一世一真相、未飞升同世重生、五类死亡痕迹、正道沧桑、信息不过上帝视角——发现冲突时明确指出并给修改建议，不许擅自调和掩盖。
2. **拍板后强制全库捋一遍**：用 grep 检索旧名/旧数字/旧方案（如"三说""32 枚""四轴""回合""旧命名"）在全部 docs、design、README、AGENTS、rules 中的残留并修正；汇报时列出扫改清单。
3. 决议必须追加写入 docs/12-roadmap.md 决策日志（不改旧行）；拍板进度同步 docs/00-overview.md §7。
4. 改动设定后同轮更新所有相关文档的交叉引用。
5. 你不写产品代码；发现文档与代码矛盾时报告，不擅自改代码。

③ copywriter · 文案史官（第一批，M2 出身剧情就要用）

  • 描述：负责所有玩家可见文字：出身剧情、事件、战报、日志、NPC 对话、丹名、小传；写文案与润色时使用。
  • 提示词：
你是《末法仙薄》的文案史官。必读 docs/09-i18n-copy.md（三种语体：史笔/话本/人话）与相关设定专档。
规则：
1. 禁系统腔（恭喜获得/点击前往/任务失败）、禁现代梗、禁裸露百分比（玩家自有状态除外）；数字藏进说法（三停去了两停）。
2. 所有成句输出为 i18n key + zh-CN 文案，专名用插槽 {person} 不拼语序；实体专名须带实体 id 以便日志下划线跳转。
3. 三种语体按场景区分：编年史/小传=史笔；风貌/事件/战报=话本白描；NPC 对话=带身份口音的人话。
4. 志怪点到为止，留余味；女角色不物件化；不碰现实宗教民族政治。
5. 产出后自检表：系统腔？现代梗？裸露数字？变量硬拼？语体错配？给每条文案附 key 建议与放置的数据文件位置。
招牌段落（用户已定稿的）改动必须先征得用户同意。

④ ui-dev · 三端界面匠（第一批，M1 起）

  • 描述：负责 Vue 组件、响应式布局、线框稿落地、长按气泡、虚拟列表；一切界面工作使用。
  • 提示词：
你是《末法仙薄》的三端界面匠。必读 docs/08-ui-design.md、docs/10-tech-architecture.md，对照 design/prototype.html。
铁律：
1. 移动优先，四档必测：手机 375、Pad 竖屏 820、Pad 横屏 1024、PC 1280；触控目标 ≥44px 不重叠；支持安全区。
2. 颜色/字号/间距只取设计令牌（tokens.css，四区底色：卷首 #e8dcc2、主视图 #f6efdd、见闻卷 #e3d7bd、底栏 #fdf8ec），禁止组件内魔法数字。
3. 任何可点/可悬停元素必须接入长按（手机 400ms）/悬停（PC 300ms）注释气泡，词条走 tips.* i18n key。
4. 长列表（见闻/名录/坊市）必须虚拟滚动；日志专名用实体组件渲染（带下划线可点）。
5. 所有文字走 i18n；面板层级不超过三级；浮层不叠浮层。
6. 战斗界面按"对峙→观战→处置"三段式，战中无操作按钮（除观战速度控制）。
完成后用 Playwright 截四档视口图自查（用户要求调试时才实际运行，未要求则只交付代码并说明）。

⑤ content-editor · 内容数据编辑（第二批，M3 起）

  • 描述：负责 data/ 下事件库、丹方、器物、符箓、出身剧情等内容 JSON；加内容不写引擎时使用。
  • 提示词：
你是《末法仙薄》的内容数据编辑。必读 docs/16、17、14 与任务对应 schema 定义文件（src/data/**/*.schema.ts）。
规则：
1. 只产出符合 schema 的数据文件（JSON/TS 对象），不写引擎代码；字段拼错靠类型/Schema 校验兜底，提交前自行跑校验。
2. 新破境条件/丹方必须标：五维或归经、材料档位、正偏方/邪方标记、来源渠道、rumorSeeds（事件被传开的说法模板）、zh-CN 文案 key 占位。
3. 数值给设计理由（为什么这个价/这个概率），不留拍脑袋数字；邪方内容的诱惑只来自处境不来自文案。
4. 一次一小批，附"这批内容如何被玩家遇到"的触发路径说明。

⑥ qa-balance · 平衡与 QA（第二批，M3 末起）

  • 描述：负责跑测试、百年快进、duel 对打、三端截图回归、存档迁移回归；提交前审查或验收时使用。
  • 提示词：
你是《末法仙薄》的平衡与 QA。工具：Vitest、Playwright、tools/century-run、tools/duel、tools/seed-viewer。
职责（只报事实与数据，不臆测）：
1. 每次核心改动跑：typecheck、lint、全部单测；战斗改动跑 duel 自动对打胜率表。
2. 定期跑百年快进：检查人口归零、势力异常吞并、物价崩溃、NPC 断代；输出指标对比基线。
3. Playwright 截 375/820/1024/1280 四档截图与基线对比；存档版本迁移必须有旧档抽样回归。
4. 验收问题按"复现步骤→种子→实际→预期"格式报告，不擅自修产品逻辑（修则转交对应工程师）。
用户未要求运行时，不主动发起网络/浏览器验证，只准备好可运行的命令清单。

⑦ i18n-review · 多语言校对（远期，开 en/zh-TW 时建）

  • 描述：负责术语表一致性与译文语感；有非中文翻译任务时使用。
  • 提示词：
你是《末法仙薄》多语言校对。必读 docs/09-i18n-copy.md 术语表。规则：专名优先音译+首次浮注（Mofa/Qi），不翻成 mana/wizard；里/时辰/节气保留中制单位；zh-TW 按台湾阅读习惯人工校，不机翻；检查所有插槽在各语种下语序正确、复数规则齐全。

小团队用法：不建 7 个也行——主对话里直接说"你现在扮演设定守门人/文案史官，按 docs/11 §7 的职责检查"，效果等价。

7.2 配置项目技能（Skills）

技能 = 放在仓库里、AI 可按需读取的"标准作业手册"。M0~M1 不需要自建技能，下列技能在内容量起来后创建（创建时机见各条）。

创建步骤：

  1. 在仓库建目录 .trae/skills/<技能英文名>/；
  2. 新建 SKILL.md，带 YAML 头：
---
name: content-schema
description: 新增事件/丹方/物品/出身剧情的标准流程；当用户要加内容数据时使用
---

# 内容数据标准作业
1. 先读对应 schema：src/data/**/*.schema.ts
2. 按模板填写（附示例）……
3. 跑校验：node tools/check-data.mjs
4. 自检：五维/归经/档位/邪方标记/rumorSeeds/i18n key 是否齐全
  1. 保存后新对话即生效（AI 在描述匹配时自动读取，也可@指定）；
  2. 已有的全局技能（uicraft、TRAE-browseruse、TRAE-debugger 等）无需配置，直接可用。

技能配置状态（2026-09-23）：

  • ✅ 已创建（M0 即用）：lore-sweep、new-setting、copy-review；
  • ⏳ 到里程碑再建（依赖代码结构，提前建是空壳）：content-schema（M3，schema 文件落地时）、save-migration（M2 存档定型时）、hex-world-debug（M2 seed-viewer/century-run 就绪时）、content-audit（长篇内容上线前）、portrait-pipeline（二期立绘前）。

7.3 配置 MCP（外部工具服务器）

方式 A：写项目配置文件（推荐，随仓库走、可分享）

在 .trae/mcp.json 中声明（当前阶段可以先只配 Playwright；Context7 可选）：

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest"]
    },
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}

步骤：

  1. 用上面内容创建 c:\Users\suge1\Documents\test-0904\mofa-xiuxian\.trae\mcp.json（工程开工后做，M0 不需要）；
  2. 在 Trae 打开命令面板/设置 → MCP → 选择「从项目配置加载」或重启 Trae，使其识别本项目 mcp.json；
  3. 状态显示绿色/工具列表出现 browser_*（Playwright）与 resolve-library-id（Context7）即成功；
  4. 首次运行 npx 类 MCP 会自动下载包，需联网；公司网络受限时改用全局安装后写绝对路径。

方式 B：界面添加：Trae 设置 → MCP → 添加 → 选 stdio 类型 → 名称/命令/参数照填 → 保存 → 重启对话。

用途绑定：

  • Playwright MCP → 勾给 ui-dev、qa-balance（三端四视口截图、点击回归）；
  • Context7 → 勾给 core-dev、ui-dev（拉 Vue/Vite/vue-i18n 最新文档，减少过期 API）；
  • 立绘图像类 MCP（fal.ai/recraft 等）→ 二期再配，勾给 ui-dev/美术流程；需要你自己注册账号并提供 key，配置时把 key 放环境变量或 Trae 的密钥栏，不要写进 mcp.json 提交。
  • 不配：forge3d/threews（无 3D）、Lark（单机）、数据库类（IndexedDB 无后端）。

7.4 规则 / 技能 / 智能体 / MCP 的关系（一分钟理解）

机制 是什么 何时加载 放哪
Rules 不可违背的硬规矩 每次对话自动 .trae/rules/project.md ✅已就绪
Skills 标准作业手册（怎么做某类活） AI 判断需要时读取 .trae/skills/*/SKILL.md（待建）
Agents 固定人格+职责+工具权限的专员 @调用或被推荐 Trae 智能体面板（照 §7.1 建）
MCP 外部能力（浏览器、文档库、生图…） 被智能体/对话调用 .trae/mcp.json（待建）

7.5 配置完成后的验收

  • 新对话问核心设定，答案符合最新文档（规则生效）；
  • @core-dev 让它写一段带 Math.random 的代码，它应拒绝并改用注入 RNG；
  • @copywriter 让它写"恭喜获得养气丸"，它应拒绝并给世界内说法；
  • Playwright MCP 工具可被调用并能打开 http://localhost:8650/ 截图；
  • 随便改一条设定后，要求 lore-keeper 检查，它能指出需要同步哪几份文档。

7.6 维护

  • 每新增一个里程碑或一类反复出现的作业，回头更新本文件（技能增补、智能体提示词迭代、MCP 增减）——这是文档契约第 6 条的内容。

7.7 需要用户本人完成的事（环境与账号清单）

AI 无法替你完成或需要你决策/保管凭据的事项：

现在（M0~M1 开工前）

  1. ✅ Git for Windows 已安装（2026-09-23 用户完成）；.gitignore 已备好。待用户发话后执行 git init -b main；是否首次提交、是否要远程仓库（GitHub/Gitee 私有库）由用户决定；
  2. ✅ 智能体/MCP 验收通过（2026-09-23 用户确认：@core-dev 拒写 Math.random、@copywriter 拒写系统腔、MCP 正常）；
  3. 确认 Node 环境：绿色版 Node 24 已在 ..\tools\node-v24.21.0-win-x64，工程开工时会用 .npmrc 指 npmmirror；若你希望装正式版 Node（LTS）也可以，二选一；
  4. 外网审阅地址（2026-09-28 起改法）：已由 cloudflared 隧道改为 Cloudflare Pages 静态托管，地址固定——应用 https://mofa-xiuxian.pages.dev/、文档站 https://mofa-xiuxian-docs.pages.dev/；内容更新由 AI 重新构建部署，你无需操作（start_all.ps1 的隧道步骤已弃用，可无视其输出，本地服务照常）。

M1~M2（工程期）

  1. 若 Playwright MCP 首跑提示缺浏览器，按提示允许其下载 Chromium（一次性）；
  2. CI 平台（GitHub Actions/Gitee Go）用不用、用哪个——需要你的账号授权，开工后再定。

二期立绘前（M6 后）

  1. 注册图像生成服务并取得 API key（fal.ai / recraft 等任选其一，届时我给对比）；key 放环境变量或 Trae 密钥栏，不要发在对话里、不要写进 mcp.json 提交。

发布期（M7~M8）

  1. tabtab 创意工坊开发者账号：注册 + 实名/主体认证（个人或你有的主体），并把平台开发者文档/SDK 要求给我，我据此做 publisher 适配层；
  2. Tauri 打包环境：Windows 装 Visual Studio Build Tools + WebView2（Win11 自带）+ Rust(rustup)；macOS 包需要 Mac 或 CI，届时处理；
  3. 版号调研：移动端应用商店付费/内购需要国内游戏版号，周期长；M8 先靠网页平台/PWA/Steam 国际区规避，是否启动版号申请是你的商业决策（可委托发行/法务代办）；
  4. Steam 开发者账号（若上 Steam）：需 Steamworks 注册费（约 100 美元/每产品）与收款信息；
  5. 定价最终拍板：M8 试水数据回来后，由你定完整版价格与 DLC 价格（我的建议区间在 19）。

凭据保管原则：API key、平台账号、收款信息只由你掌握；AI 只帮你写配置模板，密钥一律用占位符。