6cfa0c55d2
Removes kilo, kimi, kimi-code, copilot, windsurf, augment, trae, qwen, hermes, cline, codebuddy and pi end to end: capability descriptors, installer branches and converters (bin/install.js 14.9k -> 11.2k lines), TypeScript converters, hook surfaces and runtime homes, review lanes qwen/kimi-code, the two pi migrations, Kimi payload normalization in the hook guards, dead hostBehaviors vocabulary, launcher home probes, fixtures, runtime-specific tests and the prose that presented them as supported. Installer output for the six kept runtimes is byte-identical to before the prune. The Kimi tool-vocabulary tests in workflow-guard, read-guard and read-injection-scanner are left in place pending a decision.
6.5 KiB
如何在您的运行时上安装 MSD Core
将 MSD Core（@golem15/msd-core）安装到您日常使用的 AI 编码运行时中。本指南提供各支持运行时的标准安装路径，以及适用于未安装 Node.js 的机器的手动安装路径。
所需条件： Node.js 18+ 及 npm（或 npx）。如果您没有 Node.js，请跳转至不使用 Node.js 安装。
为什么需要安装程序
MSD Core 以 Claude Code 原生 frontmatter 格式分发代理和命令文件。每个支持的运行时需要不同的 schema、目录结构和命令调用语法。安装程序负责执行必要的转换——例如，为 OpenCode 转换工具列表和颜色值、为 Codex 写入 TOML 代理条目。
请勿直接从 agents/ 或 commands/ 复制文件。 这样做会绕过转换过程，导致 schema 验证错误或命令缺失。
标准安装
在任意目录运行安装程序。它会提示您选择运行时，以及是全局安装（所有项目）还是本地安装（仅此项目）。
npx @golem15/msd-core@latest
这是全新安装或切换运行时后重新运行安装程序所需的唯一命令。
各运行时安装说明
Claude Code
npx @golem15/msd-core@latest --claude --global
技能文件存放于 ~/.claude/。下次 Claude Code 会话中，命令将以 /msd-* 斜杠命令的形式出现。重启 Claude Code 以加载它们。
同时在 --global 和 --local 两个作用域安装。 这是受支持的配置（不同项目有时需要不同的自定义配置），但 Claude Code 自身的触发器解析规则——个人作用域覆盖项目作用域，且技能（skill）覆盖同名命令——都指向同一个方向：全局技能总是在 /msd-<name> 触发器上胜过本地命令。MSD Core 会检测到这一点，并在安装完成后立即打印出哪个作用域胜出（并通过 /msd-health 以诊断代码 W028 呈现相同的事实）；这只是一条提示，不是失败——安装本身仍然会成功。在全局作用域下，胜出技能的工作流规范引用会在运行时优先相对于你的工作目录解析，因此即使 Claude Code 实际调用的是全局技能，拥有自己 .claude/msd-core/ 的项目仍然能获取到自己的规范。
覆盖安装目录：
CLAUDE_CONFIG_DIR=~/.claude-alt npx @golem15/msd-core@latest --claude --global
OpenCode
npx @golem15/msd-core@latest --opencode --global
技能文件存放于 ~/.config/opencode/（XDG）或 ~/.opencode/。安装程序将代理 frontmatter 转换为 OpenCode 的 schema——移除 tools: 字段并将颜色值转换为十六进制格式。如需了解具体变更内容，请参阅不使用 Node.js 安装 — OpenCode 转换。
覆盖安装目录：
OPENCODE_CONFIG_DIR=~/.config/opencode-alt npx @golem15/msd-core@latest --opencode --global
Codex
npx @golem15/msd-core@latest --codex --global
技能文件存放于 ~/.codex/skills/msd-*/SKILL.md。代理以每个代理独立的 TOML 条目写入 config.toml。安装后重启 Codex（或运行 codex --reload）。
最低支持版本： Codex CLI 0.130.0。更早版本额外扫描技能根目录，可能导致重复列出条目。
Cursor
npx @golem15/msd-core@latest --cursor --global
技能文件存放于 ~/.cursor/。MSD 安装技能、代理和规则引用。
覆盖安装目录：
CURSOR_CONFIG_DIR=~/.cursor-alt npx @golem15/msd-core@latest --cursor --global
Antigravity
npx @golem15/msd-core@latest --antigravity --global
安装程序自动检测 Antigravity 配置目录（~/.gemini/antigravity、~/.gemini/antigravity-ide 或 ~/.gemini/antigravity-cli）。使用与 Gemini 兼容的设置策略。
覆盖安装目录：
ANTIGRAVITY_CONFIG_DIR=~/.gemini/antigravity-alt npx @golem15/msd-core@latest --antigravity --global
本地安装与全局安装
上述所有示例均使用 --global，即为您的用户账户全局安装 MSD。若要将安装范围限定到单个项目，请将 --global 替换为 --local：
npx @golem15/msd-core@latest --claude --local
本地安装写入项目根目录下的 .claude/ 目录。当全局安装和本地安装同时存在时，本地安装的设置优先于全局设置。
安装预发布版（Next / Nightly / Insiders / Preview）
运行时的预发布版（Cursor Nightly、VS Code Insiders、Codex 预览通道等）从同级配置目录读取配置。在运行安装程序前设置对应的 *_CONFIG_DIR 环境变量：
CURSOR_CONFIG_DIR=~/.cursor-nightly npx @golem15/msd-core@latest --cursor --global
在安装程序提示中选择对应的稳定版运行时。MSD 不将预发布版作为独立命名运行时枚举——它们通过此环境变量机制提供尽力支持，不在发布 CI 中单独测试。
不使用 Node.js 安装
如果您无法运行 npx（例如在没有 Node.js 的 Windows 机器上），有两种方案可选。
方案 A——使用有 Node.js 的机器。 任何有 Node.js 的机器均可：WSL、Linux 虚拟机、CI runner 或 Docker 容器。在那台机器上运行安装程序，然后将输出目录复制到目标机器。以 OpenCode 为例：
npx @golem15/msd-core@latest --opencode --global
# 然后将 ~/.config/opencode/agents/ 复制到 Windows 机器
方案 B——手动转换源文件。 代理源文件位于 MSD Core 仓库的 agents/ 目录下，格式为 Claude Code 原生 frontmatter 格式。每个运行时期望不同的结构。有关各运行时的具体字段转换说明，请参阅用户指南中的手动安装 / 无 Node.js 设置，其中详细介绍了 OpenCode 的转换内容，并指向安装程序中其他运行时对应的 convert*Frontmatter 函数。
安装后
重启您的运行时以加载新命令和代理。然后启动新项目或接入现有仓库：
/msd-new-project # 新建项目
/msd-onboard # 现有代码库
如果重启后找不到该命令，请确认安装目录与运行时预期的配置路径匹配。上方的预发布版章节介绍了最常见的路径不匹配情况。