Skip to Content
Raydo
开发者插件开发

开发与打包 Raydo 插件

为 Skill 或 MCP 包编写 raydo.json,或构建原生 App Connection 归档。

给现有插件添加 Raydo 元数据

保留原宿主清单的位置。Skill 指令放在 skills/<name>/SKILL.md,需要 MCP 服务时写入 .mcp.json。把 Raydo 专用清单与现有清单并列:

example-plugin/
  .claude-plugin/plugin.json
  .raydo-plugin/raydo.json
  skills/example/SKILL.md
  .mcp.json

以下是一份可用的 .raydo-plugin/raydo.json 示例:

{
  "schemaVersion": 1,
  "id": "example.documents",
  "displayName": "Example Documents",
  "version": "1.0.0",
  "publisher": { "id": "example", "displayName": "Example" }
}
  • schemaVersion 和 id 为必填。Raydo 会校验字段,显示名称、版本等元数据可在导入预览里覆盖外部清单的对应值。
  • tools 的键写成 MCP 服务 ID/工具名,服务需在包中。效果为 read、write 或 destructive。写入或破坏性动作需要相应控制时,用 required 声明 approval 与 idempotency。效果声明本身不授予权限。
  • connections 声明连接器 ID 与所需能力。直接导入的外部插件不会获得用户的 Raydo 登录或连接凭据。凭据通过支持的配置入口填写。
  • contributes 可声明工作流和角色文件路径。外部导入预览会列出这些声明,目前不会一起导入这些模板。

随包提供已构建的 MCP 入口,并写清所需的本地环境。通过链接导入时,Raydo 不会运行安装脚本或下载 npm 依赖。

构建原生 App Connection 归档

准备 Node.js 22.12 或更高版本。需要原生 Capability 契约时,可使用开发者预览脚手架。默认模板只读。本地打包命令写出 dist/plugin.raydo.zip,并报告 manifest 与软件包摘要。

npm create raydo-plugin@next my-raydo-plugin -- --plugin-id example.documents --display-name "Example Documents" --connector-id notion
cd my-raydo-plugin
npm install
npm run verify
npm run pack

检查声明的 Schema、权限和契约样例,保留通过校验的那份归档。按分发与安装选择对应的导入方式,再用样例数据试用。

On this page

开发与打包 Raydo 插件