# @abyssinia-labs/wake 中文文档

规范地址：https://npmcn.com/package/%40abyssinia-labs/wake/

版本：0\.6\.0
npm 元数据更新时间：2026-10-26T00:12:39.282Z
中文译文更新时间：2026-11-06T19:38:37.677Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40abyssinia-labs/wake
原文对照：https://npmcn.com/package/%40abyssinia-labs/wake/?lang=original
项目主页：https://wakectl.dev/
源码仓库：https://github.com/Abyssinia-Labs/wake

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

- 包体积（解压后）：344 kB，77 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：1 个
- 首次发布：2026-10-09T04:00:05.717Z
- 最新版本发布：2026-10-26T00:12:38.920Z
- 近 30 天下载量：2432（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：17（近 12 个月 17 个）

## 中文简介

当一个应用操作时启动您的编码代理

## 安装

```sh
npm install @abyssinia-labs/wake
```

也可以使用：`pnpm add @abyssinia-labs/wake`、`yarn add @abyssinia-labs/wake`、`bun add @abyssinia-labs/wake`

## README

# 醒来

醒来开始你的编码代理 当有人交出它的工作。 提到你的 在评论中代理 或给它分配罚单 在一个说 `wake/v1`和Wake,运行在你的Mac或Linux机器上, 在正确的寄存器中开始: Claude Code, Codex 或 Cursor, 在 或背景情况 [医生](https://herdr.dev/) 选项卡。 经纪人 回答、声称工作、写出代码和打开拉动请求 沙盒和自己的树枝上.

状态:在macOS和Linux上很早,每天使用. 医生和应用程序 支持Wake,现在 [唤醒.dev](https://wakectl.dev/)。 。 。 .

## 如何运作

-   Wake保持一个 Convex 的订阅 打开每个应用程序,你配对它。 一个 闲置的订阅费一文不值 投票费一文不值.
-   当应用软件有传票给你的经纪人时,Wake声称,就做一个git 在售票处的树上工作 然后在那里开始代理 后续行动 在同一张罚单上 同一代理: 其会话, 工作树.
-   传票上没有文字 代理读到它被问到什么 因为它的 自己与应用程序的连接, 所以应用程序检查访问 与任何呼叫一样.
-   你的经纪人对 唤醒自己:它要求应用程序提供代码并运行 `wakectl pair <app domain> <code>`所以Wake正好为那个特工服务.

## 所需资源

macOS 或 Linux , 或 微调, [阿宝](https://bun.sh/) 1.3.3 或以后,基特,至少 克劳德代码( Claude Code)之一`claude`),代码x(`codex`)或光标(`cursor-agent`, (中文(简体) ), 在应用程序的MCP服务器上签名. `gh` 请求拉动。 在Linux上,同样 `bubblewrap` 财务报告和审定财务报表 `socat` 用于 Claude 代码的 sandbox 和一个系统化用户 第二届会议`loginctl enable-linger $USER` 保留 记录后醒来 \* 退出; `wakectl doctor` 检查每个.

## 用这个

```bash
bun add -g @abyssinia-labs/wake
wakectl setup
```

或者没有Bun:GitHub上的每个发布都有 `wakectl` 作为单一文件 macOS 和 Linux (`wakectl-darwin-arm64`, (中文(简体) ), `-darwin-x64`, (中文(简体) ), `-linux-x64`, (中文(简体) ), `-linux-arm64`在SHA -256号公路旁边 把它放在你的路径 `wakectl`· ; `wakectl install` 从文件启动收听器,并 `wakectl update` 说当一个更新的出来, 因为无论放在那里,更新它.

`wake` 是同一个命令,简称为类型(`wake status`, (中文(简体) ), `wake logs -f`) (中文(简体) ). `wakectl update` 从 npm 安装最新版本,重新启动 并列出自你之后的变化 每个发行的笔记 包含 [变动情况](https://npmcn.com/package/%40abyssinia-labs/wake/CHANGELOG.md)。 。 。 .

或者来源: 复制此寄存器, 然后 `bun install` 财务报告和审定财务报表 `bun link`, (中文(简体) ), 这才叫 `wakectl` 在你的路径.

然后运行 **`wakectl setup`**它检查机器(Bun、Git、gh 问你的克隆人在哪里 和你的代理人对齐 问谁 存储器 每一个应用程序都可以运行, 运行应如何打开, 以及它们可能是什么 不请自来 由你每名探员负责 并启动 听着 随时再运行一次,每个答案 还拥有自己的指挥权:

1.  **平对.** 在 Claude 代码, Codex 或 Cursor 中, 带有应用程序的 MCP 服务器 连通了,叫你的经纪人对着Wake 它的答案为 `wakectl pair <app domain> <code>`。 。 。 .
2.  **批准储存库.** `wakectl repos allow your-org/your-repo` 让我们 应用程序运行在机器上。 传票 一个仓库你 没有批准被拒 罚单上写着指挥部 设置 首先列出应用程序之前要求的仓库, 并询问您 在同时核准十项以上之前确认: 应用应该起作用.
3.  **听着.** `wakectl install` 开始现在和每次的听众 登录,作为macOS上的启动代理(`dev.abyssinia.wake`)或系统d linux 上的用户服务 (`wake.service`),与贝壳的路径你 从那里跑出来 所以它找到了你的特工, `git` 财务报告和审定财务报表 `gh`当应用程序打开时 您的Mac 自己运行听众, 注册 `dev.abyssinia.wake` 作为 其登录项目, `wakectl install` 财务报告和审定财务报表 `uninstall` 别管它了 并说:从登录开始是应用程序的设置. `wakectl doctor` 财务报告和审定财务报表 `setup` 数为已安装.
4.  **检查.** `wakectl status` 显示对齐、连接和 运行,每跑的恢复行; `wakectl logs -f` 如下 日志; `wakectl doctor` 列出任何缺失的东西, 及其固定.

**每次运行都有名字**,两个字像 `amber-heron`,同样的在 `wakectl status`日志 草药标签 当应用程序支持它时, 你问的地方。 Wake告诉这样一个应用 运行已经开始了,它 名称、工具和会话 id,所以代理商不会只说它是 上面;应用程序显示它,并显示如何返回: `wakectl open amber-heron` 在您的文件夹中启动运行的会话工具 终端`wakectl open` 列表最近运行。 一个不支持的应用程序 像以前一样,它得到代理的评论。 跑步还没开始呢 第二次,因为一个会议的两个进程将展开斗争: herdr的帐单放在了前面 在你的终端打开了herdr (从内草药,单取出) 一个去无头被留给 结束, 用 `wakectl stop amber-heron` 结束它.

**如何运行开始, 他们可以做什么.** `wakectl mode herdr` 打开每个 在“Wake”工作空间中以标签形式运行,这是一个交互式会话,您可以观看 且进取; `wakectl mode headless` 默认值. `wakectl permissions` 选择权限模式 : `acceptEdits` (默认值:允许工具以外的任何内容都会问 在草药等待你, `auto` (Claude代码的自动模式,或 Cursor 模式) 自动审查,决定什么是安全的,并询问其他情况),或 `dontAsk` (任何不允许的东西都被拒绝,所以跑步从不等待;克劳德代码,a Cursor 运行保持到允许的列表并询问). `wakectl allow "Bash(npm test:*)"` 在允许的列表中添加一个工具,以及 `--remove` 拿回来. `bypassPermissions` 从未提供.

**哪个模特儿.** 运行会使用它自己的默认模式, 除非你选择 一个: `wakectl model claude opus --effort high`, (中文(简体) ), `wakectl model codex gpt-6.1-sol --effort medium`, (中文(简体) ), `wakectl model cursor composer-2.5`设置 要求同样的一次 对于每一个工具 你配对, 提供克劳德代码 别名( n)`opus`, (中文(简体) ), `sonnet`, (中文(简体) ), `fable`, (中文(简体) ), `haiku`,它跟随最新的 模式),模式代码x列表 `~/.codex`,这些 `cursor-agent models` 列出您的账户。 Cursor的模型 将努力在 名字,所以需要没有 `--effort`。 。 。 . `default` 清除其中之一(`wakectl model codex default --effort default`),以及 `wakectl model` 单独显示所有 三个 选择权在你,在你的机器上:一个应用从不选择模型.

**哪个工具,在哪里.** 运行其代理工具的对称名称 : Claude 代码、 代码或光标( C)`wakectl pair … --tool codex` 当应用程序 无法分辨: Codex CLI 经常以 ChatGPT 的形式到达应用程序 。 每个跑步的活树 克洛德密码在克隆人体内 `.claude/worktrees`,光标在 `~/.cursor/worktrees/<repo>`代码在 `~/.codex/worktrees/wake/<repo>`。早先运行的分支已经 检查是在那个文件夹里进行的,不管是什么工具做的,因为git 检查树枝一次; 手删除的工作树文件夹被遗忘 并再次创造。 交互式 Codex 询问是否信任 每个新文件夹; `wakectl trust codex on` 醒了,把跑步的活树加进去 `~/.codex/config.toml` 首先,标记为Wake's, 和整洁把它 再次与工作树。 光标开始于 `--trust` 给跑步者的工作树,在草地上 做为无头. 光标每个文件夹保留 MCP 签名, 所以运行在新分支上 开始在应用程序中签名 : 先叫醒检查然后拒绝这样的运行 而不是开始它无法读取要求 `wakectl logs` 给 命令显示文件夹。 如果草药里的特工在问题准备就绪之前 就停下来了, Wake等着你在帐单上回答 而不是失败运行.

**当跑步等待你.** 草药里跑来跑去 工具请求权限或信任的文件夹,显示于 `wakectl status` (单位:千美元)`waiting for you in herdr`,以问题作为其标签显示) `--json` 作为跑步 `waiting`, (中文(简体) ), `{ "since", "what" }`,并在日志中; 跑步的时候就没事了 问题留在你的机器上:一个应用程序 支持它的人只听到跑步等待 当它继续,所以它 可以告诉你。 无头跑步从不等 因为不允许的就是 否认,而不问.

`wakectl stop amber-heron` 现在一跑,找到它的名字,票 或它的会话 id: 无头运行的工具被停止, 草药中的运行是 被中断(Esc)并保存了标签,应用程序显示它无法完成, 被车主拦住. `wakectl pause` 停止新索偿( 运行中) 结束)和 `wakectl resume` 继续说.

**后续行动仍在继续.** 当罚单被传唤后 运行它完成(一个问题在评论中,说),Wake没有开始 又一名特工:它继续回答最后传票的会话,在 同一个工作树和同一个名字。 在草药中,它问代理仍然 在运行标签中打开; 关闭标签, 或者无头, 它恢复 第二届会议`claude --resume`, (中文(简体) ), `codex exec resume`, (中文(简体) ), `cursor-agent --resume`) (中文(简体) ). 新的会话只有在没有可继续或最后一届时才开始 超过14天前就完成了.

**活生生的树被打乱了.** 听者取出它制作的跑出的工作树 一旦他们完成:他们合并后的一天(平分) 包含合并,通过 `gh`),或者在他们最后一次跑后一周 里面的所有东西都被推了 它从不清除一个没有承诺的 改变或没有遥控装置上的承诺 选项卡仍然打开,而 git 本身拒绝用 变化. `wakectl prune` {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}现在说说它保存了什么和为什么; `--days` 设定一个被推倒的工作树等待多久.

**每跑步都一样** 保存在日志旁边,在 `runs/` 在 Wake 文件夹中 : 每次运行的文件, `<app>.<summons>.ndjson`,一个 `{ "at", "line" }` 一条线, 相同的线条 `wakectl logs` 显示它。 他们都是你一个人的,永远不要 如果Wake忘记了跑步 跑步的文件就会消失 最后200个.

**为了一个程序.** `wakectl status --json` 打印什么 `status` 显示为 JSON:听众,每对对的连接, 运行和他们的简历 命令和他们等待的任何问题、核准的储存库和 设置. `repos`, (中文(简体) ), `model`, (中文(简体) ), `doctor` 财务报告和审定财务报表 `open` (运行这个机器记得, 最新的第一)拿 `--json` 同样,在形式上,没有任何改变。 每个跑进 `status --json` 财务报告和审定财务报表 `open --json` 携带 `url`在应用程序的页面 它被召唤, 财务报告和审定财务报表 `herdr`无论它是否在草药标签中运行; 由一位年长的Wake保持的运行 无(`null` 内 `status`页:1 `open`) (中文(简体) ). `wakectl setup --json` 用今天的答案: 这台机器的支票, 它为克隆人提供的文件夹, 在那里找到的克隆人以及哪些应用 询问每个模式、运行模式和模式,以及是否 任何开始收听器在登录。 一个节目问这些问题 它 自己的方式,并通过命令给每个回答(`roots`, (中文(简体) ), `pair`, (中文(简体) ), `repos allow`, (中文(简体) ), `mode`, (中文(简体) ), `permissions`, (中文(简体) ), `model`, (中文(简体) ), `install`) (中文(简体) ). 永远没有钥匙 在其中任何一个.

Place 密钥在 macOS 密钥链或 Linux 的特勤服务中存在 (单位:千美元)`dev.abyssinia.wake`),从未在配置 at `~/Library/Application Support/Wake/config.json` (单位:千美元)`~/.config/wake` 打开 (原始内容存档于2017-10-11). Linux. 一台没有特勤服务的Linux机(服务器、容器) 让他们进去 `~/.config/wake/keys.json`你一个人可以读 它的设置 : `roots` (在哪里寻找克隆人, `~/Projects` 默认; `wakectl roots add ~/code` 财务报告和审定财务报表 `wakectl roots remove` 改变它们, `maxRuns` (2个,和 永远不再)和 `runTimeoutMinutes` (120) 哪个 `wakectl limits runs 1` 财务报告和审定财务报表 `wakectl limits stop-after 90` 在不重新启动的情况下更改, `extraAllowedTools` 运行,和 `models`,作为 `wakectl model` 设置它.

## 跑步会怎样

对于一张票,Wake发现你的克隆 存储器的应用程序名称, 在售票处的分行取取活树 活活树 (上). 它开始在那里的代理 编辑接受和a 固定工具列表: git, `gh`Bun和应用程序的MCP服务器 它可以回答, 要求,承诺,推动它的分支和打开拉取请求,并被告知永远不要 以合并、强制推出或按下默认分支。 对于一页,它运行在一个 只带应用程序工具的空文件夹 .

## 警卫

**打开树枝保护.** 工具列表和拒绝列表 诚实的代理人在轨;他们不是一堵墙。 带壳的特工可以 和一张罚单上的文字 可以试图说服它这样做. GitHub: 规则 在默认分支上,该分支需要拉请求,让任何人绕行 包括管理员在内.

**跑步能达到什么程度.** Claude Code 仅使用 Wake 的设置运行 (单位:千美元)`--setting-sources user`: 该分行的 `.claude` 设置和钩子是 未装入, 并告诉代理读取寄存器的 CLAUDE. md 自己来 它的外壳在克洛德密码的沙盒中运行: 它只写在 工作树, 只连接到 GitHub 和 npm, 不能读取 `~/.ssh`, (中文(简体) ), `~/.config/gh`, (中文(简体) ), `~/.aws` 或其他工具的证书. `git push` 页:1 奔跑的分支, `git fetch` 而gh的拉出请求命令运行在外 - 沙盒; `gh api`, (中文(简体) ), `gh auth`, (中文(简体) ), `git -c`, (中文(简体) ), `git config` 财务报告和审定财务报表 `bunx` 为: 否认。 光标运行方式 `--sandbox enabled`: 命令运行沙盒 没有网络, 除了相同的短列表 运行在它之外。 光标 沙盒不会隐藏您的证书 来自 shell 命令,和 Codex `workspace-write` 沙盒读到任何地方,并有网络,所以 存储器,对克劳德代码。 醒来安装 依赖关系 `--ignore-scripts`,并批准 Cursor 运行的 MCP 服务器只当分支没有列出自己的内容时.

"Wake"独自拒绝:

-   您尚未批准应用的仓库( S)`wakectl repos`) (中文(简体) ).
-   缺省分行的传票,或分行在 文件夹 Wake没有做(你自己的树).
-   任何来自应用程序的不是形状的东西 `wake/v1` 允许: 发现 非 https 的 URL( 仅针对此机上的 dev 服务器), 应用程序名称不是普通名称,没有绑定的id,标签或提示.
-   自己的仓库 `.cursor/cli.json`,或制作 `.cursor` 链接,用于光标运行。 Wake在每次跑步时都会重新写出 Cursor 的极限.
-   克隆人的被子钩, 当它做一个工作树.

两个跑步在一个分行轮流。 跑步失败时,票上写着为什么 仅以写入要共享的字词; 路径和命令输出留在其中 `wakectl logs`. Wake的配置,状态和日志可以单独读取.

## 在 GitHub 上

标签一个问题 `wake`,或写 `/wake` 在评论或评论中,以及您 代理开始于您的机器: 安装 [唤醒GitHub](https://github.com/apps/wake-for-github),对 `github.wakectl.dev/pair`,并用 `wakectl repos allow <owner/name> --app github.wakectl.dev`它的代码是 [`apps/github`](https://npmcn.com/package/%40abyssinia-labs/wake/apps/github)。 。 。 .

## 应用:服务醒悟/v1

任何应用程序都可以让Wake通过服务启动用户代理 `wake/v1`数字 : 发现时间 `/.well-known/wake`,两条HTTP路线(`pair`, (中文(简体) ), `forget`),以及 传票有两种方式之一。 在Convex上,有三个功能(`wake:pending`, (中文(简体) ), `wake:claim`, (中文(简体) ), `wake:finish`加上可选的第四种(`wake:started`),每个 以关键位置作为论据。 其它任何地方,同样的四 HTTP 路由, 未决列表为服务器发送事件和位置密钥 作为无记名标志`transport: "http"` 在发现中。 醒醒,两个都说.

Spec还有监视设备:手机、浏览器或桌面应用程序 代理的老板从您的应用程序中添加, 它列出代理的运行和 答问. 每个手表钥匙,交易在 `POST /wake/v1/watch` (单位:千美元) 代码您的应用程序只显示给它注册的所有人, 所以运行无法到达 可以为他们说是. 打开密钥 `wake:runs`, (中文(简体) ), `wake:answer`, (中文(简体) ), `wake:places`, (中文(简体) ), `wake:watching`, (中文(简体) ), `wake:push` 财务报告和审定财务报表 `wake:activity`,没有 位置调用; 一个位置密钥不打开它们 。 可选 `wake:waiting` 让我们 醒来说跑步等待它的主人。 两个包都服务于这些,以及 `wakectl check` 探测他们.

-   **光谱**数字 : [文件/规格/醒悟v1.md](https://npmcn.com/package/%40abyssinia-labs/wake/docs/spec/wake-v1.md)。 。 。 .
-   **在凸起处**数字 : [`@abyssinia-labs/wake-convex`](https://npmcn.com/package/%40abyssinia-labs/wake/packages/convex) 这是 整个服务器半个组件 。 你决定什么是传票 特工和 写出提示.
-   **在 Postgres 上, 或获取 API 的任何东西**数字 : [`@abyssinia-labs/wake-server`](https://npmcn.com/package/%40abyssinia-labs/wake/packages/server) 是同一服务器的一半 在HTTP的运输, 与德利兹.
-   **检查一下**数字 : `wakectl check <your domain>` 探测一个应用 如何唤醒 意志,用它必须拒绝的投入,所以它一无是处,一无是处. 如果应用程序制作表代码 就会检查每个表都拒绝 一个没有打开的钥匙, 和这个机器自己的位置的钥匙 当它是 与应用程序对齐.

## 名称

-   软件包 : `@abyssinia-labs/wake` (命令)和 `@abyssinia-labs/wake-convex` (Convex组件), npm
-   命令 : `wakectl` (单位:千美元)`install`, (中文(简体) ), `status`, (中文(简体) ), `logs`, (中文(简体) ), `open`, (中文(简体) ), `pause`, (中文(简体) ), `pair`, (中文(简体) ), `forget`(中文(简体) )
-   乡人后出 `brew install abyssinia-labs/tap/wake`

## 捐助和安全

见 [捐款额](https://npmcn.com/package/%40abyssinia-labs/wake/CONTRIBUTING.md)私下报告脆弱性, 作为 [警卫](https://npmcn.com/package/%40abyssinia-labs/wake/SECURITY.md) 说,从来没有在一个问题.

## 许可证

[麻省理工学院](https://npmcn.com/package/%40abyssinia-labs/wake/LICENSE) 阿比西尼亚实验室有限责任公司

## 常见问题

### @abyssinia-labs/wake 是什么？

当一个应用操作时启动您的编码代理

### 如何安装 @abyssinia-labs/wake？

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

### @abyssinia-labs/wake 支持 TypeScript 吗？

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

### @abyssinia-labs/wake 支持 ESM 还是 CommonJS？

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

### @abyssinia-labs/wake 可以商用吗？

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

### @abyssinia-labs/wake 的下载量有多少？

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

### @abyssinia-labs/wake 还在维护吗？

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