# @a5c-ai/babysitter-breakpoints 中文文档

规范地址：https://npmcn.com/package/%40a5c-ai/babysitter-breakpoints/

版本：0\.0\.170
npm 元数据更新时间：2026-03-03T13:33:11.428Z
中文译文更新时间：2026-11-06T21:46:22.700Z
软件包许可：未声明

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

原始 npm 页面：https://www.npmjs.com/package/%40a5c-ai/babysitter-breakpoints
原文对照：https://npmcn.com/package/%40a5c-ai/babysitter-breakpoints/?lang=original

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

- 包体积（解压后）：98.6 kB，22 个文件
- TypeScript 类型：未声明
- 运行依赖：2 个
- 首次发布：2026-01-17T07:55:31.657Z
- 最新版本发布：2026-03-03T13:33:11.298Z
- 近 30 天下载量：2299（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：90（近 12 个月 90 个）

## 中文简介

配有API的轻量级断点管理器,队列工人,以及网络UI.

## 安装

```sh
npm install @a5c-ai/babysitter-breakpoints
```

也可以使用：`pnpm add @a5c-ai/babysitter-breakpoints`、`yarn add @a5c-ai/babysitter-breakpoints`、`bun add @a5c-ai/babysitter-breakpoints`

## README

# 断点管理器

配有API的轻量级断点管理器,队列工人,以及网络UI.

这个包裹现在住在 `packages/breakpoints`。 。 。 .

## 所需资源

-   节点.js 18+

## 设置

```bash
cd packages/breakpoints
npm install
npm run init:db
```

## 运行( dev)

```bash
cd packages/breakpoints
npm run dev
```

## 运行( 安装的 CLI)

```bash
breakpoints start
```

或者分开运行 :

```bash
npm run start:api
npm run start:worker
```

## CLI 实例

启动完整系统( API + Web UI + 工人):

```bash
breakpoints start
```

创建断点( 代理) :

```bash
breakpoints breakpoint create --question "Need approval?" --title "Approval"
```

检查状态 :

```bash
breakpoints breakpoint status <id>
```

等待释放 :

```bash
breakpoints breakpoint wait <id> --interval 3
```

## 配置

环境变量:

-   `PORT` (违约3185)
-   `WEB_PORT` (违约3184)
-   `DB_PATH` (默认) `~/.a5c/breakpoints/db/breakpoints.db`(中文(简体) )
-   `REPO_ROOT` (默认包根/ 当前工作目录)
-   `AGENT_TOKEN` (可选)
-   `HUMAN_TOKEN` (可选)
-   `WORKER_POLL_MS` (2000年违约)
-   `WORKER_BATCH_SIZE` (默认 10)

## API 示例

创建断点( 代理) :

```bash
curl -X POST http://localhost:3185/api/breakpoints \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AGENT_TOKEN" \
  -d '{"agentId":"agent-1","title":"Need review","payload":{"summary":"check this"},"tags":["review"],"ttlSeconds":3600}'
```

检查状态 :

```bash
curl http://localhost:3185/api/breakpoints/<id>/status
```

有反馈的发布( 人力):

```bash
curl -X POST http://localhost:3185/api/breakpoints/<id>/feedback \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $HUMAN_TOKEN" \
  -d '{"author":"reviewer","comment":"Looks good","release":true}'
```

## 断点上下文有效载荷

为了在用户界面中允许上下文渲染,包括 `context.files` 数组 断点有效载荷:

```json
{
  "context": {
    "runId": "run-...",
    "files": [
      { "path": "docs/plan.md", "format": "markdown" },
      { "path": "api/routes.js", "format": "code", "language": "javascript" }
    ]
  }
}
```

API通过下列方式服务文件内容:

```
GET /api/breakpoints/:id/context?path=path/to/file
```

只提供允许的列表扩展名, 文件必须在 断点有效载荷.

## 网络用户界面

打开 `http://localhost:3184` 并提供UI中的人类标志.

## 电报扩展

Telegram扩展允许您接收断点通知,并通过Telegram与它们互动.

### 设置

1.  通过 [@ 父爱 @ info](https://t.me/botfather)
2.  拿回你的宝物
3.  配置扩展名 :

```bash
breakpoints extension enable telegram --token <bot-token> --username <your-username>
```

### 特征

**自动通知 :**

-   创建新断点时接收通知
-   断点释放时得到通知

**连接 :** 发送任何斜线命令(例如, `/start`与你的机器人连接。 机器人会:

-   确认连接
-   显示所有等待断点, 标题、 ID、 运行 ID 和问题
-   提供与断点相互作用的指示

**图标 :**

-   `list` (或 `ls`, (中文(简体) ), `waiting`) - 显示所有等待断点
-   `preview <number>` (或 `show <number>`\- 查看断点的全部细节
-   `file <number>` - 按其编号下载上下文文件
-   `file <path>` - 以路径下载上下文文件
-   `raw <path>` - 以语法加亮查看文件内置线性( 如果足够短)

**复出断点:**

-   回复任何断点信息以发布
-   发送断点ID以发布
-   发送任何文本信息以释放最近的断点

**示例工作流程 :**

```
You: /start
Bot: Telegram connected. I will notify you about breakpoints here.

     🔔 You have 2 waiting breakpoints:

     1. Approve refactoring plan
        ID: abc-123
        Run: run-20260120-refactor
        Created: 5 mins ago
        Question: Should I proceed with this refactoring?

     2. Review API changes
        ID: def-456
        Run: run-20260120-api
        Created: 2 mins ago
        Question: Are these API changes acceptable?

You: preview 1
Bot: [Shows full details including all context files]

You: file 1
Bot: [Sends the first context file as document]

You: Looks good, proceed!
Bot: ✅ Breakpoint released
     ID: abc-123
     Feedback: Looks good, proceed!
```

## 中间点 CLI( 方便代理人)

创建断点 :

```bash
breakpoints breakpoint create \
  --question "Approve process + inputs + main.js?" \
  --run-id run-123 \
  --title "Approval needed" \
  --file ".a5c/runs/run-123/artifacts/process.md,markdown" \
  --file ".a5c/runs/run-123/inputs.json,code,json" \
  --file ".a5c/runs/run-123/code/main.js,code,javascript"
```

等待发布(发布时打印出全部细节):

```bash
breakpoints breakpoint wait <id> --interval 3
```

## 页:1

-   标记作为JSON存储于SQLite;标记过滤使用简单的字符串匹配.
-   排队工人处理TTL过期工作;通知工作被固定.

## 常见问题

### @a5c-ai/babysitter-breakpoints 是什么？

配有API的轻量级断点管理器,队列工人,以及网络UI\.

### 如何安装 @a5c-ai/babysitter-breakpoints？

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

### @a5c-ai/babysitter-breakpoints 支持 TypeScript 吗？

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

### @a5c-ai/babysitter-breakpoints 可以商用吗？

@a5c-ai/babysitter-breakpoints 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @a5c-ai/babysitter-breakpoints 的下载量有多少？

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

### @a5c-ai/babysitter-breakpoints 还在维护吗？

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