# @codex-ultra/cxu 中文文档

规范地址：https://npmcn.com/package/%40codex-ultra/cxu/

版本：0\.2\.194
npm 元数据更新时间：2026-10-21T12:26:27.953Z
中文译文更新时间：2026-11-10T08:24:28.422Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：67.5 MB，165 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=18
- 运行依赖：2 个
- 首次发布：2026-09-12T14:29:50.400Z
- 最新版本发布：2026-10-21T12:26:27.550Z
- 近 30 天下载量：4886（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：61（近 12 个月 61 个）

## 中文简介

codex-ltra workbench 启动器:由 Bun + web UI 本地编译的服务器(cxu 启动全部).

## 安装

```sh
npm install @codex-ultra/cxu
```

也可以使用：`pnpm add @codex-ultra/cxu`、`yarn add @codex-ultra/cxu`、`bun add @codex-ultra/cxu`

## README

# @ codex- ultra/ cxu

用于 **密码** workbench:由本地编译的服务器+web UI. `cxu` 开始所有.

Codex Ultra是用于Codex CLI的本地第一工作台(由 `codex app-server`: React + MUI 三栏UI(历史,聊天,作曲,配置/工具/文件检查),第三方中继通道,成员有每个成员中继白名单,使用和计费,侧聊天分页,SSH工作空间,真实的Codex slash命令(`/review`, (中文(简体) ), `/compact`, (中文(简体) ), `/resume`, (中文(简体) ), `/model`, (中文(简体) ), `/skills`, (中文(简体) ), `/plugins`, (中文(简体) ), `/mcp`,...),主题插件,以及电子桌面外壳. 这个软件包将服务器二进制(每个平台的可选软件包)与已建成的Web UI一起传送,并以单一命令开始.

## 安装

```bash
npm i -g @codex-ultra/cxu
```

需要节点 `>=18` 组合键 `>=1.1`。没有预建的二进制可以下载 : `cxu` 第一次运行时为您的机器编译本地 Bun 的服务器( 每个版本一次, 缓存于 `~/.cxu/server/`) (中文(简体) ).

## 快开始

```bash
cxu
# open http://127.0.0.1:43110/
```

第一次运行检查你的机器, 提议安装缺失的东西, 如果需要, 本地编译服务器, 然后开始工作台。 无单独的 `cxu doctor` 需要打电话.

```bash
cxu serve --port 43110 --data-dir ~/.codex-ultra
cxu --help
cxu --version
```

## 环境医生

```bash
cxu doctor
```

检查 邦加那个 `codex` 编号 : `claude` 编号 : `agy` 编号 : `grok` 编号 : `pi` 编号 : `opencode` (原始内容存档于2018-03-26). CLIs. `codex` 是 REQUIRED;其余是可选的(Bun仅用于TypeScript-track执行)。 对于Codex,医生还验证了管理的独立的守护进程(`~/.codex/packages/standalone/current/`工作台应用服务器的靴子——只安装 npm 的 Codex 被标记为 `⚠` 加上正式安装者的命令。 缺少工具打印其正式安装命令, 在 TTY 上您可以得到交互提示 :

-   `[a]` 用正式安装器自动安装所有缺失的工具
-   `[s]` 跳过并启动工作台( 默认)
-   `[m]` 显示手动安装命令

```bash
cxu doctor --yes   # non-interactive one-click install (CI-friendly)
cxu doctor --no-prompt
```

退出代码为 `2` 当 Codex CLI 缺席时.

```bash
cxu install [tool]        # print install command only, changes nothing
cxu install [tool] --yes  # run the official installer
cxu install --all --yes   # one-click: install every missing tool
```

## 库: 文件 + AST 工具包

同一软件包可导入为纯TypeScript工具包(运行于平地节点.js上,零嵌入二进制) :

-   单步工具 : `read_file`, (中文(简体) ), `edit_file`, (中文(简体) ), `grep_search`, (中文(简体) ), `apply_patch`, (中文(简体) ), `find_files`, (中文(简体) ), `file_outline`, (中文(简体) ), `find_definition`, (中文(简体) ), `find_references`, (中文(简体) ), `rename_symbol`,还有20+.
-   AST通过便携式WebAssembly(`web-tree-sitter` + 键 `tree-sitter-wasms`: TypeScript, TSX, JavaScript, Python, Rust, Go, Zig, JSON, TOML, YAML, Bash. 出自"中国历史地名大辞典". `c` 编号 : `cpp` 编号 : `java` 编号 : `c_sharp` 倒回内置的regex大纲,输出形状相同.
-   复杂类型脚本音轨( T)`run_bun`)按需要检测出Bun并打印出跨平台安装提示而不是崩溃.

视窗( PowerShell ) : `powershell -c "irm bun.sh/install.ps1 | iex"` macOS / Linux : `curl -fsSL https://bun.sh/install | bash` 其它: 使用您的系统包管理器, 或查看 [https://bun.sh (中文(简体) )](https://bun.sh/)

## 平台支持

Windows / Linux / macOS(英特尔+苹果硅/ARM). 服务器是用您的本地 Bun 编译的 `bun build --compile`,当前平台),因此没有每个平台的软件包可以下载;文件/AST库本身是纯类型Script + `.wasm` 并到处工作 `>=18` 运行.

## 构建/ 发布检查( 维护者)

```bash
npm --workspace @codex-ultra/cxu run vendor
npm --workspace @codex-ultra/cxu run build
npm pack --dry-run --workspace @codex-ultra/cxu
```

`scripts/build.mjs` 首选 `bun build --minify` (目标节点,无害环境管理)并返回重建 `minify: true` bun不在的时候. `prepack` 运行构建然后 `scripts/obfuscate.mjs`因此,发布船只 精密的+模糊的捆绑.

仅 `dist/` (+ 数) `.d.ts`, (中文(简体) ), `wasm/`, (中文(简体) ), `web-dist/`, (中文(简体) ), `server-bundle/` (预先捆绑的JS服务器首次在当地编译), `README.md`, (中文(简体) ), `LICENSE` 飞船 没有 `.exe` 编号 : `.dll` 编号 : `.so` 编号 : `.dylib`没有预建的二进制.

## 链接

-   仓库 : [https://github.com/layola13/codex-ultra 页面存档备份,存于互联网档案馆](https://github.com/layola13/codex-ultra)
-   问题: [https://github.com/layola13/codex-ultra/ 问题](https://github.com/layola13/codex-ultra/issues)

## 常见问题

### @codex-ultra/cxu 是什么？

codex-ltra workbench 启动器:由 Bun \+ web UI 本地编译的服务器\(cxu 启动全部\)\.

### 如何安装 @codex-ultra/cxu？

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

### @codex-ultra/cxu 支持 TypeScript 吗？

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

### @codex-ultra/cxu 支持 ESM 还是 CommonJS？

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

### @codex-ultra/cxu 需要什么版本的 Node\.js？

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

### @codex-ultra/cxu 可以商用吗？

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

### @codex-ultra/cxu 的下载量有多少？

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

### @codex-ultra/cxu 还在维护吗？

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