# @forum-ai/cli 中文文档

规范地址：https://npmcn.com/package/%40forum-ai/cli/

版本：0\.4\.0
npm 元数据更新时间：2026-10-05T12:46:17.697Z
中文译文更新时间：2026-11-15T09:52:24.619Z
软件包许可：UNLICENSED

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

原始 npm 页面：https://www.npmjs.com/package/%40forum-ai/cli
原文对照：https://npmcn.com/package/%40forum-ai/cli/?lang=original
项目主页：https://github.com/Remark-Inc/platform#readme
源码仓库：https://github.com/Remark-Inc/platform

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

- 包体积（解压后）：471 kB，6 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=24
- 运行依赖：0 个
- 首次发布：2026-09-29T14:53:46.264Z
- 最新版本发布：2026-10-05T12:46:17.519Z
- 近 30 天下载量：4098（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：4（近 12 个月 4 个）

## 中文简介

为论坛AI导入并获取执行证据.

## 安装

```sh
npm install @forum-ai/cli
```

也可以使用：`pnpm add @forum-ai/cli`、`yarn add @forum-ai/cli`、`bun add @forum-ai/cli`

## README

# AI CLI论坛

`@forum-ai/cli` 0.4.0通过会话协议v2. 使用节点. js 24或后期记录本地会话.

```sh
npm install -g @forum-ai/cli@0.4.0
forum --version
forum --help
```

一个对话或工作流程会话是一个可浏览的录音和评价单位。 转动和成员痕迹成为不可改变的会议修订中的证据碎片。 压缩不会启动新会话 。 土著儿童会议仍然分开,有明确的父母联系.

## 导入提供者

配置 `FORUM_BASE_URL` 财务报告和审定财务报表 `FORUM_IMPORT_TOKEN` 从 **添加会话 — 导入已存在的痕迹**。目的地 `FORUM_API_KEY` 还行 保持源证书本地化.

```sh
forum projects --source langsmith
forum preview --source langsmith --project PROJECT_ID --out preview.json
forum import --plan preview.json
forum continue --plan preview.json --out next-preview.json
```

使用 `langfuse` 或者说 `braintrust` 给那些供应商。 配置 `LANGSMITH_API_KEY`, (中文(简体) ), `BRAINTRUST_API_KEY`,或两者兼有 `LANGFUSE_PUBLIC_KEY` 财务报告和审定财务报表 `LANGFUSE_SECRET_KEY` 私下.

| 提供者 | 明确本地会议身份 |
| --- | --- |
| 兰斯密斯 | `extra.metadata.thread_id` 或者说 `extra.metadata.session_id` |
| 兰福斯 | `sessionId` |
| 大脑信任 | `metadata.thread_id`, (中文(简体) ), `metadata.session_id`,或 `metadata.conversation_id` |

鉴定范围按提供者、终点和项目划分。 缺少会话身份会从痕量身份中产生一个决定性的独立会话. 标题,用户,时间戳,单是项目都从未建立会员资格.

预览默认为7天,最多100个会话. 选定会议的日期;包括所有可用的成员痕迹,包括该期间以外的成员。 检查会员,计数,限制,进口前的延续. 提供者预览在导入时冻结身份并取出证据.

需要3版预览. 重现更古老的计划. 继续跳过先前选择,而不分割会话 。 使用本地生成的预览; 从不运行带有证书的不可信计划 .

私人快递检查站与预览和目的地相接. 在发送中断后重试同一命令 。 更改的证据要求 `--refresh`,在提交更新之前读取当前片段版本。 未知的交付结果保留了确切的重试请求;经确认的冲突允许明确更新.

在所有选定成员抵达之前,导入仍然有效。 已完成的进口规定立即停产;尚未解决的边界仍然明确,并阻碍自动评估。 交付决不允许安排或改变选定的法官和抽样.

## 终点和源限制

使用 `--endpoint` 用于项目发现或预览。 继续并进口保留.

| 来源 | 默认终点 |
| --- | --- |
| 兰斯密斯 | `https://api.smith.langchain.com` |
| 兰福斯 | `https://cloud.langfuse.com` |
| 大脑信任 | `https://api.braintrust.dev` |

区域和自主办来源需要其配置的HTTPS来源。 Langfuse默认为它的公用v2观测API. 使用 `--langfuse-api v1` 更早的部署 此提供者 API 选择独立于论坛协议 v2.

Langfuse v2 必须返回请求 `sessionId` 字段。 明确无效允许独立身份; 省略字段失败 。 源侧元数据截取被披露为限制. 不支持的回复被拒绝,而不是被猜测.

预览和提供者的回应有64个米B安全限制和10万个记录的保障措施. 论坛每片可接受8个米B,每上传64个米B,每会128个米B. 限制产生明显的错误。 任何会话都不得静默地截断或分道扬镳.

## 离线捆绑

```sh
forum import --plan preview.json --bundle evidence.forum.json
forum upload --bundle evidence.forum.json
```

A 类 `forum-session-bundle` 第二版包含会话片段上传. 源检索或验证失败会阻止部分离线导出. 将捆绑和检查站保密.

浏览器导入有更小的请求限制. 使用CLI来进行更大的捆绑. 离线捆绑是新的入境请求; 使用 `--refresh` 明确调和已改变的目的地碎片.

## 本地编码会话

读取 [抓取指南](https://npmcn.com/package/%40forum-ai/cli/docs/capture.md) 用于激活、核查、升级和去除.

```sh
forum capture setup --runtime codex --scope project
forum history preview --runtime codex --out preview.json
forum history import --plan preview.json
```

使用 `claude-code` 克劳德代码。 活取从活取起;历史导入分出. 原生阶段、收缩、授权、信息和工具成果仍然是证据。 不透明加密内容保持不透明 .

历史预览选择会话并冻结可用的被支持的闭关转会和会话级收缩记录. 预览和导入摘要数旋转和会话级别片段分开 。 只压缩的会话报告为零转折, 仍然导入 。 同一来源复制件复制件。 冲突副本仍未解决。 如果源文件快照更改, 继续失败; 生成新的预览 .

## 检查确切的修订

在 **添加会话 —— 设置追踪 —— 校验已保存会话**设置 `FORUM_INSPECTION_TOKEN` 私下 缺失的证书使用隐藏的终端输入;非交互进程必须提供私人环境变量.

```sh
forum recording inspect --recording RECORDING_ID --revision REVISION
forum recording inspect --recording RECORDING_ID --revision REVISION --out private-session.json
```

使用收据上的标识符。 没有最新的修改默认值。 第一个命令打印元数据。 导出被绑定的列表和每个精确的片段版本 以被绑定的块,验证校验和,并创建一个新模式 -`0600` 文档.

现有文件永远不会被覆盖 。 下载失败, 删除部分输出 。 在重试前强制终止进程后删除部分文件 .

30分钟后,阅读补助到期,可以提前取消。 他们不能上传、管理全权证书或评价。 检查失败不重复应用操作.

## 常见问题

### @forum-ai/cli 是什么？

为论坛AI导入并获取执行证据\.

### 如何安装 @forum-ai/cli？

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

### @forum-ai/cli 支持 TypeScript 吗？

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

### @forum-ai/cli 支持 ESM 还是 CommonJS？

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

### @forum-ai/cli 需要什么版本的 Node\.js？

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

### @forum-ai/cli 可以商用吗？

@forum-ai/cli 使用 UNLICENSED 许可。作者声明为 UNLICENSED，即不授予公开使用许可（与公共领域的 Unlicense 不同）。使用前需获得作者授权。以上为概括，不构成法律意见，请以许可原文为准。

### @forum-ai/cli 的下载量有多少？

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

### @forum-ai/cli 还在维护吗？

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