# @loggie-ai/cli 中文文档

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

版本：0\.1\.9
npm 元数据更新时间：2026-11-01T17:29:03.846Z
中文译文更新时间：2026-11-01T18:23:48.378Z
软件包许可：UNLICENSED

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

原始 npm 页面：https://www.npmjs.com/package/%40loggie-ai/cli
原文对照：https://npmcn.com/package/%40loggie-ai/cli/?lang=original
项目主页：https://github.com/unblocklabs-ai/agent-platform/tree/main/cli
源码仓库：https://github.com/unblocklabs-ai/agent-platform

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

- 包体积（解压后）：123 kB，37 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：3 个
- 首次发布：2026-05-13T14:20:12.203Z
- 最新版本发布：2026-11-01T17:29:03.649Z
- 已发布版本数：7（近 12 个月 7 个）

## 中文简介

Loggie CLI用于发现集成并为代理代理经过身份验证的API请求

## 安装

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

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

## README

# Loggie CLI

代理优先发现、API代理调用和事件消费。该自述文件随 `@loggie-ai/cli` 包;命令标志定义在 [cli.ts](https://npmcn.com/package/%40loggie-ai/cli/src/cli.ts) 暴露在 `loggie <command> --help`.

## 安装和验证

需要Node 20或更新版本。

```bash
npm install -g @loggie-ai/cli
loggie init
loggie status
```

API密钥优先级： `--api-key` (别名 `--key`)或 `--profile`， `LOGGIE_API_KEY`，然后是活动配置文件 `~/.loggie/config.json`． 更喜欢互动 `init` 或者选择环境变量，而不是将凭证放入shell历史记录中。 `loggie logout` 删除所有保存的配置文件；它不会撤销服务器端密钥或取消设置的环境变量。

默认服务器为 `https://app.loggie.ai`． 集 `LOGGIE_SERVER_URL` 以覆盖它，例如用于本地开发。看到 [config.ts](https://npmcn.com/package/%40loggie-ai/cli/src/config.ts) 用于分辨率和存储。

## 转换配置文件

将每个代理API密钥保存在本地名称下，然后切换后续命令使用的配置文件：

```bash
loggie init --profile work
loggie init --profile personal
loggie profiles list
loggie profiles use work
loggie status
```

`init` 在保存之前验证密钥并激活保存的配置文件。没有 `--profile`，它更新活动概要文件，或创建 `default` 如果不存在config。现有的单键配置显示为 `default` 并在添加另一个配置文件时保留。名称可以包含字母、数字、“。”、“\_”和“-”，必须以字母或数字开头，长度不超过64个字符。

每个配置文件保存其服务器URL。使用 `loggie init --profile local --server-url http://localhost:5173` 对于本地配置文件； `LOGGIE_SERVER_URL` 还在初始化期间提供URL。新的配置文件使用默认服务器，除非被覆盖。重新初始化概要文件将保留其保存的服务器，除非被覆盖。

`profiles list` 返回名称、服务器url和不带键的活动选择。 `profiles use` 报告仍然覆盖已保存凭据或服务器的环境变量。 `--api-key` 和 `LOGGIE_API_KEY` 保留对活动配置文件的优先级； `LOGGIE_SERVER_URL` 覆盖其保存的服务器。 `status` 报告有效的认证源。 `profile` 的别名 `profiles`;使用 `--pretty` 读取可读的JSON。

当使用保存的进度时，事件命令通过验证概要文件 `/api/setup`． 一个显式的 `pull --since <cursor>` 读取提要而不加载保存的进度。游标和重试计数的范围是服务器和概要文件ID，包括命名游标，因此旋转API键可以保留进度。如果存在未限定作用域的游标，CLI将停止并报告其位置。在验证所选概要文件拥有这些事件之后，请通过 `--replay-from <cursor>` 来 `listen` 或者 `watch` (或 `--since <cursor>` 来 `pull`）. 使用 `--replay-from latest` 从现在的位置开始。即使没有事件到达，也会保存显式的消费者简历；原始的未作用域状态保持不变。

事件HTTP读取重试速率限制响应最多两次时 `Retry-After` 指定最多60秒的等待时间。每次重试都保留相同的凭据和游标。

配置文件的变化在CLI进程中序列化。中断的写操作可能会留下一个锁目录；超时错误标识它，因此您可以在确认没有写入器正在运行后删除它。

## 对一个命令使用一个配置文件

通过 `--profile <name>` 作为已保存的配置文件运行一个命令，而不更改活动配置文件或写入 `~/.loggie/config.json`：

```bash
loggie status --profile work
loggie --profile=personal setup
loggie discover linear --profile work
loggie call linear GET /issues --profile work
loggie linear pending --profile work
loggie events --profile work pull
loggie events listen --profile work --exec ./handle-event.sh
```

`setup`， `status` (别名 `whoami`)， `discover`， `call`,每一个 `linear` 行动, `events pull`， `listen`, `watch` 在命令之前或之后接受标志，事件命令之后也接受标志 `events`． 允许重复使用相同名称的旗帜；不同的名字被拒绝。

选择的概要文件提供API密钥和服务器，覆盖 `LOGGIE_API_KEY` 和 `LOGGIE_SERVER_URL`． 没有保存服务器URL的配置文件使用默认服务器。未知的名称、格式错误的名称或丢失或格式错误的配置在任何请求之前失败，并且永远不会退回到另一个凭据。结合 `--profile` 与 `--api-key` 或者 `--key` 将被拒绝。

`status` 报告命令使用的本地名称为 `auth.savedProfile` 持久化选择为 `auth.activeProfile`． 当不存在配置时，这两个都被省略。顶级 `profile` 字段是服务器端代理配置文件。

`init --profile` 保存并激活指定的配置文件，并接受 `--api-key`. `logout` 和 `profiles` 管理所有已保存的配置文件，以便它们在更改任何内容之前拒绝标志。

`events listen` 和 `watch` 在启动时捕获选定的密钥和服务器，并将它们用于重试、轮询、重新连接和处理程序。以后的配置文件切换或键旋转不会重定向正在运行的进程；重新启动它以使用新值。处理程序将这对继承为 `LOGGIE_API_KEY` 和 `LOGGIE_SERVER_URL`，所以。 `loggie` 处理程序中的命令使用相同的帐户，除非它传递自己的帐户 `--profile`． Progress的作用域为服务器和服务器端概要ID，因此同一代理的两个本地名称共享Progress。

## 打电话前先发现

```bash
loggie discover
loggie discover asana --method POST --search tasks --limit 10
loggie discover asana --endpoint /tasks --method POST
loggie discover linear --endpoint / --method POST --graphql-type query --operation viewer
loggie call linear POST / -d '{"query":"query { viewer { id } }"}'
```

鼻涕虫取决于你的关系。将目录结果用于实际路径和操作。 `loggie setup` 打印代理设置有效负载； `whoami` 别名 `status`.

命令默认为JSON，而 `call` 保留上游响应体。使用 `--pretty` 用于JSON的可读性或发现性 `--table` 从人的角度来看。 `loggie call --help` 文档头、查询字符串、多部分字段和二进制上传。

`loggie call` 具有60秒的请求超时，包括响应体下载。使用 `--timeout <seconds>` 重写它，或者 `--timeout 0` 禁用它。超时退出1，写入JSON `TIMEOUT` 错误输出到标准输出，并打印一行错误到标准输出。GET和HEAD不会隐式读取stdin；本机获取不支持这些方法的请求体。

## 请求策略

发现Loggie Admin连接，然后提出一个策略供人工审批：

```bash
loggie discover loggie-admin --endpoint /policy-requests --method POST
loggie call loggie-admin POST /policy-requests -d '{"integrationId":"CONNECTION_UUID","prompt":"Only allow reading tasks; hide customer emails.","assignToAgent":true}'
loggie call loggie-admin POST /policy-requests -d '{"policy":{"integrationId":"CONNECTION_UUID","name":"Read access","permission":"read","endpointRuleMode":"NONE"},"assignToAgent":true}'
loggie call loggie-admin GET /requests/REQUEST_UUID
```

使用一个简单的语言提示 `integrationId`，或一个完整的 `policy` 由代理人起草。一个完整的策略直接在Review中打开，不需要逻辑AI调用。提示符的前缀是与Policies选项卡相同的ai辅助创建者；人类生成并编辑它的草稿。

使用发现返回的实际Admin段代码。给返回者 `setupUrl` 到一个工作区成员。他们审查完整的策略，并在登录时批准或拒绝它。Approval创建策略并将其分配给该连接的请求代理，替换任何现有的策略分配。集 `assignToAgent` 来 `false` 只创建可重用策略。该提案在获得批准之前不会创建任何政策，也不会更改任何分配。民意调查 `pollUrl` 直到 `COMPLETED` 返回 `policyId`； `EXPIRED` 和 `CANCELLED` 是终端。请求在24小时后过期。

发现模式记录端点规则、批准规则、速率限制、响应编校和请求主体限制。连接必须有一个工作区提供程序草稿，以支持可重用策略。

要更新现有策略，请添加其 `policyId` 要么请求形状。提供完整的所需政策；当应用评审的替代品时，省略的可选限制将被清除。

```bash
loggie call loggie-admin POST /policy-requests -d '{"policyId":"POLICY_UUID","policy":{"integrationId":"CONNECTION_UUID","name":"Read access","permission":"read","endpointRuleMode":"NONE","rateLimitPerMinute":30}}'
loggie call loggie-admin POST /policy-requests -d '{"policyId":"POLICY_UUID","integrationId":"CONNECTION_UUID","prompt":"Allow only reading tasks and hide customer email addresses."}'
```

引用连接必须使用与现有策略相同的提供者和API类型。人类拒绝返回CANCELLED。更新保留策略ID和所有现有分配，因此每个分配的代理/连接都会受到影响。 `assignToAgent` 更新默认为false；真实是被拒绝的。检查显示保存的策略、建议的更改和受影响的分配。如果策略或分配集在批准前发生更改，则提交新的请求。完成的轮询返回相同的结果 `policyId`.

## 事件

```bash
loggie events pull --limit 10
loggie events listen --help
loggie events watch --help
```

`pull` 获取一次。 `listen` 使用WebSocket交付； `watch` 投票。两种连续模式都需要 `--exec` 并对事件执行该命令，在stdin和in上传递JSON `LOGGIE_EVENT`． 仅在需要这些操作时配置处理程序。有关重放和命名游标选项，请参阅每个命令的帮助。

## 使用CLI

从存储库根目录：

```bash
pnpm build:cli
pnpm test:cli
node cli/dist/cli/src/bin.js --help
```

CLI没有自动加载 `cli/.env`． 要对本地开发服务器使用这些凭据：

```bash
LOGGIE_SERVER_URL=http://localhost:5173 node --env-file=cli/.env cli/dist/cli/src/bin.js status
```

### 线性药剂交付

`loggie linear pending` 独立于事件游标恢复队列工作。如果响应具有非空值 `nextCursor`，继续 `loggie linear pending --cursor NEXT_CURSOR`。使用 `claim`， `context`， `start`， `heartbeat`， `activity`, `finish` 交付：执行交付； `inspect` 和 `reconcile` 支持中断运行。命令默认发出JSON。看到 [线性设置和恢复合同](https://npmcn.com/package/%40loggie-ai/src/worker/modules/linear-agents/README.md)． 线性读写继续进行 `loggie call` 以及现有的访问策略。

## 常见问题

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

Loggie CLI用于发现集成并为代理代理经过身份验证的API请求

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

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

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

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

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

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

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

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

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

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

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

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