扩展:Skill、插件与 MCP
了解扩展类型、安装记录与执行宿主,找到正确的开发和调用路径。
三类扩展#
| 类型 | 内容 | 使用方式 |
|---|---|---|
| Skill | SKILL.md 中的操作指令 | 作为已安装的工作方法参与 Agent 任务。 |
| 账户代码插件 | 工具、上下文、生命周期、后台任务、模型与可选界面 | 默认在账户工作区执行,需要设备依赖时选择已配对设备。 |
| MCP | stdio 或 Streamable HTTP 工具服务 | 安装后首次使用自动准备和发现工具。 |
| 完整 Runtime 插件 | Runtime tools、commands、hooks 与可选 Workbench UI | 由完整插件安装器加载;CLI 使用 --host runtime。 |
账户插件的后端使用独立 Host,静态界面由 Workbench 按账户加载。平台内置插件仍由 Runtime 管理;账户代码不会加载到平台服务器进程。
从开发到安装#
终端
zioon extensions init my-method --kind skill
zioon extensions validate my-method
zioon extensions pack my-method --out my-method-0.1.0.zion.json
zioon extensions upload my-method-0.1.0.zion.json
zioon extensions install LISTING_ID@0.1.0
zioon extensions list
zioon extensions status LISTING_ID编辑生成的内容后再校验和打包。上传返回真实 ID,上传本身不安装。固定版本内容不可覆盖,修改后提高版本号。上传版本属于当前账号的私有制品。
终端
zioon extensions disable LISTING_ID
zioon extensions enable LISTING_ID
zioon extensions uninstall LISTING_ID代码与 MCP 的执行#
终端
zioon extensions configure LISTING_ID --node NODE_ID --root /workspace
zioon extensions probe LISTING_ID
zioon extensions call LISTING_ID --tool hello --args '{"name":"Zioon"}'首次调用会自动准备固定 MCP SDK 和 Host。prepare、probe 可用于排障。账号需具备资源与 write / Bash 权限;设备连接与公开设置在扩展详情中配置。
如果默认交互配置没有允许 extensionsCall,为 prepare、probe 和 call 添加 --profile PROFILE_ID,选择已经授权该能力的实际配置。CLI 请求不会扩大服务端配置的权限。
继续开发和调用#
最后核对:2026-10-28 · 能力以实际部署与账号权限为准