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