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 倉庫：點此訪問