dsh-docs-mode
文书模式（docs-mode）Agent preset 安装器：把技术文档撰写模式（含模板知识库、去 AI 味、质量保障工具集）部署到 DSH 用户 preset 根
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:zh851233/docs-mode#c2c17d6cdf0c097c9007a1e48da2b3b4c860e3b6Docs Mode 以 dsh-docs-mode 发布，当前版本为 1.0.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →DeepSeek Harness（DSH）技术文档撰写 Agent preset（模式）安装包，可通过 dsh plugin add 一键安装。
一个自包含的 DSH agent preset，将 Agent 变成「技术文档撰写专员」，覆盖 11+ 类技术文书（每类内置骨架 + 风格卡，无模板时自动套用；用户传入模板时现场学习并存入自学习模板库）：
| 类别 | 内置模板 | 主要面向 |
|---|---|---|
| 开发概要说明书 | ✅ | 系统设计、软著申报配套 |
| 使用说明书 | ✅ | 最终用户操作手册 |
| 汇报/总结材料 | ✅ | 阶段汇报、项目总结 |
| 接口/API 文档 | ✅ | 对接开发者的接口契约 |
| 技术评审稿 | ✅ | 方案/设计评审 |
| 需求规格说明书 | ✅ | 产品需求（SRS） |
| 项目计划书 | ✅ | 里程碑、分工、风险 |
| 测试报告 | ✅ | 功能/性能/回归测试 |
| 部署运维手册 | ✅ | 安装、配置、升级、故障 |
| 周报/会议纪要 | ✅ | 轻量汇报与会议记录 |
| 软著申请说明书 | ✅ | 软著使用说明书 + 开发概要 |
| 英文技术文档 | ✅ | 英文通用骨架（README/Spec/API） |
模式内置先调研再动笔的工作准则（read/grep/glob/shell 核实项目真实信息，严禁编造细节），并随包携带三个技能：
| 技能 | 作用 |
|---|---|
doc-template-learning | 模板驱动写作：四维拆解 + 模板存档与共识提炼（自主学习）+ 修改反馈学习 + 整套文档批量生成 + 多语言路径 |
tech-doc-deai | 技术文档去 AI 味：按高危句式库精准改造（只改命中句），方向是更准确、更简洁、术语统一，严禁口语化；完整规范见 tech-doc-deai.md |
doc-quality | 文档质量保障：量化体检（AI味指数/编号/引号/空话/术语）、多文档口径交叉校验、编号重排、版本同步检查、PDF 导出、软著源代码文档、界面截图自动化 |
docs-mode/
├── package.json # dsh.bundle 声明（插件市场可安装）
├── cordis.patch.yml # 注册 docs-mode-installer 插件行
├── lib/index.js # 安装器：把 preset 部署到 ~/.dsh/.agent-presets/docs/
├── preset/ # 文书模式本体（拷贝到 .agent-presets/docs/ 即用）
│ ├── agent.cordis.yml # 模式组合（persona + 工具集 + skill 注册）
│ ├── preset.yml # 模式元数据（显示名、描述）
│ ├── skills/
│ │ ├── doc-template-learning/SKILL.md
│ │ ├── tech-doc-deai/SKILL.md + tech-doc-deai.md
│ │ └── doc-quality/SKILL.md # 质量保障工作流
│ └── assets/
│ ├── docx-tools/ # Markdown⇄Word 转换与校验
│ ├── doc-tools/ # 质量保障脚本：体检/一致性/重排/同步/PDF/软著源码
│ ├── screenshot-tools/ # Playwright 界面截图自动化
│ └── templates/ # 内置模板库 11 类 + 英文通用骨架
├── tech-doc-deai.md # 规范文档副本（便于单独查阅）
└── docs-mode-plugin.zip # 手动安装用的分发包
用户传入的模板会自动存档到 ~/.dsh/template-library/<类别>/（用户级，跨项目），每类满 3 份自动交叉提炼「共识-骨架.md + 共识-风格卡.md」，每类上限 10 份（超出淘汰最旧）。
无模板写作时按三层优先级选模板：工作区 docs/style-cards/（用户确认版）→ ~/.dsh/template-library/（自学习共识版）→ 本包 assets/templates/（内置出厂版）。
方式一：插件市场/直接安装（推荐）
dsh plugin add https://github.com/zh851233/docs-mode
安装器会把 preset 内容（preset/ 目录）部署到 ~/.dsh/.agent-presets/docs/，然后重启 DSH，模式选择器即出现「文书模式」。已存在时不覆盖（如需强制覆盖：DSH_DOCS_MODE_FORCE=1 dsh plugin add ...）。
方式二：手动拷贝
preset/ 目录内容拷贝到 DSH 用户 preset 根：
%USERPROFILE%\.dsh\.agent-presets\docs\~/.dsh/.agent-presets/docs/本包已通过
agentPresets.standingKeyFor挂载校验（mounted OK）。
doc-template-learning，四维拆解后先出大纲、确认后才撰写（硬性 gate），并把骨架/风格卡保存到工作区 docs/style-cards/ 供复用。tech-doc-deai 按规范改写（数字、版本号、命令原样保留）。doc-quality），配套文档自动交叉校验口径，主文档更新自动检出需同步章节。assets/docx-tools/，PDF 走 md_to_html + html_to_pdf，软著源代码用 make_source_docx 50 行/页）。skills/tech-doc-deai/tech-doc-deai.md（技能会参考它）。agent.cordis.yml（参考部署自带 standard preset 的结构）。customSkillDirs 随包注册三个技能（cordis 同款官方机制）。