EOSEOS 插件开发手册
核实日期：2026-11-12。面向插件作者；不要求阅读 EOS 实现源码。本文描述经过源码核实的开发方式；实际可用模块以你使用的宿主版本和能力声明为准。
阅读顺序
- 快速开始：从空目录做一个 Skills 插件，打包、检查兼容性、在测试市场安装并调用。
- 清单与兼容性：逐项解释清单、权限、配置、目标平台、多语言和当前能力边界。
- 模块开发：Skills、独立页面及 SDK、原生 MCP、远程 MCP、WASM 的输入输出与完整示例。
- 调试与排障：本地检查、页面模拟宿主、真实 Agent 验收、日志和错误处理。
- 上传、审核与发布：作者与管理员各自操作、真实 API、不可变版本、下架和撤销。
先确认能做什么
当前 EOS Agent 的源码提供 Skills、本机受信进程 MCP、固定 HTTPS MCP、无 WASI 的 WASM Component。独立页面仅在宿主实际报告 webview/v1 和 eos.ui.panel 时可用；macOS 原生隔离校验通过才会声明，不能据此承诺 Windows/Linux 页面支持。
任务读写、任意文件/网络代理、OAuth/秘密代理、跨插件导出调用、服务器执行尚不是当前 Agent 公布的能力。portable 表示按能力适配，不表示全部 EOS 产品均已支持。Todo 导入器等设计示例不能作为可运行模板。
市场允许公开浏览；安装需要登录；上传还需要邮箱白名单和已批准的发布者。当前没有发布者自助注册接口。请在首次测试市场上传前让维护者确认命名空间与环境。
工具与样例
eos-plugin 是打包/校验工具，不是应用安装器。当前没有 init、install、dev、watch 或 publish 子命令，也没有桌面端本地目录热重载入口。真实安装走测试市场的审核签名流程；参见调试路径。
| 示例目录 | 用途 | 构建 |
|---|---|---|
examples/hello-skills | 纯文本整理技能 | 直接 pack |
examples/notes-panel | 普通配置、私有存储、单文件页面 | npm ci 后构建 package/ |
examples/mcp-echo | 不依赖目标机 Node/Python 的原生 MCP | Cargo 构建并复制到 package/ |
examples/wasm-ack | 最小 Component Model 工具 | 直接 pack；WAT 由当前执行器支持 |
样例使用未注册的 tutorial 命名空间，不能直接上架；开发自己的插件时替换所有 ID/名称及相互引用。模板许可证仅覆盖模板文件，不改变 EOS 平台本身的许可证。
下一步
从快速开始完成第一个插件；已有插件要接入新模块时，查阅模块开发。提交发布前按调试验收清单记录实际结果，再完成上传与发布。