dsh-maoying

dsh plugin --profile web add dsh-maoying

dsh-maoying（毛颖）

中文 | [English](README.en.md)

毛颖者，笔也——韩愈作《毛颖传》，把一支毛笔写成有封地有爵位的臣子。dsh-maoying 把这支笔装进 DSH（DeepSeek Harness）：一支管着一班帮手、守着一摞书稿的毛笔——网文创作辅助插件，全部实现原创，MIT 发布。

装上之后，主 agent 变身网文主编（创作总监）：带七阶段工作流与六步写作法，把大纲、正文、审校、设定维护、素材考据分别委派给五个只带本行工具的帮手；整部小说就是工作区里的 novel/ 结构化 markdown/YAML 目录（角色卡、伏笔状态机、时间线、线索板、叙事记忆）——agent 直接读写文件，没有数据库，没有 API 层。查「所有未回收伏笔」就是 grep 一行。

功能特性

• 主编 + 五帮手：主 agent 当主编，只做规划、衔接、验收、状态推进；大纲师（outline）、写手（draft）、审校（review）、设定管理员（lore）、素材调研员（research）各带本行工具随叫随到。找文件、查伏笔状态这类顺手小事主编自己 glob/grep 就办，不绕委派。
• novel/ 文件数据库：角色卡、世界观、科学设定三色标注、关系图、伏笔账本、时间线、叙事记忆、线索板、拍板账，全部是 grep 友好的平键/顶层数组 YAML——人可直接改，git 可版本化，无迁移无运维。
• 七阶段工作流：idea 选题 → setting 设定 → outline 大纲 → writing 写作 → review 审阅 → consistency 一致性 → export 导出。阶段记在 project.yml 的 phase 键，每完成一个里程碑主编推进并简报；推进有完成判据（核心设定落盘、分卷规划与目标章大纲在案才进 writing），不满足就回上一阶段补齐。
• Writing 六步法：衔接检查 → 出大纲 → 写正文 → 审稿 → 修改 → 定稿维护，逐章循环；配合 Collab 四步共创（设定共创 → 分卷规划 → 黄金三章 → 交接循环）把新书从零带到滚动更新；设定一览与分卷规划各设一个用户拍板点，前三章在设定齐备前不开工。
• 伏笔状态机：planted（埋设）→ progressing（推进）→ resolved（回收）/ abandoned（弃用），埋设与回收记章节号、预期回收章节排期、优先级分档——长篇不断线，活跃伏笔超 15 条主编主动提醒清理。
• 上下文按需取：主编先读 index.yml 概览，写到哪章读哪章（前章结尾约 1500 字 + 该章大纲 + 出场角色卡 + 活跃伏笔节选），不把整本书塞进上下文。
• 工具面收窄：主编只见「角色委派 + 内部检索 + 协调」白名单，帮手各带本行工具（审校只读、考据只带联网+落笔记）；每次请求的工具开销与上下文占用随之下降。
• 素材考据：research 帮手联网检索历史/地理/专业领域素材，笔记落 novel/research/，区分史实/通说/演义并附来源——DSH 架构的红利。
• 创作台面板：DSH 侧栏一键打开的可视化创作台——默认中栏全页面板，也可按「打开方式」设置整体搬进右侧栏（分栏：创作台中栏 + 文章页右侧栏 tab / 中间栏 / 右侧栏三选一，宿主 0.2.x 支持右侧栏）——概览（含书稿元信息编辑与分卷规划）/章节/角色/伏笔/关系图/时间线/设定/写作风格/索引板九个 tab；章节整页阅读（章纲对照 + 正文/章纲编辑保存 + 五维 + 状态流转）、project.yml 表单化编辑、写作风格查看与编辑（缺失时用默认基线创建）、账本与实体卡的人工编辑写面（编辑/新建/删除，带结构校验与确认弹层）、顶栏字号六档缩放、界面语言中文/English 可切与自动新版检测。
• CLI 兜底：maoying init / stats / index / export / brief / check 六条零依赖命令管脚手架、统计、索引重建、导出、写作卡打包与静态体检。

快速开始

前置：Node.js ≥ 18、已装好的 DSH host（0.1.7+，见「兼容面」）。

官方插件通道——一条命令，装完重启即用：

dsh plugin --profile web add dsh-maoying

重启 DSH（dsh web）：插件启动时自动把预设装进 ~/.dsh/.agent-presets/maoying/，并写好声明行托管块，无需再点任何按钮。托管块写入层自动选择：桌面/服务器默认写 home 级 ~/.dsh/cordis.patch.yml；Android compat 壳环境（该壳每次启动会把 home 级 patch 重写坏）自动改写 profile 级 ~/.dsh/profiles/<name>/cordis.patch.yml——壳不碰 profile 层，插件每次启动补写自愈，并顺手清掉 home 级遗留托管块防双声明；也可用环境变量 DSH_MAOYING_PATCH_LAYER=home|profile 强制指定。新会话的预设选择器里选「毛颖创作 (Maoying)」即可开写；要设为默认，在 Settings → Agent Presets 里选。

开发检出（想改插件或预设源码）用 link 形态直连仓库，改动经重启生效：

git clone https://github.com/lifangjin/dsh-maoying.git
dsh plugin --profile web add link:"$PWD/dsh-maoying"

只要命令行工具、不装插件的读者：零依赖 CLI 单独可用，npx 即跑，或装成全局命令（均为 npm 通道，与插件互不相干）：

npx maoying init                 # 免安装直接跑
npm install -g dsh-maoying       # 或装成全局 maoying 命令

怎么用

选好预设后，对主编说话即可，它按工作流自己路由：

开新书（Collab 四步共创）：

我想写一本东方玄幻，主角靠「听懂器物说话」的金手指鉴宝升级。

主编与你逐项对齐设定（题材、金手指、基调、主角三要素、对抗主线），设定管理员落盘核心角色卡与世界观条目后交你拍板；大纲师出分卷规划再交你拍板——设定与分卷都定了，才动笔黄金三章（立世界钩子、立主角动机、立核心冲突）交付。

逐章写作（Writing 六步法）：

第三章可以开写了吗？

主编做衔接检查，委派大纲师出本章大纲（含五维叙事字段），过目后派写手写正文、审校审稿（清单 + 一致性扫描：冲突/时间线/伏笔/设定 + 连贯六维：行为/因果/资源/身份/伤势/战力），有问题回写手修，通过后由设定管理员一次跑完定稿维护（章纲对照 + 五本账 + index 重建 + 一致性核对，全部落盘才置 accepted）——你只需要在决策点拍板。

集中审查：

前 20 章做一次一致性检查。

主编推进 phase 到 consistency，审校扫描冲突/时间线/伏笔/设定与连贯六维（行为/因果/资源/身份/伤势/战力），问题按严重度排好交回写手。

用户回「ok / 可以 / 继续」即视为确认，主编直接推进，不复述确认。

创作台面板

DSH 左侧栏底部点「毛颖创作台」打开创作台（改文件、跑流程之外，给肉眼看的驾驶舱）。打开方式在面板系统设置里三选一（立即记忆，对下一次打开生效）：

• 分栏（默认）：创作台在中栏全页，点章节/最近更新开文章页右侧栏 tab——阅读/编辑与创作台同屏对照；
• 中间栏：两者都在中栏（0.1.25 及以前的唯一形态）；
• 右侧栏：两者都在右侧栏 tab（需 DSH 0.2.x；0.1.x 宿主设置里右栏两项置灰，一切按中间栏走）。

右侧栏 tab 切走/切会话/收栏都不卸载（草稿保活），重新打开即拉最新内容；文章页换章会重挂编辑器，30 秒自动保存窗口内的未存稿不保留。中栏形态行为不变：

• 章节：状态筛选 + 按单写作清单；点章节进整页阅读——返回按钮、章纲对照（Markdown 渲染）、正文与章纲就地编辑保存（正文 textarea 自动保存——待写空章节与写作中（status=writing）章节打开即直接进编辑器、约 30 秒防抖落盘、手动/自动保存都停留在编辑态续写、回车换行自动加段首两个全角空格缩进、编辑栏实时显示正文字数（不含标点/含标点双口径）、章节标题可在编辑器顶部修改（与正文一次原子保存）、编辑器带行号（逻辑行号、随软换行对齐）、编辑器字号可缩放（A−/A+，localStorage 记忆）、编辑器字体可选（下拉：系统默认+黑体/宋体/楷体/仿宋/霞鹜文楷，阅读与编辑同源生效，localStorage 记忆）、可全屏编辑（Esc 退出）、阅读模式一键返回只读（脏稿先确认）；章纲 textarea 手动保存；文件在编辑期间被外部改过时拒绝保存并放回磁盘最新内容，不覆盖人工改动）、五维叙事字段、一键状态流转。
• 概览：书稿卡右上「编辑」按钮展开 project.yml 的书名/作者/题材/篇幅/语言/工作流阶段/共创模式/简介表单化编辑（原「小说设置」tab 并入），保存保留文件里原有注释；表单载入后 project.yml 被外部（作者手改 / agent 推进阶段）改过时拒绝保存并提示重改，不覆盖人工改动。概览另设「分卷规划」卡，列出 volumes.yml 各卷定位与计划章节范围——拍板过的分卷有处可查，卡头「编辑源文件」可整文件编辑 volumes.yml。
• 受管文件写面：角色/设定/科学设定卡与六本账本（关系/时间线/记忆/线索板/伏笔/分卷）均可从面板编辑源文件——墙头「新建」、卡详情「编辑源文件/删除文件」、各账本卡头「编辑源文件」（时间线/关系图空态也给入口）；保存时结构校验（账本须是条目数组、实体卡须带 frontmatter 围栏，不合即拒存），外部改动保护与正文编辑同口径；章节阅读页可新建章纲（本章目标/节拍/出场角色/需埋需收伏笔/与前章接口五件骨架预填）、删除章纲与删除章节——删除均确认弹层，不可逆，后悔靠 git，静态体检会把孤儿引用标出来。
• 顶栏：当前版本号常驻；npm 上有新版时亮「有新版 ↗」徽章直连发布页，旁边「一键升级」按钮直接用 pnpm 把最新包装进当前 DSH 档（仅支持 profile 目录安装，pnpm 缺失时自动回落 corepack；检测到全局 maoying CLI 时顺带以同一精确版本更新，未装则跳过；装完需重启 DeepSeek 才生效）；「检测更新」按钮只在无新版时显示（有新版时收起，让位给徽章与「一键升级」），点击手动现测线上最新版（绕过 1h 缓存——面板打开时只自动拉一次，页面开久了也不聋）；版本区后的齿轮打开系统设置，界面语言中文/English 可切、字号六档（100%–150%）整体缩放、打开方式三选一（分栏/中间栏/右侧栏），均立即生效并记忆。

面板写状态（章节状态、project.yml、index.yml 重建），正文/章纲/账本/实体卡等全部人工编辑入口只给人用（hash 旧版检测 + 结构校验，外部改动一律拒绝覆盖）——agent 的创作边界不变：共创模式下正文永远归作者与主编。

共创模式（作者亲笔）

不是谁都想让 AI 代笔。project.yml 的 mode 键决定正文归谁写，三种模式一句话：ai-draft（默认）AI 代笔，走 Writing 六步法；co-write 逐章指派谁写，主编动笔前先问清本章归谁；author-draft 全书作者亲笔，毛颖只备料、审稿、记账，永不代写。

author-draft 下的协作循环——你只管写，交稿即接管杂务：

第 5 章写完了，贴给你。（正文直接粘进对话，或者说一声第 X 章写完、指个文件）

主编收稿后你会拿到三样东西：审校意见清单（只挑问题、不代改，改不改随你）、账本回填（伏笔/时间线/关系/记忆/线索五本账按你正文实际发生的记，计划外的改动也能认领，来源标 backfill）、下一章章纲（novel/outlines/vXX-cXXX.md，拿着就能写）。圣域纪律：chapters/ 正文唯作者可改，agent 至多更新 frontmatter 的 summary 与五维字段，且先建议后动手。

配套命令：maoying brief <dir> <章号> 打包写作卡（章纲 + 前章结尾 + 角色卡 + 活跃伏笔，带去任意编辑器或其他 AI），maoying check <dir> 做零模型静态体检（frontmatter 完整性、伏笔章号引用与超期、章纲钩子小节、时间线乱序、AI 味统计（句式重复/比喻密度/句长节奏）、拍板账校验等，不调模型——LLM 审校走主编）。

方法论技能

随插件带 6 个网文方法论技能，插件启动时安装器把它们落盘到 ~/.dsh/skills/（即 <home>/skills/）下的 maoying-* 六个目录，宿主技能面板可直接看到；大纲师、写手、审校、设定管理员按场景自动加载，你不用手动操作：

技能 · 一句话说明

maoying-golden-opening · 黄金三章：开篇四型选型、前三章职能分工（世界钩子 → 动机确立 → 冲突引爆）、对抗格局聚焦与金手指原则、前 300 字出事原则、信息释放纪律与自检清单

maoying-beat-pacing · 爽点节奏：即时正反馈环、期待感管理、爽点类型库与打脸节拍配比、压抑-释放配比、三级节奏曲线与章尾钩子

…(truncated)