本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

tongflow

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-tongflow

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• macOS (Universal — Apple Silicon & Intel): TongFlow-mac-universal.dmg
• Windows: TongFlow-win-x64.msi
• All modalities: TongFlow supports almost every modality and file format that people actually ship over the web.
• ✅ Text input: type text and add a text node.
• ✅ Add image: pick a local file and add an image node.

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

怎么触发 TongFlow Studio 模式？

新会话的第一条消息以 @tongflow 开头即可激活 Studio UI 与 tongflow_* 工具；其它会话维持普通 DSH。源码 src/activation.ts:17-24。

一张图片是怎么生成的？

Agent 在对应文件夹里用 tongflow_workflow_new 建一个 .tongflow.json，再用 tongflow_workflow_patch 描述节点和连线，最后 tongflow_workflow_run 运行；产出文件落在工作流旁边，编号递增，不会覆盖。src/tools/workflow-tools.ts:33-75、src/tools/run-tools.ts:72-78。

需要哪些运行环境？

dsh ≥ 0.1.0-rc.7、Node ≥ 22.19、Python ≥ 3.10（自动创建 ~/.dsh/tongflow/venv 安装 tongflow SDK）、git，视频审看还需 ffmpeg。README.md:23、src/engine/bootstrap.ts:18-27。

项目文件存在哪里？

默认在 ~/.dsh/tongflow/projects//，是普通文件夹，仅 project.json 是固定结构，其余由 Agent/用户按需设计。src/project/paths.ts:9-20、README.md:49-54。

付费插件会扣费吗？

tongflow_workflow_run 不带 user_confirmed=true 时返回 needs_confirmation 拒绝执行，必须由用户在当前会话明确同意后才跑；本地插件无需确认直接执行。src/tools/run-tools.ts:78。

怎么查看插件都装了哪些？

启动时若 autoInstallOfficial=true，会自动 shallow-clone 官方插件到 ~/.dsh/tongflow/plugins，可通过 tongflow_plugins_list 或 canvas 看全量节点目录。src/studio.ts:65-72、src/engine/registry.ts:46。

卸载会留下数据吗？

插件卸载后 ~/.dsh/tongflow 下的项目文件夹、venv、已克隆的官方插件、env.json 等都不会自动清理，需要手动删除。源码未发现删除逻辑。

— 源: plugin_wiki.faq_json

兼容性

• DSH: >=0.1.0-rc.7
• Node: >=22.19.0

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则