DeepSeek Harness (DSH) 是一個插件化的模型推理框架。在多 agent 場景下,統一控制每個 agent 的輸出格式(如代碼風格、文檔結構)是常見需求。dsh-output-styles 插件爲 DSH Web 添加了一個“輸出樣式”設置頁面,允許用戶預設或自定義樣式,並直接注入到 agent 的系統提示詞中。
核心功能¶
該插件爲 DSH Web 提供以下能力:
- 設置頁面:在
dsh web的設置對話框中新增“輸出樣式”頁面。 - 內置樣式:提供五種開箱即用的輸出風格:Default、Concise、Explanatory、Learning、Formal。
- 自定義樣式:支持通過 Markdown 指令創建命名的自定義樣式,可配置名稱和描述。
- 實時生效:選中的樣式會從“下一個模型步驟”開始進入所有 agent 的 system prompt,無需重啓服務。
- 持久化存儲:用戶定義的樣式會保存在配置文件中,重啓後依然生效。
- 文件支持:指令字段支持直接粘貼完整的樣式文件(例如 Claude Code 的輸出樣式或 Agent Skills 的 SKILL.md)。
安裝與啓用¶
插件通過 npm 包提供,安裝命令如下:
dsh plugin --profile web add @auggieteo/dsh-output-styles
安裝完成後,重啓 dsh web,在設置菜單中即可看到“輸出樣式”頁面。插件會自動將其 cordis.patch.yml 注入到 DSH 的層棧中,無需手動配置。
使用方法¶
- 打開設置 → 輸出樣式。
- 從列表中選擇一個內置樣式,或點擊“創建”按鈕。
- 在編輯模式下,修改樣式行的名稱、描述或指令內容。
- 點擊“保存”生效,點擊“取消”恢復原狀。
- 用戶自定義的樣式會持久化存儲在
~/.dsh/profiles/<profile>/cordis.patch.yml的output-styles配置項下。
注意事項¶
- 環境依賴:需要 Node.js 20+ 環境,且需要使用 DSH 的 Web profile(測試版本爲 0.2.0-rc.2)。
- 依賴關係:所有運行時依賴均由 DSH 提供,插件自身不打包 peer dependencies。
- Frontmatter 限制:指令字段雖然支持粘貼文件,但僅支持扁平的
key: value格式。只有 Name 和 Description 會被讀取,其他 key 被忽略。 - 僅會話安裝:插件支持在運行時動態定義(Session-only install),Agent 可以在當前 DSH 進程中通過工具注入此插件,無需文件層面的持久化部署。