前言¶
DeepSeek Harness(DSH)允許通過用戶級全局指令文件約束智能體行爲,默認路徑爲 $DSH_HOME/AGENTS.md(常見爲 ~/.dsh/AGENTS.md)。這類文件往往藏在用戶目錄深處,改一次需要先找到路徑、用外部編輯器打開,再確認當前會話是否讀到新內容。下面介紹 GrizzCoder 維護的客戶端插件 dsh-global-rules:把同一文件的管理收進 Web 端 Settings,在界面內完成查看與保存。
這是什麼¶
dsh-global-rules 是 DSH 的「全局規則」可視化編輯插件,分類屬客戶端(platform: "web")。它在設置面板增加 Global Rules 區塊,對接用戶級 AGENTS.md,避免手工翻找隱藏目錄。源碼與說明見 GitHub,社區目錄頁爲 SkillHub。當前 package.json 版本爲 0.1.0,許可證 MIT。
核心功能¶
依據項目 README,插件主要提供以下能力:
- 設置側欄集成:在 Settings 中增加 Global Rules 分區,風格與 DSH UI 一致。
- 路徑解析與「在文件夾中顯示」:自動解析
AGENTS.md的實際系統路徑;提供按鈕在 Windows 資源管理器、macOS Finder 或 Linux 文件管理器中高亮該文件。 - 編輯體驗:等寬字體編輯器,支持 Save / Cancel;支持一鍵撤銷;文件不存在時可自動創建。
- 生效方式:新會話立即應用新規則;當前會話在下一次文件系統類工具操作時檢測變更。
- 實現方式:基於 Connection Fetch 路由與原生 ModuleLoader,README 稱無額外第三方運行時依賴。
宿主側邏輯在 lib/index.js(文件 I/O 與文件管理器調用),客戶端 UI 在 lib/client.js,通過 cordis.patch.yml 聲明補丁。
安裝與啓用¶
官方推薦從 GitHub 安裝。在終端執行:
dsh plugin --profile desktop add github:GrizzCoder/dsh-global-rules
README 另提供本地開發安裝:克隆倉庫後對工作區路徑執行 dsh plugin --profile desktop add ./dsh-global-rules,適用於改插件源碼的場景。
安裝完成後刷新 Web 頁面,打開 Settings → Global rules 即可使用。
典型用法¶
- 按上一節命令完成安裝並刷新頁面。
- 進入 Settings → Global rules,在編輯器中修改全局指令內容。
- 使用 Save 寫入
$DSH_HOME/AGENTS.md;若改錯可用 Cancel 或一鍵撤銷。 - 需要覈對磁盤上的真實文件時,使用「在文件夾中顯示」打開系統文件管理器。
- 開啓新的 DSH 會話以立即使用新規則;若在原會話中測試,需在觸發下一次文件系統相關工具操作後再觀察是否已加載變更。
適用場景與注意¶
適合經常調整用戶級全局規則、又不想每次手動定位 ~/.dsh/AGENTS.md 的 DSH 桌面/Web 使用者。插件以當前 dsh 進程權限讀寫用戶目錄下的 AGENTS.md;安裝前建議瀏覽 倉庫源碼 與 MIT 許可證,確認符合你的安全與合規要求。
SkillHub 上的星標等信息會隨社區更新變化;功能與安裝步驟以倉庫 README 爲準。DSH 生態強調「一切皆插件」;SkillHub 爲社區目錄,與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-global-rules 把用戶級 AGENTS.md 的維護搬進 DSH 設置面板,補齊路徑展示、系統文件管理器跳轉和保存/撤銷流程。需要安裝命令與結構說明時,可直接查閱 GitHub 倉庫 或 SkillHub 目錄頁。