前言¶
DeepSeek Harness (DSH) 插件,由 NEVSTOP-LAB 维护。它的作用是把工作区自带的 VSCode/Copilot AI 配置加载进 DSH 会话,让同一份 .github 文件在 VSCode 和 DSH 里同时生效。默认就带当前用户的 ~/.copilot,也可以把工作区之外的若干配置目录一起带上,让一份共享规则喂给所有仓库。
核心功能¶
插件通过读取配置目录中的特定文件来注入上下文或注册技能:
- 常驻注入:读取
.github/copilot-instructions.md,作为仓库级指令常驻注入。 - 条件注入:读取
.github/instructions/**/*.instructions.md。如果没有applyTo前置元数据,则常驻注入;如果有,则只在当前会话与匹配文件交互后才会注入。applyTo语法与 VSCode 一致。 - 技能注册:读取
.github/skills/<name>/SKILL.md,将其注册为 DSH 技能。
配置与路径¶
插件只读取配置,不写工作区文件;唯一的写路径是 GUI 里那张改「额外配置目录」的页面,落点是 DSH 自己的 profile 配置(~/.dsh/profiles/<profile>/cordis.patch.yml)。
在插件页里改路径¶
在 Settings -> Plugins 中找到标题为「导入 Copilot 文件」的项。
- paths:工作区之外的配置目录,默认是
['~/.copilot']。路径可绝对、可相对会话 cwd,或以~开头表示用户主目录。删除该行并保存可关闭外部目录扫描。 - maxBytes:单次注入的字节预算(默认 65536),超出时会截断。
- scanSubdirectories:控制对 cwd 下
.github文件夹的扫描深度(默认 1)。
安装与启用¶
需要安装 DeepSeek Harness (DSH)。
- 安装插件:
dsh plugin --profile desktop add github:NEVSTOP-LAB/dsh-import-copilot-files
- 确认版本要求:需要 DSH >= 0.1.7。
- 重启 DSH:profile patch 层不热重载,安装后必须重启 DSH 才能生效。
注意事项¶
- 不热重载:安装插件后需要重启 DSH。修改工作区文件或
paths配置会即时生效,但修改插件自身源码需再次重启。 - 仅读工作区:插件只读取工作区文件。
- 兼容性:不再兼容 DSH 0.1.5 / 0.1.6。
结尾¶
本插件遵循 MIT 许可证。