dsh-import-copilot-files

DSH 插件：把一个工作区自带的 VSCode / Copilot 风格 AI 配置加载进每一个 DSH 会话， 同一份 .github 在 VSCode 和 DSH 里同时生效。也可以把工作区之外的若干配置目录一起带上， 让一份共享规则喂给所有仓库 —— 默认就带当前用户的 ~/.copilot（Copilot CLI 的家目录）。

插件只读取配置，不写工作区文件；唯一的写路径是 GUI 里那张改「额外配置目录」的页面， 落点是 DSH 自己的 profile 配置（~/.dsh/profiles/<profile>/cordis.patch.yml）。

功能

文件	行为
.github/copilot-instructions.md	常驻注入，等价 VSCode 的 repo-wide instructions
.github/instructions/**/*.instructions.md	按 frontmatter applyTo 生效：没有 applyTo 的常驻；有的只在本会话真的碰过匹配文件之后才注入
.github/skills/<name>/SKILL.md	注册为 DSH 技能：name + description 进技能目录，正文按需加载

applyTo 的语法与 VSCode 一致（**、*、?、{a,b}、[abc]、逗号分隔），相对该文件所属的 那个根匹配：cwd 侧是项目根，paths 条目侧是条目自身。SKILL.md 的 disable-model-invocation / user-invocable 与 DSH 原生技能同义，省略即允许，拼写非法会让该技能 被跳过并打一条警告。

扫描范围

会话 cwd 本身，加上它下面 scanSubdirectories 层（默认 1）的直接子目录，各取自己的 .github/ （.github/instructions/ 内部递归到深度 4）；不向上找祖先链。D:\NEVSTOP-LAB 这类「多 repo 工作 文件夹」因此成立：文件夹自身和它直接下面的每个 repo 各贡献自己的 .github，互不干扰。

paths 里的每个路径本身就是配置目录（等价于项目根的 .github，其下没有 .github）， 所以 scanSubdirectories 不作用于它。路径可绝对、可相对会话 cwd，或以 ~ 开头表示用户主目录 （只有开头那个 ~ 有此含义，~name 与 a/~/b 是普通相对路径；环境变量与通配符不展开）； 不存在的路径贡献为空。默认 ['~/.copilot']，在插件页里删掉那行并保存成 paths: [] 即可关闭。

AGENTS.md 不由本插件处理：它属于 DSH 核心的 dsh-agent-instructions，按 cwd 的祖先链读取。

在会话里看到什么

一条标题为「上下文注入」、来源标签为 import-copilot-files 的注入行，加上上述配置目录里 disable-model-invocation 不为 true 的技能。顺序固定为 AGENTS.md 在前；内容变化时追加 一条新注入，文件消失时先给一条 Instructions removed:。

配置

插件行在 cordis.patch.yml，config 字段：

字段	默认	含义
maxBytes	65536	单次注入的字节预算；超出时先省略、再截断，并说明丢了多少
scanSubdirectories	1	cwd 下当作项目根的下探层数（只作用于 cwd 的走查）
instructionDirs	['.github/instructions']	*.instructions.md 所在目录（相对配置目录；paths 条目去掉前导 .github）
skillDirs	['.github/skills']	<name>/SKILL.md 所在目录（同上）
paths	['~/.copilot']	工作区之外的配置目录，等价于项目根的 .github；条目以 ~ 开头表示用户主目录

在插件页里改路径

设置 → 插件 里标题为「导入 Copilot 文件」（英文界面 Import Copilot Files）的那一项 可以逐行增删 paths、保存、放弃或恢复默认；maxBytes、scanSubdirectories、 instructionDirs、skillDirs 仍只在组合配置里设。

• 写的是 profile 自己的配置层（~/.dsh/profiles/<profile>/cordis.patch.yml 里本条目 的 config.paths，即插件行下面多出来的那一段），不是工作区文件；组合配置是这一层的基底， 「恢复默认」清掉用户覆盖。保存带草稿开始时的 revision（期间别处改过会被拒绝并提示重试）， 保存后以宿主回读确认，改完从下一个模型步骤起生效。
• 「浏览…」按部署能用的那条路由取目录（DSH Desktop 用自己的 Windows 选择框，其余组合走宿主 的原生选择器）；部署没有可用路由时页面不显示该按钮，路径手填。

安装

需要 dsh CLI。--profile web 是默认 profile， 桌面版用 --profile desktop，其他 profile 换成对应名字。

dsh plugin --profile desktop add github:NEVSTOP-LAB/dsh-import-copilot-files
dsh plugin --profile desktop add github:NEVSTOP-LAB/dsh-import-copilot-files#<commit-sha>  # 锁定提交
dsh plugin --profile desktop add ./dsh-import-copilot-files-0.3.0.tgz   # 或 Release 附件里的 tarball
dsh --profile desktop --dump-config                                     # 确认组合层里出现这一行
dsh plugin --profile desktop remove dsh-import-copilot-files            # 卸载

[!IMPORTANT] profile patch 层不热重载，安装后要重启 DSH。之后改仓库里的 .github/** 或某个 paths 条目下的文件都即时生效（每个模型步骤重新读盘），只有改插件自身源码才需要再重启。

[!WARNING] 需要 DSH ≥ 0.1.7（实测 Desktop 2.0.16 / dsh 0.2.0-rc.1）。该版本重做了设置这条链 （设置文档改为由插件自己的 Config schema 派生、按 Loader 条目 id 寻址），本版本按新形态 实现，不再兼容 0.1.5 / 0.1.6（旧版本请用上一版 tag）。如果你在旧版本上装过并保存过 paths，那份值停在 ~/.dsh/settings.yaml.imported 里、不会被自动迁移 —— 手工写回 cordis.patch.yml 的方法见 docs/compatibility.md §3.7。

安装时那条 peer 依赖警告

dsh plugin add 原样转发 pnpm 的输出，profile 里任何一个插件漏声明 peer 都会让它出现。 它说的不是本插件：本插件的宿主包全部声明为可选 peer。是谁缺什么，在 profile 目录里跑 cd $DSH_HOME/profiles/<profile> && pnpm peers check 即可 —— 缺的属于那些包自己，与本插件无关。

更多文档

• Releases —— tarball 与版本记录
• CONTRIBUTING.md —— 参与开发与提交的流程
• docs/design.md —— 架构与关键机制、源码结构、已知边界
• docs/compatibility.md —— 依赖面、DSH 接缝、升级校验清单与验证记录
• docs/development.md —— 本地检查、测试与手工验证、打包发版
• docs/pitfalls.md —— 开发坑
• CHANGELOG.md —— 每个版本的变更

License

MIT