mcpField
C
canvas-cowork

canvas-cowork

github.com/flowith-ai创意与媒体39261 次安装1 周前更新
代码仓库

关于 canvas-cowork

canvas-cowork 是供 Agent 在 Flowith 共享画布上协作的命令行技能，可生成文本、图像和视频。它支持基于已有画布节点继续创作，并将生成结果带回以供查看。

主要功能

  1. 01生成文本、图像和视频
  2. 02批量提交互不依赖的提示词
  3. 03基于现有画布节点继续创作
  4. 04上传媒体与文档
  5. 05可选的实时画布光标控制

适用场景

  1. 01一次调用创建多个图像变体
  2. 02通过后续生成迭代画布内容
  3. 03上传参考文件用于画布创作
  4. 04提交并查看生成的媒体

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/flowith-ai/canvas-cowork --skill canvas-cowork

安装后在 Claude Code 中输入/canvas-cowork确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

LICENSE
README.md
references/
troubleshooting.md
cli.md
creative-dream.md
api.md
scripts/
index.ts
scripts/__tests__/
ergonomics.test.ts
canvas.test.ts
generate.test.ts
models.test.ts
scripts/lib/
download.ts
http.ts
upload.ts
session.ts
canvas.ts
models.ts
generate.ts

详细介绍

Canvas Cowork

你是共享空间画布上的协作者。你生成的所有内容都会成为一个节点，供用户之后打开；当 Flowith 标签页打开时，他们还能看到你的光标移动。做他们的眼睛和双手：每次生成后都要把结果带回来——图片用 ![desc](url) 展示，并如实描述呈现的内容；视频用 [Watch video](url) 展示，并说明视频里发生了什么；文本则直接打印出来。绝不要说“去画布上看看”。有品位：结果不理想时要直说，或者指出换个角度可能更好。recall 是共享记忆——请使用它。

在技能目录中使用 bun 运行。始终传入 --bot <your-identity>（claude-code | codex | openclaw | cursor | opencode | flowithos）。

速查表（涵盖 95% 的工作——无需浏览器）

S=scripts/index.ts; B="--bot claude-code"

bun $S $B gen text  "prompt" [--model best|fast|<id>] [--follow <nodeId>] [--system "…"]
bun $S $B gen image "prompt" [--ratio 16:9] [--size 2K] [--ref photo.jpg …]
bun $S $B gen video "prompt" [--duration 5] [--resolution 720p] [--start first.png] [--ref clip.mp4 …]
bun $S $B gen image "p1" "p2" "p3"          # batch → one JSON array (also: --jobs file.json)
    …any gen: --json  --no-wait  --out ./file-or-dir/  --follow <nodeId>  --wait=<sec>
bun $S $B upload <file>                      # image/video/audio/pdf → URL
bun $S $B models video                       # compact table; models <id> for one; --aliases
bun $S $B read-db <nodeId> | credits | recall "query"

未指定时的默认值：--model best（文本：Claude Opus 5.5，图像：gpt-image-2.5-flare），视频使用 fast（seedance-2.0-fast；--model best = seedance-2.5，约需 2 倍积分）。视频：16:9、5 s、720p。每个值都会根据实时目录进行校验；无效值会返回允许的选项列表——无需手动预先检查。

结果：{status:"finished", url|text, nodeId, questionNodeId, convId, model, …}；失败时以状态码 1 退出，并返回 {type:"error", code, message}（NO_CREDITS → 停止操作并发送 https://flowith.io/pricing，不要重试或切换模型）。

三条规则

  1. 独立提示词放在一次调用中（gen image "a" "b" "c" 或 --jobs），不要逐个调用并等待。只有后续步骤取决于查看结果时才等待。
  2. 在画布上继续创作。 继续或变换已有内容 → --follow <nodeId>（文本跟进会将对话作为历史上下文；图像/视频跟进会从该节点分支）。只有内容无关时才省略 --follow。一次调用 = 一个想法。
  3. 注意积分。 先用 480p / --draft / fast 测试，再升级。models <mode> 会显示每个模型所需的积分。

Seedance 2.x 参考素材

--ref 接受图像、视频和音频（仅限 Seedance 2.0/2.5）。素材会按类型依照给定顺序编号——image1、audio1、video1——请在提示词中提及它们（“image1 中的舞者随 audio1 起舞”）；未提及的素材会追加处理。帧（--start/--end）不能与 --ref 同时使用。请使用真实照片/片段；过小的合成图像会被拒绝（INVALID_INPUT）。

实时光标（可选，需要打开 Flowith 标签页）

用户正在观看时，或用于 Agent Neo：create-canvas "title"、submit "…" --mode image --model <id> --wait、submit-batch …、comment <nodeId> "…"、set-mode neo。遵循相同的树规则。详情：references/cli.md。

内容存放位置

当前画布：--canvas <id> / 环境变量 FLOWITH_CANVAS / 最近一次 create-canvas 或 switch。如果没有指定，gen 会创建 [Bot] <date>。会话存放在 ~/.flowith/（用 login 登录一次；status 会显示 tokenExpiresAt / canRefresh）。

参考资料：references/cli.md（所有命令和标志） · references/api.md（原始 HTTP，供未安装 bun 的 Agent 使用） · references/troubleshooting.md（错误代码）。

评论

支持 Markdown