扩展:Skill、插件与 MCP

了解扩展类型、安装记录与执行宿主,找到正确的开发和调用路径。

三类扩展#

类型内容使用方式
SkillSKILL.md 中的操作指令作为已安装的工作方法参与 Agent 任务。
账户代码插件工具、上下文、生命周期、后台任务、模型与可选界面默认在账户工作区执行,需要设备依赖时选择已配对设备。
MCPstdio 或 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 · 能力以实际部署与账号权限为准

搜索文档

输入关键词,查找操作说明。

↑ ↓ 选择 · Enter 打开全部文档 →