前言¶
DeepSeek Harness (DSH) 通过插件机制扩展能力。dsh-ruankao-essay 是一个针对软考系统分析师论文的 DSH 插件，由 Zm886 维护。该插件将题库索引、写作规范与 Word 交付流程封装在一起，解决了手动写作时需要反复回忆题目结构、理论要点、字数要求和格式规范的问题。
插件提供三个核心技能和一个 Web 速查面板，支持从查题、写作、自评到生成 Word 文档的完整链路。
核心功能¶
插件主要包含以下能力：
- 题库索引与速查：提供 2016—2026 年真题索引、题型理论骨架及写作规格，支持在 Web UI 面板快速切换查看。
- 10 段式论文写作与规范：提供标准化的 10 段式结构、字数口径（含标点 2500~2800）、语气禁忌及子题目回应规则。
- 逐段自评与改写建议：通过
ruankao-essay-review技能提供机械项检查（段数/字数/禁写项）及逐条改写建议。 - Word 交付：提供 PowerShell 脚本，将 Markdown 格式的草稿转换为 Word 文档（.doc），并包含段落数与字数统计。
安装与启用¶
方式一：Web UI 安装（推荐）¶
在 DSH Web 侧边栏打开 Plugins（插件） → Add plugin（添加插件），在输入框粘贴本目录的绝对路径：
D:\project\deeepseek\dsh-plugins\dsh-ruankao-essay
DSH 支持通过绝对本地路径安装，无需联网。安装后，在会话中输入相关指令即可调用技能。
方式二：Agent 调用安装¶
Agent 需要插件管理器授权才能操作。可以通过 Agent 调用 plugin_manager 进行安装：
{ "action": "install_bundle", "target": "D:\\project\\deeepseek\\dsh-plugins\\dsh-ruankao-essay" }
方式三：技能目录安装¶
将插件的 assets 目录内容拷贝到 DSH 的技能根目录（如 D:\project\deeepseek\.dsh\skills 或用户目录下的 .dsh\skills），插件资源即可被自动发现。
使用示例¶
在会话中调用¶
在任意 DSH 会话中输入以下指令，Agent 会自动加载对应技能：
- 「写软考系分论文」
- 「这个论文题目怎么写」
生成 Word 文档¶
使用插件提供的脚本生成 Word 文档。脚本会剥掉 Markdown 粗体标记并统计真实字数：
& "<skill-directory>\scripts\make-essay-doc.ps1" -MdPath "D:\out\论微服务架构及其应用.md"
输出示例：
段落数: 10 含标点字数: 2534 纯汉字: 2116
已生成: D:\out\论微服务架构及其应用.doc
注意事项¶
- 环境依赖：插件依赖 Node.js 版本 >= 20。
- 重启生效：修改
index.js或client.js后，需要重启 DSH 才能加载新的模块代码。 - 脚本编码：
make-essay-doc.ps1等脚本必须保存为带 BOM 的 UTF-8 编码。在 Windows PowerShell 5.1 下，无 BOM 会导致中文被按 ANSI 误读，脚本无法正常运行。 - 权限限制：调用
plugin_manager需要 Agent 授权。 - 用途限制：本插件仅供个人备考使用，请勿将仓库内容用于商业用途。
结语¶
dsh-ruankao-essay 通过将软考论文的繁琐流程标准化，降低了手动写作的认知负担。对于需要频繁进行系统分析师论文备考的用户，该插件提供了一套从查题到交付的闭环解决方案。更多细节可查看插件目录或 GitHub 仓库。
