# @flowriki/agent 中文文档

规范地址：https://npmcn.com/package/%40flowriki/agent/

版本：0\.1\.0-beta\.72
npm 元数据更新时间：2026-10-19T10:20:06.868Z
中文译文更新时间：2026-11-15T10:53:02.586Z
软件包许可：SEE LICENSE IN LICENSE

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

原始 npm 页面：https://www.npmjs.com/package/%40flowriki/agent
原文对照：https://npmcn.com/package/%40flowriki/agent/?lang=original
项目主页：https://github.com/Muhammad-Safiullah/flowriki#readme
源码仓库：https://github.com/Muhammad-Safiullah/flowriki

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

- 包体积（解压后）：956 kB，10 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.13
- 运行依赖：5 个
- 首次发布：2026-09-11T05:52:46.496Z
- 最新版本发布：2026-10-19T10:20:06.676Z
- 近 30 天下载量：2048（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：65（近 12 个月 65 个）

## 中文简介

在自己的电脑上进行Flowriki UI测试. 连接此机器到您的 Flowriki 账户 .

## 安装

```sh
npm install @flowriki/agent
```

也可以使用：`pnpm add @flowriki/agent`、`yarn add @flowriki/agent`、`bun add @flowriki/agent`

## README

# @ flowriki/ 代理服务器

运行您的 [流动里基](https://flowriki-cloud.onrender.com/) 自己做UI测试 电脑 正在测试的浏览器和您的项目文件都留在这台机器上 .

## 要求数

-   **节点.js 22.13或更新.** Flowriki 使用时 `node:sqlite`,哪个旧版本 没有. `node --version` 告诉你.
-   npm (有节点的飞船).

## 使用

```
npx @flowriki/agent@latest connect     # approve this computer in your browser
npx @flowriki/agent@latest start       # run it — stays in the foreground
```

`start` 继续跑直到你停止它。 关闭终端停止代理; 没有安装为背景服务 .

```
npx @flowriki/agent@latest status      # connected? what is prepared?
npx @flowriki/agent@latest doctor      # diagnose setup problems
npx @flowriki/agent@latest disconnect  # forget this computer's credential
```

## 跟克洛德做笔试

代理也是 MCP 服务器,所以克劳德代码或克劳德桌面可以写入 Flowriki为你做测试, 根据你自己的计划。 Claude 打开浏览器 这台电脑,每个步骤都是在保存它之前完成的,它所写的是什么 保存到一个 **新分支** 让你在仪表板上审查和公布.

先连接此计算机( N)`connect` 然后把Flowriki添加到克洛德身上:

```
claude mcp add flowriki -- npx -y @flowriki/agent@latest mcp
```

对于克洛德桌面,将此添加到其MCP设置中(`claude_desktop_config.json`:

```json
{ "mcpServers": { "flowriki": { "command": "npx", "args": ["-y", "@flowriki/agent@latest", "mcp"] } } }
```

然后问,例如: _"写出一个Flowriki测试 签名和验证 电子邮件"_Claude读到你的项目的特征 签名简介和助手, 并使用它们。 你别跑 `mcp` 克劳德开始 有用吗 并行 `start`,在自己的浏览器窗口中.

**它不断更新自己.** `@latest` 每次都启动最新的 Flowriki Claude连接,而Claude则继续连接 Flowriki的支票 每半小时释放一次,然后在任务之间切换到它——永远不要 正在写入流量 。 下一个答案是更新的,如果新版本 带来新的工具 克劳德还没有提供这些工具 开始新的克劳德会议 (克劳德代码的终端版本), `/mcp` 然后再连接也起作用). 你们的经纪人 `start` 说,当它后面: `npm install -g @flowriki/agent@latest`,然后重新启动.

## 你不需要的东西

没有Flowriki的检查, 和没有建设. `connect` 财务报告和审定财务报表 `start` 这是 整个安装.

在仪表盘上录制、运行和调试时不需要 正在测试的工程的检出 : 服务会读取您 连接寄存器并用命令发送, 这样机器就可以是一个 从来没有克隆过任何东西.

## 提供本地报到服务

可选的,对于一个案件: 与这台机器上的文档相对比 承诺.

```
npx @flowriki/agent@latest start --project /path/to/checkout
```

重复 `--project` 几个 他们被记住,所以以后的运行不需要 参数。 每个文件夹都从 `.flowriki/project.json` 当它的数据库被连接时被执行——你从不通过一个项目代号.

一个仪表板动作仍需要: **校验未保存的步骤** 从 流程编辑器,它读取了退出而不是被发送的流程。 这个 说得那么清楚,当没有。 记录、运行和调试没有.

## 保存着的东西

证书和项目映射在 npm 缓存之外, 因此升级或 清除缓存不会丢失它们 :

|  |  |
| --- | --- |
| 窗口 | `%APPDATA%\Flowriki` |
| 马科斯 | `~/Library/Application Support/Flowriki` |
| 链接 | `$XDG_STATE_HOME/flowriki` 或者说 `~/.local/state/flowriki` |

`FLOWRIKI_HOME` 超过它.

## Flowriki 这话是跟哪一个

生产,除非你另有说法. `--service <url>` (或 `FLOWRIKI_SERVICE_URL`)指向另一个地方——我们自己的支部和支部 环境,或自动安装.

全权证书保留 **每个服务**,所以制作证书 从来没有发送 连接到一个开发者,连接到第二个并不扰动第一个开发者. `doctor` 环境应答的指纹.

这里不是你的测试站 这是一个项目设置在 仪表板 改变它 再也不需要连接这个机器了.

对于Flowriki不应打开默认浏览器的终端,请使用 `npx @flowriki/agent connect --no-open` 并打开打印批准链接。 仍需批准.

## 常见问题

### @flowriki/agent 是什么？

在自己的电脑上进行Flowriki UI测试\. 连接此机器到您的 Flowriki 账户 \.

### 如何安装 @flowriki/agent？

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

### @flowriki/agent 支持 TypeScript 吗？

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

### @flowriki/agent 支持 ESM 还是 CommonJS？

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

### @flowriki/agent 需要什么版本的 Node\.js？

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

### @flowriki/agent 可以商用吗？

@flowriki/agent 使用 SEE LICENSE IN LICENSE 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @flowriki/agent 的下载量有多少？

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

### @flowriki/agent 还在维护吗？

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