微信遥控 ComfyUI 出图 · 完整实战链路

日期：2026-06-27 初次打通 → 07-02 系统整理
场景：人在外面用手机拍照，发微信给二哥，二哥远程指挥家里的台式机 ComfyUI 出图，图片回传到手机
经典战例：316 寝室苏州聚会，20+ 张实拍照片，远程生成白描风格纪念线稿
核心工具链：微信/飞书 → CC → ComfyUI (NanoBanana2 via 通用API节点)
⚠️ 2026-07 更新：BizyAir 已关停。替代方案：ComfyUI 内置的 API-Universal 通用节点 + APIYI / GrsAI 中转站，无需专用节点。

---

一、一张图看懂全链路

核心思路：手机是遥控器，微信是传输通道，二哥（WorkBuddy/Claude）是指挥中枢，ComfyUI 是发动机，BizyAir 云端 API 是燃料。全程不需要坐在电脑前，不需要打开 ComfyUI 的图形界面。

---

二、关键节点逐一拆解

2.1 准备工作：ComfyUI + API 工作流

这是整条链路最重要的前提——你需要先把工作流搭好、测试好、导出好。 不是打开就能用，而是提前做完"编排→导出→存模板"三步。

步骤	操作	为什么
① 编排工作流	在 ComfyUI 图形界面连好节点：LoadImage → BizyAir_NanoBanana2 → SaveImage	这是出图的"配方"
② 删干净多余节点	只保留三个在用节点，其他全删	否则二哥找不到真正在用的节点
③ Ctrl+S 存盘	正常保存一份 .json	备份，你自己以后打开改
④ 导出 API 格式	菜单 → Workflow → Export (API)	去可视化，纯节点 ID + 参数，给二哥用
⑤ 存为模板文件	另存为 template_single.json / template_group.json	二哥批量改参数时直接读模板

2.2 ComfyUI 的两种运行状态

这是最容易被忽略、也最关键的细节：

状态	你在做什么	二哥能干什么	注意
开着 GUI 界面	打开 ComfyUI 桌面版，画布/节点/连线全显示	✅ API 提交任务 → GUI 底部队列可见进度	开了就行，不需要打开任何工作流文件
只开后台服务 （无 GUI）	命令行启动	✅ API 完全可用，全程静默	二哥不知道进度，只能轮询
完全没开	—	❌ 端口不通，所有操作失败	二哥会 curl 检测，然后提醒你开

2.3 微信桥接：消息如何到达二哥

你在手机微信里发照片和指令 → 微信 ClawBot AI 接收 → 消息转发到 WorkBuddy 中的二哥（Claude）→ 二哥开始执行。

桥接具体是用什么工具实现的？老实说——二哥自己不记得了（每个 session 独立，微信端的对话对 WorkBuddy 不可见）。但我们知道以下事实：

1. 微信端对话确实发生过（2026-06-27 有完整聊天记录为证）
2. 二哥成功调用了 ComfyUI（photo-to-lineart skill 里有当天的成功案例记录）
3. cc-connect（一个支持 11 个聊天平台的 Go 工具）已被验证可以桥接飞书和 Claude Code，理论上微信也在支持列表

这意味着：桥接层是可复现的。 即使当前 session 断了记忆，重建桥接只需要 10 分钟。

2.4 提示词工程：白描线稿的核心秘密

这是整条链路中"手艺"含量最高的环节。不是随便说"转成线稿"就行——BizyAir NanoBanana2 对提示词极其敏感。

单人白描模板：

Convert this photo into a pure black and white line art illustration. 
ONLY black outlines on pure white background. No color, no gray, 
no shading, no fills. Clean manga lineart style. Preserve the person's 
facial features, expression, hairstyle, glasses, and clothing details 
with rich, detailed linework. Simplified cartoon IP character style. 
Clean white background with no background elements.

多人合照 + 标注模板：

Convert this group photo into a pure black and white line art illustration 
(manga/白描 style). ONLY black outlines on clean white background. 
No color, no gray, no shading, no fills. Preserve all [N] people's 
facial features, expressions, and poses with rich detail.

- LEFT person: [特征] — label them "[称呼]" in small elegant text near shoulder
- CENTER person: [特征] — label them "[称呼]" in small elegant text near shoulder
- RIGHT person: [特征] — label them "[称呼]" in small elegant text near shoulder

Add a title at the top: 「[标题]」 in bold artistic calligraphy.
Add a signature at bottom right: "[落款]" in refined small text.
Clean white background with NO background elements.

技巧	说明	反面案例
强调纯黑白	ONLY black outlines, no gray, no shading, no fills	只说 "line art" → 可能带灰阶阴影
明确去背景	Clean white background with NO background elements	不写 → 背景建筑/树木也被线描化
列出具体特征	glasses, hairstyle, expression	只说 "preserve features" → 特征丢失
文字标注	label them "老大" in small elegant text near shoulder	不写 → 无标注，NanoBanana2 支持图中生成文字
指定分辨率	resolution: "2K"	不写 → 默认可能偏低

2.5 ComfyUI API：提交、轮询、取结果

这是二哥执行的核心代码逻辑，不需要你操作，但你了解原理能更好地配合：

1. 检查端口：curl http://127.0.0.1:8188/object_info 确认 ComfyUI 在线
2. 准备输入：把你发的照片复制到 ComfyUI 的 input 目录
3. 修改模板：读 API 格式模板 JSON → 改 LoadImage 的图片名 → 改 NanoBanana2 的提示词
4. POST 提交：POST /prompt 提交工作流 → 拿到 prompt_id
5. 轮询等待：每 30 秒 GET /history/{prompt_id} 查看状态 → 直到 outputs 有结果
6. 取结果：从 output 目录复制图片 → 回传给你

参数	值	说明
端地址	http://127.0.0.1:8188	ComfyUI Desktop
提交接口	POST /prompt	body: {"prompt": workflow_json, "client_id": uuid}
查询接口	GET /history/{prompt_id}	轮询间隔 30 秒
温度	1.0	创造性
top_p	0.95	采样范围
分辨率	2K	输出分辨率
单张耗时	30 秒 ~ 3 分钟	取决于图片复杂度和 API 排队

2.6 回传：图片如何回到你的手机

出图后：ComfyUI output 目录 → 二哥复制到 WorkBuddy outputs/ → 通过桥接程序回传微信。

这里有一个已经被实测确认的限制：

微信传图会压缩。 手机收到的图片分辨率会被压缩（实测长边约 3000px，宽边约 1280px）。如果是建筑效果图这类对精度要求高的场景，建议同时上传到 winewet.com 网站，发链接给你看高清原图。白描线稿这种风格化图片，压缩后肉眼几乎无差别，可以接受。

---

三、踩过的坑（血泪总结）

#	坑	表现	解决方案
1	ComfyUI 未启动	8188 端口不通，API 调用失败	出门前双击 ComfyUI Desktop 图标启动，用 curl 127.0.0.1:8188 验证
2	工作流节点冗余	导出 API 格式后，二哥改提示词时找不到正确的节点	导出前删干净所有多余节点，只留 LoadImage → Model → SaveImage
3	轮询盲区	图已经跑好，二哥还在等	你说"跑完没？"即可触发二哥主动查询
4	背景元素泄漏	白描图里出现了建筑、树木等背景线稿	提示词加强：NO background elements, ONLY the person remains
5	微信传图压缩	高清效果图在微信里模糊	白描图无所谓；效果图走网站链接
6	API Key 过期	任务提交后一直 waiting 不出结果	检查 BizyAir API Key，重新获取

---

四、实战案例：316 苏州聚会白描线稿

2026年6月27日，八弟在苏州太湖边和大学室友聚会。人到了，照片拍了，但要做成纪念版白描线稿——人在外面，电脑在家。于是整条链路第一次实战验证：

4.1 实拍 vs 白描：第一组

老五、老六两人合影，生成双人白描线稿，保留人物特征和互动氛围。点击图片可放大查看。

4.2 实拍 vs 白描：第二组

老大、老二两人合照，老大大笑脸、老二黑T恤戴眼镜，生成双人白描纪念图。

4.3 实拍 vs 白描：第三组

三人合影（老大、老六、老七），提取三人生成带标注的白描头像，背景适当保留。

这次实战证明了：物理距离不是障碍。只要 ComfyUI 在家开着，二哥在线，你在任何有网的地方都能出图。

---

五、速查：出门前的 Checklist

✅	检查项	命令 / 操作
☐	ComfyUI Desktop 已启动	双击桌面 ComfyUI Desktop 图标，确认 8188 端口就绪
☐	8188 端口就绪	浏览器打开 http://127.0.0.1:8188 有返回
☐	BizyAir 节点可用	在 ComfyUI 里确认 BizyAir_NanoBanana2 节点存在
☐	模板文件就位	template_single.json / template_group.json 在工作目录
☐	微信桥接连通	手机上给 ClawBot 发一条测试消息，确认回复
☐	API Key 有效	BizyAir API Key 未过期

---

六、关键路径速查

组件	路径 / 说明
ComfyUI Desktop 主程序	C:\Users\sy10sd1\AppData\Local\Programs\Comfy Desktop\
API 端口	127.0.0.1:8188
照片输入目录	C:\Users\sy10sd1\Documents\ComfyUI\input\
图片输出目录	C:\Users\sy10sd1\Documents\ComfyUI\output\
成果交付目录	C:\Users\sy10sd1\WorkBuddy\Claw\outputs\
白描线稿 Skill	~/.workbuddy/skills/photo-to-lineart/
模板-单人	template_single.json
模板-多人	template_group.json