# @clemrig/flow-ui 中文文档

规范地址：https://npmcn.com/package/%40clemrig/flow-ui/

版本：0\.15\.0
npm 元数据更新时间：2026-11-09T20:37:53.449Z
中文译文更新时间：2026-11-10T01:08:43.827Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40clemrig/flow-ui
原文对照：https://npmcn.com/package/%40clemrig/flow-ui/?lang=original
项目主页：https://github.com/clementchesneau/clemrig-factory-v2#readme
源码仓库：https://github.com/clementchesneau/clemrig-factory-v2

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：339 kB，18 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=24
- 运行依赖：1 个
- 首次发布：2026-10-10T20:22:18.185Z
- 最新版本发布：2026-11-09T20:37:53.241Z
- 近 30 天下载量：3628（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：20（近 12 个月 20 个）

## 中文简介

@ clemrig/ flow 工作流程运行的本地只读仪表板

## 安装

```sh
npm install @clemrig/flow-ui
```

也可以使用：`pnpm add @clemrig/flow-ui`、`yarn add @clemrig/flow-ui`、`bun add @clemrig/flow-ui`

## README

# @ clemrig/ flow-ui (法语)

本地只读的仪表板 [`@clemrig/flow`](https://www.npmjs.com/package/@clemrig/flow) 工作流程.

## 使用

需要macOS或Linux和节点.js 24或更晚.

```sh
npm install -g @clemrig/flow-ui
flow-ui [RUNS_DIR] [--port PORT]
```

`flow-ui` 服务运行在 `RUNS_DIR` (默认 : `.flow/runs`时 `@clemrig/flow` 保留它们;a `RUNS_DIR` 给定必须是已存在的目录) `127.0.0.1`打开 `PORT` 或系统选择的端口,打印其 URL并在 Ctrl-C 上停止。 页面显示您可以折叠的栏杆中的跑道,按日分组,按其输入命名,按状态或工作流程过滤并搜索(`/`) (中文(简体) ). 运行显示它的名称、状态、结果的链接、投入和数字(启动、结束、有效时间、与初步预算相比的费用,分配每个预算,以及来自徘徊、发射、轮回和阶段处决),在三个分页以上。 时间线:在一栏上发射(第一次,然后每次恢复),每个栏按活动时间按当天和开始时间大小,两个栏间暂停,为什么每个栏间停止,一个栏间打开它运行的内容(版本、提示、运行时间、预算及其来源、机器、目录、运行时间的变量集、给出的数值),自发射以来在标记前发生了哪些变化; (b) 更正台词;下面,选定执行台词的面板,每题题有分页; 对于代理阶段,其主要代理从第一步读到最新一步,以符号表示,其步骤(主要代理响应),工具呼叫,子代理包含,成本,当一个呼叫自身成本不明时部分成本(一个呼叫自身成本:它所宣布的,或Claude Code,其数字是会话总数,总数减去会话在运行中先前的呼叫总数); 其代理:运行时间,模式和努力,权限,以及它们来自何处,工具 配置列表和会话加载多少,对话,暂停;每次通话,以及使用的工具),配置(每场会议都与什么有关,正如会议在舞台上首次呼叫宣布的那样:除宣布的运行时间外,还设定了哪些概况,以及报告的差异; 对于Claude Code,内置工具,MCP工具通过服务器,子代理,技能,命令(操作员)和插件,每个工具都有配置集和所装入的内容,在每个项目上打开标记其配置文件允许的内容:允许,拒绝(不在它的允许模式下的工具中,除非机器的规则没有记录,允许它),未决定(它没有列出工具,或者它的模式决定),在它的工具中,没有加载,或者,对于子代理和技能,没有他们需要的代理或技能工具;对于Pi,其工具,技能和扩展; Codex说它不宣布它的配置; 然后系统随即发出:运行时间的自身和工作流程的大小,只在对话的第一次通话时大小,部分估计并标出QQ),输入(每次通话发送的是什么:部分发送其信息,由于对话已经发出而命名而不是发送请求,然后请求和命令准确),输出(舞台返回,发送或无法发送的更正,舞台返回时每个呼叫的最后文本,以及成功记录错误输出的呼叫)和活性(它的呼叫,工具呼叫,日记,运行的钩子,一个失败的标记,运行时间报告,如拒绝的工具,限制,重复和收缩,以及警告,在一个可以过滤的时间内). 成本:在每次发射的预算已知的情况下,按会场和运行期间的费用。 结果:它的结果,它的数据作为您所表现的树, 它的运行时间. 地址保存运行及其标签,并在时间线上保存所选择的执行和被执行的标签(`#/<id>/stages/<n>/<tab>`, (中文(简体) ), `#/<id>/cost`, (中文(简体) ), `#/<id>/result`; 当另一个标签打开时, 时间线会保持选择执行, 发射打开, 活动的过滤器和车道的缩放和滚动, 铁路中选择的运行会在同一标签上打开 。 在时间线上, `j`, (中文(简体) ), `k` 财务报告和审定财务报表 `f` 在处决之间采取行动,以及 `1` 改为 `5` 打开执行的标签(3个代码级)。 它跟随运行运行,在恢复运行时再次跟随所选运行. 结果显示运行的验证数据为JSON.

要在另一台机器上观看运行, 请通过 SSH 转发同一端口 : `ssh -L 4321:127.0.0.1:4321 machine`运行 `flow-ui --port 4321` 在那里,打开 `http://localhost:4321/`。 。 。 .

当它运行时,任何能够达到的地方进程 `127.0.0.1` 可以读取它所服务的运行.

## 从代码

```ts
import { startDashboard } from "@clemrig/flow-ui";

const dashboard = await startDashboard({
  runsDir: ".flow/runs",
  title: "flow",
  label: "my-project",
  presentResult: (state) => [JSON.stringify(state.data)], // optional
});
console.log(dashboard.url);
// later: await dashboard.close();
```

与 `presentResult`,运行的结果是其行,页面显示运行在行下折叠的验证数据.

`dashboardHandler(options)` 提供与请求处理器相同的仪表板, 对于服务于其它页面的服务器: 它回答 `(request, response, url)`时 `url` 是请求的地址,相对于仪表板的挂载地点(`/api/runs` 页:1 `/runs/api/runs`),拒绝,如: `startDashboard`,每一种方法,但获取和任何 `Host` 其地址除外。 页面本身的地址是相对的,所以在结束于任何路径下工作 `/`。 。 。 .

## 许可证

麻省理工学院

## 常见问题

### @clemrig/flow-ui 是什么？

@ clemrig/ flow 工作流程运行的本地只读仪表板

### 如何安装 @clemrig/flow-ui？

在项目目录运行 npm install @clemrig/flow-ui，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 flow-ui，可以用 npx flow-ui 直接运行。

### @clemrig/flow-ui 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/clemrig\_\_flow-ui 是否存在。

### @clemrig/flow-ui 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @clemrig/flow-ui 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=24。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @clemrig/flow-ui 可以商用吗？

@clemrig/flow-ui 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @clemrig/flow-ui 的下载量有多少？

根据 npm 官方下载统计，@clemrig/flow-ui 在 2026/10/10 – 2026/11/08 这 30 天内被下载 3,628 次，日均约 121 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @clemrig/flow-ui 还在维护吗？

最新版本 0\.15\.0 发布于 2026/11/10（今天）；至今共发布 20 个版本，其中过去 12 个月发布了 20 个；首次发布于 2026/10/11。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。