插件迁移审计器Simidas/dsh-compat

dsh-compat

CI
npm
License

把 Claude Code 和 Codex 插件安全地迁移到 DeepSeek Harness（DSH）。

dsh-compat 会先逐项检查插件，再生成可审计的 DSH Bundle：哪些能力可以直接使用、哪些需要适配、哪些不支持、哪些必须阻断，都会写入机器可读报告。它不会执行源插件脚本，也不会假装宿主专有 Hook、Agent 或权限语义可以无损转换。

30 秒开始

需要 Node.js 22+。

npx dsh-compat inspect ./my-claude-plugin
npx dsh-compat convert ./my-claude-plugin --out ./generated-plugin
npx dsh-compat test ./generated-plugin

审阅生成物后，再按你的 DSH Profile 安装：

dsh plugin --profile demo add -w ./generated-plugin
dsh --profile demo --dump-config

dsh-compat demo

支持范围

| 组件 | 检查 | 转换 | 结果 |
|---|---:|---:|---|
| Agent Skills | 是 | 是 | 通过 ctx.skills 注册，保留静态文件供审计 |
| Markdown Commands | 是 | 适配 | 转为用户可调用的 DSH Skill |
| MCP stdio | 是 | 适配 | 生成 @deepseek-ai/dsh-mcp-client 配置，凭据值不落盘 |
| MCP HTTP | 是 | 适配 | 规范化为 streamable HTTP，Header 值不落盘 |
| Resources | 是 | 是 | 以惰性、可审计资源复制 |
| Hooks | 是 | 否 | 在 DSH 行为等价得到验证前保持 UNSUPPORTED |
| Agents/Subagents | 是 | 否 | 在模型、工具、隔离和权限等价得到验证前保持 UNSUPPORTED |
| LSP | 是 | 否 | 只做清单检查 |
| Settings/Permissions | 是 | 否 | fail-closed，不自动扩大权限 |

真实插件报告

首批报告来自 Anthropic 官方插件仓库的固定公开 commit，仓库只保存摘要、哈希、兼容结论和人工动作，不复制第三方源码：

- commit-commands：3 个 Commands 均为 ADAPTED
- hookify：Skill 为 DIRECT，Commands 为 ADAPTED，Hooks/Agent 保持 UNSUPPORTED
- feature-dev：Command 可适配，3 个 Agents 保持 UNSUPPORTED
- pr-review-toolkit：Review Command 可适配，6 个 Agents 保持 UNSUPPORTED
- security-guidance：5 个安全 Hooks 保持 UNSUPPORTED

完整索引见 reports/real/README.md。

安全边界

源插件是不可信输入。转换器不会运行 install、prepare、postinstall、Hook、MCP、LSP 或二进制程序；路径穿越、外部符号链接、内联凭据和权限放宽会被报告或阻断。生成 Bundle 仍然需要你在安装前审阅。

开发

pnpm install
pnpm test:all

新增适配规则必须同时提供规则 ID、fixture、兼容报告和必要的安全测试。详细合同见 docs/COMPATIBILITY-CONTRACT.md。

状态

当前版本是 Developer Preview，目标适配器固定为 DSH 0.1.0-rc.6。DSH 本身仍可能发生兼容性破坏，报告不能替代目标版本上的行为验证。

许可证

Apache-2.0。第三方源插件和生成物仍受其各自许可证约束，见 NOTICE。