# @arcforgelabs/flow 中文文档

规范地址：https://npmcn.com/package/%40arcforgelabs/flow/

版本：2026\.11\.1
npm 元数据更新时间：2026-11-07T13:03:47.242Z
中文译文更新时间：2026-11-07T19:36:07.390Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：5 MB，274 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=24
- 运行依赖：23 个
- 首次发布：2026-10-18T11:57:42.054Z
- 最新版本发布：2026-11-07T13:03:46.922Z
- 近 30 天下载量：2908（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：45（近 12 个月 45 个）

## 中文简介

开具发票、账单和实验室财务仪表板 与Seazona和Xero合并.

## 安装

```sh
npm install @arcforgelabs/flow
```

也可以使用：`pnpm add @arcforgelabs/flow`、`yarn add @arcforgelabs/flow`、`bun add @arcforgelabs/flow`

## README

# 流动

流动是工作管理、发票、账单批准和实验室的财务仪表板,用于 工作订购, 首先为牙科实验室。 Seazona(实验室的个案系统)是 捆绑整合,而Xero是可选的. 见 `VISION.md`。 。 。 .

流动由Arc Forge Labs维护,地点是 [弧形平面/流量](https://github.com/arcforgelabs/flow)。 。 。 .

许可证:麻省理工学院(`LICENSE`) (中文(简体) ).

## 状态

这个存放所是"流"的新家园,有新的历史. 代码移动到这里 从早先的私人代码库中一次一个模块(`CONTRIBUTING.md`, (中文(简体) ), "从早期的密码库"). 今天它掌握着存放处的规则, CI,放出轨迹(npm,容器图像和GitHub放出,在β和 稳定通道、整合港、健康检查、办事员签入 角色保存在 Flow 中, 给所有者的 Person 页面, 设计系统 Arc Forge Labs' Field 使用,核心的第一部分: PostgreSQL 数据模型 组织、联系人、价格清单和发票。 它还没有准备好 运行一个实验室.

## 文档

| 文档 | 它是为了什么 |
| --- | --- |
| `VISION.md` | 流动是为了什么,核心及其融合,以及它不会做什么 |
| `AGENTS.md` | 代理入境点( E)`CLAUDE.md` 链接到它) |
| `CONTRIBUTING.md` | 如何提交问题和拉动请求,移植规则,更改日志,合并 |
| `CHANGELOG.md` | 每次发布的变化:每发布一个文件的索引 `CHANGELOG/` |
| `SECURITY.md` | 如何报告一个安全问题, 信任模式,和规则 很难 |
| `LICENSE` | 麻省理工学院许可证 |
| `docs/docs.json` | 文献站点导航. `docs/` 发表于 [https://arcforgelabs.github.io/docs/flow/ (中文(简体) )](https://arcforgelabs.github.io/docs/flow/) 由 arcforgelabs/docs 编辑 |
| `docs/index.md` | 文件网站主页 |
| `docs/releases/` | 每个版本一个发布注释页(`<version>.md`),显示于文档站点 |
| `docs/DESIGN.md` | 设计系统(主题家族)、网页和办事员组件如何使用以及屏幕 |
| `docs/DESIGN_SYSTEM.md` | 流程设计系统文物:如何 `npm run design-system` 从代码、每个共享组件的卡片、出版和审查中建立 |
| `docs/MOBILE_TESTS.md` | 电话套间:WebKit和Chrimium中每张手机、平板电脑和办公桌大小的屏幕、支票和预算、三个宽度、保存的图像 |
| `docs/DATA_MODEL.md` | PostgreSQL 记录, 数据库的规则, 以及如何改变计划 |
| `docs/DATA_SPINE.md` | 表格和任务的设计 每一个集成共享: 镜像、 身份映射、 任务队列、 发件箱、 审查队列 |
| `docs/JOB_INVOICE_LINKS.md` | 管道:每项工作如何与客户和向其开具账单的会计发票挂钩 |
| `docs/INVOICING_RULES.md` | 开具工作发票的规则 开具工作发票的两种方式 |
| `docs/INVOICE_RULES.md` | 发票规则 实验室的建设(何时,如果,然后) 使一个准备好的工作等待 或从来没有起草 |
| `docs/INVOICE_SENDING.md` | 发票分页(定出、准备、草稿、批准、发送、沃德),更改工作,并将所有准备就绪者送交会计系统 |
| `docs/CONTACTS.md` | 联系人:Flow的客户和供应商,从一个用户创建出缺失的Xero客户端 |
| `docs/RECONCILE.md` | 每日核对:工作系统副本、分类账和会计副本每日清点数和总数 |
| `docs/ALERTS.md` | 静悄悄的警示:当某事需要一个人时,页面上的细线,以及一个人如何解职 |
| `docs/AUTOMATIONS.md` | 自动化: 流程常规, 标记已准备好开具发票和起草的工作, 每张开或关闭 |
| `docs/LINE_MAPPING.md` | 线条映射:每个工作系统线条如何找到其价格项目,以及设置中的价格代码 |
| `docs/CUSTOM_FIELDS.md` | 自定义字段:实验室自己的工作字段,只保留在流程中,以及棋盘移动如何检查冲突 |
| `docs/JOB_BOARD_MOVES.md` | 在 Jobs 板上移动工作: 自定义字段移动停留在 Flow; Seazona 阶段移动成为交接 |
| `docs/PRICE_LIST.md` | 物价列表:流量本身的代码和价格,它们与Xero项目和Seazona产品的联系,以及价格检查 |
| `docs/AI_BOTS.md` | AI bots: ClawSweeper评论和Docs代理,他们的ClawRouter预算和费用,以及设置 |
| `docs/LOW_RISK_MERGE.md` | 低风险合并道: 绿色时拉出请求合并, 有 ClawSweeper 的风险标签 |
| `docs/RELEASING.md` | 版本和频道,发布工作流程,如何剪接和回滚发布,一次性设置 |
| `docs/AGENT_ACCESS.md` | 默认本地 MCP 读取工具、 赠款、 主机门和股票 OpenClaw 设置 |
| `docs/SELF_HOSTING.md` | 运行带有 Docker, Node 或 Replit 的 Flow 发布, 更新通知, 以及办事员签名 |
| `docs/REPLIT.md` | 此寄存器的工作空间遵循释放通道( R) `FLOW_DEPLOY_REF`(中文(简体) ) |
| `docs/INTEGRATIONS.md` | 集成适配器是如何建造、打开和关闭的,并拥有其桌子 |
| `docs/XERO.md` | Xero 适配器:模式、设置、费率限制、连接 Xero 和发票草稿 |
| `docs/XERO_IMPORT.md` | Xero 进口:每张Xero 发票在Flow的复制本中与它的Flow 发票相连,或写成一张 |
| `docs/SEAZONA.md` | Seazona 适配器: 模式、 设置、 速率向导、 重放文件及其表格 |
| `docs/SENTRY.md` | 哨兵适配器:错误和问题报告给装置自己的哨兵项目 |
| `server/integrations/port.js` | 每个适配器的集成端口 |

## 开始

要求:节点24,npm和PostgreSQL 16或更后.

```bash
npm ci
FLOW_TEST_DATABASE_URL=postgres://… npm test   # a throwaway database
DATABASE_URL=postgres://… npm start             # http://localhost:19300/health
```

## 常见问题

### @arcforgelabs/flow 是什么？

开具发票、账单和实验室财务仪表板 与Seazona和Xero合并\.

### 如何安装 @arcforgelabs/flow？

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

### @arcforgelabs/flow 支持 TypeScript 吗？

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

### @arcforgelabs/flow 支持 ESM 还是 CommonJS？

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

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

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

### @arcforgelabs/flow 可以商用吗？

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

### @arcforgelabs/flow 的下载量有多少？

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

### @arcforgelabs/flow 还在维护吗？

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