跳到主要内容

调试与打包

在本机逐步调试​

安装个人工作流插件后，在对话里输入 / 选择 调试插件，或者选中插件后点 逐节点调试。调试卡显示在当前对话里，不会创建任务、第二个对话或单独的窗口。

  1. 确认插件、版本、公开参数和调试说明。可以带入当前对话的文字、历史附件，以及待发送的截图和文件。
  2. 调试按依赖顺序，在本机 Runner 上运行各个节点。每个节点可以选择不同的、已支持的本机底座和模型。
  3. AI 的回复和工具调用会显示在对话里。文件和结论类产出逐项校验，交接给下一步时再次核对 SHA-256。
  4. 审批卡可以直接查看已校验的文件。Markdown、文本、JSON、CSV 在卡片里预览，其他文件用系统默认程序打开。
  5. human_review 步骤需要对话所有者明确确认。未确认、失败或断线状态不明时，后续步骤和排队的消息都不会继续。

更多说明：

  • 重试只针对失败的节点，并遵守该节点的重试上限。停止前需要先确认执行机的状态。
  • 刷新后可以重新打开调试卡。客户端重启后需要手动恢复，已完成的节点不会重复运行。
  • 工作文件放在 plugin-debug/<runId>/<node>-<attempt> 下。本机的 publish 步骤只表示调试结束，不会上传到组织。

调试沿用你的模型授权、设备授权和 Skill 策略，每个节点只能使用它声明的 MCP 子集。

本机调试不能做什么​

  • 它不改变组织工作流在服务端的编排方式。
  • 不能把需要托管或远程执行机的路由降级到本机运行。
  • 绑定在 Git 提交上的代码审查需要组织的代码工作流，本机调试会明确阻断，不会假装通过。
  • 自定义 HTML UI 资源不会自动挂载。编辑器之外的脚本和部署节点也不会执行。

本机调试通过，不等于组织发布已经完成。

打包​

把 plugin.json、可选的 workflow.json、Skill 和其他文件放在包的根目录，然后压缩：

my-team-flow.soduwork-plugin
├─ plugin.json
├─ workflow.json          # 可选
├─ skills/                # 可选
└─ README.md              # 可选

格式和大小限制见包格式。

客户端也可以导出已安装的插件。导出的可移植包包含所有随包文件和它们的校验值，所以在其他电脑上导入不依赖你本机的路径。

从其他工具导入​

SoduWork 能识别 .codex-plugin/plugin.json 和 .claude-plugin/plugin.json，并把它们转换成 SoduWork 的不可变包。

  • 能映射的工作说明、Skill、Agent 和工作流会出现在能力报告里。
  • Hook、任意二进制文件，以及其他无法安全表达的部分不会执行，会显示为适配提醒或阻断项。

导入成功不代表外部插件的所有行为都已支持。使用前请先看预检报告并运行模拟。

harness harnesses runtime runtimes 底座
编辑此页