前言¶
长篇网文写到几百章后，常见的问题不只是“能不能生成一段情节”，而是设定是否还在、伏笔是否还记得、大纲是否被守住、欠读者的兑现有没有被跟踪。dsh-tool-writing 是面向 DeepSeek Harness（DSH）的长篇网络小说写文引擎插件，把这类问题拆成工具调用、台账记录、审查关卡和检索流程。
下面介绍它解决什么问题、提供哪些已核实能力，以及如何安装和启用。
这是什么¶
dsh-tool-writing 的维护者是 x2802490130-prog，许可证为 MIT。
它的一句话定位是：一套把“长篇一致性”做成工程的长篇网文创作系统——写到几百章，依然记得住设定、接得住伏笔、守得住大纲；每章写完，事实自动入账，欠读者的账自动记账。
它面向 DSH 提供长篇网络小说写作能力，并使用独立 DeepSeek key 承担子线程、分流、多线并行的生成与检索任务。插件提供 novel_* 工具集，README 标注为 48 个工具。
核心能力¶
多书隔离¶
插件按“一个工作区 = 一本书”组织项目，并按会话绑定工作区。这样可以在同一个宿主环境里维护多本书，减少项目状态相互干扰的问题。
独立 key 与任务分流¶
插件使用独立于主 Agent 的 DeepSeek key，用于承担子线程、分流、多线并行的生成与检索任务。
已核实的 key 配置包括：
- 主 key：
DSH_WRITING_API_KEY，必配。 - 起草通道：
DSH_WRITING_DRAFT_KEY，可选，回退主 key。 - 润色通道：
DSH_WRITING_POLISH_KEY，可选，回退主 key。 - 同步/深任务通道：
DSH_WRITING_SYNC_KEY，可选，回退主 key。
凭据全部来自宿主环境变量注入，代码内无硬编码密钥。
弹性合同体系¶
已核实的弹性合同体系包括：
- 故事承诺书
- 正典台账
- 五段写作任务书
- 硬关卡
这套体系的目标是把“全书承诺、已写事实、写作任务、写后检查”拆成可执行步骤，而不是只靠一次性提示词维持长篇一致性。
章后体检与发书审查¶
已核实的审查能力包括：
- 章后八项体检，包括节奏信号与 AI 味检查。
- 起点与番茄双平台审稿。
- 发书前敏感自查。
检索与书库¶
已核实的检索与书库能力包括：
- 语义检索
- 纯概念向量检索
- 概念索引构建
- 饲料区书库管理：导入、列表、读取、删除、检索与拆解
语义检索使用 DeepSeek 概念索引，无需第三方 embedding key；如显式配置有效 embedApiKey，仍可用稠密向量。
安装与启用¶
1、安装插件¶
先执行插件安装命令：
dsh plugin --profile web add dsh-tool-writing
安装完成后，需要重启 harness。
2、挂载到写作预设¶
在写作预设的 agent.cordis.yml 中挂载插件。以下代码块列出已核实的配置键，具体模型和并发数按实际环境填写：
- id: tool-writing
name: 'dsh-tool-writing'
config:
apiKeyEnv: DSH_WRITING_API_KEY
model: <填写可用模型>
deepModel: <填写可用模型>
maxConcurrency: <填写并发数>
这一步的目的是让写作会话可以调用 dsh-tool-writing 提供的 novel_* 工具。
3、配置 DeepSeek key¶
主 key 必配：
DSH_WRITING_API_KEY=...
可选拆分通道 key：
DSH_WRITING_DRAFT_KEY=...
DSH_WRITING_POLISH_KEY=...
DSH_WRITING_SYNC_KEY=...
可选 key 未配置时回退主 key。
4、验证安装¶
进入写作会话后，发送：
novel_status
该工具用于验证安装是否成功。
典型用法¶
开一本书¶
基本流程如下：
- 新建工作区。一个工作区对应一本书。
- 通过
novel_brief引导开书。 - 使用
novel_init建骨架。 - 使用
novel_outline搭大纲。 - 使用
novel_lore建设定。 - 使用
novel_draft写第一章。
连载维护¶
每章写完后，可以做如下编排：
- 执行
novel_sync自动编排。 - 定期执行
novel_audit八项体检。 - 执行
novel_ledger scan追读力。
发书前审查¶
发书前可以使用：
novel_market进行起点与番茄双平台审稿。novel_censor进行敏感自查。
检索与书库¶
可以使用插件提供的语义检索、纯概念向量检索与概念索引构建能力，对当前项目和饲料区书库进行检索。饲料区书库支持导入、列表、读取、删除、检索与拆解。
环境与依赖¶
package.json 声明的依赖环境如下：
{
"engines": {
"node": ">=22.5.0"
},
"peerDependencies": {
"@deepseek-ai/cordis": "^4.0.1",
"@deepseek-ai/dsh-tools": "^0.1.0-rc.6",
"@deepseek-ai/schemastery": "^3.18.1"
}
}
适用场景与注意¶
适合的使用场景：
- 需要在 DSH 中写长篇网络小说。
- 需要同时维护多本书，并要求工作区隔离。
- 需要把设定、伏笔、大纲、欠账纳入工具化流程。
- 需要在发书前做平台审稿与敏感自查。
- 需要导入现有书库并做检索或拆解。
使用前注意：
- 插件会以当前 DSH 进程权限运行其代码，安装前应检查源码与许可证。
- 插件需要独立于主 Agent 的 DeepSeek key，主 key 必配，其他通道 key 可选且回退主 key。
- 仓库
.gitignore排除所有项目数据文件，内容不上传，饲料由插件用户自备。 - 代码内无硬编码密钥，凭据全部来自宿主环境变量注入。
- 语义检索默认使用 DeepSeek 概念索引，无需第三方 embedding key；如显式配置有效
embedApiKey，仍可用稠密向量。 - 许可证为 MIT。
资源¶
GitHub 仓库：
https://github.com/x2802490130-prog/dsh-tool-writing
当前已核实资料未提供目录页 URL，本文不给出未核实的目录页链接。
