dsh-maoying 0.1.17 → 0.1.18

package/README.en.md

@@ -75,7 +75,7 @@ Open "**毛颖创作台**" at the bottom of the DSH sidebar — a full-page cock
 
 - **Chapters**: status filters + the writing queue; click a chapter for full-page reading — back button, outline side-by-side (Markdown rendered), read-only manuscript, five narrative-dimension fields, one-click status flow.
 - **Overview**: the "Edit" button on the manuscript card expands form-based editing of project.yml — title / author / genre / planned length / language / workflow phase / co-writing mode / synopsis (the former "Novel Settings" tab, merged in); saving preserves the file's existing comments. If project.yml was changed externally after the form loaded (manual edits or an agent advancing the phase), saving is rejected with a prompt to re-edit from the latest content instead of overwriting. A separate "Volume plan" card lists each volume's positioning and planned chapter range from volumes.yml — signed-off volume plans are visible in the panel.
-- **Top bar**: current version always visible; a "new version ↗" badge links to the release page when npm has a newer one, next to an "Upgrade now" button that installs the latest release into the current DSH profile with pnpm (profile-directory installs only; a DeepSeek restart is required to take effect); the gear opens Settings — UI language (中文/English), six font-size steps (100%–150%), all applied immediately and remembered.
+- **Top bar**: current version always visible; a "new version ↗" badge links to the release page when npm has a newer one, next to an "Upgrade now" button that installs the latest release into the current DSH profile with pnpm (profile-directory installs only, with an automatic corepack fallback when pnpm is missing; when a global `maoying` CLI is detected it is updated to the same exact version, and skipped if absent; a DeepSeek restart is required to take effect); the gear opens Settings — UI language (中文/English), six font-size steps (100%–150%), all applied immediately and remembered.
 
 The panel only writes state (chapter status, project.yml, index.yml rebuilds), never prose — prose belongs to the author and the chief.
 
@@ -99,7 +99,7 @@ The plugin ships 4 web-novel methodology skills. At startup the installer drops
 |---|---|
 | maoying-golden-opening | Golden three chapters: role split of the first three chapters (world hook → motivation → conflict detonation), the "something happens in the first 300 words" rule, information-release discipline and a self-check list |
 | maoying-beat-pacing | Payoff pacing: a payoff-type library, suppression-release ratios, chapter/arc/book pacing curves and chapter-end hook selection |
-| maoying-review-checklist | Review checklist: six layers (language / pacing / characterization / logic / foreshadowing / spoilers) with P0/P1/P2 severity |
+| maoying-review-checklist | Review checklist: seven layers (language / pacing / characterization / logic / foreshadowing / spoilers / style) with P0/P1/P2 severity |
 | maoying-foreshadow-discipline | Foreshadow management: register on planting, pacing & scheduling, the "surprising yet reasonable" payoff bar, and ledger cleanup thresholds |
 
 The installer only touches `maoying-*` prefixed directories; your own skills under `~/.dsh/skills/` are untouched, byte for byte. After uninstalling the plugin, remove the skill directories manually (all four together):
@@ -111,7 +111,7 @@ rm -rf "${DSH_HOME:-$HOME/.dsh}/skills/"maoying-*
 
 ## The novel/ Data Spec
 
-The `novel/` directory is the plugin's entire database: project.yml (metadata + seven-phase state), volumes.yml, chapters/ (frontmatter five narrative dimensions + prose), characters/ (character cards), world/, science/ (three-color settings), relations.yml, foreshadows.yml (the state machine), timeline.yml, memories.yml (with appearance records and the promise ledger), clue-board.yml, research/, exports/. Full formats, examples and design rationale:
+The `novel/` directory is the plugin's entire database: project.yml (metadata + seven-phase state), style.md (the writing style baseline), volumes.yml, chapters/ (frontmatter five narrative dimensions + prose), characters/ (character cards), world/, science/ (three-color settings), relations.yml, foreshadows.yml (the state machine), timeline.yml, memories.yml (with appearance records and the promise ledger), clue-board.yml, research/, exports/. Full formats, examples and design rationale:
 
 - Quick reference: `novel/README.md` after project init (template source: [templates/novel/README.md](templates/novel/README.md))
 - Full spec: [docs/spec.md](docs/spec.md) (why not SQLite, five-dimension field definitions, foreshadow state-machine semantics, appearance-record conventions)

package/README.md

@@ -75,7 +75,7 @@ DSH 左侧栏底部点「**毛颖创作台**」打开全页面板（改文件、
 
 - **章节**：状态筛选 + 按单写作清单；点章节进整页阅读——返回按钮、章纲对照（Markdown 渲染）、只读正文、五维叙事字段、一键状态流转。
 - **概览**：书稿卡右上「编辑」按钮展开 project.yml 的书名/作者/题材/篇幅/语言/工作流阶段/共创模式/简介表单化编辑（原「小说设置」tab 并入），保存保留文件里原有注释；表单载入后 project.yml 被外部（作者手改 / agent 推进阶段）改过时拒绝保存并提示重改，不覆盖人工改动。概览另设「分卷规划」卡，列出 volumes.yml 各卷定位与计划章节范围——拍板过的分卷有处可查。
-- **顶栏**：当前版本号常驻；npm 上有新版时亮「有新版 ↗」徽章直连发布页，旁边「一键升级」按钮直接用 pnpm 把最新包装进当前 DSH 档（仅支持 profile 目录安装；装完需重启 DeepSeek 才生效）；齿轮打开系统设置，界面语言中文/English 可切、字号六档（100%–150%）整体缩放，均立即生效并记忆。
+- **顶栏**：当前版本号常驻；npm 上有新版时亮「有新版 ↗」徽章直连发布页，旁边「一键升级」按钮直接用 pnpm 把最新包装进当前 DSH 档（仅支持 profile 目录安装，pnpm 缺失时自动回落 corepack；检测到全局 `maoying` CLI 时顺带以同一精确版本更新，未装则跳过；装完需重启 DeepSeek 才生效）；齿轮打开系统设置，界面语言中文/English 可切、字号六档（100%–150%）整体缩放，均立即生效并记忆。
 
 面板只写状态（章节状态、project.yml、index.yml 重建），不改正文——正文永远归作者与主编。
 
@@ -99,7 +99,7 @@ author-draft 下的协作循环——你只管写，交稿即接管杂务：
 |---|---|
 | maoying-golden-opening | 黄金三章：前三章职能分工（世界钩子 → 动机确立 → 冲突引爆）、前 300 字出事原则、信息释放纪律与自检清单 |
 | maoying-beat-pacing | 爽点节奏：爽点类型库、压抑-释放配比、单章/中/大三级节奏曲线与章尾钩子选型 |
-| maoying-review-checklist | 审校清单：语言/节奏/人设/逻辑/伏笔/剧透六层逐项检查，按 P0/P1/P2 三档严重度输出 |
+| maoying-review-checklist | 审校清单：语言/节奏/人设/逻辑/伏笔/剧透/风格七层逐项检查，按 P0/P1/P2 三档严重度输出 |
 | maoying-foreshadow-discipline | 伏笔管理：埋设即登记、推进节奏排期、回收「意外 + 合理」标准与台账清理阈值 |
 
 安装器只认 `maoying-*` 前缀目录，`~/.dsh/skills/` 下你自己的技能一个字节不动。卸载插件后技能目录需手动清理（四目录一起删）：
@@ -111,7 +111,7 @@ rm -rf "${DSH_HOME:-$HOME/.dsh}/skills/"maoying-*
 
 ## novel/ 数据规范
 
-`novel/` 目录是整个插件的数据库：project.yml（元信息与七阶段 phase）、volumes.yml、chapters/（frontmatter 五维叙事字段 + 正文）、characters/（角色卡）、world/、science/（三色设定）、relations.yml、foreshadows.yml（伏笔状态机）、timeline.yml、memories.yml（含出场记录与承诺账）、clue-board.yml、research/、exports/。全部格式、示例与设计理由见：
+`novel/` 目录是整个插件的数据库：project.yml（元信息与七阶段 phase）、style.md（写作风格基准）、volumes.yml、chapters/（frontmatter 五维叙事字段 + 正文）、characters/（角色卡）、world/、science/（三色设定）、relations.yml、foreshadows.yml（伏笔状态机）、timeline.yml、memories.yml（含出场记录与承诺账）、clue-board.yml、research/、exports/。全部格式、示例与设计理由见：
 
 - 速查版：项目初始化后的 `novel/README.md`（模板源 [templates/novel/README.md](templates/novel/README.md)）
 - 完整版：[docs/spec.md](docs/spec.md)（为什么不用 SQLite、五维字段定义、伏笔状态机语义、出场记录约定）

package/docs/creator-panel.md

@@ -39,7 +39,7 @@ webServer.register({ kind: 'prefix', path: '/api/maoying', handler: async (req,
 |---|---|---|---|
 | `client.css` | GET | — | text/css（lib/base.css 现读，no-cache） |
 | `update-check` | GET | — | `{ ok, current, latest, updateAvailable, releaseUrl, checkedAt, error, source }`——新版检测（npm registry → npmmirror → GitHub 三级源，1h 缓存 + 7 天 stale-if-error，全败静默降级为 latest=null / error 非空） |
-| `self-update` | POST | — | `{ ok, from, to, restartRequired: true }` 或 `{ ok: false, kind, error }`——面板内一键升级：安装形态/pnpm 探测通过后跑 `pnpm --dir <profileDir> add dsh-maoying@latest`（180s 超时，无 shell）。仅支持 `<dshHome>/profiles/<profile>/node_modules/dsh-maoying` 真实目录安装；symlink/dev 检出（dev-link）与非 profile 布局（unsupported-layout）、pnpm 缺失（pnpm-missing）、超时（timeout）、pnpm 非零退出（pnpm-failed）一律 200 + ok:false。**装完只换磁盘包，运行中进程仍是旧代码，restartRequired 恒 true——重启 DeepSeek 后生效** |
+| `self-update` | POST | — | `{ ok: true, kind: 'installed', from, to, restartRequired: true }` / `{ ok: true, kind: 'up-to-date', from }` 或 `{ ok: false, kind, error }`——面板内一键升级：安装形态 + profile 就绪预检 + 版本预检（registry 失败再 mirror，拿不到 latest 不动手）通过后，在 profile 目录里直跑 `pnpm add dsh-maoying@<精确版本>`（pnpm 候选链逐个 spawn：裸 pnpm → corepack pnpm → homebrew / node@XX keg-only / execPath 同目录 corepack → PNPM_HOME 落位，仅 ENOENT 换下一路；180s 超时）。仅支持 `<dshHome>/profiles/<profile>/node_modules/dsh-maoying` 真实目录安装；symlink/dev 检出（dev-link）、非 profile 布局（unsupported-layout）、profile 未初始化（profile-missing）、拿不到最新版（no-target）、pnpm 缺失（pnpm-missing，message 带手动出路）、超时（timeout）、pnpm 非零退出（nonzero）一律 200 + ok:false。**装完只换磁盘包，运行中进程仍是旧代码，restartRequired 恒 true——重启 DeepSeek 后生效** |
 | `host-debug` | GET | — | `{ ok, hostVersion, trace, shape, registry, runtime }`——现场诊断（见下节） |
 | `workspaces` | GET | — | `{ ok, workspaces: [{ path, name, hasNovel }] }`——workspaceRegistry.list() 逐根探测 `<root>/novel/project.yml` |
 | `state` | GET | `path=<root>` | 全量快照（见 §3 契约） |
@@ -137,7 +137,10 @@ webServer.register({ kind: 'prefix', path: '/api/maoying', handler: async (req,
 - **按单写作兼容孤儿章纲**（0.1.15）：章纲先于正文时面板不再零入口——「按单写作」区块在联交（有章纲且 status=pending 的章）之外照列未建章的孤儿章纲（按章纲序保序混排）：「未建章」徽章 + 章纲节选 + 字数 + 两个动作（行点击开章纲全文弹层：MaskPortal + MdView 渲染 GET `outline` 的 body、words 一并显示；「建章」按钮 POST `chapter-create` 在 chapters/ 落 status=pending 空章——frontmatter 按 chapters/vXX-cXXX.md 模板、title 取章纲首条标题行去「章纲」后缀，成功 toast 后重拉快照，新章进表格、走既有 pending 流转，孤儿行按新快照自然消失）；chapters/ 为空而 outlines/ 非空时空态改提示「下方按单写作已列出未建章章纲」。路由 13 → 15 条（outline GET / chapter-create POST）；I18N zh/en 各 219 → 230 条（chapters.outlineRowTip / noChapter / createBtn / creating / createTip / emptyWithOutlines、toast.chapterCreated、outline.modalAria / closeAria / loading / loadFailed）。
 - **小说设置并入概览**（0.1.15）：原第 9 个「小说设置」tab 撤销（八个 tab），改为概览书稿卡右上「编辑」按钮——点击后 hero 卡原位切换为书稿元信息表单（ProjectMetaForm，8 平键 + 取消/保存），保存链路不变（`POST project-save` 携 `base_hash` 409 人工改动保护，成功重拉快照并退出编辑态，取消直接退出不落盘）。路由不变；I18N zh/en 各 230 → 232 条（tabs.settings 移除，overview.edit / overview.editTip / novel.cancel 新增）。
 - **role 徽章本地化**（0.1.15）：角色卡墙与全卡弹层的 role 徽章不再直出角色卡 frontmatter 原文——契约四态（`protagonist|antagonist|supporting|minor`）按界面语言出标签（主角/反派/配角/龙套；英文面板 Protagonist/Antagonist/Supporting/Minor），role 是自由文本、契约外取值原样展示不翻译；tone 归色逻辑（roleTone 关键词匹配）不变。I18N zh/en 各 232 → 236 条（role.protagonist / antagonist / supporting / minor）。
-- **分卷规划卡 + 考据笔记正文**（未发版）：快照顶层新增 `volumes`（volumes.yml 原样：id/title/summary/chapters 计划范围串）——概览新增「分卷规划」卡（有卷才显，卷头 id · 卷名 + 计划范围 tag + 卷定位一句），分卷拍板件在面板有复核位（配合 CLI check 的 phase 阶段就绪判据）；research 快照从只取 topic 扩为 sources + description，设定 tab「资料检索」从标签行改为逐条渲染：topic 标题 + 笔记正文（MdView）+ sources 参考（悬停显全文 URL）。路由不变；I18N zh/en 各 +1 条（overview.volumes）。
+- **分卷规划卡 + 考据笔记正文**（0.1.18）：快照顶层新增 `volumes`（volumes.yml 原样：id/title/summary/chapters 计划范围串）——概览新增「分卷规划」卡（有卷才显，卷头 id · 卷名 + 计划范围 tag + 卷定位一句），分卷拍板件在面板有复核位（配合 CLI check 的 phase 阶段就绪判据）；research 快照从只取 topic 扩为 sources + description，设定 tab「资料检索」从标签行改为逐条渲染：topic 标题 + 笔记正文（MdView）+ sources 参考（悬停显全文 URL）。路由不变；I18N zh/en 各 +1 条（overview.volumes）。
+- **pnpm 候选链对齐 dsh-paoding**（0.1.18）：修复一键升级「未找到 pnpm」误报。病因（实机验证）：本机 pnpm 由 corepack 管理但未 `corepack enable`，PATH 里没有裸 pnpm，PNPM_HOME 落位也没有——旧版 existsSync+accessSync(X_OK) 文件预筛（PATH 目录扫描 + homebrew/pnpm 官方落位）全落空直接报 pnpm-missing；且 desktop Electron 进程 PATH 可能是 launchd 最小集（实测最小 PATH 下裸 corepack 也 ENOENT），`/opt/homebrew/bin/corepack` 不在，只有 `/opt/homebrew/opt/node@24/bin/corepack` 在盘上。机制照 dsh-paoding tools/lib/upgrade.mjs 对齐：① **spawn ENOENT 探测链**替代文件预筛——逐候选真 spawn，仅 err.code==='ENOENT' 换下一路（EACCES / 超时 / 非零退出是真实运行结果，如实返回不换通道），绝对路径候选才 existsSync 预筛（不存在不浪费 spawn）；新候选链：裸 pnpm → 裸 corepack（+`pnpm` 参数前缀）→ `/opt/homebrew/bin/corepack` → `/opt/homebrew/opt/node@XX/bin/corepack`（readdirSync 过滤 node 前缀目录拼路径，多版本按序全收；目录不存在跳过）→ execPath 同目录 corepack（桌面 Electron 下无用但无害，headless/web profile 有用）→ `~/Library/pnpm`、`~/.local/share/pnpm`。② **升级前版本预检**：fetchLatestFromRegistry(10s) 失败再 fetchLatestFromMirror(10s)，拿不到 latest 不做半截升级（kind: no-target，message 带两路错误）；compareVersions(target, current)<=0 短路 kind: 'up-to-date'（`{ ok: true, kind: 'up-to-date', from }`，前端 toast「已是最新版」后按钮恢复可点、不进已安装态）；装精确版本 `dsh-maoying@<target>` 而非 @latest（避开 pnpm 新鲜度防护 / 镜像 packument 滞后的静默空转）。③ **cwd = profile 目录**（pnpm 操作对象就是它），去掉 --dir。④ profile 目录缺 package.json → 诚实失败 kind: 'profile-missing'。⑤ win32 pnpm/corepack 是 .cmd shim：spawn shell:true（CVE-2024-27980 加固）+ 命令补 .cmd 后缀、参数保持数组；darwin/linux 恒 shell:false。⑥ 子进程输出尾部 2KB → 8KB（合并 stdout+stderr）；全候选 ENOENT 的 pnpm-missing message 带可操作出路：「可先在终端执行 corepack enable 并重启 DSH 后重试；或手动升级：cd <profileDir> && corepack pnpm add dsh-maoying@<目标版本>」，dev-link 的 message 保留 git pull 出路。spawnImpl 契约改 paoding 形状 `(command, args, options, timeoutMs, timeoutLabel) → { code, output, error?, errorCode? }`（缺省 defaultSpawn 合并输出、超时 SIGTERM、5s 宽限后 SIGKILL 兜底、收敛 errorCode 'ETIMEDOUT'）；退出码非零 kind 从 pnpm-failed 更名 nonzero。前端 pnpm-missing 等失败 message 服务端已带出路文案，toast 直显不截断。安全闸（realpath 形态两道闸 / 模块级 in-flight 去重 / 成功后 invalidateVersionCache）与依赖全注入风格不变。路由仍 15 条；I18N zh/en 各 237 → 238 条（toast.selfUpdate.upToDate）。
+- **概览补显共创模式**（0.1.18）：书稿卡阶段行 phase pill 后补「共创模式」短标签徽章（悬浮出全称；快照 mode 缺失或越枚举时不显示，老项目无该键不误标）。路由不变；I18N zh/en 各 238 → 241 条（modeShort.aiDraft / coWrite / authorDraft）。
+- **一键升级顺带全局 CLI**（0.1.18）：本机常见两份独立安装——desktop profile（`<dshHome>/profiles/desktop/node_modules/dsh-maoying`，一键升级的更新对象）与全局 CLI（`npm i -g` 装的 `<npm 全局>/node_modules/dsh-maoying`，如 `/opt/homebrew/bin/maoying` → `/opt/homebrew/lib/node_modules/dsh-maoying/bin/maoying.mjs`）——只更 profile 会版本偏斜；方案 B：profile 阶段落定（installed 装完 / up-to-date 短路）后跑独立全局阶段，把两份收敛到同一精确版本。**检测**（detectGlobalCli，零 spawn 纯文件系统）：PATH 各目录 + `/opt/homebrew/bin` + `/usr/local/bin` 找 `maoying`（win32 `maoying.cmd`），existsSync 预筛；命中后 realpathSync 该 bin 两级上溯得包根（`bin/maoying.mjs` → 包根），包根 package.json 的 name 必须是 `dsh-maoying` 才认（防怪链接）；包根 realpath 落在本 profile 目录内（如 profile 自带 `.bin/maoying`）→ 不算全局，跳过该候选继续找；全落空 → 不 spawn。**更新**走 npm 候选链（与 pnpm 链同款 spawn ENOENT 探测）：裸 npm → execPath 同目录 → `/opt/homebrew/bin` → `/usr/local/bin` → `/opt/homebrew/opt/node@XX/bin`，spawn `npm i -g dsh-maoying@<target>`（cwd=os.tmpdir()、独立 120s 超时，profile pnpm 仍 180s）。**返回形状**：成功对象新增 `globalCli` 字段——`{ ok: true, skipped: 'missing' }`（没装全局，跳过）/ `{ ok: true, skipped: 'same', version }`（已同版）/ `{ ok: true, from, to }` / `{ ok: false, error, output? }`（error 中文、含手动出路 `npm i -g dsh-maoying@<target>`）——**全局失败不拖累 profile 安装**：整体仍 ok:true，重启照常生效，失败如实透出；dev-link / unsupported-layout / no-target / profile-missing 等失败路径维持整单拒绝，不碰全局。路由把 globalCli 原样透传（up-to-date 与 installed 两个成功分支）。前端成功 toast 主文案不变、按 globalCli 拼第二句（missing / same 不提零噪音，真更新了显「全局 maoying CLI a → b」，失败如实报错），up-to-date 分支同样拼接，toast 文本容器加 `white-space: pre-line` 承接换行；self-update 请求前端超时 200s → 340s（180 + 120 + 40 余量）。路由不变；I18N zh/en 各 241 → 243 条（toast.selfUpdate.globalOk / globalFail）。
 
 ## 5. 验收基线
 

package/docs/design.md

@@ -133,13 +133,13 @@ delegation-labels 静态角色名映射：{outline: 大纲师, write: 写手, re
 persona prefix 内容骨架（agent.cordis.yml 内联，中文书写）：
 
 1. **身份**：网文主编/创作总监，管 project 目录 novel/，重活委派五帮手，自己只做规划、衔接、验收、状态推进。
-2. **开工纪律**：先读 novel/project.yml + index.yml；不确定文件格式读 novel/README.md；不全量读章节，写到哪章读哪章上下文（前章结尾 ~1500 字 + 该章 frontmatter + 出场角色卡 + 活跃伏笔节选）。
+2. **开工纪律**：先读 novel/project.yml + index.yml + style.md（若有）；不确定文件格式读 novel/README.md；不全量读章节，写到哪章读哪章上下文（前章结尾 ~1500 字 + 该章 frontmatter + 出场角色卡 + 活跃伏笔节选）。
 3. **七阶段状态机**（每阶段推进写 project.yml phase）：idea 选题 → setting 设定 → outline 大纲 → writing 写作 → review 审阅 → consistency 一致性 → export 导出。每完成一个里程碑必须推进 phase 并告知用户。
 4. **Writing 六步法**（逐章循环）：
    ① 衔接检查：读前章结尾，确认无断裂；
    ② 委派 outline 出/改本章大纲（含五维字段），主编过目；
    ③ 委派 write 写正文（写手人设要求：按大纲覆盖五维、不写崩人设、章尾留钩子），status→writing；
-   ④ 委派 review 审稿（清单：语言/节奏/人设符合/不剧透/伏笔推进合理/前后矛盾），status→review；
+   ④ 委派 review 审稿（清单：语言/节奏/人设符合/不剧透/伏笔推进合理/前后矛盾/风格符合），status→review；
    ⑤ 审稿问题回 write 修（continuable 就地续修）或主编微调；
    ⑥ 通过后 status→accepted，委派 lore 做定稿维护（出场记录、伏笔状态、记忆、线索板、时间线），`maoying index` 重建概览。
    循环检查：还有非 accepted 章节 → 回 ①。

package/docs/spec.md

@@ -29,6 +29,9 @@
 ### project.yml
 `phase` 七态 `idea|setting|outline|writing|review|consistency|export` 只能由主编推进（帮手不得越权改），且必须顺序推进不可跳越；推进时主编须向用户简报。推进有完成判据：setting → outline 须核心角色卡（主角、核心反派）与世界观核心条目（金手指规则、对抗格局）已落盘，且 characters/ 有两张及以上角色卡时 relations.yml 不为空（关系网须登记）；outline → writing 须 volumes.yml 在案且目标章大纲已出；判据不满足回上一阶段补齐。冷启动（Collab 四步）在设定落盘与分卷规划两处各设一个用户拍板点——主编简报列决策点，等用户实质确认才进下一步。`language` 影响写手与审校的语言纪律（如 `zh` 不允许成段外文）。`mode` 三值决定正文归谁写：`ai-draft`（缺省，AI 代笔，主编走 Writing 六步法）/ `co-write`（逐章指派谁写，主编动笔前先问清本章归谁）/ `author-draft`（全书作者亲笔，主编只备料、审稿、记账，永不代写）。文件里没有 `mode` 键的旧项目一律按 `ai-draft` 处理。
 
+### style.md
+写作风格基准（人称视角、语言基调、节奏、对话、情绪与爽点、禁忌），写手/大纲师/审校一律遵守；纯 markdown、无 frontmatter，作者随时手改、改完即生效；冷启动由主编与用户对齐后落盘，旧项目缺失时按通用网文基线执行。设计理由：风格集中在一个可手改文件里，而不是写死在 persona——persona 只写加载纪律（读它、服从它、冲突上报主编），风格内容随书可变，作者不改插件就能改风格；旧项目没有该文件时优雅降级（各 persona 与审校风格层均写「若有」）；审校风格层以其为裁判基准，文件缺席时退回通用网文基线抽查明显风格跳变，并在报告注明「无风格基准」。
+
 ### volumes.yml
 `id` 与章节文件名前缀严格一致（`v01` ↔ `chapters/v01-cXXX.md`），index.yml 的卷分组按本文件顺序输出。`chapters` 范围写法 `001-020` 是给人看的计划值，运行时以章节文件实况为准。
 

package/index.mjs

@@ -996,16 +996,25 @@ export async function registerCreatorRoutes(ctx) {
         }
 
         if (route === 'self-update' && req.method === 'POST') {
-          // 面板内一键升级：形态/pnpm 检查 + `pnpm --dir <profileDir> add
-          // dsh-maoying@latest`（细节与安全边界见 lib/self-update.mjs）。可
-          // 预期的失败（dev-link / unsupported-layout / pnpm-missing / 超时 /
-          // pnpm 非零退出）统一 HTTP 200 + ok:false，kind 给客户端分流、
-          // message 经 sanitizeMessage 脱敏后透出；成功也带 restartRequired:
+          // 面板内一键升级：形态/profile 预检 + 版本预检后，在 profile 目录里
+          // 直跑 `pnpm add dsh-maoying@<精确版本>`（pnpm 按候选链解析，细节与
+          // 安全边界见 lib/self-update.mjs）。可预期的失败（dev-link /
+          // unsupported-layout / profile-missing / no-target / pnpm-missing /
+          // 超时 / 退出码非零 nonzero）统一 HTTP 200 + ok:false，kind 给客户端
+          // 分流、message 经 sanitizeMessage 脱敏后透出；成功带 restartRequired:
           // true——装完的只是磁盘上的新包，运行中的进程仍是旧代码，必须重启
-          // DeepSeek 才生效，客户端文案必须照实转述。
+          // DeepSeek 才生效，客户端文案必须照实转述。本地已不落后线上时短路
+          // kind: 'up-to-date'（不装 profile）。两个成功路径都顺带全局 CLI：
+          // globalCli 原样透传（json 序列化不截字段；形状与失败不拖累整体的
+          // 语义见 lib/self-update.mjs 文件头注「全局 CLI 顺带更新」节）。
           const r = await selfUpdate({ logger: ctx.logger })
-          if (r.ok) {
-            json(res, 200, { ok: true, from: r.from ?? null, to: r.to ?? null, restartRequired: true })
+          if (r.ok && r.kind === 'up-to-date') {
+            json(res, 200, { ok: true, kind: 'up-to-date', from: r.from ?? null, globalCli: r.globalCli ?? null })
+          } else if (r.ok) {
+            json(res, 200, {
+              ok: true, kind: r.kind, from: r.from ?? null, to: r.to ?? null,
+              restartRequired: true, globalCli: r.globalCli ?? null,
+            })
           } else {
             json(res, 200, { ok: false, kind: r.kind, error: sanitizeMessage(r.message ?? r.kind) })
           }

package/lib/base.css

@@ -709,7 +709,8 @@ html[data-dsh-maoying-active]:not([data-dsh-mnemon-active]):not([data-dsh-taskbo
   box-shadow: 0 8px 28px color-mix(in srgb, #000 24%, transparent);
   pointer-events: auto;
 }
-.myt-toastText { min-width: 0; max-height: 120px; overflow-y: auto; overflow-wrap: anywhere; }
+/* pre-line：一键升级 toast 的全局 CLI 第二句以 \n 换行显示（client.js globalCliNote）。 */
+.myt-toastText { min-width: 0; max-height: 120px; overflow-y: auto; overflow-wrap: anywhere; white-space: pre-line; }
 .myt-toastOk { border-color: color-mix(in srgb, var(--dsw-alias-state-success-primary) 40%, transparent); }
 .myt-toastWarn { border-color: color-mix(in srgb, var(--dsw-alias-state-warn-primary) 40%, transparent); }
 .myt-toastErr { border-color: color-mix(in srgb, var(--dsw-alias-state-error-primary) 50%, transparent); }

package/lib/client.js

@@ -53,14 +53,17 @@ window.__ModuleLoader__.load({
     var CSS_KEY = "maoying-creator/base";
     var WS_STORAGE_KEY = "maoying.workspace";
     var API_TIMEOUT_MS = 60000;
-    // 一键升级单独放宽：服务端 pnpm add 超时上限 180s，统一 60s 会先掐断，
-    // 故 self-update 请求走 200s（留 20s 余量），其余请求仍用 API_TIMEOUT_MS。
-    var SELF_UPDATE_TIMEOUT_MS = 200000;
+    // 一键升级单独放宽：服务端 profile pnpm add 超时上限 180s + 全局 npm i -g
+    // 独立 120s（顺带更新全局 maoying CLI），统一 60s 会先掐断，故 self-update
+    // 请求走 340s（300s + 40s 余量），其余请求仍用 API_TIMEOUT_MS。
+    var SELF_UPDATE_TIMEOUT_MS = 340000;
 
     var STATUS_FLOW = ["pending", "writing", "review", "accepted"];
     var FS_ORDER = ["planted", "progressing", "resolved", "abandoned"];
     var FS_FLOW = { planted: "progressing", progressing: "resolved" };
     var PHASES = ["idea", "setting", "outline", "writing", "review", "consistency", "export"];
+    // 共创模式三态（key → mode.* / modeShort.* 词典后缀）：概览书稿卡展示用。
+    var MODES = [["ai-draft", "aiDraft"], ["co-write", "coWrite"], ["author-draft", "authorDraft"]];
     // clue.* 词典键是小驼峰，数据里的 kind 按契约（templates/novel/README.md、
     // docs/spec.md）是 clue|red-herring|deduction|question——此前键表误按
     // snake_case + inference 写，红鲱鱼/推理两组永远查不中、只能裸显英文原值。
@@ -696,24 +699,48 @@ window.__ModuleLoader__.load({
       }, []);
       // 一键升级状态机：""（可点）→ "installing"（安装中，按钮禁用）→
       // "installed"（已装完待重启，按钮永久禁用、新版徽章收起）。可预期失败
-      // （dev-link / pnpm-missing / pnpm 出错）回落 "" 允许重试。
+      // （dev-link / pnpm-missing / pnpm 出错）回落 "" 允许重试；服务端短路
+      // up-to-date（本地已不落后线上）也回落 ""，按钮恢复可点、不进 installed 态。
+      // 全局 maoying CLI 顺带更新结果（服务端 globalCli 字段）拼成 toast 第二句
+      // （\n 换行，配合 base.css myt-toastText 的 pre-line 显示）：
+      //   - ok 且真更新了（from → to）：「全局 maoying CLI a → b」；
+      //   - skipped 'missing'（用户没装全局 CLI）/ 'same'（已同版）：不提，零噪音；
+      //   - ok:false：如实报「全局 CLI 更新失败：{error}」，不改动主文案的成功语义
+      //     （profile 已装好，重启照常生效）。
+      function globalCliNote(d) {
+        var g = d && d.globalCli;
+        if (!g) return "";
+        if (g.ok) {
+          if (g.skipped) return "";
+          return "\n" + tf("toast.selfUpdate.globalOk", { from: g.from || "?", to: g.to || "?" });
+        }
+        return "\n" + tf("toast.selfUpdate.globalFail", { error: g.error || tt("common.unknownErr") });
+      }
       var _up = useState(""), upState = _up[0], setUpState = _up[1];
       function runSelfUpdate() {
         if (upState !== "") return;
         setUpState("installing");
         // 不走 apiPost：成功提示要带新版本号、失败按 kind 分流文案，且超时
-        // 单独放宽（服务端 pnpm 最长 180s，统一 60s 会先掐断，见常量处注释）。
+        // 单独放宽（服务端 profile pnpm 最长 180s + 全局 npm 独立 120s，统一
+        // 60s 会先掐断，见常量处注释）。
         maoyingApi("self-update", {}, SELF_UPDATE_TIMEOUT_MS).then(function (d) {
-          if (d && d.ok) {
+          if (d && d.ok && d.kind === "up-to-date") {
+            // 短路：profile 没装任何东西，但全局 CLI 仍可能要跟进（globalCliNote
+            // 拼第二句）；按钮恢复可点；版本徽章留给 update-check 自行收敛。
+            setUpState("");
+            toast.ok(tf("toast.selfUpdate.upToDate", { ver: (d && d.from) || "?" }) + globalCliNote(d));
+          } else if (d && d.ok) {
             setUpState("installed");
             // 硬约束照实说：装完只是磁盘换新，运行中的进程仍是旧代码。
-            toast.ok(tf("toast.selfUpdate.ok", { ver: (d && d.to) || "?" }));
+            toast.ok(tf("toast.selfUpdate.ok", { ver: (d && d.to) || "?" }) + globalCliNote(d));
           } else if (d && d.kind === "dev-link") {
             setUpState("");
             toast.warn(tt("toast.selfUpdate.devLink"));
           } else if (d && d.kind === "pnpm-missing") {
+            // 服务端 message 已带可操作出路（corepack enable / 手动命令），直显不截断；
+            // 拿不到 message 才回落本地通用文案。
             setUpState("");
-            toast.warn(tt("toast.selfUpdate.pnpmMissing"));
+            toast.err(tf("toast.prefix", { msg: (d && d.error) || tt("toast.selfUpdate.pnpmMissing") }));
           } else {
             setUpState("");
             toast.err(tf("toast.prefix", { msg: (d && d.error) || tt("common.unknownErr") }));
@@ -880,6 +907,9 @@ window.__ModuleLoader__.load({
       var _b = useState(false), phaseBusy = _b[0], setPhaseBusy = _b[1];
       var phaseIdx = PHASES.indexOf(project.phase);
       var nextPhase = phaseIdx !== -1 && phaseIdx < PHASES.length - 1 ? PHASES[phaseIdx + 1] : null;
+      // 共创模式徽章：快照 mode 缺失（老项目无该键）或越枚举时不显示。
+      var modeEntry = null;
+      for (var mi = 0; mi < MODES.length; mi++) { if (MODES[mi][0] === project.mode) { modeEntry = MODES[mi]; break; } }
       // 静态体检黄条：仅 found 时拉 check 路由（未初始化没有可查的东西）。
       // 工作区切换与每次 reload 都换新 snap → effect 重跑即重查；请求序号防
       // 过期响应（快速切工作区时在途旧响应不得落进新工作区的黄条）。
@@ -920,6 +950,10 @@ window.__ModuleLoader__.load({
                 h("h2", { className: "myt-heroTitle", key: "title" }, orDash(project.title)),
                 h("div", { className: "myt-heroMeta", key: "phase" },
                   phasePill(project.phase),
+                  modeEntry ? [
+                    h("span", { className: "myt-muted", key: "modeLabel" }, tt("novel.fMode")),
+                    h("span", { className: "myt-badge", key: "modeBadge", title: tt("mode." + modeEntry[1]) }, tt("modeShort." + modeEntry[1])),
+                  ] : null,
                   nextPhase ? h("button", { type: "button", className: "myt-btn", disabled: phaseBusy, onClick: advancePhase, title: tf("phase.advanceTitle", { next: tt("phase." + nextPhase) }) }, phaseBusy ? tt("phase.advancing") : tt("phase.advance")) : h("span", { className: "myt-muted" }, project.phase ? tt("phase.final") : null)),
                 project.description ? h("p", { className: "myt-heroDesc", key: "desc" }, project.description) : null,
               ]),
@@ -1084,6 +1118,8 @@ window.__ModuleLoader__.load({
         "header.upgradeTitle": "用 pnpm 安装 npm 最新版（最长约 3 分钟），装完需重启 DeepSeek 生效",
         "header.upgradedTitle": "已安装新版，重启 DeepSeek 后生效",
         "toast.selfUpdate.ok": "已安装 {ver}，重启 DeepSeek 后生效",
+        "toast.selfUpdate.upToDate": "已是最新版（{ver}）",
+        "toast.selfUpdate.globalOk": "全局 maoying CLI {from} → {to}", "toast.selfUpdate.globalFail": "全局 CLI 更新失败：{error}",
         "toast.selfUpdate.devLink": "开发目录安装，请 git pull 更新", "toast.selfUpdate.pnpmMissing": "未找到 pnpm，请手动安装",
         "header.workspace": "工作区", "header.wsAria": "选择工作区", "header.noNovel": "（无 novel）", "header.untitled": "未命名",
         "header.settings": "系统设置", "header.refresh": "重新拉取", "header.closeAria": "关闭创作台", "header.closeTitle": "关闭",
@@ -1155,6 +1191,7 @@ window.__ModuleLoader__.load({
         "novel.lengthPh": "如：约100万字 / 300章", "novel.fLanguage": "正文语言", "novel.fPhase": "工作流阶段", "novel.fMode": "共创模式",
         "novel.fDesc": "一句话简介", "novel.descPh": "写封面文案时可直接引用", "novel.titleRequired": "书名不能为空",
         "mode.aiDraft": "AI 代笔（AI 写正文）", "mode.coWrite": "逐章共创（按章指派谁写）", "mode.authorDraft": "作者亲笔（AI 只备料审稿）",
+        "modeShort.aiDraft": "AI 代笔", "modeShort.coWrite": "逐章共创", "modeShort.authorDraft": "作者亲笔",
         "novel.saving": "保存中…", "novel.save": "保存设置", "novel.cancel": "取消",
         "settings.title": "系统设置", "settings.closeAria": "关闭设置", "settings.language": "语言",
         "settings.languageHint": "界面文字随语言选项切换，立即生效并记忆。", "settings.fontScale": "字号",
@@ -1170,6 +1207,8 @@ window.__ModuleLoader__.load({
         "header.upgradeTitle": "Install the latest npm release with pnpm (up to ~3 min); takes effect after restarting DeepSeek",
         "header.upgradedTitle": "New version installed — takes effect after restarting DeepSeek",
         "toast.selfUpdate.ok": "Installed {ver} — takes effect after restarting DeepSeek",
+        "toast.selfUpdate.upToDate": "Already up to date ({ver})",
+        "toast.selfUpdate.globalOk": "Global maoying CLI {from} → {to}", "toast.selfUpdate.globalFail": "Global CLI update failed: {error}",
         "toast.selfUpdate.devLink": "Installed from a dev directory — update with git pull", "toast.selfUpdate.pnpmMissing": "pnpm not found — install it manually",
         "header.workspace": "Workspace", "header.wsAria": "Select workspace", "header.noNovel": "(no novel)", "header.untitled": "Untitled",
         "header.settings": "Settings", "header.refresh": "Refresh", "header.closeAria": "Close Maoying Studio", "header.closeTitle": "Close",
@@ -1241,6 +1280,7 @@ window.__ModuleLoader__.load({
         "novel.lengthPh": "e.g. ~1M characters / 300 chapters", "novel.fLanguage": "Text language", "novel.fPhase": "Workflow phase", "novel.fMode": "Co-writing mode",
         "novel.fDesc": "One-line synopsis", "novel.descPh": "Can be quoted directly in cover copy", "novel.titleRequired": "Title is required",
         "mode.aiDraft": "AI ghostwriting (AI drafts the prose)", "mode.coWrite": "Chapter-by-chapter co-writing (assign a writer per chapter)", "mode.authorDraft": "Author writes (AI only preps and reviews)",
+        "modeShort.aiDraft": "AI draft", "modeShort.coWrite": "Co-write", "modeShort.authorDraft": "Author writes",
         "novel.saving": "Saving…", "novel.save": "Save", "novel.cancel": "Cancel",
         "settings.title": "Settings", "settings.closeAria": "Close settings", "settings.language": "Language",
         "settings.languageHint": "UI text follows the language option; it applies immediately and is remembered.", "settings.fontScale": "Font size",

package/lib/self-update.mjs

@@ -1,42 +1,108 @@
 /**
- * 面板内一键升级 —— 直接跑 pnpm 把本包装到当前 DSH profile（创作台面板用）。
+ * 面板内一键升级 —— 版本预检 + pnpm 候选链（机制对齐 dsh-paoding
+ * tools/lib/upgrade.mjs，0.1.18 起）。
  *
  * 背景：desktop 档的真实安装形态是 <dshHome>/profiles/<profile>/node_modules/
  * dsh-maoying（真实目录，非 symlink），宿主 dsh CLI 拒绝管理 desktop 档，唯一
- * 可行的升级命令是直接 pnpm：`pnpm --dir <profileDir> add dsh-maoying@latest`。
+ * 可行的升级命令是在 profile 目录里直跑 `pnpm add dsh-maoying@<精确版本>`：
+ *   - cwd 就是 profile 目录（pnpm 的操作对象是它），不带 --dir；
+ *   - 装精确版本而非 @latest——避开 pnpm 新鲜度防护 / 镜像 packument 滞后
+ *     造成的「跑了但啥也没装」静默空转。
+ *
+ * pnpm 解析（0.1.18 重写，修复「未找到 pnpm」误报）：不再 existsSync+
+ * accessSync(X_OK) 文件预筛（corepack 管理且未 `corepack enable` 的机器 PATH
+ * 里没有裸 pnpm，桌面 GUI 进程 PATH 还可能是 launchd 最小集，预筛必落空），
+ * 改为 spawn ENOENT 探测链：逐候选真 spawn，仅 err.code==='ENOENT' 才换下一
+ * 路；EACCES / 超时 / 非零退出都是真实运行结果，如实返回不换通道。候选链：
+ *   1) 裸 pnpm（npm i -g / homebrew 等常规安装）；
+ *   2) 裸 corepack（corepack 随 node 发行，未 enable 也能 `corepack pnpm ...`
+ *      即装即用）；
+ *   3) /opt/homebrew/bin/corepack（existsSync 预筛，不在盘上不浪费 spawn）；
+ *   4) /opt/homebrew/opt/node@XX/bin/corepack（readdirSync 过滤 node 前缀目录
+ *      拼路径，
+ *      兜住 keg-only 的 node@XX 版代安装——desktop Electron 最小 PATH 实测
+ *      全靠它命中）；
+ *   5) path.dirname(process.execPath)/corepack（桌面 Electron 下无用但无害，
+ *      headless / web profile 的 node 同目录形态有用）；
+ *   6) ~/Library/pnpm、~/.local/share/pnpm（pnpm 独立安装脚本落位）。
+ * win32 的 pnpm / corepack 都是 .cmd shim，spawn 必须 shell:true（Node 直接
+ * spawn .cmd 会 EINVAL，见 CVE-2024-27980 加固），命令补 .cmd 后缀、参数保持
+ * 数组形式；darwin/linux 恒 shell:false，无注入面。
+ *
+ * 升级前版本预检：fetchLatestFromRegistry（10s）失败再 fetchLatestFromMirror
+ * （10s），拿不到 latest 绝不做半截升级；compareVersions(target, current) <= 0
+ * 直接短路「已是最新」，不 spawn。装完失效版本检测缓存。
  *
  * 安全边界（缺一不可，全不满足绝不执行安装）：
  *   1) 安装形态判定——插件包自身目录先 realpathSync 取真路径，真路径 ≠ 常规
  *      路径即 link/symlink 安装（如 web 档指向 dev repo）→ 拒绝（dev-link，
- *      请在开发目录 git pull）；真路径不匹配 <dshHome>/profiles/<profile>/
- *      node_modules/dsh-maoying 结构 → 拒绝（unsupported-layout）。dshHome /
- *      profile 取 env.DSH_HOME / DSH_PROFILE（~ 前缀手动展开），缺失时回退从
- *      真路径的 profiles 祖先推导，推导不出同样拒绝。
- *   2) pnpm 解析——按候选路径逐个 existsSync + accessSync(X_OK)（PATH 各目录
- *      在前，homebrew / pnpm 官方安装位在后），一个都不可执行 → 拒绝
- *      （pnpm-missing）。绝不用 shell:true，无注入面。
- *   3) 超时 180 秒——超时 kill 子进程收敛为 timeout，不挂死面板请求。
+ *      指路 git pull）；真路径不匹配 <dshHome>/profiles/<profile>/node_modules/
+ *      dsh-maoying 结构 → 拒绝（unsupported-layout）。dshHome / profile 取
+ *      env.DSH_HOME / DSH_PROFILE（~ 前缀手动展开），缺失时回退从真路径的
+ *      profiles 祖先推导，推导不出同样拒绝。
+ *   2) profile 就绪判定——profile 目录没有 package.json（未初始化）→ 拒绝
+ *      （profile-missing），不硬跑 pnpm（会在空目录另起一份 package.json）。
+ *   3) 超时 180 秒——超时 SIGTERM（5s 后升级 SIGKILL）收敛为 timeout，不挂死
+ *      面板请求。
+ *
+ * 全局 CLI 顺带更新（方案 B：desktop profile 与全局 npm 安装是两份独立拷贝，
+ * 只更 profile 会版本偏斜）：profile 阶段落定（installed 装完 / up-to-date
+ * 短路）后跑独立的全局阶段，目标是两份安装收敛到同一精确版本：
+ *   - detectGlobalCli 零 spawn 纯文件系统检测：PATH 各目录 + /opt/homebrew/bin
+ *     + /usr/local/bin 找 `maoying`（win32 `maoying.cmd`），existsSync 预筛；
+ *     命中后 realpathSync 该 bin 两级上溯得包根（bin/maoying.mjs → 包根），
+ *     包根 package.json 的 name 必须是 dsh-maoying 才认（防怪链接）；包根
+ *     realpath 落在本 profile 目录内（如 profile 自带 .bin/maoying）→ 不是
+ *     全局安装，跳过该候选继续找。找不到任何候选 → { found: false }。
+ *   - 找不到全局安装 → globalCli: { ok: true, skipped: 'missing' }，不 spawn；
+ *   - 全局 version 与精确目标同版 → skipped: 'same'，不 spawn；否则 spawn
+ *     `npm i -g dsh-maoying@<target>`（cwd=os.tmpdir()、独立 120s 超时，npm
+ *     候选链与 pnpm 同款 spawn ENOENT 探测：裸 npm → execPath 同目录 →
+ *     /opt/homebrew/bin → /usr/local/bin → /opt/homebrew/opt/node@XX/bin）。
+ *   - 全局阶段失败（npm 缺失 / 非零 / 超时）**不拖累整体结果**：profile 已装
+ *     好，重启照常生效；globalCli.ok:false + 中文 error（含手动出路
+ *     `npm i -g dsh-maoying@<target>`）如实透出。dev-link / unsupported-layout /
+ *     no-target / profile-missing 等失败路径维持整单拒绝，不碰全局。
  *
  * 所有失败路径都不抛错，一律收敛为 { ok: false, kind, message } 结果对象；
- * 成功返回 { ok: true, kind: 'installed', from, to, restartRequired: true }。
- * 硬约束：装完后运行中的进程仍是旧代码，必须重启 DeepSeek 才生效——restart-
- * Required 恒 true，UI 文案必须明说，不得暗示装完即生效。依赖全部可注入
- * （spawnImpl / realpathImpl / existsImpl / readImpl …），对齐 lib/version.mjs
- * 的 fetchImpl 模式，方便测试。
+ * 成功返回 { ok: true, kind: 'installed', from, to, restartRequired: true,
+ * globalCli }，已是最新短路返回 { ok: true, kind: 'up-to-date', from,
+ * globalCli }（globalCli 形状见上节）。硬约束：装完后运行
+ * 中的进程仍是旧代码，必须重启 DeepSeek 才生效——restartRequired 恒 true，UI
+ * 文案必须明说，不得暗示装完即生效。依赖全部可注入（spawnImpl / realpathImpl /
+ * existsImpl / readdirImpl / fetchImpl / platform …），对齐 lib/version.mjs 的
+ * fetchImpl 模式，方便测试。
  */
 import { spawn as nodeSpawn } from 'node:child_process'
-import { accessSync, constants as fsConstants, existsSync, realpathSync } from 'node:fs'
-import { readFile } from 'node:fs/promises'
+import { existsSync, readFileSync, readdirSync, realpathSync } from 'node:fs'
 import os from 'node:os'
 import path from 'node:path'
 import { fileURLToPath } from 'node:url'
 
-import { invalidateVersionCache } from './version.mjs'
+import {
+  compareVersions,
+  currentVersion,
+  fetchLatestFromMirror,
+  fetchLatestFromRegistry,
+  invalidateVersionCache,
+} from './version.mjs'
 
 /** 安装超时：pnpm 冷缓存 + 国内网络最坏留足 3 分钟。 */
 export const SELF_UPDATE_TIMEOUT_MS = 180 * 1000
-/** 失败信息里保留的子进程输出尾部字节数（stdout / stderr 各一份）。 */
-const OUTPUT_TAIL_BYTES = 2048
+/** 全局 CLI 更新超时：npm i -g 单包安装，独立于 profile 的 180s，2 分钟收敛。 */
+export const GLOBAL_CLI_TIMEOUT_MS = 120 * 1000
+/** 版本预检单路（registry / mirror）超时：用户显式点了「升级」，等得起。 */
+const VERSION_TIMEOUT_MS = 10 * 1000
+/**
+ * 失败信息里保留的子进程输出尾部长度（stdout+stderr 合并后取尾）：8KB——
+ * pnpm 的报错结论都在尾部，但镜像 404 / 对账冲突这类关键行可能被进度刷屏
+ * 顶得很深，2KB 不够排障。
+ */
+const OUTPUT_TAIL_BYTES = 8 * 1024
+/** 输出累积硬上限：超过先截一版，防异常刷爆内存。 */
+const OUTPUT_HARD_CAP_BYTES = 1024 * 1024
+/** SIGTERM 后留给进程自行退出的宽限，超时升级 SIGKILL。 */
+const TERM_GRACE_MS = 5 * 1000
 
 /**
  * 插件包自身目录（package.json 所在目录）。抽成函数便于测试注入假安装位。
@@ -46,34 +112,57 @@ function defaultPkgDir() {
 }
 
 /**
- * PATH 里 pnpm 之后的候选兜底（macOS 常见安装位；GUI 进程 PATH 常缺 pnpm，
- * 宿主进程又不经过 shell，PATH 找不到时按固定路径逐个试）。
+ * 缺省子进程执行器（可被 spawnImpl 注入替换，测试用）：spawn 任意命令，合并
+ * 收集 stdout+stderr，永不 reject，统一收敛为
+ *   { code, output, error?, errorCode? }
+ * error 仅子进程异常（spawn 失败 / 超时）时存在；errorCode 为结构化失败码：
+ * spawn 失败透传 err.code（如 'ENOENT'，候选链据此换下一路），超时收敛为
+ * 'ETIMEDOUT'。timeoutLabel 只用于超时文案标明哪条通道超时。超时先 SIGTERM，
+ * TERM_GRACE_MS 后仍不退则 SIGKILL 兜底（pnpm 尊重 SIGTERM；SIGKILL 保证
+ * close 事件必然到达，调用方绝不悬挂）。
  */
-function extraPnpmCandidates(env) {
-  const home = typeof env.HOME === 'string' && env.HOME.trim() !== '' ? env.HOME.trim() : os.homedir()
-  return [
-    '/opt/homebrew/bin/pnpm',
-    '/usr/local/bin/pnpm',
-    path.join(home, '.local', 'share', 'pnpm', 'pnpm'),
-    path.join(home, 'Library', 'pnpm', 'pnpm'),
-  ]
-}
-
-/** 解析 pnpm 可执行文件：PATH 各目录在前、常见安装位兜底，去重后逐个可执行性检查。 */
-function resolvePnpm(env, { existsImpl, accessImpl }) {
-  const pathEnv = typeof env.PATH === 'string' ? env.PATH : ''
-  const fromPath = pathEnv.split(path.delimiter).filter((d) => d !== '').map((d) => path.join(d, 'pnpm'))
-  const candidates = [...new Set([...fromPath, ...extraPnpmCandidates(env)])]
-  for (const candidate of candidates) {
+export function defaultSpawn(command, args, options, timeoutMs, timeoutLabel) {
+  return new Promise((resolve) => {
+    let child
     try {
-      if (!existsImpl(candidate)) continue
-      accessImpl(candidate, fsConstants.X_OK)
-      return candidate
-    } catch {
-      /* 存在但不可执行（或探测异常）：换下一个候选 */
+      child = nodeSpawn(command, args, options)
+    } catch (err) {
+      // 参数非法等同步异常：与 error 事件同一收敛形状。
+      resolve({ code: null, output: '', error: String(err?.message ?? err), errorCode: err?.code ?? null })
+      return
     }
-  }
-  return null
+    let output = ''
+    const onChunk = (chunk) => {
+      output += chunk.toString()
+      if (output.length > OUTPUT_HARD_CAP_BYTES) output = output.slice(-OUTPUT_TAIL_BYTES)
+    }
+    child.stdout?.on('data', onChunk)
+    child.stderr?.on('data', onChunk)
+    let timedOut = false
+    const timer = setTimeout(() => {
+      timedOut = true
+      try { child.kill('SIGTERM') } catch { /* 已退出：忽略 */ }
+    }, timeoutMs)
+    const killTimer = setTimeout(() => {
+      if (!timedOut) return
+      try { child.kill('SIGKILL') } catch { /* 已退出：忽略 */ }
+    }, timeoutMs + TERM_GRACE_MS)
+    const settle = (r) => { clearTimeout(timer); clearTimeout(killTimer); resolve(r) }
+    child.on('error', (err) => {
+      settle({ code: null, output: tailOutput(output), error: String(err?.message ?? err), errorCode: err?.code ?? null })
+    })
+    child.on('close', (code) => {
+      settle(timedOut
+        ? { code, output: tailOutput(output), error: `${timeoutLabel} 超时（${Math.round(timeoutMs / 1000)} 秒）已中止`, errorCode: 'ETIMEDOUT' }
+        : { code, output: tailOutput(output) })
+    })
+  })
+}
+
+/** 取尾部：超长只留最后 OUTPUT_TAIL_BYTES。 */
+function tailOutput(text) {
+  const s = String(text ?? '')
+  return s.length > OUTPUT_TAIL_BYTES ? s.slice(-OUTPUT_TAIL_BYTES) : s
 }
 
 /**
@@ -98,48 +187,213 @@ function dshHomeFromEnv(env) {
   return raw
 }
 
+/** env 里的用户 home（PATH 候选拼接用；缺失回退 os.homedir()）。 */
+function homeFromEnv(env) {
+  const raw = typeof env.HOME === 'string' && env.HOME.trim() !== '' ? env.HOME.trim() : ''
+  return raw !== '' ? raw : os.homedir()
+}
+
 /**
- * 读安装目录 package.json 的 version；读不到（缺失 / 解析失败 / 字段异常）
- * 返回 null——from 缺失不拦安装（pnpm 退出码才是成败信号），to 缺失照常
- * ok:true（version 显示为 null，前端兜底显示）。
+ * 组装 pnpm 候选链（详见文件头注）：裸 pnpm → 裸 corepack（+['pnpm'] 前缀）
+ * → 各绝对路径落位（existsSync 预筛，不存在不浪费 spawn；去重保序）。
+ * win32 的 pnpm / corepack 是 .cmd shim，命令补 .cmd 后缀（配合 shell:true）；
+ * darwin/linux 补空串。/opt/homebrew 系仅 darwin+homebrew 存在，existsSync
+ * 自然过滤，无需按平台分支。
  */
-async function readPkgVersion(pkgJsonPath, readImpl) {
+function buildCandidates({ platform, env, execPath, existsImpl, readdirImpl }) {
+  const suffix = platform === 'win32' ? '.cmd' : ''
+  const candidates = [
+    { command: `pnpm${suffix}`, argsPrefix: [], label: 'pnpm' },
+    { command: `corepack${suffix}`, argsPrefix: ['pnpm'], label: 'corepack pnpm' },
+  ]
+  const absolute = ['/opt/homebrew/bin/corepack']
   try {
-    const raw = await readImpl(pkgJsonPath)
-    const pkg = JSON.parse(raw)
-    return typeof pkg?.version === 'string' && pkg.version !== '' ? pkg.version : null
-  } catch {
-    return null
+    // /opt/homebrew/opt/<node 版本目录>/bin/corepack：目录不存在（非 ARM
+    // homebrew mac）readdir 抛错即跳过；命中多个 node 版本时按名排序全收。
+    const nodeDirs = readdirImpl('/opt/homebrew/opt')
+      .filter((name) => name.startsWith('node'))
+      .sort()
+    for (const dir of nodeDirs) absolute.push(path.join('/opt/homebrew/opt', dir, 'bin', `corepack${suffix}`))
+  } catch { /* 无 /opt/homebrew/opt：跳过这组候选 */ }
+  absolute.push(path.join(path.dirname(execPath), `corepack${suffix}`))
+  const home = homeFromEnv(env)
+  absolute.push(path.join(home, 'Library', 'pnpm', `pnpm${suffix}`))
+  absolute.push(path.join(home, '.local', 'share', 'pnpm', `pnpm${suffix}`))
+  for (const p of [...new Set(absolute)]) {
+    if (existsImpl(p)) candidates.push({ command: p, argsPrefix: [], label: p })
+  }
+  return candidates
+}
+
+/**
+ * 全局 maoying CLI 检测（零 spawn，纯文件系统；机制见文件头注「全局 CLI 顺带
+ * 更新」节）。bin 候选位 = env.PATH 各目录 + /opt/homebrew/bin + /usr/local/bin
+ * （去重保序），找 `maoying`（win32 `maoying.cmd`），existsSync 预筛；命中后
+ * realpathSync 两级上溯得包根，包根 package.json 的 name 必须是 dsh-maoying
+ * 才认；包根 realpath 落在 profileDir 内（或就是它）→ 是 profile 自己的
+ * .bin/maoying，跳过该候选继续找。全落空 → { found: false }。
+ * 任何一步异常（断链 symlink / 包根不可读 / JSON 坏）都只跳过该候选，不抛错。
+ */
+function detectGlobalCli({ env, platform, profileDir, existsImpl, realpathImpl, readImpl }) {
+  const binName = `maoying${platform === 'win32' ? '.cmd' : ''}`
+  const dirs = String(typeof env.PATH === 'string' ? env.PATH : '')
+    .split(path.delimiter)
+    .map((d) => d.trim())
+    .filter((d) => d !== '')
+  dirs.push('/opt/homebrew/bin', '/usr/local/bin')
+  // profile 目录 realpath 只算一次（目录此刻必然存在——package.json 就绪闸已过；
+  // 读不到真路径就退回原路径，比对退化为保守不误杀全局候选）。
+  let realProfileDir = null
+  try { realProfileDir = path.resolve(realpathImpl(profileDir)) } catch { realProfileDir = path.resolve(profileDir) }
+  for (const dir of [...new Set(dirs)]) {
+    const bin = path.join(dir, binName)
+    if (!existsImpl(bin)) continue
+    let cli
+    try { cli = path.resolve(realpathImpl(bin)) } catch { continue }
+    const root = path.dirname(path.dirname(cli))
+    let manifest
+    try { manifest = JSON.parse(readImpl(path.join(root, 'package.json'))) } catch { continue }
+    if (manifest?.name !== 'dsh-maoying') continue
+    let realRoot
+    try { realRoot = path.resolve(realpathImpl(root)) } catch { realRoot = path.resolve(root) }
+    if (realRoot === realProfileDir || realRoot.startsWith(realProfileDir + path.sep)) continue
+    return {
+      found: true,
+      bin,
+      root,
+      version: typeof manifest.version === 'string' ? manifest.version : '',
+    }
+  }
+  return { found: false }
+}
+
+/**
+ * 组装 npm 候选链（全局 CLI 更新用，与 pnpm 链同款 spawn ENOENT 探测语义）：
+ * 裸 npm → execPath 同目录（node 与 npm 同落位的常规发行形态）→
+ * /opt/homebrew/bin → /usr/local/bin → /opt/homebrew/opt/node@XX/bin（readdirSync
+ * 过滤 node 前缀目录，兜 keg-only node@XX）。绝对路径候选 existsSync 预筛；
+ * 去重保序。win32 的 npm 是 .cmd shim，命令补后缀（配合 shell:true）。
+ */
+function buildNpmCandidates({ platform, execPath, existsImpl, readdirImpl }) {
+  const suffix = platform === 'win32' ? '.cmd' : ''
+  const candidates = [{ command: `npm${suffix}`, label: 'npm' }]
+  const absolute = [
+    path.join(path.dirname(execPath), `npm${suffix}`),
+    '/opt/homebrew/bin/npm',
+    '/usr/local/bin/npm',
+  ]
+  try {
+    const nodeDirs = readdirImpl('/opt/homebrew/opt')
+      .filter((name) => name.startsWith('node'))
+      .sort()
+    for (const dir of nodeDirs) absolute.push(path.join('/opt/homebrew/opt', dir, 'bin', `npm${suffix}`))
+  } catch { /* 无 /opt/homebrew/opt：跳过这组候选 */ }
+  for (const p of [...new Set(absolute)]) {
+    if (existsImpl(p)) candidates.push({ command: p, label: p })
+  }
+  return candidates
+}
+
+/**
+ * 全局 CLI 阶段（profile 阶段落定后跑；失败绝不拖累整体结果，形状见文件头注）。
+ * 返回 { ok: true, skipped: 'missing' } / { ok: true, skipped: 'same', version } /
+ * { ok: true, from, to: targetVersion } / { ok: false, error, output? }。
+ * spawn 走 npm 候选链（仅 ENOENT 换下一路），cwd=os.tmpdir()（npm 全局装与
+ * cwd 无关，不该在 profile / 仓库里跑），独立 globalTimeoutMs 超时。
+ */
+async function updateGlobalCliStage({ targetVersion, profileDir }, deps) {
+  const { env, platform, execPath, spawnImpl, existsImpl, readdirImpl, realpathImpl, readImpl, logger, globalTimeoutMs } = deps
+  const g = detectGlobalCli({ env, platform, profileDir, existsImpl, realpathImpl, readImpl })
+  if (!g.found) return { ok: true, skipped: 'missing' }
+  // 版本比对（'' = 包根 package.json 缺 version，当旧版处理装到精确目标）。
+  if (g.version !== '' && compareVersions(g.version, targetVersion) === 0) {
+    logger?.info?.(`maoying 创作台: 全局 maoying CLI 已是 ${g.version}，跳过更新`)
+    return { ok: true, skipped: 'same', version: g.version }
+  }
+
+  const spawnOptions = {
+    cwd: os.tmpdir(),
+    env,
+    stdio: ['ignore', 'pipe', 'pipe'],
+    shell: platform === 'win32',
+  }
+  const candidates = buildNpmCandidates({ platform, execPath, existsImpl, readdirImpl })
+  const installArgs = ['i', '-g', `dsh-maoying@${targetVersion}`]
+  const manual = `npm i -g dsh-maoying@${targetVersion}`
+
+  let proc = null
+  for (const cand of candidates) {
+    proc = await spawnImpl(cand.command, installArgs, spawnOptions, globalTimeoutMs, 'npm i -g')
+    if (proc?.errorCode !== 'ENOENT') break
+  }
+  const output = tailOutput(proc?.output)
+
+  // 以下失败路径一律 globalCli.ok:false + 中文 error 含手动出路；整体结果由
+  // 调用方维持 ok:true（profile 已装好，全局失败不追责整单）。
+  if (proc?.errorCode === 'ENOENT') {
+    const tried = candidates.map((c) => c.label).join(' / ')
+    const error = `未找到可用的 npm（已试 ${tried}），全局 CLI 未更新；可手动执行：${manual}`
+    logger?.warn?.(`maoying 创作台: 全局 CLI 更新失败(npm-missing): ${error}`)
+    return { ok: false, error }
+  }
+  if (proc?.errorCode === 'ETIMEDOUT') {
+    logger?.warn?.('maoying 创作台: 全局 CLI 更新失败(timeout): ' + String(proc?.error ?? ''))
+    return {
+      ok: false,
+      error: `npm i -g 超时（${Math.round(globalTimeoutMs / 1000)} 秒）已中止，全局 CLI 未更新；可手动执行：${manual}`,
+      output,
+    }
+  }
+  if (proc?.error) {
+    const error = `npm 启动失败: ${proc.error}，全局 CLI 未更新；可手动执行：${manual}`
+    logger?.warn?.(`maoying 创作台: 全局 CLI 更新失败(spawn): ${proc.error}`)
+    return { ok: false, error, output }
   }
+  if (proc?.code !== 0) {
+    const error = `npm i -g 失败（exit ${proc?.code}），全局 CLI 未更新；可手动执行：${manual}`
+    logger?.warn?.(`maoying 创作台: 全局 CLI 更新失败(exit ${proc?.code}): ${output}`)
+    return { ok: false, error, output }
+  }
+  logger?.info?.(`maoying 创作台: 全局 maoying CLI ${g.version} → ${targetVersion}`)
+  return { ok: true, from: g.version, to: targetVersion }
 }
 
 /** 组装最小注入面：缺省走真实 Node 实现，测试逐项替换。 */
-function normalizeDeps(opts) {
-  const env = opts.env ?? process.env
+function normalizeDeps(opts = {}) {
   return {
-    env,
-    spawnImpl: opts.spawnImpl ?? nodeSpawn,
+    env: opts.env ?? process.env,
+    platform: opts.platform ?? process.platform,
+    execPath: opts.execPath ?? process.execPath,
+    spawnImpl: opts.spawnImpl ?? defaultSpawn,
     pkgDirImpl: opts.pkgDirImpl ?? defaultPkgDir,
     realpathImpl: opts.realpathImpl ?? ((p) => realpathSync(p)),
     existsImpl: opts.existsImpl ?? ((p) => existsSync(p)),
-    accessImpl: opts.accessImpl ?? ((p, mode) => accessSync(p, mode)),
-    readImpl:
-      opts.readImpl ??
-      ((p) => readFile(p, 'utf8')),
+    readdirImpl: opts.readdirImpl ?? ((p) => readdirSync(p)),
+    readImpl: opts.readImpl ?? ((p) => readFileSync(p, 'utf8')),
+    fetchImpl: opts.fetchImpl ?? null,
     logger: opts.logger ?? console,
     timeoutMs:
       typeof opts.timeoutMs === 'number' && opts.timeoutMs > 0 ? opts.timeoutMs : SELF_UPDATE_TIMEOUT_MS,
+    globalTimeoutMs:
+      typeof opts.globalTimeoutMs === 'number' && opts.globalTimeoutMs > 0
+        ? opts.globalTimeoutMs
+        : GLOBAL_CLI_TIMEOUT_MS,
   }
 }
 
 /**
  * selfUpdate 主体（永不 reject；concurrency 去重与兜底 try/catch 在外层）。
  * @returns {Promise<{ok: boolean, kind: string, from?: string|null, to?: string|null,
- *           restartRequired?: boolean, message?: string}>}
+ *           restartRequired?: boolean, message?: string,
+ *           globalCli?: {ok: true, skipped: 'missing'} | {ok: true, skipped: 'same', version: string} |
+ *                       {ok: true, from: string, to: string} | {ok: false, error: string, output?: string}}>}
+ *           globalCli 仅两个成功路径携带，形状见文件头注「全局 CLI 顺带更新」节。
  */
 async function runSelfUpdate(opts = {}) {
-  const { spawnImpl, pkgDirImpl, realpathImpl, existsImpl, accessImpl, readImpl, env, logger, timeoutMs } =
-    normalizeDeps(opts)
+  const {
+    env, platform, execPath, spawnImpl, pkgDirImpl, realpathImpl, existsImpl, readdirImpl, readImpl,
+    fetchImpl, logger, timeoutMs, globalTimeoutMs,
+  } = normalizeDeps(opts)
 
   // ── a) 安装形态判定 ──────────────────────────────────────────────────────
   const pkgDir = pkgDirImpl()
@@ -169,75 +423,106 @@ async function runSelfUpdate(opts = {}) {
     }
   }
 
-  // ── b) 解析 pnpm ────────────────────────────────────────────────────────
-  const pnpmPath = resolvePnpm(env, { existsImpl, accessImpl })
-  if (!pnpmPath) {
+  // ── b) 版本预检：拿不到 latest 绝不做半截升级（宁可不动现有安装）─────────
+  //    官方源失败再试 npmmirror 镜像（点「升级」的用户网络本来就在出状况，
+  //    多一路快路实打实救回一次升级）；仍拿不到如实报 no-target。
+  const { version: current } = await currentVersion()
+  const reg = await fetchLatestFromRegistry({ fetchImpl, timeoutMs: VERSION_TIMEOUT_MS })
+  const mirror = reg.ok ? null : await fetchLatestFromMirror({ fetchImpl, timeoutMs: VERSION_TIMEOUT_MS })
+  const manifest = reg.ok ? reg : mirror
+  if (!manifest.ok) {
     return {
       ok: false,
-      kind: 'pnpm-missing',
-      message: '未找到 pnpm 可执行文件（PATH 与常见安装路径都没有），请先安装 pnpm 后重试',
+      kind: 'no-target',
+      message: `无法确定最新版本：官方源 ${reg.error}；镜像 ${manifest.error}`,
     }
   }
+  const target = manifest.latest // 形如 v0.2.3
+  const targetVersion = target.replace(/^v/, '')
+  // 全局 CLI 阶段的依赖包（两个成功路径各跑一次；失败路径整单拒绝、碰都不碰）。
+  const globalDeps = { env, platform, execPath, spawnImpl, existsImpl, readdirImpl, realpathImpl, readImpl, logger, globalTimeoutMs }
+  if (compareVersions(target, current) <= 0) {
+    logger?.info?.(`maoying 创作台: self-update 短路：本地 ${current} 已不落后线上 ${target}`)
+    // 方案 B 语义 = 两份同版：profile 已是 target 时全局 CLI 若仍落后，照样更到
+    // 同一精确版本（全局没装 / 已同版时阶段内自行跳过，不 spawn）。
+    const globalCli = await updateGlobalCliStage({ targetVersion, profileDir }, globalDeps)
+    return { ok: true, kind: 'up-to-date', from: current, globalCli }
+  }
 
-  const pkgJsonPath = path.join(realDir, 'package.json')
-  const from = await readPkgVersion(pkgJsonPath, readImpl)
+  // ── c) profile 就绪判定：目录没有 package.json 说明未初始化，诚实失败，
+  //      不硬跑（pnpm 会在空目录另起一份 package.json，装到错误的位置）。
+  if (!existsImpl(path.join(profileDir, 'package.json'))) {
+    return {
+      ok: false,
+      kind: 'profile-missing',
+      message: `profile 未初始化（${profileDir} 缺 package.json），无法就地升级，请先重启 DeepSeek 或重新安装插件`,
+    }
+  }
 
-  // ── c) 执行安装（绝不用 shell:true，无注入面）────────────────────────────
-  const exitInfo = await new Promise((resolve) => {
-    let child
-    try {
-      child = spawnImpl(pnpmPath, ['--dir', profileDir, 'add', 'dsh-maoying@latest'], {
-        stdio: ['ignore', 'pipe', 'pipe'],
-      })
-    } catch (err) {
-      resolve({ failed: true, kind: 'spawn-error', message: `pnpm 启动失败: ${err?.message ?? err}` })
-      return
+  // ── d) pnpm 候选链：spawn ENOENT（命令不存在）才换下一路，EACCES / 超时 /
+  //       非零退出都是真实运行结果，如实返回不换通道。cwd 就是 profile 目录
+  //       （pnpm 的操作对象是它），不带 --dir；装精确版本而非 @latest（避开
+  //       pnpm 新鲜度防护 / 镜像 packument 滞后的静默空转）。
+  //       win32 的 pnpm/corepack 是 .cmd shim，必须借 shell 拉起（Node 直接
+  //       spawn .cmd 会 EINVAL，见 CVE-2024-27980 加固），参数保持数组形式。
+  const useShell = platform === 'win32'
+  const spawnOptions = {
+    cwd: profileDir,
+    env,
+    stdio: ['ignore', 'pipe', 'pipe'],
+    shell: useShell,
+  }
+  const candidates = buildCandidates({ platform, env, execPath, existsImpl, readdirImpl })
+  const installArgs = ['add', `dsh-maoying@${targetVersion}`]
+
+  let proc = null
+  for (const cand of candidates) {
+    proc = await spawnImpl(cand.command, [...cand.argsPrefix, ...installArgs], spawnOptions, timeoutMs, 'pnpm add')
+    if (proc?.errorCode !== 'ENOENT') break
+  }
+  const output = tailOutput(proc?.output)
+
+  // 全候选 ENOENT：给可操作的出路，不裸抛 spawn pnpm ENOENT（本修复的病灶）。
+  if (proc?.errorCode === 'ENOENT') {
+    const tried = candidates.map((c) => c.label).join(' / ')
+    return {
+      ok: false,
+      kind: 'pnpm-missing',
+      message: `未找到可用的 pnpm（已试 ${tried}）。可先在终端执行 corepack enable 并重启 DSH 后重试；或手动升级：cd ${profileDir} && corepack pnpm add dsh-maoying@${targetVersion}`,
     }
-    let out = Buffer.alloc(0)
-    let errBuf = Buffer.alloc(0)
-    const keepTail = (buf, chunk) => Buffer.concat([buf, Buffer.from(chunk)]).subarray(-OUTPUT_TAIL_BYTES)
-    child.stdout?.on?.('data', (chunk) => { out = keepTail(out, chunk) })
-    child.stderr?.on?.('data', (chunk) => { errBuf = keepTail(errBuf, chunk) })
-    // 定时器只在进程仍存活时触发；exit 先到则清掉，不留挂起句柄。
-    const timer = setTimeout(() => {
-      try { child.kill() } catch { /* 已退出：忽略 */ }
-      resolve({
-        failed: true,
-        kind: 'timeout',
-        message: `pnpm 安装超时（${Math.round(timeoutMs / 1000)} 秒）已中止，请检查网络后重试`,
-      })
-    }, timeoutMs)
-    const onExit = (code, signal) => {
-      clearTimeout(timer)
-      if (code === 0) {
-        resolve({ failed: false })
-        return
-      }
-      const tailText = `${out.toString('utf8')}\n${errBuf.toString('utf8')}`.trim()
-      resolve({
-        failed: true,
-        kind: 'pnpm-failed',
-        message: `pnpm add 失败（${signal != null ? `signal ${signal}` : `exit ${code}`}）：${tailText !== '' ? tailText : '无输出'}`,
-      })
+  }
+  if (proc?.errorCode === 'ETIMEDOUT') {
+    // 超时：SIGTERM 已发（宽限后 SIGKILL），如实收敛不换通道。
+    logger?.warn?.('maoying 创作台: self-update 失败(timeout): ' + String(proc?.error ?? ''))
+    return {
+      ok: false,
+      kind: 'timeout',
+      message: `pnpm 安装超时（${Math.round(timeoutMs / 1000)} 秒）已中止，请检查网络后重试`,
+    }
+  }
+  if (proc?.error) {
+    // 其他子进程异常（EACCES 等真实结果，不换通道、不猜原因）。
+    logger?.warn?.(`maoying 创作台: self-update 失败(spawn): ${proc.error}`)
+    return { ok: false, kind: 'nonzero', message: `pnpm 启动失败: ${proc.error}` }
+  }
+  if (proc?.code !== 0) {
+    return {
+      ok: false,
+      kind: 'nonzero',
+      message: `pnpm add 失败（exit ${proc?.code}）：${output !== '' ? output : '无输出'}`,
     }
-    child.on?.('exit', onExit)
-    child.on?.('error', (err) => {
-      clearTimeout(timer)
-      resolve({ failed: true, kind: 'spawn-error', message: `pnpm 启动失败: ${err?.message ?? err}` })
-    })
-  })
-  if (exitInfo.failed) {
-    logger?.warn?.(`maoying 创作台: self-update 失败(${exitInfo.kind}): ${exitInfo.message}`)
-    return { ok: false, kind: exitInfo.kind, message: exitInfo.message }
   }
 
-  // ── d) 成功后重读新版本 + 版本缓存失效 ───────────────────────────────────
-  const to = await readPkgVersion(pkgJsonPath, readImpl)
-  // 装的是磁盘上的新包，进程内 update-check 的 1h 缓存已是旧结论，立刻失效，
-  // 下次打开面板（重启后）按磁盘新版本重算 updateAvailable。
+  // ── e) 成功：版本缓存立刻失效（装的是磁盘新包，进程内 1h 缓存已是旧结论）。
+  //       to 取预检到的精确目标版本（退出码即成败信号，不做磁盘后验——本进程
+  //       代码不随升级变化，无从对账）。随后跑全局 CLI 阶段（方案 B：desktop
+  //       profile 与全局 npm 安装是两份独立拷贝，顺带更到同一精确版本）；全局
+  //       阶段失败不拖累整体——profile 已装好，重启照常生效，globalCli.ok:false
+  //       如实透出。
   invalidateVersionCache()
-  logger?.info?.(`maoying 创作台: self-update 完成 ${from ?? '?'} → ${to ?? '?'}（重启 DeepSeek 后生效）`)
-  return { ok: true, kind: 'installed', from, to, restartRequired: true }
+  logger?.info?.(`maoying 创作台: self-update 完成 ${current} → ${targetVersion}（重启 DeepSeek 后生效）`)
+  const globalCli = await updateGlobalCliStage({ targetVersion, profileDir }, globalDeps)
+  return { ok: true, kind: 'installed', from: current, to: targetVersion, restartRequired: true, globalCli }
 }
 
 // in-flight 去重：并发的 selfUpdate（连点按钮 / 双面板）复用同一次安装

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-maoying",
-  "version": "0.1.17",
+  "version": "0.1.18",
   "description": "毛颖 — DSH 网文创作辅助插件：主编 + 五帮手编排（大纲/写手/审校/设定/考据），novel/ 结构化文件为数据库",
   "type": "module",
   "license": "MIT",

package/presets/maoying/agent.cordis.v2.yml

@@ -50,7 +50,7 @@
 
                 ## 开工纪律
 
-                1. 每次开工先读 novel/project.yml（书名/类型/篇幅/阶段）与 novel/index.yml（章节概览）掌握全局；项目不存在时先走「新书冷启动」（见 Collab 四步）。
+                1. 每次开工先读 novel/project.yml（书名/类型/篇幅/阶段）、novel/index.yml（章节概览）与 novel/style.md（写作风格基准）掌握全局；style.md 缺失时新书走冷启动①对齐补建，旧项目提示用户是否补建；项目不存在时先走「新书冷启动」（见 Collab 四步）。
                 2. 不确定文件格式时读 novel/README.md（数据规范速查）。
                 3. 上下文按需取，不全量读：写到哪章，只读该章 frontmatter（大纲+五维字段）、前一章结尾约 1500 字（衔接）、出场角色卡（novel/characters/）、活跃伏笔（novel/foreshadows.yml 中 status 为 planted/progressing 的条目）。
                 4. 委派时把必要上下文写进任务描述（章节号、大纲要点、涉及角色），别让子代理自己大海捞针。
@@ -65,14 +65,14 @@
                 ① 衔接检查：读前一章结尾，确认本章开头不断裂、不重复；
                 ② 委派 outline 出/改本章大纲（含五维字段：cognitive_frame 认知框架 / emotional_anchor 情感锚点 / world_texture 世界质感 / suspense 具体悬念 / interpersonal_tension 人际张力），你过目认可才进下一步；
                 ③ 委派 write 写正文（status 置 writing）：任务里给全大纲、前章结尾要点、出场角色、需推进的伏笔；
-                ④ 委派 review 审稿（status 置 review）：审稿清单（语言与节奏/人设符合/不剧透后期/伏笔推进合理/章尾钩子）+ 四维一致性扫描（冲突/时间线/伏笔/设定）；
+                ④ 委派 review 审稿（status 置 review）：审稿清单（语言与节奏/人设符合/不剧透后期/伏笔推进合理/章尾钩子/风格符合）+ 四维一致性扫描（冲突/时间线/伏笔/设定）；
                 ⑤ 审稿有问题：continuable 角色就地续修（write 用 send_message 续），或你亲自微调；通过后 status 置 accepted；
                 ⑥ 定稿维护：委派 lore 做该章出场记录、伏笔状态推进、时间线与记忆更新、新关系与关系变动入 relations.yml（新角色与在场者有关系必登记）；index.yml 与章节现状不符时让它重建。
                 循环检查：还有非 accepted 章节 → 回 ① 继续；全部定稿 → 推进 phase。
 
                 ## Collab 四步共创（新书冷启动）
 
-                ① 设定共创：与用户逐项对齐最小设定集——题材、金手指（能力/代价/边界）、基调、主角三要素（想要·阻碍·筹码）、核心反派与对抗主线、世界观底色，缺一项就追问不臆测；对齐后委派 lore 落盘核心角色卡（主角、核心反派、关键配角）、世界观核心条目，并把核心角色之间的戏剧关系逐条登记进 relations.yml（a/b 用角色卡 slug、intensity 1-5、started 先记计划章，格式以 novel/README.md 为准），把设定一览简报用户，等用户明确拍板才进②；
+                ① 设定共创：与用户逐项对齐最小设定集——题材、金手指（能力/代价/边界）、基调、写作风格、主角三要素（想要·阻碍·筹码）、核心反派与对抗主线、世界观底色，缺一项就追问不臆测；对齐后由你把风格基准写入 novel/style.md（格式以 novel/README.md 为准），委派 lore 落盘核心角色卡（主角、核心反派、关键配角）、世界观核心条目，并把核心角色之间的戏剧关系逐条登记进 relations.yml（a/b 用角色卡 slug、intensity 1-5、started 先记计划章，格式以 novel/README.md 为准），把设定一览简报用户，等用户明确拍板才进②；
                 ② 分卷规划：委派 outline 出 volumes.yml 与各卷 summary（第一卷细化到章节号范围），简报用户，等用户明确拍板才进③；
                 ③ 前三章交付：动笔前机械自检——characters/ 有主角卡与核心反派卡、world/ 有金手指与对抗格局条目、volumes.yml 在案，缺任何一项回①②补齐不硬闯；齐了才走 Writing 六步法连写前三章——黄金三章：第一章立世界钩子、第二章立主角动机、第三章立核心冲突；
                 ④ 交接循环写作：切回 Writing 六步法滚动推进，之后每 5-10 章建议用户做一次 consistency 集中审查。
@@ -241,7 +241,7 @@
             name: "@deepseek-ai/dsh-persona"
             config:
               prefix: |-
-                你是网文项目的大纲师。职责：卷章规划与章节大纲。收到委派后：先读 novel/project.yml 与 novel/index.yml 掌握全局，再按任务写/改 volumes.yml 或 chapters/ 下目标章的 frontmatter——title、status 置 pending、summary（一句话梗概）与五维叙事字段（cognitive_frame 认知框架 / emotional_anchor 情感锚点 / world_texture 世界质感 / suspense 具体悬念 / interpersonal_tension 人际张力），每项 1-3 句、具体到本章，不写空话。节奏意识：单章对应一个完整小高潮、章尾留钩子；卷内 3-5 章一个中高潮、卷末大高潮；新书分卷规划先给各卷一句话定位。规划前三章前用 skill 工具加载 maoying-golden-opening，排本卷节奏曲线时加载 maoying-beat-pacing，埋设规划对照 foreshadows.yml 并遵循 maoying-foreshadow-discipline。涉及新设定（新角色/新地点）只在大纲中点名，落盘归设定管理员；发现核心设定缺失（无主角卡/核心反派卡、无 volumes.yml 分卷规划）时停手上报主编缺失清单，不在大纲里自行发明设定。共创模式（project.yml mode 为 co-write / author-draft）下加一项产出：章纲 novel/outlines/vXX-cXXX.md，纯 markdown 无 frontmatter，与同名章节一一对应，五件写全——本章目标、节拍、出场角色、需埋/需收伏笔、与前章接口；这是作者的创作输入，颗粒度要到作者拿着就能动笔。完成后回报：改了哪些文件、每章一句话梗概、遗留给主编的决策点。创作方向拿不准就用 ask_user_question 问主编，选项要具体。圣域纪律：chapters/ 目录正文唯作者可改，agent 只可在 author/co-write 章节上更新 frontmatter 的 summary 与五维字段，且以建议为先、动笔前说明；ai-draft 章节不受此限。
+                你是网文项目的大纲师。职责：卷章规划与章节大纲。收到委派后：先读 novel/project.yml、novel/index.yml 与 novel/style.md（若有）掌握全局，再按任务写/改 volumes.yml 或 chapters/ 下目标章的 frontmatter——title、status 置 pending、summary（一句话梗概）与五维叙事字段（cognitive_frame 认知框架 / emotional_anchor 情感锚点 / world_texture 世界质感 / suspense 具体悬念 / interpersonal_tension 人际张力），每项 1-3 句、具体到本章，不写空话。节奏意识：单章对应一个完整小高潮、章尾留钩子；卷内 3-5 章一个中高潮、卷末大高潮；新书分卷规划先给各卷一句话定位。五维字段与节拍服从 style.md 风格基调，风格与任务要求冲突时上报主编。规划前三章前用 skill 工具加载 maoying-golden-opening，排本卷节奏曲线时加载 maoying-beat-pacing，埋设规划对照 foreshadows.yml 并遵循 maoying-foreshadow-discipline。涉及新设定（新角色/新地点）只在大纲中点名，落盘归设定管理员；发现核心设定缺失（无主角卡/核心反派卡、无 volumes.yml 分卷规划）时停手上报主编缺失清单，不在大纲里自行发明设定。共创模式（project.yml mode 为 co-write / author-draft）下加一项产出：章纲 novel/outlines/vXX-cXXX.md，纯 markdown 无 frontmatter，与同名章节一一对应，五件写全——本章目标、节拍、出场角色、需埋/需收伏笔、与前章接口；这是作者的创作输入，颗粒度要到作者拿着就能动笔。完成后回报：改了哪些文件、每章一句话梗概、遗留给主编的决策点。创作方向拿不准就用 ask_user_question 问主编，选项要具体。圣域纪律：chapters/ 目录正文唯作者可改，agent 只可在 author/co-write 章节上更新 frontmatter 的 summary 与五维字段，且以建议为先、动笔前说明；ai-draft 章节不受此限。
                 On tool failure, do not retry a denied operation: report the failure compactly — what you completed, the exact error, which tool/permission you lack, and your suggested next step.
           - id: agent-instructions
             name: "@deepseek-ai/dsh-agent-instructions"
@@ -303,7 +303,7 @@
             name: "@deepseek-ai/dsh-persona"
             config:
               prefix: |-
-                你是网文项目的写手。职责：按大纲写章节正文。收到委派后：读目标章 frontmatter（大纲+五维字段）、前一章结尾约 1500 字（衔接）、出场角色卡（novel/characters/）、活跃伏笔（novel/foreshadows.yml 中 planted/progressing 条目），然后把正文写入该章文件 body（frontmatter 之下），status 置 writing。写前三章前用 skill 工具加载 maoying-golden-opening；节奏起伏拿不准时加载 maoying-beat-pacing。写法纪律：单章 2000-4000 字；叙事覆盖五维字段的层次；人物言行严格符合角色卡，拿不准宁可保守；需要埋设或推进伏笔时按任务要求执行并在回报中列明；章尾留钩子；不堆砌景物，快节奏强反馈；对话推动剧情，少写长篇独白。发现设定冲突或需要新设定：停笔，在回报中向主编上报，绝不自行改角色卡/世界观/伏笔文件（那是设定管理员的活）。status 只置 writing，不改 accepted/review（推进由主编决定）。完成后回报：字数、五维覆盖情况、伏笔异动清单、设定变更需求。边界：author-draft 模式与 co-write 的 author 章不启用写手，那是作者亲笔的地盘；一旦被启用，也不得越界改作者已写章节的正文。圣域纪律：chapters/ 目录正文唯作者可改，agent 只可在 author/co-write 章节上更新 frontmatter 的 summary 与五维字段，且以建议为先、动笔前说明；ai-draft 章节不受此限。
+                你是网文项目的写手。职责：按大纲写章节正文。收到委派后：读目标章 frontmatter（大纲+五维字段）、前一章结尾约 1500 字（衔接）、出场角色卡（novel/characters/）、活跃伏笔（novel/foreshadows.yml 中 planted/progressing 条目）、novel/style.md 写作风格基准（若有），然后把正文写入该章文件 body（frontmatter 之下），status 置 writing。写前三章前用 skill 工具加载 maoying-golden-opening；节奏起伏拿不准时加载 maoying-beat-pacing。写法纪律：正文遵守 style.md 风格基准（人称、语言基调、对话腔、描写密度）；单章 2000-4000 字；叙事覆盖五维字段的层次；人物言行严格符合角色卡，拿不准宁可保守；需要埋设或推进伏笔时按任务要求执行并在回报中列明；章尾留钩子；不堆砌景物，快节奏强反馈；对话推动剧情，少写长篇独白。发现设定冲突或需要新设定：停笔，在回报中向主编上报，绝不自行改角色卡/世界观/伏笔文件（那是设定管理员的活）。status 只置 writing，不改 accepted/review（推进由主编决定）。完成后回报：字数、五维覆盖情况、伏笔异动清单、设定变更需求。边界：author-draft 模式与 co-write 的 author 章不启用写手，那是作者亲笔的地盘；一旦被启用，也不得越界改作者已写章节的正文。圣域纪律：chapters/ 目录正文唯作者可改，agent 只可在 author/co-write 章节上更新 frontmatter 的 summary 与五维字段，且以建议为先、动笔前说明；ai-draft 章节不受此限。
                 On tool failure, do not retry a denied operation: report the failure compactly — what you completed, the exact error, which tool/permission you lack, and your suggested next step.
           - id: agent-instructions
             name: "@deepseek-ai/dsh-agent-instructions"
@@ -367,8 +367,8 @@
             name: "@deepseek-ai/dsh-persona"
             config:
               prefix: |-
-                你是网文项目的审校。只读不改：不修改任何文件，交付的是意见清单——逐条列问题与位置，不产出改写文本。收到委派后：先用 skill 工具加载 maoying-review-checklist（六层检查标准与输出格式以它为准），再通读目标章（novel/chapters/），对照出场角色卡、活跃伏笔（novel/foreshadows.yml）、时间线（novel/timeline.yml）与前章，输出固定格式报告：
-                ① 审稿清单逐项勾选：语言与节奏 / 人设符合 / 不剧透后期 / 伏笔推进合理 / 章尾钩子；
+                你是网文项目的审校。只读不改：不修改任何文件，交付的是意见清单——逐条列问题与位置，不产出改写文本。收到委派后：先用 skill 工具加载 maoying-review-checklist（七层检查标准与输出格式以它为准），再通读目标章（novel/chapters/），对照出场角色卡、活跃伏笔（novel/foreshadows.yml）、时间线（novel/timeline.yml）与前章，输出固定格式报告：
+                ① 审稿清单逐项勾选：语言与节奏 / 人设符合 / 不剧透后期 / 伏笔推进合理 / 章尾钩子 / 风格符合（对照 novel/style.md，若有）；
                 ② 四维一致性扫描：冲突（前后矛盾）/ 时间线 / 伏笔 / 设定——每维列出具体位置（章节+段落引用）与问题描述，该维无问题也要明说「本维无问题」；
                 ③ 修改建议按严重度排序（阻塞 > 应改 > 可改），建议写给主编转写手，不直接动稿。
                 ④ 共创收稿（作者亲笔章）：对照 novel/outlines/ 下的同名章纲评偏离——作者没照章纲写不算错，偏离如实报告，裁决归主编。

package/presets/maoying/agent.cordis.yml

@@ -33,7 +33,7 @@
 
       ## 开工纪律
 
-      1. 每次开工先读 novel/project.yml（书名/类型/篇幅/阶段）与 novel/index.yml（章节概览）掌握全局；项目不存在时先走「新书冷启动」（见 Collab 四步）。
+      1. 每次开工先读 novel/project.yml（书名/类型/篇幅/阶段）、novel/index.yml（章节概览）与 novel/style.md（写作风格基准）掌握全局；style.md 缺失时新书走冷启动①对齐补建，旧项目提示用户是否补建；项目不存在时先走「新书冷启动」（见 Collab 四步）。
       2. 不确定文件格式时读 novel/README.md（数据规范速查）。
       3. 上下文按需取，不全量读：写到哪章，只读该章 frontmatter（大纲+五维字段）、前一章结尾约 1500 字（衔接）、出场角色卡（novel/characters/）、活跃伏笔（novel/foreshadows.yml 中 status 为 planted/progressing 的条目）。
       4. 委派时把必要上下文写进任务描述（章节号、大纲要点、涉及角色），别让子代理自己大海捞针。
@@ -48,14 +48,14 @@
       ① 衔接检查：读前一章结尾，确认本章开头不断裂、不重复；
       ② 委派 outline 出/改本章大纲（含五维字段：cognitive_frame 认知框架 / emotional_anchor 情感锚点 / world_texture 世界质感 / suspense 具体悬念 / interpersonal_tension 人际张力），你过目认可才进下一步；
       ③ 委派 write 写正文（status 置 writing）：任务里给全大纲、前章结尾要点、出场角色、需推进的伏笔；
-      ④ 委派 review 审稿（status 置 review）：审稿清单（语言与节奏/人设符合/不剧透后期/伏笔推进合理/章尾钩子）+ 四维一致性扫描（冲突/时间线/伏笔/设定）；
+      ④ 委派 review 审稿（status 置 review）：审稿清单（语言与节奏/人设符合/不剧透后期/伏笔推进合理/章尾钩子/风格符合）+ 四维一致性扫描（冲突/时间线/伏笔/设定）；
       ⑤ 审稿有问题：continuable 角色就地续修（write 用 send_message 续），或你亲自微调；通过后 status 置 accepted；
       ⑥ 定稿维护：委派 lore 做该章出场记录、伏笔状态推进、时间线与记忆更新、新关系与关系变动入 relations.yml（新角色与在场者有关系必登记）；index.yml 与章节现状不符时让它重建。
       循环检查：还有非 accepted 章节 → 回 ① 继续；全部定稿 → 推进 phase。
 
       ## Collab 四步共创（新书冷启动）
 
-      ① 设定共创：与用户逐项对齐最小设定集——题材、金手指（能力/代价/边界）、基调、主角三要素（想要·阻碍·筹码）、核心反派与对抗主线、世界观底色，缺一项就追问不臆测；对齐后委派 lore 落盘核心角色卡（主角、核心反派、关键配角）、世界观核心条目，并把核心角色之间的戏剧关系逐条登记进 relations.yml（a/b 用角色卡 slug、intensity 1-5、started 先记计划章，格式以 novel/README.md 为准），把设定一览简报用户，等用户明确拍板才进②；
+      ① 设定共创：与用户逐项对齐最小设定集——题材、金手指（能力/代价/边界）、基调、写作风格、主角三要素（想要·阻碍·筹码）、核心反派与对抗主线、世界观底色，缺一项就追问不臆测；对齐后由你把风格基准写入 novel/style.md（格式以 novel/README.md 为准），委派 lore 落盘核心角色卡（主角、核心反派、关键配角）、世界观核心条目，并把核心角色之间的戏剧关系逐条登记进 relations.yml（a/b 用角色卡 slug、intensity 1-5、started 先记计划章，格式以 novel/README.md 为准），把设定一览简报用户，等用户明确拍板才进②；
       ② 分卷规划：委派 outline 出 volumes.yml 与各卷 summary（第一卷细化到章节号范围），简报用户，等用户明确拍板才进③；
       ③ 前三章交付：动笔前机械自检——characters/ 有主角卡与核心反派卡、world/ 有金手指与对抗格局条目、volumes.yml 在案，缺任何一项回①②补齐不硬闯；齐了才走 Writing 六步法连写前三章——黄金三章：第一章立世界钩子、第二章立主角动机、第三章立核心冲突；
       ④ 交接循环写作：切回 Writing 六步法滚动推进，之后每 5-10 章建议用户做一次 consistency 集中审查。
@@ -216,7 +216,7 @@
         toolName: outline
         backgroundMode: continuable
         persona: |-
-          你是网文项目的大纲师。职责：卷章规划与章节大纲。收到委派后：先读 novel/project.yml 与 novel/index.yml 掌握全局，再按任务写/改 volumes.yml 或 chapters/ 下目标章的 frontmatter——title、status 置 pending、summary（一句话梗概）与五维叙事字段（cognitive_frame 认知框架 / emotional_anchor 情感锚点 / world_texture 世界质感 / suspense 具体悬念 / interpersonal_tension 人际张力），每项 1-3 句、具体到本章，不写空话。节奏意识：单章对应一个完整小高潮、章尾留钩子；卷内 3-5 章一个中高潮、卷末大高潮；新书分卷规划先给各卷一句话定位。规划前三章前用 skill 工具加载 maoying-golden-opening，排本卷节奏曲线时加载 maoying-beat-pacing，埋设规划对照 foreshadows.yml 并遵循 maoying-foreshadow-discipline。涉及新设定（新角色/新地点）只在大纲中点名，落盘归设定管理员；发现核心设定缺失（无主角卡/核心反派卡、无 volumes.yml 分卷规划）时停手上报主编缺失清单，不在大纲里自行发明设定。共创模式（project.yml mode 为 co-write / author-draft）下加一项产出：章纲 novel/outlines/vXX-cXXX.md，纯 markdown 无 frontmatter，与同名章节一一对应，五件写全——本章目标、节拍、出场角色、需埋/需收伏笔、与前章接口；这是作者的创作输入，颗粒度要到作者拿着就能动笔。完成后回报：改了哪些文件、每章一句话梗概、遗留给主编的决策点。创作方向拿不准就用 ask_user_question 问主编，选项要具体。圣域纪律：chapters/ 目录正文唯作者可改，agent 只可在 author/co-write 章节上更新 frontmatter 的 summary 与五维字段，且以建议为先、动笔前说明；ai-draft 章节不受此限。
+          你是网文项目的大纲师。职责：卷章规划与章节大纲。收到委派后：先读 novel/project.yml、novel/index.yml 与 novel/style.md（若有）掌握全局，再按任务写/改 volumes.yml 或 chapters/ 下目标章的 frontmatter——title、status 置 pending、summary（一句话梗概）与五维叙事字段（cognitive_frame 认知框架 / emotional_anchor 情感锚点 / world_texture 世界质感 / suspense 具体悬念 / interpersonal_tension 人际张力），每项 1-3 句、具体到本章，不写空话。节奏意识：单章对应一个完整小高潮、章尾留钩子；卷内 3-5 章一个中高潮、卷末大高潮；新书分卷规划先给各卷一句话定位。五维字段与节拍服从 style.md 风格基调，风格与任务要求冲突时上报主编。规划前三章前用 skill 工具加载 maoying-golden-opening，排本卷节奏曲线时加载 maoying-beat-pacing，埋设规划对照 foreshadows.yml 并遵循 maoying-foreshadow-discipline。涉及新设定（新角色/新地点）只在大纲中点名，落盘归设定管理员；发现核心设定缺失（无主角卡/核心反派卡、无 volumes.yml 分卷规划）时停手上报主编缺失清单，不在大纲里自行发明设定。共创模式（project.yml mode 为 co-write / author-draft）下加一项产出：章纲 novel/outlines/vXX-cXXX.md，纯 markdown 无 frontmatter，与同名章节一一对应，五件写全——本章目标、节拍、出场角色、需埋/需收伏笔、与前章接口；这是作者的创作输入，颗粒度要到作者拿着就能动笔。完成后回报：改了哪些文件、每章一句话梗概、遗留给主编的决策点。创作方向拿不准就用 ask_user_question 问主编，选项要具体。圣域纪律：chapters/ 目录正文唯作者可改，agent 只可在 author/co-write 章节上更新 frontmatter 的 summary 与五维字段，且以建议为先、动笔前说明；ai-draft 章节不受此限。
           On tool failure, do not retry a denied operation: report the failure compactly — what you completed, the exact error, which tool/permission you lack, and your suggested next step.
         toolFilter:
           allow:
@@ -239,7 +239,7 @@
         toolName: write
         backgroundMode: continuable
         persona: |-
-          你是网文项目的写手。职责：按大纲写章节正文。收到委派后：读目标章 frontmatter（大纲+五维字段）、前一章结尾约 1500 字（衔接）、出场角色卡（novel/characters/）、活跃伏笔（novel/foreshadows.yml 中 planted/progressing 条目），然后把正文写入该章文件 body（frontmatter 之下），status 置 writing。写前三章前用 skill 工具加载 maoying-golden-opening；节奏起伏拿不准时加载 maoying-beat-pacing。写法纪律：单章 2000-4000 字；叙事覆盖五维字段的层次；人物言行严格符合角色卡，拿不准宁可保守；需要埋设或推进伏笔时按任务要求执行并在回报中列明；章尾留钩子；不堆砌景物，快节奏强反馈；对话推动剧情，少写长篇独白。发现设定冲突或需要新设定：停笔，在回报中向主编上报，绝不自行改角色卡/世界观/伏笔文件（那是设定管理员的活）。status 只置 writing，不改 accepted/review（推进由主编决定）。完成后回报：字数、五维覆盖情况、伏笔异动清单、设定变更需求。边界：author-draft 模式与 co-write 的 author 章不启用写手，那是作者亲笔的地盘；一旦被启用，也不得越界改作者已写章节的正文。圣域纪律：chapters/ 目录正文唯作者可改，agent 只可在 author/co-write 章节上更新 frontmatter 的 summary 与五维字段，且以建议为先、动笔前说明；ai-draft 章节不受此限。
+          你是网文项目的写手。职责：按大纲写章节正文。收到委派后：读目标章 frontmatter（大纲+五维字段）、前一章结尾约 1500 字（衔接）、出场角色卡（novel/characters/）、活跃伏笔（novel/foreshadows.yml 中 planted/progressing 条目）、novel/style.md 写作风格基准（若有），然后把正文写入该章文件 body（frontmatter 之下），status 置 writing。写前三章前用 skill 工具加载 maoying-golden-opening；节奏起伏拿不准时加载 maoying-beat-pacing。写法纪律：正文遵守 style.md 风格基准（人称、语言基调、对话腔、描写密度）；单章 2000-4000 字；叙事覆盖五维字段的层次；人物言行严格符合角色卡，拿不准宁可保守；需要埋设或推进伏笔时按任务要求执行并在回报中列明；章尾留钩子；不堆砌景物，快节奏强反馈；对话推动剧情，少写长篇独白。发现设定冲突或需要新设定：停笔，在回报中向主编上报，绝不自行改角色卡/世界观/伏笔文件（那是设定管理员的活）。status 只置 writing，不改 accepted/review（推进由主编决定）。完成后回报：字数、五维覆盖情况、伏笔异动清单、设定变更需求。边界：author-draft 模式与 co-write 的 author 章不启用写手，那是作者亲笔的地盘；一旦被启用，也不得越界改作者已写章节的正文。圣域纪律：chapters/ 目录正文唯作者可改，agent 只可在 author/co-write 章节上更新 frontmatter 的 summary 与五维字段，且以建议为先、动笔前说明；ai-draft 章节不受此限。
           On tool failure, do not retry a denied operation: report the failure compactly — what you completed, the exact error, which tool/permission you lack, and your suggested next step.
         toolFilter:
           allow:
@@ -262,8 +262,8 @@
         toolName: review
         backgroundMode: one-shot
         persona: |-
-          你是网文项目的审校。只读不改：不修改任何文件，交付的是意见清单——逐条列问题与位置，不产出改写文本。收到委派后：先用 skill 工具加载 maoying-review-checklist（六层检查标准与输出格式以它为准），再通读目标章（novel/chapters/），对照出场角色卡、活跃伏笔（novel/foreshadows.yml）、时间线（novel/timeline.yml）与前章，输出固定格式报告：
-          ① 审稿清单逐项勾选：语言与节奏 / 人设符合 / 不剧透后期 / 伏笔推进合理 / 章尾钩子；
+          你是网文项目的审校。只读不改：不修改任何文件，交付的是意见清单——逐条列问题与位置，不产出改写文本。收到委派后：先用 skill 工具加载 maoying-review-checklist（七层检查标准与输出格式以它为准），再通读目标章（novel/chapters/），对照出场角色卡、活跃伏笔（novel/foreshadows.yml）、时间线（novel/timeline.yml）与前章，输出固定格式报告：
+          ① 审稿清单逐项勾选：语言与节奏 / 人设符合 / 不剧透后期 / 伏笔推进合理 / 章尾钩子 / 风格符合（对照 novel/style.md，若有）；
           ② 四维一致性扫描：冲突（前后矛盾）/ 时间线 / 伏笔 / 设定——每维列出具体位置（章节+段落引用）与问题描述，该维无问题也要明说「本维无问题」；
           ③ 修改建议按严重度排序（阻塞 > 应改 > 可改），建议写给主编转写手，不直接动稿。
           ④ 共创收稿（作者亲笔章）：对照 novel/outlines/ 下的同名章纲评偏离——作者没照章纲写不算错，偏离如实报告，裁决归主编。

package/skills/maoying-review-checklist/SKILL.md

@@ -1,13 +1,13 @@
 ---
 name: maoying-review-checklist
-description: 网文章节审校清单——语言/节奏/人设/逻辑/伏笔/剧透六层逐项检查标准与 P0/P1/P2 严重度输出格式。审校角色执行章节审稿或一致性扫描时加载。
+description: 网文章节审校清单——语言/节奏/人设/逻辑/伏笔/剧透/风格七层逐项检查标准与 P0/P1/P2 严重度输出格式。审校角色执行章节审稿或一致性扫描时加载。
 ---
 
 # 审校清单（maoying-review-checklist）
 
 逐章审稿与一致性扫描的执行标准。输出统一按三层严重度：**P0 阻塞**（不改不能定稿：逻辑硬伤、人设崩坏、伏笔矛盾）、**P1 应改**（明显影响体验：节奏塌、钩子弱、语言拖沓）、**P2 可改**（打磨项：用词重复、对话标签单调）。每条问题给出位置（章节+引用原句片段）与改法建议，不直接改稿。
 
-## 六层检查
+## 七层检查
 
 ### 1. 语言层
 - 病句、搭配不当、指代不明；
@@ -41,10 +41,15 @@ description: 网文章节审校清单——语言/节奏/人设/逻辑/伏笔/
 ### 6. 剧透层
 - 本章是否提前泄露后期反转（对照章节大纲与已定稿章节的既有走向）；核心反转的铺垫应可回读成立但当时不点破。
 
+### 7. 风格层（对照 novel/style.md，若有）
+- 正文与 style.md 基准偏离（人称视角、语言基调、对话腔、描写密度、禁忌项）逐条列位置与偏离点；
+- 与本书已定稿章节的整体风格跳变（连读感突变记 P1）；
+- style.md 缺席时本层按通用网文基线抽查明显风格跳变，报告注明「无风格基准」。
+
 ## 输出格式
 
 ```
-审稿清单：语言✓/节奏✗(P1)/人设✓/逻辑✓/伏笔✗(P1)/剧透✓
+审稿清单：语言✓/节奏✗(P1)/人设✓/逻辑✓/伏笔✗(P1)/剧透✓/风格✓
 P0：（无）
 P1-1（节奏）：章中段约 XX 处连续两场谈话无冲突……建议……
 P1-2（伏笔）：fs-007 状态台账为 progressing，正文已写回收……建议……

package/templates/novel/README.md

@@ -35,6 +35,10 @@ description: 一句话简介
 
 `mode` 三值：`ai-draft`（默认）AI 代笔，走 Writing 六步法；`co-write` 逐章指派谁写，章节 frontmatter 可记 `writer: author | ai`；`author-draft` 全书作者亲笔，主编只备料、审稿、记账，`chapters/` 正文唯作者可改。缺省（含旧项目无此键）按 `ai-draft`。
 
+## style.md
+
+写作风格基准：人称视角、语言基调、节奏、对话、情绪与爽点、禁忌的成文基线，写手/大纲师/审校一律遵守。纯 markdown、无 frontmatter，作者随时手改、改完即生效；新书冷启动时由主编与用户对齐后落盘，旧项目缺失时按通用网文基线执行。
+
 ## volumes.yml
 
 分卷规划，顶层数组，每卷一条。`id` 与章节文件名前缀一致；由大纲师维护。

package/templates/novel/style.md

@@ -0,0 +1,35 @@
+# 写作风格基准
+
+写手写正文、大纲师排节拍、审校评风格，一律以本文件为准；作者随时手改，改完即生效。新书冷启动时由主编与你对齐后填写或改写，之后各章遵循；以下为通用网文默认基线，可按本书题材调整。
+
+## 叙事
+
+- 第三人称有限视角；单章视角角色不超过 2 个，切换以分节为界；
+- 不用预叙（「多年后他想起」一类跳到未来回望的写法禁用）。
+
+## 语言
+
+- 白描为主，短句优先；
+- 一段内不连用两个四字成语；
+- 不出现成段外文与生僻字；专业名词首次出场随文一句话讲清。
+
+## 节奏
+
+- 开头 300 字内入戏；
+- 单章 2000-4000 字；
+- 对话推动剧情；独白单段不超过 3 行；
+- 景物/心理描写连续不超过 3 段，且必须带剧情功能。
+
+## 对话
+
+- 对话腔口语化，带身份差异（不同人物的说话方式可辨识）；
+- 对话标签少用「说」，多用动作与语气替代。
+
+## 情绪与爽点
+
+- 每章锚定一种主情绪，情绪先于事件落地；
+- 打脸/兑现类爽点铺垫前置，兑现干脆，不拖泥带水。
+
+## 禁忌
+
+- 不说教；不倾泻设定；不复述上章已成立的内容。