开发者插件开发
开发与打包 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、权限和契约样例,保留通过校验的那份归档。按分发与安装选择对应的导入方式,再用样例数据试用。