Fectivnfy112357 / crossplug

crossplug — DSH ↔ mcode 插件互转桥

在 DSH（DeepSeek Harness）与 mcode（MiniMax Code / pi）之间双向转换插件的零依赖工具。 转换是"脚手架 + 映射"：能映射的能力直接桥接（逻辑零移植），无法映射的生成带说明的桩， 每项结论写进输出包的 CONVERSION-REPORT.md。

使用

安装转换器（可选，装到任一侧）

node bin/convert.mjs install dsh        # DSH 侧：agent preset（~/.dsh/.agent-presets/crossplug/）
node bin/convert.mjs install dsh-host   # DSH 侧：宿主组合插件（推荐，所有会话可用，需重启 DSH）
node bin/convert.mjs install mcode      # mcode 侧：agent-plugins 插件包（~/.minimax/plugins/crossplug/）

转换

# DSH → mcode
node bin/convert.mjs dsh2mcode <DSH preset目录|插件源码文件> [--out <dir>] [--install mcode]

# mcode → DSH（默认输出 agent preset）
node bin/convert.mjs mcode2dsh <pi extension文件|插件包目录> [--out <dir>] [--install dsh]
# 输出为普通插件（宿主组合插件，所有会话可用，不依赖 preset 选择）
node bin/convert.mjs mcode2dsh <pi extension> --host [--install dsh-host]

# 安装 host 模式转换产物到指定 profile
node bin/convert.mjs install dsh-host --src <host转换产物目录> --profile <web|cc-tui|headless>

# 查看两侧插件
node bin/convert.mjs list

输入形态：DSH preset 目录（preset.yml + agent.cordis.yml）、DSH 插件源码（.js）、 pi extension 文件（.js/.ts）、pi 插件包目录（含 vendor/ 相对依赖）、 agent-plugins 插件包（plugin.json / .minimax-plugin / .claude-plugin）。

在 DSH 里用

• 转换产物为 preset：复制到 ~/.dsh/.agent-presets/<id>/，新会话选择该 preset。
• 转换产物为 host 插件（--host）：所有会话自动生效，无需选择 preset。

在 MiniMax Code 里用

• 转换产物复制到 ~/.minimax/plugins/<name>/，/plugins → Local 标签页安装/启用； 包内技能自动注册为斜杠命令（/技能名）。
• mcode 侧使用转换器自身：安装后通过 /convert-plugin 斜杠命令或自然语言触发。

注意事项

1. mcode CLI 不加载 pi extension（2026-08-15 实证，见 doc/mcode-plugin-spec.md §1.1）： ~/.minimax/settings.json 的 extensions 数组是死配置。面向 mcode 的产物以 agent-plugins MCP 包为准（工具经 MCP stdio 生效）；pi extension 包与事件桥接 仅在独立 pi CLI / DSH 运行时有效。
2. 事件桥接范围：system-prompt/assemble ↔ before_agent_start、 session/event(turn/end) ↔ turn_end 为 1:1；其余事件弱/只读转发或丢失（报告标注）。
3. 能力边界：mcode 插件承载 skills/MCP，DSH 工具行无法自动变成 mcode 插件工具； TUI 渲染、快捷键、provider 注册等两侧无对应，空操作。MCP 服务器不随 preset 迁移（DSH 侧需手工配置）。
4. 技能不转换：两侧通过 ~/.agents/skills 共享，转换器只处理插件。
5. mcode 插件市场官方插件（恒生、企查查等）是服务端付费产品，无法本地转换。
6. 详细规范与事件映射疑问见 doc/（dsh-plugin-spec.md / mcode-plugin-spec.md / event-mapping-questions.md）。