# #10 【开源代码解析·Toonflow】解析 Toonflow-app 源码并提炼对我们有用的知识，写成文档存档。代码在 /home/zyf/桌面/开源项目/Toonflow-app（37M，monorepo：apps/ packages/ docs/），已下载完成。要提炼：① 它怎么接入本地 ComfyUI 与本地 LLM（配置项、代码路径、参数原样）② 角色一致性与角色资产管理怎么做的 ③ 无限画布+剧本分镜的数据结构 ④ 能搬进我们现有流程（ComfyUI+H3+晚风）的点子。产出：一份中文文档放 ~/桌面/重要资料/（文件名含 Toonflow），并在工程日志注明产出绝对路径。来源：用户 2026-10-14 交办（他说「解析序号一那个玩意儿」，即清单里 Toonflow-app 那条）。

归属日期: 2026-10-14
序号: 10
当前状态: ✅ 已通过（第1次）
被接手次数: 1

该任务出现时间为
2026-10-14-本次第一次

---

## 2026-10-14 第1次
- 执行者: deepseek-v4-flash（晚风）
- 做了什么:
  1. 下载：`git clone --depth 1 https://github.com/HBAI-Ltd/Toonflow-app.git`（走本机代理 7897）→ `/home/zyf/桌面/开源项目/Toonflow-app`
  2. 逐层解析：apps(desktop/mobile/server/updateServer/web) + packages(providers/nodes/ext/nodeScaffold/extScaffold/mcp...) 结构与关键模块
  3. 产出中文解析文档并落盘
- 证据（真命令 + 原始输出）:
  - 下载完成：`du -sh` → `37M  Toonflow-app`
  - provider 注册表 `packages/providers/index.ts`：
    `export const languageProviders = [tfRouterLanguage, deepSeek]`
    `export const mediaProviders = [tfRouterMedia, apiMart, metaso, compshare]`  ← **无 comfyui**
  - `grep -ri comfy`（摘）仅命中三处：`README.md`（宣传语+FAQ）、`packages/providers/src/media/metaso.ts`（秘塔广告文案）、`apps/web/src/components/settings/panels/mediaModel/providerPrompt.ts`（一段给 AI 的接入提示词）
  - provider 接口类型 `packages/providers/types.d.ts`：`ProviderModel{id,label,type,think?,mode?,...}` / `ProviderContext{config,signal,tool}` / `ProviderTools{fetch,media,audio,ffmpeg...}` / `MediaInput{url|base64|binary}`
  - `apps/web/.../providerPrompt.ts` 原文：用户把这段提示词交给自己的 AI → AI 生成一个能导入 Toonflow 的 `.ts` provider；导入路径「设置 → 媒体模型 → 添加自定义供应商（文件导入 / 粘贴代码）」
  - `curl /ai_done` 返回：`{"ok":true,"seq":10,"log":"#10_【开源代码解析·Toonflow】解析 Toonflow-app 源码并提炼对我.md"}`
- 结论:
  - Toonflow **能**接本地 ComfyUI，但**代码里没有现成的 ComfyUI 适配器**；官方路径是「让 AI 生成一个 provider `.ts` → 导入」
  - 内置 provider 全是云（deepSeek / TF-router / apiMart / compshare / metaso）
  - AI Agent 基于第三方 `@earendil-works/pi-coding-agent`；画布 = 插件化节点；角色一致性 = 工程约定（引用同一份资产文件，无专门算法）
- 产物: `/home/zyf/桌面/重要资料/Toonflow-app_源码解析_20261014.md`（8481 字节）
- 备份/回滚: 无（纯只读解析，未改动 Toonflow 源码，未部署任何服务）
- 遗留/卡点: 无。若日后真要接本地 ComfyUI，下一步是按 `types.d.ts` 写一个 `comfyui` provider `.ts`（可复用官方 providerPrompt 让 AI 生成）。

## 2026-10-14 验收通过
- 验收人: 用户
- 备注: （无）