# @askexenow/exe-os 中文文档

规范地址：https://npmcn.com/package/%40askexenow/exe-os/

版本：0\.9\.415
npm 元数据更新时间：2026-10-28T07:01:40.627Z
中文译文更新时间：2026-11-06T23:32:37.479Z
软件包许可：SEE LICENSE IN LICENSE

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

原始 npm 页面：https://www.npmjs.com/package/%40askexenow/exe-os
原文对照：https://npmcn.com/package/%40askexenow/exe-os/?lang=original
项目主页：https://askexe.com/
源码仓库：https://github.com/AskExe/exe-os

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

- 包体积（解压后）：10.2 MB，831 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20\.0\.0
- 运行依赖：27 个
- 首次发布：2026-04-17T06:49:44.255Z
- 最新版本发布：2026-10-28T07:01:40.461Z
- 近 30 天下载量：4716（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：483（近 12 个月 483 个）

## 中文简介

AI员工操作系统——Claude Code的持续内存,任务管理和多代理协调.

## 安装

```sh
npm install @askexenow/exe-os
```

也可以使用：`pnpm add @askexenow/exe-os`、`yarn add @askexenow/exe-os`、`bun add @askexenow/exe-os`

## README

# 欧斯

AskExe的AI员工操作系统:本地第一内存,身份,任务管弦,以及运行时间胶水,通过克洛德码,Codex,OpenCode管理AI队友,以及新出现的桌面/运行时间堆栈.

当前 npm 软件包 : `@askexenow/exe-os` v0.9.341. 节点.js `>=20` 所需经费.

## 这回购是为了什么

ele-os 让创始人运行一个AI Org而不是单个聊天会话:

-   一个协调员代理通过跟踪任务拥有创始人的对话和代表.
-   专家在与世隔绝的tmux/worktree课程中运行,具有持续的身份,行为和记忆.
-   本地守护进程、MCP服务器、钩子和CLI保持会话、提醒、审查、云同步和诊断连接.
-   客户端数据保持本地第一并加密;启用时云同步为端到端加密.

每个变化都面临困难:

-   **MCP是唯一的数据接口.** 永远不要直接访问 SQLCipher DB .
-   **维护客户数据主权.** 更新不得覆盖身份,行为,程序,名册,本地内存,或用户配置.
-   **在代码,日志,测试,遥测,或bug报告上没有秘密.**
-   **没有 `require()` 运行时的无害环境管理类型Script** 下级 `src/lib`, (中文(简体) ), `src/mcp`,或 `src/tui`;使用无害环境管理进口.
-   **每个任务/审查/信息/通知查询都必须经过过滤 `session_scope`。 。 。 .**
-   **没有硬码员工姓名.** 使用角色/配置解析度,而不是 AskExe 的本地名册 .

## 一览建筑

```text
User / founder
  -> coordinator agent session
     -> managers / specialists via task DB + tmux sessions

Claude Code / Codex / OpenCode
  -> hooks + MCP tools
     -> exe daemon
        -> encrypted local memory/tasks/identity/behavior store
        -> optional E2EE cloud sync
        -> gateway / stack integrations
```

键片 :

-   **MCP 服务器( U)`src/mcp`(中文(简体) )** 曝光支持的工具表面,用于内存,任务,身份,行为,支持,诊断,配置,文档,CRM/raw数据,以及网关行动.
-   **守护进程( D)`src/lib`, (中文(简体) ), `src/services`(中文(简体) )** 监督会议、计时器、任务执行、对接系统、同步、诊断以及当地状况.
-   **适应器`src/adapters`(中文(简体) )** 通过钩子和发射器行为与克洛德代码, Codex,和OpenCode相融合.
-   **CLI 命令 (`src/bin`, (中文(简体) ), `src/commands`(中文(简体) )** 安装、发射、诊断、更新、释放、飞行前、同步和操作堆栈.
-   **运行时间/ TUI (`src/runtime`, (中文(简体) ), `src/tui`(中文(简体) )** 是遗留/当前终端运行时间表面; 架构 doc 注意到遗留的 Irk TUI 被冻结, 而产品方向则向本地的exe-building/desktop聊天运行时间移动.
-   **堆栈部署( O)`deploy`(中文(简体) )** 包含编译、清单、可观察性、注册代理、nginx、迁移和客户VPS部署资产.

代理人使用的认知层 :

1.  公司程序:整体规则.
2.  身份:角色定义和不可谈判.
3.  行为/专长:学习的惩戒和技能.
4.  经验/记忆:可搜索的历史和决定.
5.  后期物品:未来条件内存/再现于靴子上.

## 重播地图

| 路径 | 目的 |
| --- | --- |
| `src/lib/` | 核心守护进程/运行时库:内存,任务,身份,行为,搜索,同步,配置,管弦. |
| `src/mcp/` | 集成MCP服务器和工具执行. 这是支持的数据/控制边界 . |
| `src/adapters/` | Claude/Codex/OpenCode 集成钩和适配胶. |
| `src/bin/` | 通过 CLI 发布的条目 `package.json#bin`。 。 。 . |
| `src/commands/` | 命令执行 `exe-os`,设置/更新/放行流量,诊断等. |
| `src/runtime/` | 代理运行时间/工具注册文件 . |
| `src/tui/` | 遗产 Irk TUI表面;除非明确任务,否则避免新产品投资. |
| `src/gateway/` | 网关/提供者适配器和外部消息集成码. |
| `deploy/` | 客户堆栈会编集文件,清单,迁移,nginx,可观察性,注册代理,Ansible. |
| `deploy/stack-manifests/` | 客户的堆栈清单;图像必须用消化器粘贴. |
| `packages/` | 共享UI/主题/健康/错误页面包. |
| `tests/` | 维特套房,烟雾测试,部署测试,集成测试,管弦测试. |
| `scripts/` | 建立锁,警卫,计划检查,堆栈模拟,飞行前帮助器. |
| `.planning/ARCHITECTURE.md` | 当前架构的真实源并运出进度 。 未来行进图属于MCP支持特性记录,而不是标记下. |
| `release-notes.json` | 更新后显示的当前 npm 发布注释 . |
| `stack.release.json` | 用于客户/VPS参与的堆栈发布描述符. |

## 密钥命令

此软件包发布的客户/操作命令 :

| 命令 | 使用 |
| --- | --- |
| `exe` | 启动配置的协调员代理 . |
| `exe-os` | 主CLI/dashboard条目. |
| `exe-os setup` | 首次设置向导:加密,许可,团队,钩子,MCP,守护进程. |
| `exe-os update` | 为已安装的系统推荐交互式更新路径 . |
| `exe-os healthcheck` 编号 : `exe-healthcheck` | 对守护进程、记忆、云/同步、检索和运行时状态进行健康检查. |
| `exe-doctor` | 更深诊断. |
| `exe-pending-reviews` | 显示检讨队列; 在声称工作是闲置/ 空置前使用 . |
| `exe-pending-messages` | 显示待处理的代理信件 . |
| `exe-config-dump` | 仅读有效的配置垃圾堆, 并进行秘密编辑 . |
| `exe-timers` | 计时器健康仪表板. |
| `exe-search-quality` | 检索质量/相关性遥测. |
| `exe-stack-update` | 客户堆栈图像更新流程 。 运行时只获得明确批准. |
| `exe-preflight` | 堆栈/客户生产飞行前检查. |
| `exe-cloud` | 云同步/链接命令. 从不打印代理输出中的恢复短语 . |

有用的本地检查 :

```bash
npm run typecheck
npm run lint
npm test
npm run test:daemon-smoke
npm run test:stack-sim
npm run guard:esm-require
npm run check:schema-version
npm run build
```

## 发展工作流程

安装依赖性 :

```bash
npm install
```

编码前 :

1.  阅读任务简介和源文件.
2.  在宽手动 grep 之前可用时使用代码折叠/ MCP 搜索 .
3.  保持 diffs 外科手术; 不要重构无关的文件 .
4.  不得触摸客户-本地数据,身份,行为,程序,或名册.

标准验证 :

```bash
npm run typecheck
npm test
npm run build
```

定向验证对于小的改变是可以接受的,但放出/相接闸门需要相关的全面检查. 对于运行时间/守护关键工作,也运行:

```bash
npm run guard:esm-require
npm run test:daemon-smoke
```

构建细节 :

-   `npm run build` 用途 `scripts/build-lock.sh`,然后将运行时间资产复制到 `dist/` 并尽可能生成钩子表.
-   `npm run deploy` 在全球构建、 安装此检出, 并重新启动/ 重新注册 。 它干扰了正在运行的MCP会话;不要随意运行.
-   `postinstall` 运行只命令安装行为,因此全局安装会曝光CLI而不覆盖客户数据.

## 测试和笔记

-   主试跑者: `vitest run`。 。 。 .
-   `test:publish` 是需要公布的门子集加上选定的序列式压力/出入口测试.
-   触摸支持/bug/地貌上上游路径的测试必须模拟 `fetch`;从不创建测试的活性支持记录.
-   Docker/活-DB测试可隔离于 `test:publish`; 在假设一个缺失的测试是偶然的之前读取脚本注释.
-   在合并/释放之前,CI必须是绿色的.

## 出版和发行

国家预防机制公布大门:

```bash
npm run prepublishOnly
```

运行排版检查,构建,孤儿块挤出,无害环境管理 `require()` 警卫 计划版本检查 客户准备状态 以及印刷前检查.

用户普通本地软件包更新路径 :

```bash
npm install -g @askexenow/exe-os@latest
# or use the interactive path
exe-os update
```

客户堆栈释放与 npm 包释放是分开的 :

-   `release-notes.json` 目前音轨为npm v0.9.341.
-   `stack.release.json` 目前描述堆栈/源v0.9.312,并包括用于私人GHCR应用图像消化解析的TODO注释.
-   客户堆栈清单/图像必须是SHA256消化装置。 不要向客户发布推广只使用标签的应用程序图像 .
-   生产堆栈更新必须保留命名的 Docker 卷和客户状态; 永远不要使用 `docker compose down -v` 或删除数据卷.
-   堆叠图像释放应该通过文件 `exe-os release --stack` 流动、Bob/客户 -- -- 准备情况审计、飞行前、固定图像和健康核查.

## 业务专栏

-   **仅限MCP.** 如果 MCP 已断开, 请重新连接它; 不要绕过直接 DB 读取或 ad-hoc 脚本对 SQLCipher .
-   **会议范围很重要.** 交叉会话任务/审查/消息泄漏是一个P0类错误. 查询过滤器必须包含 `session_scope` 在适用的情况下.
-   **除非用户更改数据,否则数据是不可改变的.** 安装、更新、进口、启动包和堆栈更新必须首先添加/检查-存在.
-   **云端点是 `https://api.askexe.com`。 。 。 .** 不引入遗留的云域 .
-   **关键材料属于Keychain/机密工具.** 永远不要日志、打印或承诺恢复短语或主密钥.
-   **运行时间 TypeScript 是无害环境管理.** `require()` 在守护进程/ MCP/ TUI 运行时间路径中, 构建后会中断 .
-   **堆栈状态需要量.** WhatsApp auth, Postgres, wiki/CRM/gateway数据, 监视数据,以及其他状态服务在图像交换前需要命名批量.
-   **医而后取.** 验证守护进程的健康, 待审查, 待审查消息, 任务状态, 和 tmux 状态后再报告代理是闲置/ done/ stuck .
-   **合并后构建 .** 干净的 git 合并不是构建检查; 运行 `npm run build` 之后合并的工作会影响运出代码.
-   **没有 `:latest` 以清单/组成.** 发布图像必须进行版本化和摘要化,供客户部署.

## 供审查的安全清单

-   没有秘密,PII,API密钥,恢复短语,或者代码/测试定着/日志输出中的指使.
-   保留了 Auth 中间软件和权限检查 .
-   外部网络连接使用TLS,除非明确只使用局部.
-   遥测/bug-report Egress 校正了秘密和气象.
-   没有添加直接的 DB 访问路径; 所有代理数据通过 MCP 工具流出 .
-   没有硬编码 AskExe 员工姓名、 本地路径或私人名册假设 .
-   制片服务有健康检查,州级服务有耐用量.

## 许可证

专有. 见 [自由主义](https://npmcn.com/package/%40askexenow/exe-os/LICENSE)。 。 。 .

## 常见问题

### @askexenow/exe-os 是什么？

AI员工操作系统——Claude Code的持续内存,任务管理和多代理协调\.

### 如何安装 @askexenow/exe-os？

在项目目录运行 npm install @askexenow/exe-os，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 exe、exe-os、exe-glm、exe-cicd、exe-kill、exe-kimi、exe-muse、exe-agent、exe-cloud、exe-codex、exe-grant、exe-doctor，可以用 npx exe 直接运行。

### @askexenow/exe-os 支持 TypeScript 吗？

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

### @askexenow/exe-os 支持 ESM 还是 CommonJS？

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

### @askexenow/exe-os 需要什么版本的 Node\.js？

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

### @askexenow/exe-os 可以商用吗？

@askexenow/exe-os 使用 SEE LICENSE IN LICENSE 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @askexenow/exe-os 的下载量有多少？

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

### @askexenow/exe-os 还在维护吗？

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