dsh-tongflow

主要功能

• 会话以 @tongflow 开头时自动切换为 Studio 界面：聊天栏、项目文件树、预览/编辑/画布与运行记录抽屉。
• agent 为每个素材生成 .tongflow.json 工作流文件，通过 TongFlow 引擎与官方插件执行，而非直接调用"生成图片"类工具。
• 项目按纯文件夹组织（如角色、分镜、音乐、导出目录），素材、workflow 与运行记录（.runs.json）就近存放，可随时手动重整。
• 支持 tongflow_workflow_compose 将文件夹内多个小工作流合并为一个按依赖排序的整体工作流。
• 运行涉及付费插件（API Key 或 Modal GPU）时会先返回计费提示，需用户明确确认后才执行。
• 首次使用会自动创建 Python 虚拟环境并克隆官方 TongFlow 插件列表，画布节点目录与官方托管版一致。

适合什么时候用

• 需要在 DSH 中制作分镜漫剧/短片等多素材项目，希望每个生成步骤都可复现、可追溯。
• 希望用可视化工作流画布搭建和调整图片/配音/音乐/视频生成流程，并让 agent 按此流程持续迭代。
• 涉及付费生成插件（API Key 或 Modal GPU），需要在每次实际花费前得到明确确认。

安装后会多出什么

使用前需要

• DSH ≥ 0.1.0-rc.7（含 0.1.1-rc 系列），Node ≥ 22.19
• 系统需安装 Python ≥ 3.10、git、ffmpeg
• 首次使用会自动创建 Python 虚拟环境并克隆官方 TongFlow 插件（可关闭自动安装）
• 使用付费插件需配置相应 API Key 或 Modal 账号
• 若需 agent 查看生成图片（tongflow_look），需配置支持视觉的聊天模型