# local-agent-dashboard 中文文档

规范地址：https://npmcn.com/package/local-agent-dashboard/

版本：0\.3\.6
npm 元数据更新时间：2026-11-04T01:31:27.886Z
中文译文更新时间：2026-11-04T02:15:23.697Z
软件包许可：UNLICENSED

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

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

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

- 包体积（解压后）：242 kB，26 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.18
- 运行依赖：0 个
- 首次发布：2026-11-03T03:23:02.011Z
- 最新版本发布：2026-11-04T01:31:27.546Z
- 已发布版本数：6（近 12 个月 6 个）

## 中文简介

Codex, Claude Code, DeepSeek Harness

## 安装

```sh
npm install local-agent-dashboard
```

也可以使用：`pnpm add local-agent-dashboard`、`yarn add local-agent-dashboard`、`bun add local-agent-dashboard`

## README

# Local Agent Dashboard

把闲置的 Android 手机变成 AI 任务看板：不用一直盯着电脑，也能看到 Codex Desktop、Claude Code 和 DeepSeek Harness 的必要任务状态。

电脑上运行这个 npm 包，手机上安装配套 App。手机和电脑需要连接同一个局域网，也可以在 App 中添加多台电脑。

## 电脑需要什么？

-   macOS 13 或更新版本，支持 Apple 芯片和 Intel 芯片。
-   [Node.js](https://nodejs.org/) 22.18 或更新版本。
-   OpenSSL 3。如果已经安装 [Homebrew](https://brew.sh/)，运行：

```sh
brew install openssl@3
```

目前电脑端仅支持 macOS，暂不支持 Windows 和 Linux。

## 启动电脑端

在终端运行：

```sh
npx local-agent-dashboard@0.3.6
```

第一次运行时，npx 会询问是否下载，输入 `y` 确认即可。启动后会自动打开浏览器，显示这台电脑最近的任务。

使用期间请保持这个终端窗口打开。要停止服务，在终端按 `Control + C`。

## 连接 Android 手机

1.  从 [GitHub 下载 0.3.6 的 Android 安装包](https://github.com/jiahim/local-agent-dashboard/releases/tag/v0.3.6)，在手机上安装。请选择 `.apk` 文件；无需安装 Expo Go。
2.  让手机和电脑连接同一个 Wi-Fi，或处于可以互相访问的局域网。
3.  在电脑页面点击 **连接手机**，确认网络地址，再点击 **应用所选地址**。默认会选中所有可用地址，也可以用全选、反选来调整。
4.  点击 **生成配对邀请**。打开手机 App，在 **设置 → 电脑连接** 中扫码；也可以把配对链接发送到手机，点击链接打开 App。
5.  核对手机显示的电脑身份，并在电脑页面确认对应的连接申请。

连接成功后，手机就会显示这台电脑的任务。需要添加其他电脑时，在那些电脑上运行同一个命令，再从手机设置中添加。

手机端仅支持 Android arm64，系统要求 Android 8.0 或更新版本。目前 APK 使用测试签名，供试用。

## 常用命令

| 用途 | 命令 |
| --- | --- |
| 检查运行环境，排查启动问题 | `npx local-agent-dashboard@0.3.6 --doctor` |
| 用示例任务体验界面 | `npx local-agent-dashboard@0.3.6 --demo` |
| 启动时不自动打开浏览器 | `npx local-agent-dashboard@0.3.6 --no-open` |
| 查看全部参数 | `npx local-agent-dashboard@0.3.6 --help` |

如果下载的是 Release 中的 `.tgz` 文件，在文件所在目录运行：

```sh
npx --package ./local-agent-dashboard-0.3.6.tgz local-agent-dashboard
```

## 数据保存在哪里？

新安装的数据保存在当前用户目录：

```text
~/Library/Application Support/Local Agent Dashboard
```

如果你已经使用过旧版，且没有创建过新目录，程序会继续使用原来的 `~/Library/Application Support/Agent Signal`，保留已有电脑身份，不会自动移动或删除文件。启动前运行 `--doctor`，可以查看实际使用的目录。

也可以用 `--state-dir <目录>` 指定已有数据目录。同一个目录不要同时运行两个服务。通过源码启动时使用的 `.runtime` 目录不会自动迁移。

已批准手机的授权和已启用的网络地址保存在同一用户数据目录。服务重启或更新 npm 版本后会恢复；撤销授权也会保存。旧版本已经丢失的授权需重新配对一次，之后可保留。

## 隐私与使用范围

程序只读取本机 Codex、Claude Code 和 DeepSeek Harness 的任务状态，不安装 Hook，也不修改它们的配置。DeepSeek 默认读取 `~/.dsh/sessions`，设置了 `DSH_HOME` 时读取该目录下的 `sessions`；支持标准 JSONL / Zstandard v0–v4 的状态子集，自定义持久化后端未接入。原生日志落盘可能延迟；没有明确事件时显示状态待确认，结束不等于已读。电脑管理页面只允许本机访问，手机连接使用加密通信，不经过云端中转。

任务标题可能包含私人信息，请只连接你信任的设备，不要公开分享配对链接或数据目录。任务状态识别仍在完善，部分会话可能显示为状态待确认。

项目目前未提供开源许可证，按 `UNLICENSED` 管理。源码、问题反馈和版本下载见 [GitHub 仓库](https://github.com/jiahim/local-agent-dashboard)。

## 常见问题

### local-agent-dashboard 是什么？

Codex, Claude Code, DeepSeek Harness

### 如何安装 local-agent-dashboard？

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

### local-agent-dashboard 支持 TypeScript 吗？

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

### local-agent-dashboard 支持 ESM 还是 CommonJS？

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

### local-agent-dashboard 需要什么版本的 Node\.js？

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

### local-agent-dashboard 可以商用吗？

local-agent-dashboard 使用 UNLICENSED 许可。作者声明为 UNLICENSED，即不授予公开使用许可（与公共领域的 Unlicense 不同）。使用前需获得作者授权。以上为概括，不构成法律意见，请以许可原文为准。

### local-agent-dashboard 还在维护吗？

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