dsh-story-mode

dsh-story-mode · 短篇小说模式

给 DeepSeek Harness (DSH) 的一个写作专用模式。装好之后，新建会话时模式选择器里会多出两个写作模式——「短篇小说模式」（五位角色化审读员）与「短篇小说模式（精简）」（一位合并审读员）——进去的不是编码 agent，而是一个接稿的短篇小说作者。

整套能力（两个模式、技能、工具）都在一个包里，一条命令落地。两个模式共用同一份文风契约与同一套写作工具，只有审读的组织方式不同：完整版按五个维度各派一位独立读者，精简版派一位读者一次读完五个维度。

---

它解决什么问题

让可测量的内容由程序负责，让需要上下文的内容由读者判断。

字面命中不代表违规，统计正常不代表故事好看。工具不再根据“我/你/他”判定视角滑移，也不依据固定对话比例评价节奏。

新稿与实质性改写保留独立审读；规划随任务规模缩放，纯文字小改由主代理核对上下文。近似字数允许合理浮动。

---

安装

dsh plugin --profile <你的 profile> add github:Furry-wucheng/dsh-story-mode

就这一条。 不需要第二步、不需要改任何配置文件。装完新建会话，模式选择器里就有「短篇小说模式」与「短篇小说模式（精简）」。同时你会看到另外六个「审读员（内部）」条目——那是 DSH 0.2.1 机制的一部分，原因和代价见下面「0.2.1 的新代价」一节，正常使用时不要选它们。（CLI 启动的 profile 下当场生效；桌面版若没看到，重启一次 DSH——它的 profile 组装只在启动与插件状态变更时跑，没有监听 bundles 的 watcher。）

它是怎么做到的

模式是包内补丁插入的 preset 声明行（插件 @deepseek-ai/dsh-agent-preset）。DSH 0.2.1 的 preset 注册表不扫描目录、也不接受预设路径：新建或覆盖预设都靠 bundle 补丁插一行。完整版那一层插 6 行——主模式 preset-short-story（config.id: short-story，order: 5）与五个只读审读员 preset preset-short-story-review-b1 … -b5（story-review-b1 … b5，order: 101–105）；精简版那一层插 2 行——主模式 preset-short-story-lite（short-story-lite，order: 6）与合并审读员 preset preset-short-story-review-merged（story-review-merged，order: 111）。config.plugins 是这个 preset 的全部子插件：完整版主模式是人设、文件工具、精确编辑器、写作工具、技能、压缩与委派；审读员 preset 只有人设、只读文件工具与搜索工具。config.name / config.description 是模式选择器里显示的文本。

为什么审读员也是一个 preset。 DSH 0.2.1 的 @deepseek-ai/dsh-tool-subagent 删掉了 persona 与 toolFilter（源码对这两项是硬报错，不是忽略），孩子的人设与工具面必须写在一个命名的 agent preset 里，调度工具行只写 agentPreset: story-review-bN。所以五位审读员各占一行声明，主模式里的 tool-subagent-review-b* 五条行用 agentPreset 指过去；精简版同理，一位合并审读员。声明顺序是硬约束：tool-subagent 在挂载时就校验 agentPreset 指向的声明是否存在，所以审读员行必须写在主模式行之前——顺序反了，整个主模式会变成 broken 行。

于是没有任何"复制到 home"的步骤：patch 跟着包走，技能由各行用 customSkillDirs 从包内挂载（完整版一个根 skills/；精简版两个根：skills-lite/ 与 skills/writing-style-contract/）。包内文件路径一律运行时算出——这也是社区插件（如 dsh-TUI）解决同一个问题的做法。

两条反直觉的解析规则（改这个文件前必须知道）：

• 子插件行的名字写裸包名 dsh-story-mode。 preset 子插件的解析基准是 profile 目录，不是 patch 文件所在目录、也不是包目录；profile 的 node_modules 里就是本包（社区插件 dshmarket、dsh-better-sidebar 用的是同一条路）。相对路径 ./lib/index.js 会按 profile 目录解析而找不到；name: !!js … 更不行——loader 只对 config 插值，name 会原样丢给 import()。
• 包内文件路径在运行时问出来。 !!js 里的 baseUrl 现在是 profile 目录（解析锚点），不再是组合文件所在目录，所以每个读文件的行都先用 createRequire(baseUrl).resolve('dsh-story-mode/package.json') 拿到包根，再 path.join。官方组合（dsh-web-app 的 cordis 预设）用的也是这个写法。

两个模式怎么选

装的是同一个包，所以模式选择器里会同时出现两个写作模式与六个「审读员（内部）」条目（完整版 5 个 + 精简版 1 个）；它们只是自动派发的目标，不要直接选，原因见下文的「0.2.1 的新代价」。

数字是怎么来的：审读子代理是独立 spawn 的（零继承上下文），所以每个孩子的固定成本里最大的一项是再读一遍正文——10,000 字中文稿 read 带行号返回约 12,000 字符（按 400 行左右的分行正文估）；五位读者就是同一篇正文读五遍。两个"总开销"数字是把子代理的工具面、人设、派发消息与报告上限都算进去的每轮派发成本；两种模式的审读员现在都只带 read / read_image / glob / grep 四件工具（约 2,400 字符），所以完整版约 5 ×（12,000 正文 + 2,400 工具面 + 人设 + 派发与报告）≈ 100,000 字符（≈ 72k token），精简版约 24,000 字符（≈ 17k token，里面含合并审读员人设拼进去的那份文风契约）。工具 schema 与人设长度都按已装构建估算，误差约 ±15%；五个孩子里 B4 最贵——它的 persona 除了角色说明，还拼着整份文风契约（约 4,300 字符）。精简版不是"读得浅"，是省掉四遍重复读，并把五维覆盖留在同一份报告里：读不懂的地方、故事逻辑与关系依据、阅读体验与节奏、文风契约执行、动作与空间连续性。

它换掉了什么（说清楚，免得踩空）：

• 五位读者之间的交叉验证与冗余没有了。精简版用"冷读起点"补偿了一部分——那位读者默认只拿正文，不拿人物卡、节拍、大纲和你的写作推理，所以"我没看懂"仍然是读者证据，而不是抄你的意图。但它确实只有一双眼睛：B5 的独立状态重建、B3 的独立节奏判断，都由同一位读者在同一遍阅读里给出。
• 文风契约在精简版里是"尺子"而不是意图：合并审读员既要冷读、也要对文风，所以契约（它写着"冷读者不读本契约"）会装进它的人设。人设里明确要求：先读完、判完其它四维，再拿契约定第 ④ 项的尺度，不用它预判剧情与人物；契约里提到 short-story 技能/审读面板的段落都指完整版。
• 最终盲读要另起一位新读者：重写或旧报告可能让原读者带入预期时，精简版的规则是再派一次 subagent_review（全新子代理、不给旧报告；调用立即返回一个新的 started subagent <childId>），而不是 send_message 复用——这条占掉第 2 个名额，所以"盲读"和"复审批次"二者按需取一。

要更严的审读时：预设是会话级选择，中途不能切换。所以做法是给这一篇另开一个完整版会话，把稿子交给它做交付级审读（含五位角色、/goal）。精简版留在会话里的通用 subagent 不是审读替代品——它没有信息边界、也没有报告格式，只适合查资料或核对某条设定这类不属于独立审读的活。

0.2.1 的新代价：模式选择器里多出六个「审读员（内部）」条目

审读员在 0.2.1 里必须是命名的 agent preset，而 preset 注册表没有"隐藏"字段：一个 preset 一经声明，就会出现在模式选择器里。所以装好之后，选择器里除了两个写作模式，还会多出完整版的五个「短篇审读员 B1 · 冷读（内部）」…「B5 · 动作与空间（内部）」（order: 101–105，config.id: story-review-b1 … b5）与精简版的一个「短篇审读员 · 合并五维（内部）」（order: 111，config.id: story-review-merged）。它们都排在最后、名字带「内部」、描述里写明"不要直接选择这个模式"。

这是 0.2.1 机制的直接结果，不是本包的偏好：只要审读员要有固定人设与只读工具面，就必须是一个独立 preset；独立 preset 就会被列出来。误选的代价是有界的——进去的是一位只读读者，工具面只有 read / read_image / glob / grep，没有写、编辑、交付、委派工具，稿件不会因为误选被改；但你也得不到一个写作模式（它没有作者身份、story_* 工具与技能挂载）。注册表同样不禁止把审读员 preset 设为默认模式，所以卸载前的 cleanup 也认这六个 id：万一误设了，它会在卸载前把默认值清掉，避免 agent-preset/not-found。正常使用时请忽略这些条目；如果以后 DSH 给 preset 增加"内部/隐藏"标记，本包会跟着改用。

卸载

dsh plugin --profile <你的 profile> remove dsh-story-mode

两个模式与它们自带的技能都跟着包一起走，这些不需要任何清理——它们从来没被复制到你家里去过。（模式与审读员都是包内两层 patch 插入的声明行，技能由 customSkillDirs 从包内挂载，所以它们只在这两个模式的作用域里可见。）

只有一件事要在卸载前确认：

dsh plugin --profile <你的 profile> exec dsh-story-mode check

如果它提示「默认模式指向本模式」，先清理再卸载：

dsh plugin --profile <你的 profile> exec dsh-story-mode cleanup

为什么要跑：如果你在模式选择器里把任一个写作模式设成了默认模式，卸载包之后新建会话会直接以 agent-preset/not-found 失败——DSH 找不到默认 preset 时不会回退到 standard，而真正会顺手清掉这个默认值的那条路径被 dsh plugin remove 绕过了。这一步必须在卸载之前做，因为包一旦 remove，这个命令也就没了。

（这个默认值存在 agent-preset-registry 行的 volatile 字段 selectedDefault 上，由 loader 写回 profile 的 cordis.patch.yml；cleanup 只删那一行，不动文件里的其他内容，并且本包声明的全部 preset id 都认（两个写作模式与六个审读员 preset）——只认完整版的话，选了精简版当默认的人卸载后会撞上同一个 agent-preset/not-found。它顺带清掉两处历史残留：v1.0.1 复制到 <DSH_HOME>/.agent-presets/short-story 的模式副本，以及 v1.0.1／v1.0.2 曾可选安装的 <DSH_HOME>/skills/writing-style-contract 副本——后者只在带 .dsh-story-mode.json 归属标记时才删，绝不会误伤你自己手写的同名技能。不是本包放的东西一律不动。）

一条命令的边界

ctx.agentPresets.register() 是多发布接口，所以本包不碰任何官方行：完整版插自己的 6 行声明（preset-short-story 与五个 preset-short-story-review-b1 … -b5），精简版插 2 行（preset-short-story-lite 与 preset-short-story-review-merged），都排在官方 standard / ptc / minimal / cordis 之后。早期版本那种"接管官方 agent-presets 行、整体重述它的 config"的代价（官方加字段就被静默抹掉）已经不存在了。

这些声明住在两个补丁文件里（cordis.patch.yml 与 cordis.lite.patch.yml），由 package.json 的 dsh.bundle.patch 一次声明——它是路径数组（@deepseek-ai/dsh-app-boot 的 bundlePatchFiles()：字符串或路径列表都接受），按顺序合并成两层。为什么分开：那份完整版补丁与它周围的校验设施（scripts/verify-composition.mjs、test/preset-contract.test.js、story_doctor）都是按"一个文件一个模式"写死的，同文件再插一块会让"原预设已被验证"这件事整体失效；分开之后，完整版的检查一字不改地继续守着它，精简版由同一个脚本的 --preset lite 档位来守。

剩下几条要记住的：preset 的 config.id 与 loader 行 id 都要成对唯一——config.id 撞了会在注册表里抛 Duplicate agent preset（响亮），而 loader 行 id 撞了更隐蔽：后者静默覆盖前者（loader 按行 id 建表、last wins），表现为某个模式或某个审读员"莫名其妙不见了"。声明行是普通条目，可以被用户 patch 覆盖。 profile 的 cordis.patch.yml（以及 Web 配置编辑器保存的修改）能按 id preset-short-story、preset-short-story-lite 或任一个 preset-short-story-review-b* / preset-short-story-review-merged 覆写它的 config——而 config 是整体替换、不是深合并，两层互不影响。所以你改过某个模式或某个审读员的话，升级包不会覆盖你的改动；想拿回包里的版本，删掉 profile patch 里那一段再重启。story_doctor 会检查这一点。

需要什么版本

DSH 0.2.1-rc.1 及以后（在 0.2.1-rc.2 上实测）。0.2.1 把 tool-subagent 的 persona、toolFilter 与 backgroundMode 三个配置项删掉了，孩子的固定人设与工具面改由命名的 agent preset 提供——本包的审读员正是按这个机制组合的。更早的 DSH 不要用这个版本：0.1.7 的 tool-subagent 没有 agentPreset 字段，schema 不认识它会原样留着、运行时又不读，于是审读员工具行会静默退回"孩子加入父代理的 preset"——审读员拿到整套写作工具，只读保证无声失效；同理 0.1.7 的 tool-fs 也没有 write / edit 开关，审读员 preset 里的 write: false 不会生效。

旧包不通用。 v1.5.0 及以前的包在 0.2.1 上会整段失效：那些审读员行还写着旧版的 persona 与 toolFilter，0.2.1 对这两项是硬报错（不是忽略），挂载即抛，父 preset 变 broken。两条路不通用，请按 DSH 版本选包。

验证安装

下面的命令只检查卸载残留，不证明模式已经加载成功：

dsh plugin --profile <你的 profile> exec dsh-story-mode check

安装验证请在新会话里让 agent 调用 story_doctor —— 它会逐项报告：包是否进了 bundles、package.json 是否可解析（带 BOM 会让 DSH 读不出 dsh.bundle）、两层 patch 是否插齐了声明（完整版 1 个主模式 + 5 个审读员 preset，精简版 1 个主模式 + 1 个审读员 preset）、子插件行与 agentPreset 指向能不能对上（审读员行必须在主模式行之前）、每个审读员 preset 是不是只有 persona + tool-fs（write / edit 关）+ tool-fs-search 三行、包内模式文件与审读员人设是否齐全、技能根能不能从包内读到、profile patch 有没有覆盖其中任一行；在写作模式里还会问运行时本身：roster 里这两个模式与对应审读员 preset 在不在、组合是不是 broken、本作用域里有哪些技能与 story_* 工具。模式选择器里应该看到两个写作模式 + 六个「审读员（内部）」条目；后六个只是注册表可见，不要选。

其他安装方式

# 全局安装
pnpm add -g github:Furry-wucheng/dsh-story-mode

# 从源码目录直接开发：打成 tgz 再装进 profile（link 安装也可以，见下面的开发验证）
git clone https://github.com/Furry-wucheng/dsh-story-mode
cd dsh-story-mode && pnpm pack        # 得到一个 tgz
dsh plugin --profile <你的 profile> add ./dsh-story-mode-<version>.tgz

升级

dsh plugin --profile <你的 profile> add github:Furry-wucheng/dsh-story-mode

模式与技能都跟着更新——它们都住在包里，没有任何需要手动刷新的副本。

（唯一的例外：你在 profile 的 cordis.patch.yml 里按 id preset-short-story、preset-short-story-lite 或任一个审读员 preset 行改过它的 config。patch 是整体替换 config 的，所以那一份以你的为准——升级不会覆盖它，也不会提醒你。story_doctor 会把这种情况报出来。）

用它

主代理先加载写作技能。复杂新稿或结构改写需要细化规划时再读共用流程；准备独立审读时再读审读面板的相关章节。只有缺失信息确实影响交付时才向作者追问；“写一段”“短一点”可以自行确定合理篇幅并说明。作者要求直接写、且范围已清楚时直接写；长稿或复杂关系线按需先拟节拍。

• 新写整篇或片段：明确范围与停止点 → 按规模规划 → 成稿 → 独立审读 → 必要时修订复核。片段无需全篇闭环。
• 续写：读取获准前文与相关设定，按新增内容规模规划并独立审读；不擅自补完全文。
• 整体改稿：核对并补齐受影响的人物卡和节拍，按确认范围修改，独立审读新版。
• 局部润色：读取必要上下文并核对改动与接缝。纯措辞、标点等不改变事实与阅读含义的修改由主代理自查；改变动机、因果、设定、视角或动作状态时派对应审读员。
• 只要评价或方案：独立审读对应材料后交付意见或方案，不自动写正文；评价不擅造作者设定。

完整作品的篇幅档位仅供参考：微型 3k–5k、标准短篇 5k–10k、中短篇 10k–20k、系列每篇 3k–10k。单点近似目标默认允许约 ±15% 浮动；作者给了区间就优先落在区间内。明确写出精确值、最低或最高字数时按硬约束执行。工具报告实际字数，小幅偏差不自动触发补写、删字或复审。

故事资产

较长新项目可用 brief.md 保存方向、bible.md 保存人物卡、outline.md 保存节拍、draft.md 保存正文；短片段可以在当前任务中保留简短规划，不强制创建四个文件。已有项目沿用既有记录，只整理本次受影响的内容。

人物卡包括身份、当下动机或需要、关系、性格和口吻、当前状态与相关事实。节拍安排当前内容的先后、快慢详略、字数与停止点；可以有不推进事件的闲聊和停留。详见共用流程的示例。

时间关系复杂时再用 timeline.md，专名多时再用 glossary.md。搜索、枚举和审读输入都限于授权目录，不能为避免新目录重名先列出其他作品。

四个工具

全部只读。正文和设定的修改走宿主的常规文件工具。

按大纲目标统计

{“path”:“故事/draft.md”,“sceneTargets”:“1000,3000”}

sceneTargets 是按场景顺序排列的正整数字数。工具计算（实际字数 − 目标字数）/ 目标字数，不按场景均分。 逐场成稿时可传包含后续未写场景的完整列表；已写场景必须都有目标。没有计划目标时省略参数，只看分布。 配置 sceneDriftPercent 表示相对单场参考目标的提示阈值，默认 15%。提示用于查看分布，不代表场景不合格，也不要求逐场凑字。旧 dialogueLowPercent / dialogueHighPercent 已不再使用。

引号内比例仅是对话的近似量，包含引用，不含无引号台词。重复项是未经分词的双字组合，不自动构成用词错误。 标题与开头的完整元数据块不计入正文；报告行号仍对应源文件。

用词线索与人物检查

story_lint 的 only 可筛选：template-simile、psychological-summary、emotion-explained、dialogue-tag-overuse、emotion-adverb-tag、ai-rhythm、cheap-adverb。这些旧规则 id 保持兼容，报告现在只表示待阅读的线索。旧 pov 参数和 only: pov-drift 仍接受，但不执行人称检查，会说明判断已移交审读员。

story_bible 的“缺卡候选”仅来自 bible 的“已知事实”清单里，在正文出现至少两次、却未建卡的条目。正文中新出现但未进清单的名字不会自动识别；人物、指代与拼写一致性要由审读员核对。

审读流程

新写、续写正文或大幅重写，包括片段：B1 冷读与 B2 故事逻辑独立审读初稿或实质性改写稿；B3 阅读体验、B4 文风执行、B5 动作与空间连续性按本次风险派。主代理修改后，只有实质问题或受影响状态链需要交原读者复核；旧报告可能影响判断时才换全新 B1 盲读。各角色独立读稿，不预先看彼此报告。 一句或一段的纯文字润色由主代理核对上下文，不逐处派审。若一句话改变人物动机、事件因果、视角或重要的动作与物品状态，派对应角色审受影响范围。自查、计数和 lint 不冒充独立审读；需要的报告或复核缺失时标待审。

精简版（short-story-lite）只有一位审读员。 新稿与实质性改写派 subagent_review 一次（调用立即返回 started subagent <childId>）：它从冷读起点出发（默认只拿正文，不拿人物卡、节拍、大纲与你的写作推理），一遍读完，在一份报告里分五节给出五个维度，每节最多 3 条、每条带原文锚点与影响。复核用 send_message 发回同一位读者，只给改动范围与要问的事；一次会话新建的子代理不超过 2 位。它的派发规则写在 skills-lite/short-story-lite/SKILL.md 里，不读完整版的审读面板（那份规则对应的是精简版没有的五个角色工具）。

关系与关键转折

B2 除了核对事实和因果，也会检查重要关系转折是否有读者能感知的依据。两项在成稿后同一轮完成，不另派角色；没有关系线时不强加关系轴报告。独立读者能发现主代理因熟悉大纲而忽略的跳跃，但审读意见仍需回到正文判断。

关系依据可以来自行动、对话、积累的细节或叙述。暧昧和留白可以保留；没有固定的露出次数、对称主动要求、起点场景或逐拍代价。B2 只报告确实妨碍理解的断裂，给出原文证据和可选修法。纯文字小改无需重跑；实质改变关系转折时复核受影响范围。

台词是否自然、人物判断是否可信，也由读者结合上下文检查。闲谈可以存在，紧凑对话也可以成立；年轻人和弱势者同样可能敏锐。字面工具无法替代这类判断。

作者说“我没看懂”时，先核实困惑来自信息顺序、缺少必要依据，还是有意的悬念，再决定修改范围；不预设必须补一整场。 审读员是可复用的持久子代理，但 0.2.1 里没有"后台开关"。 每次派发都是受管的 activation：调用立即返回 started subagent <childId>，运行结束后投递一条结算通知（含孩子的收尾正文）；没有前台分支，也没有需要你在参数里指定的运行模式。拿到报告后把"角色 → childId"记在当前任务中；需要复核时用 send_message 交给同一位读者，只检查相关实质改动。需要排除旧报告影响的最终盲读才另起新读者（那是又一个新的 childId）。

这套行为由 tool-subagent 的受管 activation 加 control 包的 send_message / list_agents 两行工具提供；story_doctor 会静态检查五条委派行的 agentPreset 指向、两份 control 行，以及审读员 preset 的只读开关。

读者数量有配额，所以复用不只是省钱。 DSH 给委派设了一个存活子代理名额池：Host 的 dsh-subagent 设置 maxActiveSubagents 默认 8，同一棵父子树共享；池满之后新建会被直接拒绝（ACTIVATION_LIMIT_REACHED），那一次派发拿不到报告，只能等已有读者空出来。三条机制值得记牢：send_message 回已驻留的读者复用它的名额；0.2.1 的每一次派发都是受管 activation，都占一个池位（没有"不占池的一次性分支"可走）；名额只在当前进程里，限制的是"同时活着的读者数"，不是累计报告数。

所以本模式自限：一次会话（一篇文章从接稿到交付）新建的审读子代理不超过 6 位——B2 一位、B1 一位、B3/B4/B5 合计最多三位、最终盲读一位；通用 subagent 最多 1 位。之后的每一次"再读一遍"都是 send_message 发回原读者。额度不够时先复用、再借用边界允许的读者，最后在汇总里标"因额度未派 X，该项待审"，不虚报验收。

逻辑审读与关系轴是同一位 B2 的同一轮：都读已经落地的正文——核设定与因果（一致性），再答"这一跳有没有依据"（充分性），派发消息里加一行"审读类型：关系轴"即可。所以 B2 只有一次落点（第一个成稿版本），方案阶段不派读者：那时没有正文，判不出可信结论；方案的必答项由主代理拟节拍表时写死并自查，交付方案时注明"未经独立审读"。

派发预算写在审读面板的第一节；npm test 会检查 6 位上限、额度不足时的处置和复用规则。作者需要更多并发时可以在 DSH 的「插件 → 子智能体」里调高 maxActiveSubagents，但 6 位自限仍然成立。

story-review-b1 … b5 是审读员 preset 的 config.id：每个角色的固定人设与只读工具面住在那一行声明里，主模式里的五条 tool-subagent-review-b* 行用 agentPreset 指过去。这些 preset 也会出现在模式选择器里（见「0.2.1 的新代价」），正常使用时不要直接选。

每次派发记录正文路径和工具给出的内容版本。审读期间暂停修改；结算通知到达后核对版本。 问题位置采用“场景 + 原文短引 + 行号”，主代理追踪改稿后的对应位置。不同版本的段落号不能直接交叉判断。

需要最终盲读时使用全新读者，只看最新正文。 初次 B1 已读最终版本、期间没有实质改写时无需重复盲读。读者的困惑是需要核实的证据，也可能是合理悬念。

审读员的只读是组合保证的，不是提示词里的请求。 每个角色由主模式里独立的一行 tool-subagent 提供，agentPreset 指向一个只读审读员 preset；那个 preset 的 config.plugins 只有三行：persona（身份、读什么、报告格式由 !!js 从 skills/short-story/references/reviewers/<角色>.md 读出）、tool-fs（read / read_image 开，write / edit 关）、tool-fs-search（glob / grep）。写入、编辑、交付、委派、技能与压缩工具根本没有挂载——不是"先注册再用 restrict() 剥掉"，而是孩子从一开始就拿不到。所以派发时只给变量、不必重述边界，也不必写"不许改文件"这类请求。独立审读无法运行时如实说明，不虚报验收。

（审读员 preset 故意不挂 str_replace_editor：它的命令是 view / create / str_replace / insert，挂上它就不再是物理只读；而且它的 schema 约占一个审读子代理工具面的一半（约 2,803 / 5,171 字符），去掉它每次派发少一半工具面。审读只需要读与定位——read 已经返回带行号的正文，glob / grep 负责找。审读员 preset 也不挂 compaction：压缩会在读到一半时改写证据，让报告静默丢掉前半部；宁可上下文撑爆、以 max-tokens 明确失败。）

共用流程和审读面板位于包内的 skills/short-story/references/ 下。复杂规划与准备派发时按需读取相关章节；skill 调用不会自动加载参考文件。文风契约的长篇示例也已移到 references/style-examples.md，只有需要比较写法时读取。

---

包结构

dsh-story-mode/
  cordis.patch.yml                  完整版：插入 6 行 preset 声明（@deepseek-ai/dsh-agent-preset）——
                                    主模式 preset-short-story（order 5）带人设、工具、技能、压缩
                                    与五条委派行；preset-short-story-review-b1 … -b5（order 101–105）
                                    是五个只读审读员 preset（人设 + 只读文件工具 + 搜索）
  cordis.lite.patch.yml             精简版：插入 2 行——主模式 preset-short-story-lite（order 6）
                                    与合并审读员 preset-short-story-review-merged（order 111）；
                                    两层都由 package.json 的 dsh.bundle.patch 数组声明
  skills/short-story/               完整版的写作流程技能
    SKILL.md                        写作入口、柔性字数与分级审读
    references/                     writing-workflow.md：人物卡、节拍、成稿与修订；review-panel.md：派发规则与角色触发条件
      reviewers/                    B1–B5 各自的固定人设（身份、读什么、报告格式），由对应审读员 preset 的 persona 读出
  skills-lite/
    short-story-lite/SKILL.md       精简版的写作流程与派发规则（规则内联，没有额外的面板文件要读）
    references/reviewer-merged.md   合并审读员的固定人设：冷读起点 + 五个维度 + 报告格式
  skills/writing-style-contract/    文风契约（**两个模式共用同一份**，由各自的 skill-filesystem 行挂载）
    references/style-examples.md    需要比较具体写法时再读取
  lib/index.js                      主入口：四个写作工具
  lib/doctor.js                     独立入口 dsh-story-mode/doctor：只注册 story_doctor
  lib/tool-kit.js                   零依赖的工具构造器与参数校验（两个入口共用）
  bin/cli.mjs                       check / cleanup（不安装任何东西，只做卸载前清理）
  scripts/cleanup.mjs               实际干活的那份
  scripts/verify-composition.mjs    离线组合自检（--preset lite 校验精简版那一层，见「开发验证」）

模式是那一行声明，不是目录。 预设不再从文件系统发现，所以包里没有 presets/：子插件行写在补丁文件里，行名用裸包名 dsh-story-mode 指回本包的 lib/index.js。审读员同样是声明行——行 id 是 preset-short-story-review-b*，config.id 是 story-review-b*，被主模式的委派行用 agentPreset 引用。完整版的技能根是包内 skills/；精简版声明两个根——skills-lite/（只装精简流程）与 skills/writing-style-contract/（单独挂契约，不复制第二份）。skill-filesystem 扫描根时，根下的 *.md 文件直接算一个技能，所以第二个根指向契约目录本身即可；好处是精简会话的技能清单里不会出现完整版的 short-story 技能（否则模型可能加载它，再去找精简版没有的 subagent_review_b* 工具）。

两个入口是 exports 子路径实现的同包多入口。./doctor 可以单独挂到任何模式里做诊断（例如创造模式），不必连带加载三个写作工具。

---

已知约束与设计取舍

这些都是查过框架源码、并且踩过之后才写下来的：

• 委派在 0.2.1 里是受管 activation，不是"可复用的后台会话"开关。 每次 subagent_review_* 调用都立即返回 started subagent <childId>，运行完投递一条结算通知（含孩子的收尾正文）；没有前台分支，也没有要在参数里指定的运行模式。所以技能与审读面板的第一条规则是：记下 childId，结算通知到了再改稿；复核用 send_message 发回同一个 id，孩子带着上一版的阅读和自己写过的报告继续，不必重读全文。历史：v1.1.0 及以前的包是"每次复核再派一位读者"，同一篇正文要重读一遍；这个代价在可续接机制之后才消掉。
• 五个审读角色各占一行声明，人设与只读工具面都在组合里。 每个角色是一个独立的 @deepseek-ai/dsh-agent-preset 行（config.id: story-review-b1 … b5，order: 101–105），config.plugins 恰好三行：persona（由 !!js 从 references/reviewers/<角色>.md 读出并装到那个孩子身上，B4 另拼文风契约）、tool-fs（write: false / edit: false 是必填项——不写就默认可写）、tool-fs-search；主模式里的 tool-subagent-review-bN 行只写 provider / toolName / agentPreset。于是派发时主代理只给变量（路径、版本、范围、改动清单），不再从面板抄模板——抄一次就可能漏一条信息边界。三个坑：① 审读员 preset 行必须排在主模式行前面——tool-subagent 在挂载时校验 agentPreset 指向的声明存在，顺序反了整行变 broken；② 审读员 preset 不挂 compaction：压缩会在读到一半时改写证据，报告会静默丢掉前半部；③ 审读员人设里不要指望 skill 工具——那个插件根本没有挂载，B4 需要的文风契约在挂载时已拼进它自己的 persona。
• 两个模式住在两层补丁里，这是刻意的。 完整版那一层与它的校验设施是"一个文件一个模式"的：scripts/verify-composition.mjs 顶层只允许一条 insert，test/preset-contract.test.js 按整份文件数审读员 preset 行数，story_doctor 只读 <包根>/cordis.patch.yml。把精简版塞进同一份文件，等于让"原预设已被验证"这件事整体失效。拆成两层之后，完整版的检查原样守着它，精简版由同一个脚本的 --preset lite 档位守。两个坑：config.id 撞了会在注册表里抛 Duplicate agent preset（响亮），而 loader 行 id 撞了是静默的——loader 按行 id 建表、后面的覆盖前面的，表现为某个模式或某个审读员无声消失，所以 id 必须成对唯一（preset-short-story / short-story，preset-short-story-review-bN / story-review-bN，preset-short-story-lite / short-story-lite，preset-short-story-review-merged / story-review-merged）。
• 精简版是一位"合并审读员"，不是"少派几位角色"。 审读子代理独立 spawn、零继承上下文，所以每个孩子的固定成本里最大的一项是再读一遍正文：10,000 字中文稿的 read（带行号）约 12,000 字符，五个人就是五遍。合并版把五维（冷读困惑、故事逻辑与关系依据、阅读体验与节奏、文风契约执行、动作与空间连续性）放进同一遍阅读与同一份报告，代价要说清楚：五位读者之间的交叉验证与冗余没有了，B5 的独立状态重建、B3 的独立节奏判断都由同一位读者给出。补偿手段是"冷读起点"（默认只给正文，不给人物卡与大纲），以及另开一个完整版会话做交付级审读——预设是会话级选择，中途不能切换。
• 精简版砍掉的是工具面，不是写作能力。 常驻工具 schema 是每轮前缀里最大的一块（完整版 28 个工具约 22,300 字符 ≈ 5,600 token/轮，这是按已装构建估算的数、误差约 ±15%；而它自己的写作人设只有 873 字符），所以精简版把 4 个角色工具合并成 1 个、去掉 tool-web（2 个工具）与 tool-goal（3 个工具）。command-goal 保留：斜杠命令不进工具面，长稿仍能用 /goal 定目标。四个 story_* 工具、压缩、精确编辑器、技能与文风契约一个不动——省的是重复读和每轮的 schema，不是写作与自查能力。
• 写作模式故意不开 subagent_fork。 fork 继承主代理的全部上下文（大纲、写作推理、修改理由）；读者看过作者的底牌之后，“我没看懂”就不再是读者证据。审读员也因此不开子级模型选择，一律与主代理同路由。
• 技能根由 preset 声明，所以这些技能只在这两个写作模式里生效。 完整版挂包内 skills/（写作流程 + 文风契约），精简版挂 skills-lite/ 与 skills/writing-style-contract/；路径由各行的 customSkillDirs 在运行时从包内算出来，注册落进各自 preset 那一层，所以模式与技能永远同进同出。它们故意不放进 <DSH_HOME>/skills：那是用户根（rank 400），而每个 preset 自己挂的 skill-filesystem 实例都会扫它（includeDefaultRoots 默认 true）——放进去等于让它们出现在所有模式里，包括编码会话，而它们只属于写作模式。
• 写作模式保留了搜索工具（glob / grep）。 shell、计划模式、后台任务、工作流、多级委派都拆掉了，但"找"不能拆：系列连载里核对名字与细节靠搜，不靠通读。这一行要注意 sampleOverCapGlobResults 在 framework 侧是必填配置（z.boolean().required()），漏了它整个 preset 会挂不上；审读员 preset 的 tool-fs-search 行同理，漏了它那个审读员 preset 会挂不上。
• preset 是普通 loader 行，注册表不扫描目录。 @deepseek-ai/dsh-agent-preset 的一行 = 一个预设：config.id 是引用它的标识符，config.plugins 是子插件列表。插入用 bundle patch 的 insert 层，不碰官方任何一行。坑：子行的 name 必须是字符串，且解析基准是 profile 目录——所以本包自己的行写裸包名，包内文件路径一律用 createRequire(baseUrl) 在运行时问出来（baseUrl 是解析锚点，不是路径基准）。注册表没有隐藏字段：审读员 preset 同样是普通条目，会出现在模式选择器里（order: 101+、名字带「内部」、描述写明不要直接选）——这是 DSH 0.2.1 机制的直接结果，不是本包的偏好；选错只得到一个只读阅读器，稿件不会被改。详见前面的「0.2.1 的新代价」。
• insert 里的相对路径会被启动器改写，config.plugins 里的不会。 启动器只把 insert 条目（及其嵌套分组）中形如 /绝对路径、./、../ 的行名转成相对 patch 文件的 file URL；子插件行的名字不在这个改写范围内。这就是为什么本包用裸包名，而不是 ./lib/index.js。
• !!js 后面若是折叠标量，整段代码会压成一行。 所以那段 JavaScript 里不能有 // 行注释（一个就吃掉后面全部），也不能靠自动分号插入。这两条都是实测踩出来的（本包现在把这类表达式写成单行双引号标量）。
• 双引号 !!js 里不要出现反斜杠转义。 YAML 先处理转义，'\n' 会变成真换行、JS 源码跨行；需要换行写 String.fromCharCode(10)。story_doctor 与 npm run verify 都有针对这一条的检查。
• createRequire 的锚点必须按文件 URL 给。 给它一个不带尾斜杠的目录路径，Node 会把该目录当成文件解析，直接 MODULE_NOT_FOUND。preset 树的 baseUrl 带尾斜杠，所以直接可用。
• package.json 不能有 BOM。 带 BOM 会让 JSON.parse 失败，DSH 因此读不出 dsh.bundle 声明，dsh plugin add 不会把包加进 profile 的 bundles，patch 永远不生效——表现为"装好了但模式不出现"。这个坑本包也踩过一次，story_doctor 里有常驻检查（package.json 无 BOM 那一项）。
• 升级包之后要确认模式真的换了。 你改的是哪一份包决定模式的行为：从 GitHub 装的（dsh plugin --profile <name> add github:<作者>/dsh-story-mode）取的是远端默认分支，本地改动没推上去就不会生效。更隐蔽的一种：早期版本或插件市场留下过一份 profile 里的包快照，dsh plugin remove 之后不会自动删掉它——它可能还留在 node_modules 与插件目录里，于是"装了新版但模式没变"。判断办法是看模式里有没有 subagent_review_b1 这个工具，或者模式选择器里有没有六个「审读员（内部）」条目；清理由市场或手动删除那份快照完成（本包的 cleanup 脚本只处理 home 下的技能副本与旧模式副本）。开发期用 link: 装本地目录时，源码改动立刻生效，但改完要重启 profile。
• 本包零运行时依赖（连 schemastery 都没有）。ESM 的解析基准是加载入口的父路径，所以插件若 import 任何 @deepseek-ai/* 包就必须自带 node_modules；它什么都不 import，于是任何布局下都能加载。改代码时不要引入裸导入。

以下是旧版审读规则的实测记录，用来说明独立读者为什么需要检查关系转折，也记录了当时过于严格的处理方式；当前版本以本页前面的分级审读和正文证据为准。

• v1.2.0 之前，这套流程有一个已实测的失效形态：五个角色全绿而主轴空心。 一次真实调用里，五个审读员对一篇 23,399 字的稿子出了 19 份报告（含两次全新读者盲读），逐条命中字形、雨季倒序、浮毛时令、椅子数量、扣子崩落、字数台账，最终盲读明确写「没有大结构问题」；作者随后在半小时内用七个连续发言拆掉了它——主人公在八场里零主动推动、另一方“想要”的露出全部可被解释成尽职、关键那一跳没有任何不可否认的依据。

  盲测对照（v1.2.0 补做）：同一份 23,000 字稿、同一组派发变量、不带任何对话上下文的新子代理，唯一差别是 B2 的人设文件（标签随机化、判前不知对应）：

  	旧版人设 2.8 KB	新版人设 8.7 KB
  报出关系轴缺口	否	是
  关键结论	第 14 条把因果链判为**「已建立的理由与因果（通过）……越线不是凭空发生……逐级落到具体动作与位置」**	「转折点之前没有一条不可否认的露出」「推动者分布失衡，被动方在读者眼里是空的」「承认是告知而不是揭示」
  逐条判定	无（核的是“有没有铺垫”）	第一组 34 条逐条带行号判定，定位缺口的场次与必要条件

  旧版把“逐级有铺垫”当成了通过项——它核的是“有没有铺垫”，不是“这些铺垫立不立得住”。这正是「一致性」与「充分性」的差别，也是这道缺口能在一整套流程里活下来的原因。

  留这一条在这里，是因为缺口的形状（自洽但空心）不会自己暴露，只会以“读者看不懂”的形式回来。

  另有一条人设本身的修订，也是盲测逼出来的：最初第一组的判据是“全部条目都可否认 → 报缺口”。第三轮盲测报了 34 条、其中 15 条判为不可否认，缺口却仍然成立——因为那 15 条集中在关系已经变化之后，转折点之前读者手里还是零。所以判据已补成“可否认总数不是结论，分布才是”：落在哪、是不是被逼近后的反应、有没有一件是“他单独为对方做的”。概括的数量判断会漏掉这一种。

• v1.2.0 还漏了同一个方向的第二种形态：露出有据可引，起点没有。 一次真实调用里，一篇 17,900 字的师生短篇把关系轴跑了三轮（方案阶段一次、成稿后两次复核），B2 逐条列出 22 条露出、逐条判定、逐条给正文短引，推动者分布也数过、结论是“不失衡”；补拍之后缺口关掉，交付时验收状态是干净的。作者读完后仍然说这篇**“没有人味”**：两个人从什么时候开始不一样的、老师是怎么开始注意这个学生的，正文一场戏都没交代。

  形状：作者的定调是“学生主动进攻、老师屡次退守”，于是老师的朝前动作只落在转折点那一刻；而在转折点之前，正文给老师的两处来路是——去年十一月一节语文课上“忽然听不见学生的声音”，和五月里“他记得那个学生的气味……高二下学期还没有。到了冬天，那个味道变了。他没有理由去分辨它变成什么样，他分