用途
flow-view 的目标是把 CocoFlow 流水线渲染成可交互的 HTML 可视化（DAG），并默认在浏览器中打开。它属于 CocoPlus 插件体系，用于查看当前 flow.json 所描述的流水线状态。
主要能力
- 优先检查 CocoConsole 是否运行：读取 .cocoplus/lifecycle/console-state.json，若其中 running 为 true 且包含 port 值，则输出“Opening Flow panel in CocoConsole.”并打开 http://localhost:<port>/flow，随后停止，不生成独立快照。
- 独立快照模式：当 CocoConsole 未运行时，读取 .cocoplus/flow.json，将数据注入 HTML 模板，生成独立的 flow-view.html 文件。
- 状态汇总：从 nodes 数组中按 status 字段统计节点数量（排除 type 为 "control" 的节点），在输出中报告流水线名称、阶段数与状态分布（如 success / running / pending 等）。
- 只读操作：不创建 git 提交。
使用方式
执行前会进行预检：
- 检查 .cocoplus/ 是否存在。若不存在，输出“CocoPlus not initialized in this directory. Run $pod init to begin.”并停止。
- 读取 .cocoplus/flow.json。若文件缺失，输出“No flow.json found. Run $plan first to generate an execution flow.”并停止；若 JSON 无效，输出“flow.json contains invalid JSON: . Fix the file and retry.”并停止；若缺少 nodes 数组，输出“Invalid flow.json: missing "nodes" array. Ensure $plan has completed successfully.”并停止。
- 定位模板：~/.coco/plugins/cocoplus/templates/flow-view.html.template（Windows 为 %APPDATA%\coco\plugins\cocoplus\templates\flow-view.html.template）。若模板缺失，输出“CocoView template not found. Reinstall the CocoPlus plugin.”并停止。
- 注入数据：在模板中查找 /* FLOW_INJECTION_START / 与 / FLOW_INJECTION_END / 标记，将两者之间（含标记）替换为： / FLOW_INJECTION_START / const INJECTED_FLOW_DATA = <flow.json contents serialized via JSON.stringify>; / FLOW_INJECTION_END */
- 确定输出路径：默认为 .cocoplus/flow-view.html；若提供了 --output <path>，则使用该路径，必要时创建父目录。写入时覆盖已有文件，始终重新生成。
- 打开浏览器（仅默认路径）：若未提供 --output，则按平台打开文件——macOS 使用 open .cocoplus/flow-view.html，Linux 使用 xdg-open .cocoplus/flow-view.html，Windows 使用 powershell -Command "Invoke-Item '.cocoplus/flow-view.html'"。若打开命令失败或平台不确定，则跳过并在输出中注明路径。
输出示例：
- 成功打开浏览器：✓ Flow visualizer opened in browser. File: .cocoplus/flow-view.html Pipeline: <project name> — <N> stages · <X success / Y running / Z pending / ...>
- --output 模式（不打开浏览器）：✓ Flow visualizer written to: <path> Pipeline: <project name> — <N> stages · <X success / Y running / Z pending / ...> Open this file in any browser to view.
- 浏览器打开失败的回退：✓ Flow visualizer written to: .cocoplus/flow-view.html Could not open browser automatically. Open the file above manually. Pipeline: <project name> — <N> stages · <X success / Y running / Z pending / ...>
适用场景
- 需要以图形方式查看 CocoFlow 流水线结构与各阶段状态。
- 在 CocoConsole 运行时，希望直接在控制台面板中查看 Flow。
- 在无 CocoConsole 环境下，生成可独立打开的 HTML 快照用于查看或分享。
限制
- 依赖 .cocoplus/ 目录与 flow.json 文件，未初始化或文件缺失/无效时无法生成。
- 依赖 CocoPlus 插件模板文件，模板缺失时需重装插件。
- 为只读操作，不创建 git 提交。
- 关于收费、价格、平台支持范围等更多信息，资料中暂未提供。