# @alook/app 中文文档

规范地址：https://npmcn.com/package/%40alook/app/

版本：0\.1\.64
npm 元数据更新时间：2026-11-05T06:05:24.004Z
中文译文更新时间：2026-11-06T10:26:23.645Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：111 MB，3816 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20\.9
- 运行依赖：4 个
- 首次发布：2026-05-13T07:37:59.730Z
- 最新版本发布：2026-11-05T06:05:23.650Z
- 近 30 天下载量：3486（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：186（近 12 个月 186 个）

## 中文简介

本地运行 Alook —— 一个命令, 不需要克隆

## 安装

```sh
npm install @alook/app
```

也可以使用：`pnpm add @alook/app`、`yarn add @alook/app`、`bun add @alook/app`

## README

# @ alook/ app

在当地运行 Alook——一个命令,不需要克隆.

## 快速启动

```bash
npx @alook/app onboard
```

这将:

1.  请检查url=值 (帮助) 环境(Node.js QQ20, AI 运行时间)
2.  安装视图 `~/.alook/self-hosted/`
3.  产生秘密( E)`BETTER_AUTH_SECRET`, (中文(简体) ), `ENCRYPTION_KEY`(中文(简体) )
4.  运行数据库迁移( SQLite 通过 Cloudflare D1 本地端)
5.  启动所有服务(网络、电子邮件工作人员、WebSocket、Wake工作人员)
6.  创建您的本地账户
7.  给这台机器配对然后启动 `@alook/daemon`
8.  在浏览器中打开仪表板

## 图标

| 命令 | 说明 |
| --- | --- |
| `npx @alook/app onboard` | 完整的设置:安装、迁移、启动和对 |
| `npx @alook/app start` | 从现有安装开始服务 |
| `npx @alook/app stop` | 停止所有服务 |
| `npx @alook/app update` | 更新服务和重新运行迁移 |

### 嵌入式守护进程

`@alook/app` 捆绑当前 `@alook/daemon` CLI(英语:CLI). 在机上自动进行对等;在应用程序拥有的数据目录中,保存的机器证书仍然保持私密.

```bash
npx @alook/app daemon list                   # List paired/running daemons
npx @alook/app daemon status [machine-id]    # Check agent status
npx @alook/app daemon stop <machine-id>      # Stop one daemon
npx @alook/app daemon start --id <machine-id> # Restart without exposing its credential
```

## 选项

```
--port-web <port>    Web server port (default: 15210)
--port-email <port>  Email worker port (default: 15211)
--port-ws <port>     WebSocket worker port (default: 15212)
--port-wake <port>   Wake worker port (default: 15213)
--skip-register      Skip account creation (onboard only)
```

## 建筑

### 服务

Alook 管理着四个本地服务, 各自在自己的Wrangler dev进程中:

| 服务 | 默认端口 | 说明 |
| --- | --- | --- |
| **网页** | 第1520号 | 主要网络应用(Wrangler上的Next.js)——仪表板,API,认证 |
| **电子邮件工作员** | 1521 (英语) | 电子邮件处理工人 |
| **WebSocket (WS- DO) (英语)** | 15212号 | 通过持久对象进行实时通信 |
| **唤醒工人** | 1521(2003) | 向本地守护进程发送未读提醒事件 |

所有服务共享一个单一的 SQLite 数据库( Cloudflare D1 本地模式),状态持续到 `~/.alook/self-hosted/web/.wrangler/state/`。 。 。 .

### 目录布局

```
~/.alook/self-hosted/
├── web/                  # Web app (wrangler.toml, migrations, .dev.vars)
│   ├── .wrangler/state/  # D1 database & KV persistence
│   └── migrations/       # SQL migration files
├── email-worker/         # Email worker (wrangler.toml, .dev.vars)
├── ws-do/                # WebSocket Durable Object worker
├── queue-worker/         # Queue task consumer (agent wake + mobile push)
├── daemon/               # Private machine credentials, daemon state, and logs
├── logs/                 # Service logs (web, email, WS, and wake workers)
└── .pids.json            # PID tracking for running services
```

### 数据库迁移

迁移是通过 `wrangler d1 migrations apply --local`。它们在下列时间自动运行:

-   **`onboard`** - 应用所有新安装的迁移
-   **`update`** 安装最新版本后应用任何新的迁移

Wrangler追踪已实施迁移;只执行待定的追踪.

### 机密管理

开始 `onboard`,秘密是自动生成并写入 `.dev.vars` 文件 :

-   **网页**数字 : `BETTER_AUTH_SECRET`, (中文(简体) ), `BETTER_AUTH_URL`, (中文(简体) ), `ENCRYPTION_KEY`, OAuth 客户端 ID/ 秘密占位符
-   **电子邮件工作员**数字 : `ENCRYPTION_KEY` (网名从)

在后续运行中,秘密永远不会被覆盖——只有缺失的文件被创建.

## 开发模式

当 `ALOOK_PROJECT_ROOT` 环境变量被设定, `@alook/app` 以 dev 模式运行以对抗 monorepo :

-   运行 `pnpm predev` 设置环境文件
-   运行 `pnpm db:migrate` 移民(而不是Wrangler CLI)
-   开始网络通过 `next dev` (代替Wrangler)
-   服务在前景中运行,并有前缀日志输出(`[web]`, (中文(简体) ), `[email-worker]`, (中文(简体) ), `[ws-do]`(中文(简体) )
-   `Ctrl+C` 干净地停止所有服务

```bash
ALOOK_PROJECT_ROOT=/path/to/alook npx @alook/app onboard
```

## 所需资源

-   节点.js
-   支持代理运行时间, 如 Claude 代码、 Codex、 OpenCode、 Pi 或 Cursor

## 限制

-   没有本地模式的电子邮件发送/接收
-   OAuth 登录( GitHub, Google) 已禁用; 使用电子邮件/ 密码字

## 许可证

阿帕奇-2.0 — 见 [自由主义](https://npmcn.com/package/LICENSE)。 。 。 .

## 常见问题

### @alook/app 是什么？

本地运行 Alook —— 一个命令, 不需要克隆

### 如何安装 @alook/app？

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

### @alook/app 支持 TypeScript 吗？

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

### @alook/app 支持 ESM 还是 CommonJS？

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

### @alook/app 需要什么版本的 Node\.js？

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

### @alook/app 可以商用吗？

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

### @alook/app 的下载量有多少？

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

### @alook/app 还在维护吗？

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