dsh-official-document-mode：DeepSeek Harness 公文模式插件

前言¶

DeepSeek Harness (DSH) 采用插件化架构，旨在将模型推理能力与交互界面解耦。在开发需要特定格式输出的智能体时，如公文撰写，开发者通常需要自行处理复杂的排版逻辑或通过系统提示词引导模型。此插件对标 codex-document-mode，解决了在 DSH 环境下如何将助手回复自动渲染为标准公文格式，并支持输入端圈阅反馈的问题。

插件概览¶

该插件由 ESxyzbil 维护，采用 MIT 许可证。它通过 host 端注入文风约束，配合 client 端的 DOM 渲染，实现公文的格式化输出与交互。

安装¶

通过桌面版 profile 安装：

dsh plugin --profile desktop add link:C:\Users\34983\dsh-plugins\dsh-official-document-mode

安装后需要重启 DSH Desktop 才能生效。

核心功能¶

插件主要包含以下三个核心能力：

公文格式渲染：开启后，助手回复的最终汇报会被渲染为标准公文版式，包含题头机关名与文号、红色分隔线、居中标题、称谓、正文（Markdown 原样）以及落款。工具调用与中间步骤不参与渲染。
圈阅反馈：输入区左侧新增 36px 画板。支持通过几何启发式算法识别画笔轨迹：闭合且圆度高的轨迹识别为“同意”（画圈），自相交或多笔交叉的轨迹识别为“不同意”（画叉）。识别成功后自动写入 【反馈：同意】 或 【反馈：不同意】 到草稿区。
配置管理：支持通过 cordis.patch.yml 或 API 配置文号、落款、文风等参数。

使用说明¶

启用与切换¶

安装并重启 DSH 后，输入区下方会出现“公文模式”按钮。点击即可切换总开关。
* 开启：host 端注册 systemPrompt 约束，client 端渲染公文框，显示画板。
* 关闭：移除 host 约束，取消渲染，隐藏画板。

配置参数¶

在 cordis.patch.yml 中可设置以下参数：

- id: dsh-official-document-mode
  name: dsh-official-document-mode
  config:
    enabled: true            # 公文模式总开关
    salutation: '尊敬的领导：'
    signature: 'DeepSeek 人工智能助手'
    orgName: 'DeepSeek Harness'
    titlePrefix: ''
    fileNo: ''
    styleConstraint: ''

语义区分（重要）¶

插件以“模式开启时刻”为界进行语义区分。
* 开启前产生的历史消息保持普通显示。
* 开启后产生的新回复才会套用公文框。
* 再次关闭后开启，以新的开启时刻重新为界。这避免了历史消息被“套框”。

技术细节与已知限制¶

热加载机制¶

根据实测（2026-08-22），DSH Desktop 对热加载的支持存在差异：
* Client 半侧：修改 lib/client.js 后，刷新页面即可生效。
* Host 半侧：修改 lib/index.js 或新增插件，必须重启 DSH Desktop 才能生效。桌面版 host 未支持免重启加载新插件。

已知限制¶

分段渲染：如果在一个回合内包含多次工具调用，助手可能会分段输出多份公文，每段均带有题头和落款，工具调用行保持原样。
标题提取：标题提取规则为首个标题行或“标题：”行，无标题时截断首句。
圈阅识别：识别基于轻量几何启发式，非机器学习。画圈/画叉的线条过小或几何特征不明显时可能无法触发。
运行权限：插件随 DSH 进程运行，安装前需检查源码与许可证。

总结¶

dsh-official-document-mode 为 DSH 提供了一套完整的公文处理解决方案，从生成到圈阅形成闭环。开发者可根据需求调整配置，利用其语义区分机制管理历史消息的显示状态。

插件目录：点此访问
GitHub 仓库：点此访问