DeepSeek Harness（DSH）的核心理念是“一切皆插件”。在利用大模型撰写技术文档时，常见痛点是内容可能存在事实偏差（幻觉）、术语不统一或“AI味”过重。docs-mode 是一个为解决这些问题而设计的 DSH agent preset，它将 Agent 定位为“技术文档撰写专员”，覆盖 11+ 类技术文书，内置了从调研到交付的全流程工具。
这是什么¶
这是一个自包含的 DSH agent preset。安装后，DSH 在该模式下将不再进行通用对话，而是转为执行技术文档的撰写任务。它内置了“先调研再动笔”的工作准则，强制模型核实项目真实信息，严禁编造细节。
支持的文书类型¶
该模式覆盖了从开发到交付的全生命周期文档，每类均内置骨架与风格卡：
| 类别 | 主要面向 |
|---|---|
| 开发概要说明书 | 系统设计、软著申报配套 |
| 使用说明书 | 最终用户操作手册 |
| 汇报/总结材料 | 阶段汇报、项目总结 |
| 接口/API 文档 | 对接开发者的接口契约 |
| 技术评审稿 | 方案/设计评审 |
| 需求规格说明书 (SRS) | 产品需求 |
| 项目计划书 | 里程碑、分工、风险 |
| 测试报告 | 功能/性能/回归测试 |
| 部署运维手册 | 安装、配置、升级、故障 |
| 周报/会议纪要 | 轻量汇报与会议记录 |
| 软著申请说明书 | 软著使用说明书 + 开发概要 |
| 英文技术文档 | 英文通用骨架 (README/Spec/API) |
核心功能¶
1. 模板驱动与自主学习¶
模式内置三种技能：
* doc-template-learning：负责模板驱动写作。当用户传入模板时，系统会先拆解骨架，确认大纲后才开始撰写，并将骨架/风格卡保存到工作区。用户自定义的模板会自动存档到 ~/.dsh/template-library/<类别>/，每类满 3 份会自动提炼“共识-骨架”与“共识-风格卡”。
* tech-doc-deai：负责去除“AI 味”。基于规范库改造高危句式，确保术语统一、准确、简洁，严禁口语化。
* doc-quality：负责质量保障。包含量化体检（AI 味指数/编号/引号/空话/术语）、多文档口径交叉校验、编号重排、版本同步检查、PDF 导出及界面截图自动化。
2. 无模板自主写作¶
当不提供模板时，模式会按三层优先级自动选型：
1. 工作区 docs/style-cards/（用户确认版）
2. ~/.dsh/template-library/（自学习共识版）
3. 本包 assets/templates/（内置出厂版）
3. 交付格式灵活¶
支持 Markdown、Word、PDF 三种格式。Word 交付使用 assets/docx-tools/，PDF 交付使用 md_to_html + html_to_pdf 链路，软著源代码文档支持按 50 行/页排版。
安装与启用¶
方式一：插件市场安装（推荐）¶
通过插件管理界面搜索 dsh-docs-mode 安装，或直接使用命令：
dsh plugin add dsh-docs-mode
方式二：从本地源码安装¶
需要将仓库克隆到本地，并使用绝对路径安装：
git clone https://github.com/zh851233/docs-mode
dsh plugin add /绝对路径/docs-mode
启用与配置说明¶
- 重启 DSH：安装完成后必须重启 DSH 才能加载新模式。
- 版本兼容性：DSH 0.2 起不再读取
$DSH_HOME/.agent-presets/<id>/目录，本插件采用cordis.patch.yml方式声明，无需手动拷贝文件。 - 旧版本兼容：1.x 版本的安装器（
lib/index.js）已废弃，仅供旧版 DSH 使用，不再随发行包发布。
典型用法¶
- 按模板写文书：将模板内容粘贴到对话中，或提供文件路径，指令“按这个模板写一份使用说明书”。系统会先出大纲确认，再撰写，并将确认后的模板保存。
- 无模板写作：直接指令“写一份技术评审稿”或“写一份测试报告”，系统自动匹配内置模板或自学习模板。
- 去除 AI 味：在交付前，系统会询问是否去除 AI 味，确认后自动应用
tech-doc-deai规范进行改造。 - 选择交付格式：交付前询问“导出为 Word”或“导出为 PDF”，系统自动处理转换。
注意事项¶
- 升级旧版本：如果你是从 1.x 升级，请务必清理旧的 preset 目录，否则在 DSH 0.2+ 中模式将无法加载：
# Windows
rmdir /s /q "%USERPROFILE%\.dsh\.agent-presets\docs"
# Linux/macOS
rm -rf ~/.dsh/.agent-presets/docs
- 权限与安全：插件以当前 DSH 进程权限运行，安装前建议检查源码与许可证（MIT）。
- 自定义：如需调整去 AI 味的力度或补充句式，可编辑
skills/tech-doc-deai/tech-doc-deai.md；如需修改人设，可编辑preset/agent.cordis.yml。
总结¶
docs-mode 通过模板库、去 AI 味工具链和质量保障流程，将 DSH 转变为一个可落地的技术文档专员。它适合需要批量生成规范文档、软著材料或技术评审稿的开发者与工程师。
- 项目地址：https://github.com/zh851233/docs-mode
- 插件目录：https://www.skillhub.cn/plugins/zh851233/docs-mode
