DeepSeek Harness 插件：加載 Cursor / Gemini / Copilot 工作區規則

前言¶

DeepSeek Harness (DSH) 支持通過插件擴展系統。在實際開發中，開發者通常會在項目根目錄維護 .cursorrules、GEMINI.md 或 .github/copilot-instructions.md 等文件，以定義 AI 助手的行爲規範。DSH 默認不讀取這些文件，導致規則無法在 Harness 中生效。

本插件旨在解決這一割裂問題。它將 Cursor、Gemini CLI 和 GitHub Copilot 的現有工作區指令讀取併合並，統一注入到 DeepSeek Harness 的系統提示中。

插件介紹¶

名稱: youjiaqi421/dsh-plugin-workspace-rules
定位: 工作流插件
簡介: 將 Cursor、Gemini CLI 和 GitHub Copilot 的現有工作區指令加載到 DeepSeek Harness 中。

核心功能¶

文件讀取順序: 按照固定順序讀取文件：.cursorrules、GEMINI.md、.github/copilot-instructions.md。缺失或空文件會被忽略。
統一合併: 將讀取到的內容合併爲一個系統提示部分。
實時更新: 無需重啓 Harness，插件會在每次模型請求前重新讀取文件，確保規則變更即時生效。
語法保留: 保留 {{...}} 文本，不將其解析爲 Harness 的變量。
大小限制: 通過 maxFileBytes 和 maxTotalBytes 限制文件大小和總大小，防止提示詞過大導致問題。

安裝與啓用¶

插件尚未發佈到 npm，需要從 GitHub 安裝到指定 profile：

dsh plugin --profile web add github:youjiaqi421/dsh-plugin-workspace-rules

安裝過程中，如果遇到 pnpm 10+ 默認阻止 git 依賴構建腳本的問題，需要在 profile 的 pnpm-workspace.yaml 中添加配置：

allowBuilds:
  dsh-plugin-workspace-rules: true

添加後重復執行上述安裝命令。

配置與使用¶

安裝後插件無需額外配置即可工作。若需自定義路徑或限制，編輯 profile 的 cordis.patch.yml：

- id: workspace-rules
  config:
    root: .
    files:
      - .cursorrules
      - GEMINI.md
      - .github/copilot-instructions.md
      - docs/agent-rules.md
    maxFileBytes: 65536
    maxTotalBytes: 131072
    order: 20

配置說明：
- root: 起始目錄，相對於 dsh 啓動目錄。
- files: 需要讀取的文件列表。
- maxFileBytes: 單個文件最大字節數。
- maxTotalBytes: 所有文件合併後的總字節數上限。
- order: 插入的系統提示在提示詞鏈中的順序。

注意事項¶

環境要求:
- 需要安裝 Node.js ^22.19.0 或 >=24.0.0。
- 需要安裝 pnpm。
pnpm 10+ 行爲: 默認情況下，pnpm 10+ 會阻止 git 依賴的構建腳本，需要通過 allowBuilds 配置放行。
路徑解析: root 路徑必須是相對於 dsh 啓動目錄的相對路徑，且所有文件路徑必須在此根目錄內。
編碼處理: 文件必須爲有效的 UTF-8 編碼，文件開頭的字節順序標記 (BOM) 會被自動移除。
安全性: 插件會讀取項目根目錄下的文件。在安裝使用前，建議檢查源碼與許可證。

總結¶

該插件爲 DSH 提供了統一加載外部 AI 工具規則的能力。通過配置 cordis.patch.yml，可以靈活控制讀取的文件範圍和大小限制，幫助開發者在 Harness 中複用現有的工作流配置。

GitHub: https://github.com/youjiaqi421/dsh-plugin-workspace-rules
插件目錄: https://www.skillhub.cn/plugins/youjiaqi421/dsh-plugin-workspace-rules