前言¶
DeepSeek Harness (DSH) 的開發者在配置智能體行爲時,通常需要在全局配置 (~/.dsh/AGENTS.md) 和項目特定規則之間切換。手動維護這些文件容易產生路徑錯誤或內容衝突。dsh-rule-manager 插件將全局規則編輯、項目規則編輯以及 LLM 自動拆分功能整合到了 Web UI 的「規則管理」入口中,提供了一個統一的操作界面,替代了分散的舊版插件。
功能說明¶
該插件包含以下三個核心功能:
-
全局規則編輯
在插件界面中直接編輯~/.dsh/AGENTS.md。修改保存後,新會話會立即生效;當前會話需在下次進行文件操作後感知變更。 -
項目規則編輯
通過界面選擇目標工作區,進而編輯該工作區根目錄或子目錄下的任意AGENTS.md文件。這比直接在文件系統操作更直觀,且便於跨項目管理。 -
LLM 自動拆分
將冗長的項目規則粘貼到界面中,LLM 會將其拆分爲「精簡總綱」以及按需加載的.dsh/skills/<主題>/SKILL.md。支持覆蓋或合併兩種模式,在確認寫入前會自動備份原文件並提供預覽。
安裝與啓用¶
通過 DSH 的插件命令安裝此插件:
dsh plugin --profile web add dsh-rule-manager
安裝完成後,重啓 dsh web 服務。
典型用法¶
- 打開瀏覽器中的 設置 → 規則管理。
- 根據需求切換三個標籤頁:
- 全局規則:編寫適用於所有項目的通用指令。
- 項目規則:選擇當前工作區,調整項目特定的約束條件。
- 自動拆分:粘貼複雜的項目規則,選擇模型,預覽拆分結果,確認寫入。
注意事項¶
- 升級兼容性:本插件合併了舊版
dsh-global-rules和dsh-rule-splitter的功能。若已安裝這兩個舊插件,需先卸載它們,再安裝本插件,以避免出現多個規則入口。 - 內容限制:單次操作規則內容上限爲 256 KiB,超時時間爲 180 秒。若規則過長,建議先精簡再試。
- 生效機制:插件依賴 DSH 內置的
dsh-agent-instructions進行動態檢測。保存後,新會話立即加載新規則,當前會話需等待下一次文件操作纔會刷新。 - 技術棧:插件採用零構建方案,Host 端爲純 Node ESM,Client 端爲手寫
__ModuleLoader__bundle。
結語¶
dsh-rule-manager 通過將文件系統操作與 LLM 能力結合,降低了 DSH 規則維護的門檻。若需查看源碼或提交問題,可訪問其 GitHub 倉庫 或 社區目錄。