# @atolis-hq/wake 中文文档

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

版本：0\.4\.112
npm 元数据更新时间：2026-10-23T18:11:05.565Z
中文译文更新时间：2026-11-07T03:12:00.187Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40atolis-hq/wake
原文对照：https://npmcn.com/package/%40atolis-hq/wake/?lang=original
项目主页：https://github.com/atolis-hq/wake#readme
源码仓库：https://github.com/atolis-hq/wake

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

- 包体积（解压后）：5.4 MB，1256 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=24
- 运行依赖：12 个
- 首次发布：2026-07-18T23:54:14.827Z
- 最新版本发布：2026-10-23T18:11:05.008Z
- 近 30 天下载量：7412（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：349（近 12 个月 349 个）

## 中文简介

用于软件开发的自主代理控制平面

## 安装

```sh
npm install @atolis-hq/wake
```

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

## README

![logo](https://raw.githubusercontent.com/atolis-hq/wake/refs/heads/main/assets/wake-logo.svg)

# 醒来

自动软件工程控制平面

[![last update](https://img.shields.io/github/last-commit/atolis-hq/wake)](https://github.com/atolis-hq/wake/commits/main) [![CI/CD status](https://github.com/atolis-hq/wake/actions/workflows/ci-cd.yml/badge.svg)](https://github.com/atolis-hq/wake/actions/workflows/ci-cd.yml) [![open issues](https://img.shields.io/github/issues/atolis-hq/wake)](https://github.com/atolis-hq/wake/issues/) [![license](https://img.shields.io/github/license/atolis-hq/wake.svg)](https://github.com/atolis-hq/wake/blob/main/LICENSE) [![latest tag](https://img.shields.io/github/v/tag/atolis-hq/wake)](https://github.com/atolis-hq/wake/tags) [![npm version](https://img.shields.io/npm/v/%40atolis-hq%2Fwake)](https://www.npmjs.com/package/@atolis-hq/wake) [![runs in docker](https://img.shields.io/badge/sandbox-docker-2496ED?logo=docker&logoColor=white)](https://npmcn.com/package/%40atolis-hq/wake/docker/Dockerfile)

  

Wake是自动软件工程的控制平面. 它看着 频道 您的团队已经使用,协调了代理活动 并涉及到人类 将长期记录附在工作上,而不是 运行的终端会话 .

创造出一个问题, 分配Wake, 并继续做你自己的工作。 醒来调查, 当人类的判断重要时,请各方提供投入,提出一项计划,在当地发射 编码代理 CLI 执行更改、打开拉动请求并携带 在工作已经进行的地方继续对话.

## 目录

-   [问题](https://npmcn.com/package/%40atolis-hq/wake/#readme-the-problem)
-   [愿景](https://npmcn.com/package/%40atolis-hq/wake/#readme-vision)
-   [特征概览](https://npmcn.com/package/%40atolis-hq/wake/#readme-feature-overview)
-   [工作发生的地方](https://npmcn.com/package/%40atolis-hq/wake/#readme-where-the-work-happens)
-   [支持的代理CLIs](https://npmcn.com/package/%40atolis-hq/wake/#readme-supported-agent-clis)
-   [开始](https://npmcn.com/package/%40atolis-hq/wake/#readme-getting-started)
-   [文档](https://npmcn.com/package/%40atolis-hq/wake/#readme-documentation)
-   [问题和特性请求](https://npmcn.com/package/%40atolis-hq/wake/#readme-issues--feature-requests)
-   [许可证](https://npmcn.com/package/%40atolis-hq/wake/#readme-license)

## 问题

现代编码代理人是强大的,但持续的发展工作仍需要 很多手动管弦乐。 特工通常从手开始,绑在一个CLI上 ,并优化用于互动会话而不是管理下的执行 随着时间的推移.

这就留下了巨大的业务差距:决定下一步应如何,选择 每个步骤的正确工具和模型,在中断时保持状态, 在LLM路径之外运行决定性的家务,让人类 当直接干预最快时,恢复准确的地方会议.

{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}醒来来弥补这个差距 它将现有的代理CLI包在一个本地控制中 能够应用脚本路由规则的平面,通过明文移动工作 生命周期步骤、恢复或结束会话,并保持确定性进程 尽可能走出燃烧的路.

## 愿景

唤醒应该使 可靠,可活性, 象征意识的自主工程 实用。 默认操作模式为同步和频道驱动:工作 通过耐久的外部系统进入,Wake使人类在循环中发挥作用 在可检查的工作空间或 沙盒

Wake不是在试图替换编码代理,发行跟踪器,或源控制. 它在它们之间协调。 随着时间的推移,它应该成为 选择的地层 工作,决定下一步,援引正确的当地工具或决定性 过程,坚持状态,以后恢复状态,不失去上下文.

详见: [文件/视觉](https://npmcn.com/package/%40atolis-hq/wake/docs/vision.md) 财务报告和审定财务报表 [文件/建筑图](https://npmcn.com/package/%40atolis-hq/wake/docs/architecture.md)。 。 。 .

## 特征概览

-   **醒悟决定,代理运行.** 选择CLI、模型和生命周期 过渡是一个控制飞机的决定; 代理人进行这项工作并报告 结果.
-   **默认由问题驱动.** Wake目前与 GitHub 问题和 报告问题、批准、进展和结果.
-   **明确的生命周期阶段.** 工作可以通过可配置的阶段进行 而不是消失为一个不透明的 届会.
-   **事件源和重启安全.** 持久记录是一个仅附加的事件 日志; 预测可以重建, 循环可以崩溃并恢复, 而无需 失去它的地位.
-   **可重用的事件包 .** `@atolis-hq/eventing` 用品 持续中立事件合同和运行时间服务 `@atolis-hq/eventing-filesystem` 成套用品 节点文件系统适配器. Wake's Bootstrap 成分选择这些适配器,所以域模块永远不会 依赖于文件系统软件包.
-   **(原始内容存档于2018-10-21). Canonical work discuss.** GitHub 评论和 Wake 代理报告是 记录在每件工作物品中,保留来源和 上下文独立于其出现的表面.
-   **当地可检查.** 就住在一个普通的档案里 目录 : `config.yaml`, (中文(简体) ), `config.workflows.yaml`, (中文(简体) ), `prompts/`, (中文(简体) ), `SETUP.md`,以及 `workspaces/` 顶级 每天编辑或浏览的,有耐用/内部状态(活动, 投影、运行、日志、沙盒认证) `.wake/`。 。 。 .
-   **持久的交易.** 代理阶段可以在外出发表作品 基特工作空间. Wake只向后来的特工传递了一份 潜行清单 通过运行中的MCP能力按需获取内容. 网络工作 实物标签内置视图 `.md` 文件(大小写不敏感), 与原始 HTML 禁用,一个下载链接,并返回到文物导航.
-   **以沙盒为导向的处决.** Wake可以从一个持久多克的沙盒跑出来 有耐久的认证状态 并安装了Wake家的数据.
-   **跑者不可知论.** Claude Code, Codex, Cursor, 还有假跑者坐在后面 跑道适配器所以Wake拥有政策和路由,而不是依赖一个 供养.
-   **人文复兴.** 人可以收集准确的本地代理会话 当 直接的终极干预是前进的最佳途径.
-   **操作员关联逃出舱门.** `wake correlate <resourceUri> <workItemId>` 让操作员手动声明资源( PR, Slack) 线程等)属于一个已存在的工作项目,因为没有检测到 链接。 见 [文件/配置](https://npmcn.com/package/%40atolis-hq/wake/docs/configuration.md)。 。 。 .

当前跑道能力差异记录于 [文档/运行比较](https://npmcn.com/package/%40atolis-hq/wake/docs/runner-comparison.md)。 。 。 .

## 工作发生的地方

Wake没有聊天UI 你需要检查状态。 你的罚单系统是 界面: Wake 张贴进度更新、询问澄清问题和报告 并反映舞台和标签状态 这个 当它准备好了,它打开了拉 请求反对你的寻回正常的方式. 检讨、批准和合并 恰好发生在他们已经做的今天 没有新的学习, 没有单独的仪表板来照看.

本地控制飞机 UI 用于想要观看运行、检查的操作员 事件,或使用工作项目上的专用对话标签来读取其 警犬时间线。 何时 `surfaces.api.conversationMessages.enabled` 已启用, 同一标签还允许操作员添加Wake记录和可能使用的消息 恢复合格的代理阶段。 UI是进入同一状态的窗口,不是 工作流程的必要部分. API和UI需要操作员登录 : 运行 `wake ui token` 打印单用配对链接或临时代码,然后 输入UI。 成功登录浏览器持续两年 唤醒容器重启 。 使用 `wake ui token set <key>` 替换持久 access 密钥; 替换将显示现有会话.

分析为现场报告提供可选窗口,运行结果桶, 与今天的系统活动计数器并列 见 [分析 API](https://npmcn.com/package/%40atolis-hq/wake/docs/analytics-api.md) 财务报告和审定财务报表 [网络用户界面](https://npmcn.com/package/%40atolis-hq/wake/docs/web-ui.md) 定义.

## 支持的代理CLIs

Wake将已有的编码代理CLI包起来,而不是替换. 运行者 目前存在的适配器用于:

-   **[克劳德代码](https://claude.com/claude-code)**
-   **[代码](https://openai.com/codex/)**
-   **[光标](https://cursor.com/cli)**

每个跑者都坐在同一个执行合同后面 所以Wake的路线, 寿命周期和沙盒行为都是一样的,不管CLI执行哪一个 特定的活动。 假跑道适配器也存在,用于零键测试 控制飞机本身。 见 [文档/运行比较](https://npmcn.com/package/%40atolis-hq/wake/docs/runner-comparison.md) 说明跑者的能力差异.

## 开始

```sh
npm install -g @atolis-hq/wake
cd ~/
wake init ./wake-home
cd ./wake-home
# point your agent CLI at the scaffolded SETUP.md to finish configuring
# (e.g. "read SETUP.md and help me configure this")
wake sandbox build
wake sandbox up
wake sandbox setup
wake start
```

完整的设置指令在 [文档/开始](https://npmcn.com/package/%40atolis-hq/wake/docs/getting-started.md)运行 `wake --help` 时间 随时提供完整命令列表,或查看 [文件/目录](https://npmcn.com/package/%40atolis-hq/wake/docs/cli.md) 为完整命令参考.

## 文档

-   [文档/开始](https://npmcn.com/package/%40atolis-hq/wake/docs/getting-started.md) - 包装安装、沙盒生命周期, `wake doctor`。 。 。 .
-   [文件/目录](https://npmcn.com/package/%40atolis-hq/wake/docs/cli.md) - 完整的CLI指令参考.
-   [文件/视觉](https://npmcn.com/package/%40atolis-hq/wake/docs/vision.md) - Wake的理由和长远方向.
-   [文件/建筑图](https://npmcn.com/package/%40atolis-hq/wake/docs/architecture.md) - 模块边界和事件源核心.
-   [软件包/活动/README.md](https://npmcn.com/package/%40atolis-hq/wake/packages/eventing/README.md) - 公共活动合同, 运行时间,和内膜测试适配器.
-   [软件包/事件文件系统/README.md](https://npmcn.com/package/%40atolis-hq/wake/packages/eventing-filesystem/README.md) - 公众 事件端口的节点文件系统适配器 .
-   [文献/工作流程](https://npmcn.com/package/%40atolis-hq/wake/docs/workflows.md) - 阶段、提示和跑道如何配置.
-   [文件/即时文件](https://npmcn.com/package/%40atolis-hq/wake/docs/prompts.md) - 如何将模板映射到工作流程阶段.
-   [文件/配置](https://npmcn.com/package/%40atolis-hq/wake/docs/configuration.md) - 说吧 `config.yaml`编号 :`config.workflows.yaml` 选项和操作员的关联 逃出舱门.
-   [文献/公共-ui-access.md](https://npmcn.com/package/%40atolis-hq/wake/docs/public-ui-access.md) - 通过ngrok或其他安全的入侵让操作员UI曝光.
-   [文件/开发](https://npmcn.com/package/%40atolis-hq/wake/docs/development.md) - 源头检查设置(`wake-dev`),npm脚本,格式化,自更新,GitHub投票.
-   [文档/运行比较](https://npmcn.com/package/%40atolis-hq/wake/docs/runner-comparison.md) - 受支助跑者的能力差异.

## 问题和特性请求

找到窃听器还是Wake的主意? [打开一个问题](https://github.com/atolis-hq/wake/issues/new) - 说吧 错误报告和特性请求都是受欢迎的.

## 许可证

Wake被许可使用 [Apache 许可证 2.0](https://npmcn.com/package/%40atolis-hq/wake/LICENSE)。 。 。 .

## 常见问题

### @atolis-hq/wake 是什么？

用于软件开发的自主代理控制平面

### 如何安装 @atolis-hq/wake？

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

### @atolis-hq/wake 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @atolis-hq/wake 支持 ESM 还是 CommonJS？

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

### @atolis-hq/wake 需要什么版本的 Node\.js？

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

### @atolis-hq/wake 可以商用吗？

@atolis-hq/wake 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @atolis-hq/wake 的下载量有多少？

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

### @atolis-hq/wake 还在维护吗？

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