长文写作工坊 tea-whale/dsh-writing-studio

dsh-writing-studio

DeepSeek Harness (DSH) 写作工具插件：把长篇写作变成一条可续写、可审校、可汇编的流水线。

一个零运行时依赖的 DSH 工具型插件：注册 writing_ 工具族，提供长文工作流、风格控制、常用写作模板。文字由模型生成，插件负责把项目状态可靠地落盘——上下文压缩、会话中断、换台电脑都能接着写。

能力

| 能力 | 说明 |
| 长文工作流 | 建项目 → 定大纲 → 逐节起草 → 逐节审校 → 汇编成稿 |
| 风格控制 | 文体 / 语气 / 读者 / 语言 / 视角 / 全篇与每节目标字数 / 自定义约束 |
| 常用模板 | 公众号文章、技术博客、周报、小说章节、小红书笔记、演讲稿、调研报告、使用教程 |
| 持久化 | 每个项目一个 JSON（大纲、草稿、审校记录、历史），成稿输出 markdown |

安装

从本仓库安装（当前方式）

git clone https://github.com/tea-whale/dsh-writing-studio.git
cd dsh-writing-studio
dsh plugin --profile web add link:$(pwd)

PowerShell（Windows）：

dsh plugin --profile web add link:D:\path\to\dsh-writing-studio

装完重启 dsh web。验证：

dsh --profile web --dump-config
应能看到 id: writing-studio 的行

卸载：

dsh plugin --profile web remove dsh-writing-studio

计划发布 npm 后，安装将简化为：
dsh plugin --profile web add <包名>

用法

重启后在 dsh web 里新开会话，直接说：

用写作工具帮我写一篇「DeepSeek Harness 插件入门」技术博客，目标 3000 字，读者是会写代码的开发者。

模型会自动走：writing_templates 选模板 → writing_project_create 建项目 → 逐节 writing_section_save 起草 → writing_section_review 审校 → writing_assemble 汇编成稿。

也可以在关键节点直接下指令：

writing_status 看一下进度第 2 节重写，语气再轻松一点，先 writing_section_read 再 writing_section_save 全文审校一遍，每节用 writing_section_review，最后 writing_assemble

工具一览

| 工具 | 作用 |
| writing_templates | 列出 8 套模板及其默认大纲、风格、写作提示 |
| writing_project_create | 用标题 + 模板创建项目 |
| writing_project_open | 打开已有项目，恢复完整状态 |
| writing_projects_list | 列出工作目录下全部项目与进度 |
| writing_status | 查看当前项目状态与下一步建议 |
| writing_style_set | 查看 / 修改风格参数与字数目标 |
| writing_outline_set | 替换大纲与主旨；默认按位置保留已有草稿 |
| writing_section_save | 保存一节草稿（写一节存一节） |
| writing_section_read | 取回一节草稿与写作目标（续写用） |
| writing_section_review | 记录审校意见 / 问题清单 / 修订稿 / 定稿 |
| writing_assemble | 汇编成带 front matter 的完整 markdown 成稿 |

存储布局

默认在每个会话工作目录下：

<工作目录>/ └── .writing-studio/ ├── projects/ │ └── <项目名>.json # 风格、大纲、各节草稿、审校记录、历史 └── manuscripts/ └── <项目名>.md # 汇编后的成稿

项目文件是普通 JSON，可提交进 git、拷走或手动编辑。默认用会话的 header.cwd；工具参数 working_dir 可指定其它目录；插件行 config.rootDir 可改默认目录名（默认 .writing-studio），config.storageRoot 可指定一个绝对路径作为存储根，优先级高于 rootDir。

自定义模板与风格

所有写作规则都集中在 templates.js：

- STYLE_ENUMS：语气 / 读者 / 语言 / 视角的可选项；
- TEMPLATES：每套模板的 key、name、默认风格、章节大纲（title + goal）与写作提示。

复制一个模板整块并修改 key / name / outline / defaultStyle / tips 即可新增模板，无需改其它代码。临时要求也可以直接在对话里让模型用 writing_style_set 写进项目的 extra 约束。

开发

dsh-writing-studio
├── index.js # 插件入口：name / inject / apply + 11 个工具 ├── store.js # 项目读写、状态机、字数统计、路径安全、原子写入 ├── templates.js # 8 套模板 + 风格枚举/校验 ├── cordis.patch.yml # bundle 补丁：把插件行 insert 进 profile ├── package.json # dsh.bundle.patch 声明与测试依赖 ├── .npmrc / package-lock.json # 测试依赖的安装配置（运行时零依赖） ├── CHANGELOG.md └── test/ ├── store.test.mjs # 存储层单元测试 ├── regression.test.mjs # 已修缺陷的回归测试（并发、越界、状态回退…）
└── schema-check.mjs # 官方 schema 校验 + 端到端工作流模拟

插件运行时零依赖（只 import Node 内置模块），工具定义直接采用 DSH registry 的 JSON Schema 子集，避免本地 link: 挂载时 ESM 符号链接解析问题。测试依赖 @deepseek-ai/dsh-tools 用 harness 官方校验器验证全部工具定义。插件运行时要求 Node ≥ 20；测试脚本用 --experimental-test-isolation=none（Node 22 与 24 都认这个拼写，24 里的稳定名是 --test-isolation），CI 跑 22 与 24 两个版本。

npm install
npm test

已知限制

- 工具不调用模型：写作、修改、审校都由当前会话的模型完成，工具只做状态机与持久化，不消耗额外 API。
- 风格字段是「提示合同」而非自动风格检测；最终质量取决于模型。
- writing_assemble 默认覆盖 manuscripts/<项目名>.md，需要多版本时用 output 指定文件名。
- 插件全局注册；在 agent 预设显式裁剪全局工具的会话里，writing_ 同样会被裁掉。
- 同一工作目录存在多个项目时，省略 project 参数会报错要求显式指定（只有一个项目时仍自动选中），避免新会话/重启后改错稿子。
- 章节状态只进不退：保存草稿、记录审校意见都不会把 reviewed/done 打回；只有 writing_section_review({ decision: "revise" }) 会显式回退。
- 并发保护是「进程内锁 + 独占创建」：同一进程内的并发调用安全；两个进程同时写同一个项目文件仍可能后写覆盖先写。

生态

- deepseek-harness —— DSH 本体
- dsh-web-ui —— DSH Web GUI 插件与皮肤全家桶
- dshfind —— DSH 学习与分享社区

License

MIT © 2026 tea-whale