This guide is currently available in Simplified Chinese.
CODEAGENT / COMPATIBILITY
兼容性与迁移
先确认扩展依赖的文件格式和运行环境，再选择迁移路径。以下说明对应当前桌面预览版的实现。
当前兼容范围
| 来源 | 当前支持情况 | 接入方式 |
|---|---|---|
| CodeAgent plugin.json | 支持声明式插件 | 按插件指南导入、审查并启用。 |
| 其他工具的 SKILL.md | 支持受限格式，需检查元数据和工具引用 | 迁移为平面 front matter 和可用工具流程。 |
| 独立 stdio MCP 服务 | 支持连接，需已安装服务与运行时 | 连接器配置或插件 mcp 贡献。 |
| DSH / Cordis JavaScript 插件 | 不支持原生运行 | 改写为声明式插件，或将执行能力封装为 MCP 服务。 |
| DSH 配置补丁、生命周期与 UI 插件 | 没有对应兼容运行时 | 按具体功能重构，不能仅重命名文件。 |
DSH 插件为何不能直接导入
DSH 使用 npm 包中的 dsh.bundle 声明、Cordis 配置补丁及 JavaScript 插件入口；CodeAgent 使用 plugin.json 声明贡献，没有加载这些生命周期和上下文服务的运行时。
因此，package.json 或 cordis.patch.yml 不能通过改名转换成 CodeAgent 插件。此页面不承诺 DSH 原生插件兼容。
格式依据：DSH 官方插件打包与安装文档。
迁移一份已有扩展
- 拆出工作流程：把触发条件和任务步骤整理为 SKILL.md，移除不支持的元数据。
- 拆出快捷命令：把任务模板转换为 plugin.json 的 commands；发送前保留用户编辑。
- 拆出执行工具：把专有运行时中的工具实现封装成独立 MCP 服务，再配置连接。
- 检查界面贡献：只映射为当前支持的静态文本、徽标、命令或专家入口。
- 在真实项目验证：分别检查导入、启用、工具调用和权限处理；兼容性须以实际验证为准。
若扩展只能在 DSH 专有上下文、事件钩子或 UI 中运行，需要先重构这部分依赖。
SKILL.md 迁移注意事项
当前支持 manifestVersion、name、description、tools、permissions、license、compatibility、allowed-tools 这些平面字段。未知字段、嵌套对象和多行 YAML 需要改写。allowed-tools 只作为兼容元数据读取，不能替代 CodeAgent 的工具与权限配置。