插件概览
建议先用插件开发助手。 制作插件最快的方式，是把这项工作讲给内置的 插件开发助手：在对话里输入
/选择它。它只问会影响结果的问题，替你写好插件和所需文件、完成检查，并安装到你的电脑上试用。见在对话中创建插件。本章其余内容说明它生成了什么，供你审阅、修改或手写插件时参考。
SoduWork 插件是一个可安装的包，告诉 Agent 怎样完成某一类工作。它可以包含工作说明、Skill、MCP 连接、输入项、权限声明，以及可选的工作流。即用是带独立窗口的插件。
不是所有插件都需要工作流。单步方法、知识型 Skill、系统连接器都可以直接从对话或任务里调用。只有工作需要多个 Agent 协作、人工确认、质量检查、发布，或要从失败步骤继续时，才加工作流。
插件类型
类型（template） | 用途 |
|---|---|
method | 一套工作方法：说明、Skill 和输入项 |
connector | 通过 MCP、平台账号或随包 CLI 访问外部系统 |
workflow | 多个步骤，带交接、审查和确认点 |
app | 带独立窗口和 AI 侧栏的插件（见即用） |
三个对象
| 对象 | 回答什么问题 | 能否修改 |
|---|---|---|
| PluginVersion | 插件包含什么、能从哪里调用、工作流怎么执行 | 不能。内容变化必须升 SemVer 版本号 |
| PluginBinding | 在这个组织或项目里怎么接：MCP、密钥、Agent 底座、模型、Runner | 可以。切换版本前先检查兼容性 |
| WorkflowRun | 这次运行到了哪一步、每一步实际由谁执行、留下了哪些证据 | 持久保存。失败时从准确的步骤继续 |
不要把公司地址、某台机器、个人模型或密钥写进插件。插件定义可移植的方法，绑定把它接到真实环境，运行记录实际发生了什么。
生命周期
- 编写：在客户端插件工坊、通过和"插件开发助手"对话，或在 Git 仓库里编写。
- 打包成不可变的版本。
- 预检：导入时做静态检查。
- 隔离区：上传到组织的候选版本先存放在这里，此时不会执行任何内容。
- 审查：管理员检查能力、签名密钥和评测。
- 绑定到组织或项目。
- 模拟：针对真实环境逐步检查。
- 运行：在 Runner 上逐步执行。
- 恢复：从失败的步骤继续，并保留证据。
个人插件只在你自己的电脑上经过前三步。是否上传到组织，由你决定。
从哪里开始
| 你想 | 阅读 |
|---|---|
| 把刚做完的事情变成插件 | 在对话中创建插件 |
| 手写一个工作流 | 编写第一个工作流 |
| 查某个字段 | 包格式 · 工作流节点 |
| 分享给团队 | 发布到组织 |
| 做一个带界面的插件 | 即用 |
仓库的 hub-backend/plugins/ 目录里有可运行的示例。管理端 插件与应用 → 制作与上架说明 提供起步包，它会随当前的格式版本同步更新。