是什么
ComfyTV Bot 是侧边栏的聊天面板(✨ 图标),背后是本机的 agent CLI。你发的每条消息都会启动一个 agent 回合,它能使用完整的 ComfyTV MCP 工具集 — 而且只有这套工具:能读写画布、跑渲染、看图、管理资产库,但没有 shell、没有文件系统、没有其他任何工具。 典型用法:- “加一个 Z-Image Turbo 的图片节点,提示词写夜里的霓虹猫,16:9,跑起来。”
- “用那张图做参考出一段 5 秒图生视频,等它跑完,质检一下首帧。”
- “看看我的画布,告诉我视频节点为什么失败了。”
- “打开导演台时间线,把第 3 段用更慢的运镜重拍一条。”
- “我刚 link 了个新工作流 — 帮我把 seed、宽、高绑上。“
不碰 API key,这是设计
Bot 不直接调用任何模型 API,ComfyTV 也永远不存 key。它驱动的是你机器上已经装好的 agent CLI — 目前是 Claude Code — 用那个 CLI 自己的登录态(比如你的订阅)。Provider 层是可插拔的,以后可以接入其他本地 agent CLI。 前置条件:- 装好 Claude Code 并登录一次(
npm install -g @anthropic-ai/claude-code,然后运行claude登录)。 - 在 ComfyTV 设置 → Agent 与 MCP 里,先开 MCP 服务,再开 ComfyTV Bot(Bot 依赖 MCP — 那是 agent 触达画布的通道)。
面板用法
- 对话持久化:列表支持置顶、改名、删除;每个对话跨回合保持完整上下文(CLI 恢复同一会话)。
- 流式:回复实时流出;工具调用显示为可折叠条目(如
add_stage、wait_stage),你能实时看它操作画布 — 节点在画布上边长边跑。 - 停止按钮中断当前回合,已有的部分输出保留。
- 切走侧边栏(或收起面板)不会打断进行中的回合 — 回合在服务器侧继续,回来时记录自动补齐。
简述原理
每个回合都以 headless 模式启动一个全新 CLI 进程,锁死在 ComfyTV 的 MCP 服务上(--strict-mcp-config,工具白名单 mcp__comfytv__*),并恢复该对话的会话保证连续性。对话状态由 CLI 持有;ComfyTV 数据库只存一份用于显示的记录镜像。画布写操作仍遵循 MCP 规则 — 由打开着的 ComfyTV tab 执行,所以 Bot 干活时保持 tab 开着。
排障
另见
- Agent 接入(MCP) — Bot 用的工具集,以及如何接入外部 agent
- 侧边栏 — 带两个开关的设置面板