前言¶

在 DeepSeek Harness（DSH）里让智能体写 Word，常见做法是每次会话重复说明格式、禁用词和章节结构，模型也容易在未验收排版的情况下宣布完成。手工改 docx 时，LaTeX 公式、模板样式、表格错位等问题往往要到导出后才暴露。

下面介绍社区插件 dsh-word-master（维护者 wszw142857-beep，GitHub：wszw142857-beep/dsh-word-master）。它以 agent preset 形式提供一条带硬停与闸门的流水线：素材转换 → 规格冻结 → 逐节写作 → 质检门 → 审阅界面 → 渲染闸门 → 导出，并把写作偏好落盘、每轮注入。架构范式学习自 PPT Master（独立实现，MIT 许可）。插件在 SkillHub 目录分类为「工作流」，npm 包当前版本为 0.2.0。

这是什么¶

Word Master for DeepSeek Harness 是一套只在选中「Word Master」预设的会话里生效的工具与 skill：不占其他会话上下文。它解决的核心问题是：把「素材 → 规范 Word 文档」做成可续跑、可质检、可视觉验收的流程，而不是一次性长文生成。

与「只在对话里答应格式要求」相比，偏好写入本地库并在每次请求注入；与「结构对了但版式没验」相比，渲染后还有 PDF/PNG 与视觉判据；与「PDF 素材接不住」相比，word_convert 支持 PDF、Word、Excel、PPT、网页等转为 Markdown 再进入后续步骤。

核心功能¶

流水线阶段¶

README 中的阶段顺序如下（⓪ 为建项与素材，①–⑨ 为环境与交付）：

⓪ word_project  建项目 + 收素材
⓪b word_convert 素材转 Markdown
① word_env      体检（Python / python-docx / lxml / LibreOffice）
② word_pref     偏好核对（read / set / memory_text）
   word_template 套模板（可选）
③ word_spec     规格冻结 ← 硬停，等用户确认
④ 写 draft.md   逐节写，遵守已注入的偏好
⑤ word_build    构建 docx
⑥ word_gate     质检门 ← 硬停，P0 阻断交付
⑦ word_review   HTML 审阅界面 ← 硬停，等用户逐段设决定
⑧ word_render   渲染闸门 + word_visual 视觉判据
⑨ word_export   导出 DOCX / PDF

两个硬停点需要单独记住：规格冻结前禁止写正文；质检 P0 未清（退出码 3）不能进入审阅，需改到 0 或 4。

工具一览¶

跨会话续做时，可先跑 word_project validate：推断阶段（empty→draft→frozen→built→reviewed→delivered），并检查如 gate-p0、stale-gate、spec-not-frozen 等漏步。

偏好记忆¶

本地偏好库路径为 $DSH_HOME/word-master/preferences.json，是唯一事实来源；每轮通过系统提示词小节注入，不依赖模型「想起来」。用户说「以后都用小四」之类要求时，必须用 word_pref 的 set 落盘，仅在对话里答应无效。memory_text 可把偏好渲染成可交给 mnemon_remember 的文本，用于跨机器档案，与每轮注入分工明确。

审阅界面（word_review）¶

本地 HTML 分栏：左侧改 draft.md 正文并逐段设处理方式；右侧展示质检发现、已记录决定与全局补充。决定写入 review-notes.json（schemaVersion 2），交接看 review-result.json。审阅服务器有文件锁、端口避让（5070 起）、空闲超时（默认 1800 秒）；用完须 word_review action=stop 优雅关闭。

环境与实现要点¶

• Node：>=22（package.json engines）
• Python：3.10+（README badge）；依赖含 python-docx、lxml、LibreOffice 等，由 word_env 体检
• 公式：Markdown 中的 LaTeX 可转为 Word 原生公式；构建时注意中文字体 w:eastAsia、标题样式等（README「实现笔记」中有说明）

安装与启用¶

DSH 生态里插件通过 profile 安装；社区目录页见 SkillHub：dsh-word-master（独立站点，与 DeepSeek / 幻方无官方从属关系）。

推荐从 npm 安装：

dsh plugin --profile <你的profile> add dsh-word-master

包地址：npm dsh-word-master。

本地调试可用 link（示例路径以 README 为准，按本机修改）：

dsh plugin --profile desktop add D:/dsh/plugins/dsh-word-master

装完后重启 DSH，新建会话时在预设选择器里选 「Word Master」；不选该预设的会话不受影响。

安装前建议自行查看 GitHub 源码与 MIT 许可证；插件以当前 DSH 进程权限运行，会读写项目目录、起本地审阅服务，并调用 Python / LibreOffice 等外部程序。

典型用法¶

1、安装并选预设¶

执行上述 dsh plugin add，重启后在 Word 相关任务里选用 Word Master 预设。

2、建项与环境¶

在 agent 引导下依次使用 word_project（init、收素材）、word_convert（如需）、word_env、word_pref / 可选 word_template。

3、冻结规格后再写正文¶

word_spec 完成 freeze 并确认后，再逐节维护 draft.md，然后 word_build。

4、质检与审阅¶

# 由 agent 调用 word_gate；P0 时退出码 3，需修复后重跑

通过门禁后启动 word_review，在界面中确认段落与全局意图，stop 服务后继续。

5、渲染与导出¶

word_render 与 word_visual 完成视觉验收后，word_export 导出 DOCX / PDF。

偏好变更示例（须在工具中执行，而非仅口头约定）：

word_pref { action: "set", patch: { formatting: { bodySizePt: 10.5 } } }

维护者提供的自检：

node verify.mjs

（在插件包根目录；50 项检查，含契约、schema、偏好一致性等。）

适用场景与注意¶

适合：需要 repeatable 的长文/报告/论文式 Word；有多源素材（含 PDF）；要单位模板样式；强调禁用词、章节结构、半角括号等硬规则；愿意在规格冻结与审阅硬停点人工确认的场景。

注意：

• 流程纪律靠 [!CAUTION] 与 BLOCKING 硬停，不是全自动状态机；跳过 freeze 或 gate 会导致后续返工范围变大。
• 改 draft.md 后若未重跑 word_gate，validate 可能报 stale-gate。
• 改 profile JSON 时 README 提醒：须用 Node 写回 UTF-8，避免 PowerShell 5.1 Set-Content -Encoding UTF8 写入 BOM 导致 Host 启动失败。

结尾¶

dsh-word-master 把「素材 → 规范 Word」拆成可验证的阶段，用 preset 隔离上下文、用偏好库与质检/渲染闸门约束交付质量。若要安装或读完整工具说明，可看目录页 SkillHub 与仓库 GitHub README。