dsh-babel
让 DSH 直接使用其他 AI 编码工具生态里的 MCP 服务器、插件与斜杠命令。
读它们已有的配置，而不是要求插件作者为 DSH 重新移植一遍。
dsh-babel 是社区维护的 DeepSeek Harness（DSH）插件，并非 DeepSeek AI 官方产品。
它解决什么问题
插件作者要支持一个平台，就得为它单独写一份目录。一个典型的多平台插件会带六到八个这样的目录：
.claude-plugin .codex-plugin .cursor .gemini-extension.json ...
DSH 的那个格子通常是空的。dsh-babel 换个思路：作者不用动，DSH 这边读他们已有的 .mcp.json / commands/，把 N×M 的移植问题变成 N×1。
同时它做一件别家没做的事：装之前就告诉你哪个能跑、哪个缺密钥、哪个根本跑不起来——而不是装上去之后静默失败。
功能
- 发现：扫描 Claude Code 与 Codex 插件目录下的
.mcp.json，以及两种斜杠命令文件（.md / .toml）；根目录可配置。
- 归一化：把多种
.mcp.json 方言（带 mcpServers 包装的 / 裸顶层的 / Codex 专有键的）降成一套中间表示。
- 预检：四类检查把"静默失败"变成"明确原因"——依赖命令是否在
PATH、守护进程是否在跑（如 Docker socket）、密钥是否可用、版本是否未固定。
- 兼容性报告：把每个服务器归入「可用 / 需密钥 / 不可用」，每条都附具体原因。
- 命令注册：把发现到的斜杠命令注册进 DSH，支持
{{args}} / $ARGUMENTS / $1 参数替换。
- MCP 注册：连上 stdio 或 streamable-http 服务器，用 DSH 自己的
createMcpToolDefinition 注册工具。
- 密钥解析：
process.env 优先，其次 macOS 钥匙串的白名单（仅 GitHub token 家族）——绝不无差别翻钥匙串。
- 展示元数据：
locale/ 文案与图标，配置项由 schemastery schema 声明，设置界面可渲染。
安装
# 从 GitHub
plugin_manager install_bundle github:Oliveryfaso/dsh-babel
# 或本地目录
plugin_manager install_bundle /绝对/路径/dsh-babel
也可以在 DSH Desktop 里走 设置 → 插件 → 添加插件，填入仓库地址或本地路径。
安装后默认 dry-run：只在日志里打印兼容性报告，不注册任何东西。
配置
配置项由 schemastery schema 声明，因此会出现在 设置 → 插件 → dsh-babel 的配置界面里：
| 配置项 | 默认 | 说明 |
|---|
roots | [] | 扫描根目录；字符串路径或 { source, path }。留空时使用默认的 Claude / Codex 插件目录 |
dryRun | true | 只报告，不注册。要真正注册必须先设为 false |
logReport | true | 把兼容性报告打印到日志 |
registerCommands | false | 注册发现到的斜杠命令（需 dryRun: false） |
registerMcp | false | 注册预检通过（severity: ok）的 MCP 服务器（需 dryRun: false） |
开启真注册：
config:
dryRun: false
registerCommands: true
registerMcp: true
兼容矩阵（诚实版）
| 外部形态 | 覆盖 | 说明 |
|---|
MCP .mcp.json（stdio） | ✅ 高 | 免密钥、依赖命令存在的，基本可用 |
MCP .mcp.json（http/sse） | ✅ 高 | 依赖 bearer token 的会标「需密钥」 |
| MCP（依赖宿主运行时变量） | ⚠️ 有损 | CODEX_* / CLAUDE_* 等对方宿主注入的变量，DSH 没有，标为不可用 |
| MCP（OAuth） | ❌ 无对应 | oauth_resource 等 DSH 无等价物，丢弃并告知 |
技能 skills/*/SKILL.md | ✅ 高 | 格式统一（由 skills-manager 等已有实现覆盖） |
斜杠命令 commands/* | ✅ 已实现 | 发现 + 归一化 + 报告 + 注册 |
| Hooks | ⚠️ 有损 | DSH 仅 7 个点、仅 command handler |
子代理 agents/* | ⚠️ 降级 | DSH 无注册接口，只能降级为技能 |
| 插件 UI / mods | ❌ 不支持 | 必须用 DSH client 插件重写，无法移植 |
报告长什么样
在一台装了 Claude Code 与 Codex 插件的机器上，首次加载会打印：
=== dsh-babel 兼容性报告 ===
文件: 28 服务器: 28
方言: {"bare":14,"wrapped":14}
传输: {"stdio":17,"streamable-http":11}
结论: 可用 14 / 需密钥 5 / 不可用 9
✗ 不可用 (9):
laravel-boost [stdio] BLOCKED
- [command] command not on PATH: php
terraform [stdio] BLOCKED
- [daemon] docker installed but not running (no socket / probe failed)
- [secret] missing credential: TFE_TOKEN
codex_app [stdio] BLOCKED
- [env] depends on CODEX_MCP_NODE_PATH (other-harness runtime), not available in DSH
这就是这个插件的第二个价值：明确告诉你为什么跑不起来，而不是让用户以为「DSH 很烂」。
目录结构
index.js 插件入口（apply + schemastery Config，Cordis 宿主插件形式）
cordis.patch.yml bundle patch（插入 dsh-babel 一行）
locale/zh.json 卡片展示文案（标题 + 简介）
locale/en.json same, in English
icon.svg 插件图标
lib/normalize.mjs 内核：方言 → IR
lib/discover.mjs 发现：遍历文件系统找声明
lib/preflight.mjs 预检：命令 / daemon / 密钥 / 版本
lib/secrets.mjs 密钥解析：env 为主 + 钥匙串白名单兜底
lib/commands.mjs 命令归一化：.md / .toml → 命令 IR
lib/register.mjs 命令注册：ctx.commands.register + 参数替换
lib/register-mcp.mjs MCP 注册：连接 + createMcpToolDefinition + 工具注册
lib/report.mjs 报告：聚合 + 文本渲染
bin/dsh-babel.mjs CLI runner（本地测试用）
test/ 单测 + 冒烟
docs/ 详细文档
CHANGELOG.md 版本变更记录
开发与测试
npm test # 全部单测（75 断言）
node test/mcp-smoke.mjs # MCP 注册冒烟（需本地 symlink 到 DSH 包 + 真实服务器）
node bin/dsh-babel.mjs # 直接跑一次报告
文档
许可证
MIT
