用 JarvisHub 搭一个画布原生 Agent：长程多模态创作可观察可恢复

你有没有遇到过这种情况：让 Agent 做一个「做 10 页带图带数据的产品方案」的任务，它跑着跑着就乱了——前面生成的图找不到了、改到一半崩了、重跑又从头开始。2026 年 8 月开源的 JarvisHub 就是冲着这个痛点来的：它把一张可编辑画布同时变成 Agent 的工作区、外部记忆、行动空间和共享项目状态。本教程手把手教你用 JarvisHub 搭一个长程多模态创作 Agent，让几十步的复杂任务变得可观察、可恢复、不跑飞。

🎨 本教程适合：被「长任务 Agent 容易跑飞」折磨过的开发者、做内容/AIGC 产品的团队。你只需要一台能跑 Docker 的电脑，会基础命令行即可。

先搞懂：JarvisHub 和普通 Agent 框架差在哪？

用一句话理解：普通框架把 Agent 当「黑盒流水线」，JarvisHub 把 Agent 当「在你的画布上干活的可视化同事」。它的核心由三层构成：

层	作用	解决什么
Canvas State 画布状态	把画布当作 Agent 的外部记忆与项目状态	长任务不丢上下文
Protocol Bridge 协议桥	把模型输出转成可执行的画布操作	多次修改可追踪
Agent Runtime 运行底座	真正跑 Agent 循环并约束每次修改	可观察、可恢复

关键认知：JarvisHub 用「能力清单 + 执行授权」约束每一次画布修改。也就是说，Agent 不能直接乱改你的项目，每一步都得在授权范围内、且被记录下来——这正是长程任务能「可恢复」的底气。

Step 1：准备运行环境

1 装好 Docker 并拉起 JarvisHub

JarvisHub 以容器方式分发，最省事的做法是用官方 Docker Compose：

# 克隆仓库
git clone https://github.com/jarvishub/jarvishub.git
cd jarvishub

# 一键启动（含画布服务 + 运行底座）
docker compose up -d

# 启动后访问
open http://localhost:8080

💡 新手提示：如果本地没装 Docker，先去 docker.com 下载 Desktop 版装好再跑上面的命令。第一次启动会拉镜像，可能要等一两分钟。

Step 2：认识画布：你的 Agent 工作区

2 把画布当成「共享白板」

打开后你会看到一张可编辑画布。和普通白板不同的是：

· 画布上的每个节点 = Agent 的一次产出（一段文案 / 一张图 / 一张表）
· 节点之间的连线 = 任务依赖关系
· 画布右侧 = Agent 运行底座的控制台（日志、授权请求、状态）
· 顶部 = 项目级状态（哪些做完了、哪些在跑、哪些卡住）

🚀 先别急着跑任务，花两分钟拖几下节点、连几条线，感受「画布即状态」——后面你会对 Agent 的每一步操作一目了然。

Step 3：配置模型与能力清单

3 先给 Agent 立规矩

JarvisHub 用「能力清单（capability manifest）」声明 Agent 能干啥。先写一个最小化清单：

{
  "agent": "product-proposal",
  "model": "deepseek-v4-flash",
  "capabilities": ["text", "image", "table", "web_search"],
  "permissions": {
    "canvas_write": "ask",      // 改动画布要先问你
    "external_call": "deny"     // 暂不允许联网外呼
  }
}

权限先收着：第一次跑，把 external_call 设成 deny、canvas_write 设成 ask。等确认 Agent 行为稳定了，再逐步放开。这是避免长程任务「跑飞」的第一道闸。

Step 4：派第一个长程任务

4 让 Agent 基于画布干活

在控制台输入一个真有多步依赖的任务，观察 Agent 怎么一步步往画布上「贴」成果：

任务：做一份 10 页产品方案
1. 第 1 页：市场背景（调用 text 能力，生成文案节点）
2. 第 2 页：竞品对比表（调用 table 能力，生成表格节点）
3. 第 3 页：产品架构图（调用 image 能力，生成图片节点）
4. 后续页面自动依赖前序节点输出……

💡 你会看到：每生成一块，画布上就多一个节点，并且带时间戳和来源标注。这就是「可观察」——你随时知道它干到哪了。

Step 5：中途崩溃？一键恢复到上一个检查点

5 利用画布状态做断点续跑

这是 JarvisHub 最实用的能力。如果任务跑到第 6 页报错：

1. 在控制台点「历史 / History」→ 找到第 5 页完成时的快照
2. 点「恢复到此处 Restore」
3. 修正第 6 页的指令（比如换一个更清晰的提示词）
4. 点「从检查点续跑 Resume」

Agent 会基于第 5 页的画布状态继续，而不是从头再来。

这就是「可恢复」的价值：传统 Agent 崩了只能重跑浪费几十分钟；JarvisHub 因为画布就是状态，断点续跑几乎零成本。长任务必用。

Step 6：多人协作与共享项目状态

6 把画布变成团队资产

JarvisHub 的画布是「共享项目状态」，适合小团队协作：

· 导出画布：File → Export Canvas（得到可复现的项目快照）
· 导入画布：同事拿到快照即可在同一状态上继续
· 评论节点：在任意一个产出节点上留言，对应 Agent 步骤会收到上下文

🤝 实战建议：把「最终通过的画布快照」当作交付物归档，比单纯导出一个 PPT 更有价值——它保留了完整的创作脉络，下次改只需改局部。

Step 7：从画布导出成品

7 把节点拼成可交付文件

创作完成后，把画布节点导出为成品：

1. 选中要导出的节点范围
2. 点「导出 Export → PDF / Markdown / 图片包」
3. 如需二次加工，导出为 Markdown 后用 OfficeCLI 转成 PPT（见本中心相关教程）

🎉 恭喜！你现在已经能用 JarvisHub 把「一句话需求」变成「带脉络、可恢复、能协作」的多模态成品。长程创作 Agent 的核心心智模型你已掌握。

常见问题速查

现象	原因 & 解决
Agent 一直弹授权请求	capabilities 里声明了但它要的操作超出权限，收紧 permissions 或逐项放行
续跑后风格不一致	恢复的检查点太早，选更靠后的稳定快照
画布节点太多卡顿	把已完成分支折叠（collapse），只展开当前在跑的
模型输出不符预期	先改能力清单里的 model 字段换更合适的模型，再续跑

📚 更多教程 📰 智能体资讯

← 返回教程中心