# 0rrery 中文文档

规范地址：https://npmcn.com/package/0rrery/

版本：0\.1\.2
npm 元数据更新时间：2026-07-09T19:41:23.562Z
中文译文更新时间：2026-10-31T13:51:35.139Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：376 kB，7 个文件
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2026-07-05T22:13:51.617Z
- 最新版本发布：2026-07-09T19:41:23.196Z
- 已发布版本数：3（近 12 个月 3 个）

## 中文简介

AI代理工作流的跟踪优先、本地优先的可观察性

## 安装

```sh
npm install 0rrery
```

也可以使用：`pnpm add 0rrery`、`yarn add 0rrery`、`bun add 0rrery`

## README

# 0 rrery

AI代理工作流的跟踪优先、本地优先的可观察性。观察您的Claude Code会话实际做了什么（每个工具调用、子代理、LLM调用和权限决定），作为本地仪表板中的实时跟踪。一个进程，一个SQLite文件，没有云。摄取Claude Code和OpenAI Codex CLI会话。

## 快速入门

```
npm install -g 0rrery    # or: bun install -g 0rrery
0rrery init
```

`init` 做三件事（每个都可以跳过）：安装Claude Code钩子(`--no-hooks`)，设置一个用户服务，以便持久化运行(`--no-service`)，并导入现有的会话历史记录(`--no-import`）. 然后打开 **http://localhost:7317**.

需要 [包子](https://bun.sh/) 运行时≥1.1：即使通过npm安装，CLI也运行在Bun上，因此 `npm install` 成功无Bun，但the `0rrery` 命令退出，并显示一条install-Bun消息，直到Bun位于您的PATH上。Claude Code钩子需要全局安装(hook命令是 `0rrery hook`); `bunx 0rrery serve` 无需安装即可环顾四周。

## 命令

| 命令 | 它是做什么的 |
| --- | --- |
| `0rrery init` | 钩子+座席技能+服务+历史导入，幂等 |
| `0rrery serve` | 在前台运行服务器+仪表板 |
| `0rrery install` | （重新）安装Claude Code钩子到 `~/.claude/settings.json`;替换过时的ery条目 |
| `0rrery import <file.jsonl>` | 导入一份成绩单 |
| `0rrery import --all` | 导入下面的所有内容 `~/.claude/projects` |
| `0rrery service install|uninstall|status` | 管理systemd用户单元(Linux) /启动代理（macOS） |

## 写在哪里

-   `~/.claude/settings.json` - hook entries（命令） `0rrery hook`）
-   `~/.0rrery/` - SQLite DB + tailer偏移量
-   `~/.config/systemd/user/0rrery.service` 或者 `~/Library/LaunchAgents/com.0pon.0rrery.plist`

## 配置

| Env var | 默认的 |  |
| --- | --- | --- |
| `ORRERY_PORT` | `7317` | 仪表板/ API端口 |
| `ORRERY_HOST` | `127.0.0.1` | 绑定地址（仅限本地主机） |
| `ORRERY_DATA_DIR` | `~/.0rrery` | 数据目录 |
| `ORRERY_DB` | `<data dir>/0rrery.db` | 数据库路径 |
| `ORRERY_URL` | `http://localhost:7317` | 钩子/导入到哪里 |
| `ORRERY_CLAUDE_DIR` | `~/.claude` | Claude Code config/transcripts root |

## 代理技术

`init` 在 `~/.claude/skills/0rrery/` 它教会Claude通过查询本地API来回答诸如“我这周花了多少钱”、“这个回购中什么总是失败”或“我上一个会话做了什么”之类的问题。跳过, `--no-skill`;删除与 `rm -rf ~/.claude/skills/0rrery`.

## 释放

版本由CI通过npm可信发布（Trusted Publishing）发布：插入版本 `scripts/build-pkg.ts`、标记 `vX.Y.Z`，推标签-工作流测试、阶段和发布带有出处。没有令牌。

## 升级

```
npm install -g 0rrery@latest    # or: bun install -g 0rrery@latest
0rrery service uninstall && 0rrery service install   # regenerate if the bin path changed
```

升级后（或者从repo开发时），重新构建并强制重新安装，这样仪表板就会选择新的bundle： `bun run build:pkg`,然后 `bun install -g 0rrery@latest` 对于注册表安装，或 `cd ~ && bun install --force` 用于 `file:`\-pinned dev安装-一个不变的 `file:` 否则，Dep可能会跳过重新复制。

## 卸载

```
0rrery service uninstall
npm uninstall -g 0rrery    # or: bun remove -g 0rrery
rm -rf ~/.0rrery
```

钩子项：重新运行Claude会话或删除命令为 `0rrery hook` 从 `~/.claude/settings.json`.

## 开发

```
bun install
bun run build        # dashboard
bun test
bun packages/cli/src/index.ts serve
bun run build:pkg    # stage the npm package in dist-pkg/
```

规范生活在 `docs/superpowers/specs/`.

想让ery摄取另一个代理CLI？看到 [ADAPTERS.md](https://npmcn.com/package/0rrery/ADAPTERS.md).

## 常见问题

### 0rrery 是什么？

AI代理工作流的跟踪优先、本地优先的可观察性

### 如何安装 0rrery？

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

### 0rrery 支持 TypeScript 吗？

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

### 0rrery 可以商用吗？

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

### 0rrery 还在维护吗？

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