DeepSeek Harness 插件：mycodesite/dsh-rules（全局 + 項目兩級 Markdown 規則注入）

前言¶

DeepSeek Harness (DSH) 強調“一切皆插件”的擴展理念。在多項目協作中，開發者常需要在每個對話中重複粘貼相同的“項目規範”、“代碼風格”或“注意事項”作爲系統提示詞。mycodesite/dsh-rules（RuleBase）插件通過文件驅動的方式，將這些規矩固化，實現“一處編寫，處處生效”。

這是什麼¶

mycodesite/dsh-rules 是一個工作流插件。它支持全局和項目兩級 Markdown 規則文件，在每次對話開始或系統提示詞組裝時自動注入給 AI。規則文件以 .md 格式持久化，通過文件監聽機制實現即時生效，無需重啓 DSH。插件在 DSH 設置面板提供了可視化的規則管理界面。

核心功能¶

全局 + 項目兩級注入：全局規則（默認路徑 ~/.dsh/rules）管理所有項目共用的規範；項目規則（<cwd>/.dsh/rules）跟隨當前工作目錄（cwd），切換項目時自動應用對應規則。
文件監聽，即時生效：規則文件保存後立即被捕獲，下一次模型請求自動採用，無需重啓。
可視化規則管理：在 DSH 設置面板的“規則”區可直接增刪改查規則、一鍵刷新，操作結果即時可見。
運行時零依賴：插件僅對宿主依賴使用編譯期類型依賴（import type），轉譯後擦除。運行時不需要 node_modules，任意新環境均可直接運行。

安裝與啓用¶

本插件需要 DeepSeek Harness >= 0.1.5-rc.1 以及 Node.js >= 22.5。

# 通過 GitHub 源安裝
dsh plugin add github:mycodesite/dsh-rules

# 指定版本
dsh plugin add github:mycodesite/dsh-rules#v0.1.7

典型用法¶

編寫規則文件：在項目根目錄創建 .dsh/rules 目錄，或在全局 ~/.dsh/rules 下創建 .md 文件（文件名作爲規則 ID）。
配置規則：在 DSH 設置面板的“規則”區查看已識別的文件。如果未選中項目，請先開啓一個項目對話。
應用規則：切換到指定項目的對話中，全局規則與項目規則會自動組裝並注入到系統提示詞中。

適用場景與注意¶

注意同名風險：不要在插件市場更新本插件。npm 上存在同名項目，安裝該包會導致 DeepSeek Harness 無法啓動。請始終通過下文 GitHub 源或本地 tarball 安裝。
全局路徑：默認全局規則路徑爲 ~/.dsh/rules。若設置了環境變量 DSH_HOME，則規則跟隨該變量。
版本兼容：本插件適配了 DSH >= 0.1.5-rc.1 的 rpc.handle 兩參化與鑑權機制。

結語¶

RuleBase 讓 AI 助手成爲“懂你項目規矩的協作者”。通過文件驅動的規則注入，它消除了重複的口頭交代，將項目規範固化爲可管理的配置。詳細文檔與源碼請參考 GitHub 倉庫。