Appearance
工坊手册
三大工坊的使用维度：创意工坊（Recipe/Chain）、技能工坊、交换所工坊。
🎨 创意工坊 CreativeWorkshop
Recipe / Chain 的可视化管理，把技能编排成可复用的"配方"。
入口
- Desktop 桌面壳 → 创意工坊 图标
- 或 Manager 对话列表 → 创意工坊
功能概览
| 功能 | 说明 |
|---|---|
| 新建 Recipe | 创建新的技能配方（图：输入→处理→输出） |
| 可视化编辑 | 拖节点/连线，编排 LLM 调用 + 工具执行 |
| 编译 | recipe_compile 结构校验，检查节点连接和类型 |
| 干跑 | recipe_dryrun 无真模型 deps，走 stub asker 测试 |
| 发布 | 打包 + 签名 → relay 市场（审核发布） |
Recipe 图结构
标准 Recipe 是一个 7 节点图：
parse_inputs → 澄清(emit_event) → 规划(llm_call) → 展示计划(emit_event)
→ 分支(plan_route) → 生成(llm_call) → 合成(llm_call)- compute 节点：表达式计算，可用
extra_modules白名单导入 - llm_call 节点：直接调模型，支持
output_format结构化输出 - emit_event 节点：向用户展示信息 / 阻塞等待
节点配置
| 参数 | 说明 |
|---|---|
system_prompt | LLM 节点的系统提示 |
user_prompt_template | 支持 |
tool_whitelist | 允许调用的工具列表 |
output_format | JSON Schema，约束输出结构 |
output_var | 把 schema 字段收口到一个变量名 |
常见坑
- 节点提示词要明确让 LLM 发工具调用，否则在 tool_loop 节点空转
output_var未配置时 schema 字段会散列到顶层- 改翻译器后需重启 bridge 或重跑
install_built_ins才生效 - 边缘
condition=走 AST 白名单；用x['key']下标语法，.get()会静默判 False
能力审批
每 (recipe, agent) 组合有独立能力审批：
capabilities.extra_modules声明可导入的模块- 授予
src.x即解锁全部src/（⚠️ 谨慎） - 首次运行弹出审批卡片，用户确认后记录
🔧 技能工坊 SkillWorkshop
Manager 长跑 skill 的深表单管理。
入口
- Manager 对话列表 → 技能调用工坊
功能
| 功能 | 说明 |
|---|---|
| 长跑 Skill | 管理 manager 可持续执行的 skill |
| 参数配置 | 深表单配置 skill 参数/manifest |
| 审批队列 | 变更进入 SkillProposals 审批 |
Skill 改动审批（SkillProposals）
Manager 对 SKILL.md 的修改默认需要用户确认：
- 待审批：修改进入队列等待
- 自动应用：Agent 设置开启"SKILL 改动自动应用"后跳过审批
技能锻造（SkillForge）
从聊天提炼 SKILL.md：
- 描述你想要的技能
- 系统自动生成 SKILL.md 蓝图
- 确认后写入对应 agent 的 skill 目录
🏪 交换所工坊 BrokerWorkshop
Broker 应用包管理与市场。
入口
- Desktop 桌面壳 → 应用 → 交换所工坊
- 或 Manager 对话列表 → 交换所工坊
已安装应用
面板顶部显示：
| 状态 | 说明 |
|---|---|
| 已安装 | 正常运行中 |
| 已暂停 | 临时禁用，保留数据 |
| 未启用 | 已装但未激活 |
点开看能力列表、UI 入口。
新建 Broker
BrokerCreateModal 填写：
| 字段 | 说明 |
|---|---|
| 名称 | 显示名 |
| 图标 | 桌面图标 |
| 简介 | 一句话描述 |
| 开放 Agent | 哪些 agent 可用 |
发布后出现在桌面 shell 的"应用"里。
安装外部包
- 拖入/选择
.broker.zip - 显示声明的权限
- 确认后安装
来源与只读：
| 来源 | 标识 | 可编辑 |
|---|---|---|
| 市场 store | 🔒 徽标 | ❌ 只读黑盒 |
| built_in | 无 | ✅ 可二次开发 |
| user_created | 无 | ✅ 可二次开发 |
| imported_zip | 无 | ✅ 可二次开发 |
导出 / 分享
已装交换所可导出 .broker.zip 发给朋友对接。
卸载 / 暂停
- 暂停：右键图标 → 暂停（留数据）
- 卸载：右键图标 → 卸载（连数据删）
🧩 开发视角
想在工坊里做生态？直接看 生态开发教程：
| 类型 | 粒度 | 用途 |
|---|---|---|
| Recipe | 单技能 | 一次解决一类任务的自动化剧本 |
| Flow | 跨 Agent | 多角色并发协作工作流 |
| Broker | 可分发包 | 应用包（manifest + UI + 插件） |
完整来源：仓库根
OPERATION.md§37–§42。