在对话中创建插件
目标:不手写 JSON,把一套工作方法做成个人插件。
开始前:客户端已连接,并且配置好了模型(见快速开始)。
插件开发助手是内置插件。它会询问你想沉淀的做法,在对话的工作目录里写出插件草稿并自检,再交给客户端安装。
1. 用插件开发助手开始对话
在输入框输入 /,选择 插件开发助手,然后描述这项工作。请写明:
- 输入什么(一个文件、一个链接、几个字段);
- 有哪些步骤,分别用到哪些工具或系统;
- 怎样算完成,怎么检查;
- 绝对不能发生什么。
做一个插件:输入一份 PDF 格式的供应商报价,把明细提取成表格,和附件表格里最近三次报价对比,
标出涨价超过 10% 的项目。每一行都注明来源页码,才算完成。
如果你刚在另一个对话里完成了一项工作,把关键步骤贴进来或附上文件,再说"把这个做成插件"。
2. 只回答影响结果的问题
插件开发助手会先拟出完整方案,只在缺少会改变结果的关键信息时才提问。插件类型(method、connector、workflow 或 app)由它替你选择。
3. 检查并安装
草稿写入对话工作目录里的 soduwork-plugin-draft.json,插件需要的模板、示例、脚本和素材也放在旁边。插件开发助手会从磁盘重新读取文件、检查无误后再告诉你。
点回复旁边的 检查并安装。客户端会收集草稿和相关文件,执行预检,并把插件安装到这台电脑上。
不需要打开隐藏目录、复制 JSON 或修改源码。
4. 试用
在新对话里输入 /,选择你的插件。工作流插件可以输入 / 选择 调试插件,逐步运行(见调试与打包)。
草稿包含哪些内容
| 字段 | 作用 |
|---|---|
template | method、connector、workflow 或 app |
name、version、description、instructions | 身份信息和工作方法本身 |
inputs | 插件启动时填写的公开参数:text、textarea、boolean、number、select |
setup | 安装后每位用户填写一次的非敏感偏好 |
mcpServers、runtimeCapabilities | 需要的连接和电脑能力 |
evaluationInstruction、evaluationCriteria | 一道代表性测试题及判断标准 |
resources | 随插件分发的文件 |
workflow | 工作流插件的步骤 |
插件永远不保存密码、令牌或 API Key,inputs 和 setup 会拒绝这类内容。企业凭据在插件发布到组织时再接入。
新建和更新的插件至少要通过 locales 支持中文和英文。