# @brutalstrikedevs/codexui-android 中文文档

规范地址：https://npmcn.com/package/%40brutalstrikedevs/codexui-android/

版本：0\.1\.96
npm 元数据更新时间：2026-09-25T07:21:48.538Z
中文译文更新时间：2026-11-08T16:51:24.024Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：3.9 MB，31 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=18
- 运行依赖：7 个
- 首次发布：2026-05-28T07:12:41.420Z
- 最新版本发布：2026-09-25T07:21:48.346Z
- 近 30 天下载量：5480（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：6（近 12 个月 6 个）

## 中文简介

运行在 Codex 应用程序服务器上方的 Codex 的轻量级网络界面, 允许从任何浏览器远程访问

## 安装

```sh
npm install @brutalstrikedevs/codexui-android
```

也可以使用：`pnpm add @brutalstrikedevs/codexui-android`、`yarn add @brutalstrikedevs/codexui-android`、`bun add @brutalstrikedevs/codexui-android`

## README

# qq 编码程序

### 在Android上运行 Codex App UI 任何地方: Linux, Windows, 或 Termux

[![npm](https://img.shields.io/npm/v/codexapp?style=for-the-badge&logo=npm&logoColor=white)](https://www.npmjs.com/package/codexapp) [![platform](https://img.shields.io/badge/Platform-Linux%20%7C%20Windows%20%7C%20Android-blue?style=for-the-badge)](https://npmcn.com/package/%40brutalstrikedevs/codexui-android/#readme--quick-start) [![node](https://img.shields.io/badge/Node-18%2B-339933?style=for-the-badge&logo=node.js&logoColor=white)](https://nodejs.org/) [![license](https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge)](https://npmcn.com/package/%40brutalstrikedevs/codexui-android/LICENSE)

> **浏览器中的代码 UI 。 没有戏剧。 一个命令.**
> 
> **是的,这是你的 Codex 桌面应用体验 通过网络用户界面曝光。 是的,它运行跨平台.**

```text
 ██████╗ ██████╗ ██████╗ ███████╗██╗  ██╗██╗   ██╗██╗
██╔════╝██╔═══██╗██╔══██╗██╔════╝╚██╗██╔╝██║   ██║██║
██║     ██║   ██║██║  ██║█████╗   ╚███╔╝ ██║   ██║██║
██║     ██║   ██║██║  ██║██╔══╝   ██╔██╗ ██║   ██║██║
╚██████╗╚██████╔╝██████╔╝███████╗██╔╝ ██╗╚██████╔╝██║
 ╚═════╝ ╚═════╝ ╚═════╝ ╚══════╝╚═╝  ╚═╝ ╚═════╝ ╚═╝
```

* * *

![image](https://github.com/user-attachments/assets/1a3578ba-add8-49a2-88b4-08195a7f0140)

## 这是什么?

**`codexapp`** 是一个轻量级的桥, 它为您提供了一个浏览器可访问的 Codex 应用服务器工作流程的 UI .

你负责一个指令。 它启动本地网络服务器. 你打开它从你的机器,你的局域网, 或任何地方你的设置允许.

**TL; DR QQ: Codex app UI 为Linux,Windows,和Termux驱动的Android设置解锁.**

* * *

## QQ 快速启动

> **主要活动.**

```bash
# 🔓 Run instantly (recommended)
npx @brutalstrikedevs/codexapp

# 🌐 Then open in browser
# http://localhost:18923
```

默认, `codexapp` 现在开始:

```bash
cloudflared tunnel --url http://localhost:<port>
```

它在启动输出中一起打印隧道URL,终端QR代码和密码.  
使用 `--no-tunnel` 以禁用此行为.

如果您正在使用一个已经认证且不需要的提供者或 AI 网关 `codexapp` 强制 `codex login` 启动时,使用:

```bash
npx @brutalstrikedevs/codexapp --no-login
```

### Linux \\\\\\ \\ \\ \\ \\ \\ \\ \\ \\

```bash
node -v   # should be 18+
npx @brutalstrikedevs/codexapp
```

维护者: 遵循 [npm 出版程序](https://npmcn.com/package/%40brutalstrikedevs/codexui-android/docs/publishing.md) 释放 `@brutalstrikedevs/codexapp`。 。 。 .

### 视窗QQ (PowerShell)

```powershell
node -v   # 18+
npx @brutalstrikedevs/codexapp
```

### Termux (Android) (中文(简体) )

```bash
pkg update && pkg upgrade -y
pkg install nodejs -y
npx @brutalstrikedevs/codexapp
```

安卓背景要求:

1.  保留 `codexapp` 在当前 Termux 会话中运行(不要关闭它).
2.  在 Android 设置中,禁用电池优化 `Termux`。 。 。 .
3.  保持持续的Termux通知功能,所以Android不太可能杀死它.
4.  可选但建议载于Termux:

```bash
termux-wake-lock
```

5.  在您的 Android 浏览器中打开显示的 URL 。 如果应用程序被杀死, 请返回 Termux 并运行 `npx @brutalstrikedevs/codexapp` 再来一次.

* * *

## iPhone / iPad 通过 Tailscale 服务

如果要使用从iPhone或iPad Safari得到的代码UI,建议在HTTPS上服务.

一个实用的私人设置是在当地运行代码UI,并用Tailscale Service在你的尾网中发布:

```powershell
npx @brutalstrikedevs/codexapp --no-tunnel --port 5900
tailscale serve --bg 5900
```

然后打开 :

```text
https://<your-machine>.<your-tailnet>.ts.net
```

这种设置在实践中效果良好:

-   iPhone Safari 访问
-   添加到家屏幕
-   应用程序中的内置拼写/ 抄写功能
-   从 Windows 主机查看相同的工程和对话

注释:

-   尾部图 保持对尾部网的访问
-   在 iOS 上, HTTPS / 安全上下文似乎对移动浏览器的访问和拼写很重要
-   一些小移动的Safari CSS问题可能仍然存在,但它们并不妨碍正常使用
-   根据代理细节,认证行为可能不同于直接远程访问
-   如果在 Web UI 中创建的对话不立即出现在 Windows 应用中,重新启动 Windows 应用可能会刷新它们

* * *

## \* 特性

> **载荷.**

-   一个命令发射装置 `npx @brutalstrikedevs/codexapp`
-   QQ 对 Linux、 Windows 和 Android 上的 Termux 的跨平台支持
-   QQ 浏览器- 首个编码器 UI 流出 `http://localhost:18923`
-   从同一网络上的其他设备进入局域网
-   用于基于服务器的 Codex 使用的远程/无头型设置
-   \* 采用反向代理和地道设置
-   \* 快速试验不需要全球安装
-   🎙️ 内建 持有并起诉 语音输入 并抄送作曲草稿
-   QQ可选的Telegram bot Bridge: 发送消息给bot, 转发到映射线程, 发送助手回复到Telegram
-   QQ 工程可移植性: 从项目或线程菜单导出一个工程为 ZIP, 包括匹配 Codex Chat JSONL 历史 `.codex-project/chats/`
-   QQ 工程导入: 从浏览器中恢复导出的项目 ZIPs `Import Project`
-   QQ 为目的地重写导入聊天 `CODEX_HOME`,项目路径,以及目前选定的提供者/模型,以便在新的环境中恢复它们
-   QQ 工程 ZIP 性能: 以响应后压处理导出流 ZIP 字节并跳过生成/ git-ignored 文件夹 ; 导入仍然缓冲选中的 ZIP 一次, 因为浏览器上传为单个文件

### 电波桥( 可选)

开始前设定这些环境变量 `codexapp`数字 :

```bash
export TELEGRAM_BOT_TOKEN="<your-telegram-bot-token>"
export TELEGRAM_ALLOWED_USER_IDS="<your-telegram-user-id>,<optional-second-id>"
export TELEGRAM_DEFAULT_CWD="$PWD" # optional, defaults to current working directory
npx @brutalstrikedevs/codexapp
```

`TELEGRAM_ALLOWED_USER_IDS` 安全进出需要。 只有允许上市的Telegram用户ID才能使用桥接. 如果不配置允许的用户ID,则拒绝输入的Telegram消息.

要找到您的 Telegram 用户 ID :

1.  给机器人发个消息.
2.  运行 `curl "https://api.telegram.org/bot<your-telegram-bot-token>/getUpdates"`。 。 。 .
3.  读取 `message.from.id` 从返回的更新有效载荷.

装瓶命令 :

-   `/start` 显示快速帮助和线索拾取器
-   `/threads` 列表最近线索并选择一条
-   `/newthread` 为此Telegram 聊天创建并映射新代码线索
-   `/thread <threadId>` 将当前Telegram聊天映射到已有线索
-   `/current` 显示当前连接的此聊天线索
-   `/history` 显示当前线程的最近历史
-   `/status` 显示桥/映射状态
-   `/whoami` 显示您的 Telegram 用户/ 聊天ID 和授权状态
-   `/help` 显示命令引用

用Telegram发送出助理信件 `parse_mode=HTML` 用于格式化,如果 HTML 发送失败,则使用自动倒置的纯文本.

* * *

## • 近期产品特性(主要产品)

> **不只是发射 实际UX升级.**

-   在新线程中搜索可选项目
-   QQ 在“ 选择文件夹” 旁边的“ 创建工程 ” 按钮, 有浏览器提示
-   QQ 新工程自动被绑入顶端
-   通过服务器侧的自由目录扫描,智能默认新项目名称建议( S)`New Project (N)`(中文(简体) )
-   \* 项目秩序在全球持续维持,以建立工作空间根基状态
-   🧵 在刷新/渗透周期中保留的最佳在建线程
-   XQ 桌面布局中的移动抽屉侧边栏( 切换上覆盖 + 方便刷取的结构)
-   \* 改进技能中心移动方便的间隔/工具栏布局
-   QQ 技能细节模式调制用于移动工作表风格的行为
-   技能中心事件打字修正 `SkillCard` 选择发送兼容性
-   作曲家的相声`hold to dictate` - > 转录 - > 附录文本)

* * *

## 你能用这个做什么?

| 使用大小写 | 你得到什么了吗 |
| --- | --- |
| Linux 工作站 | 在浏览器中运行代码UI而不依赖于桌面外壳 |
| 视窗机 | 从 Chrome/ Edge 快速启动网络用户界面和访问 |
| QQ Android 上的 Termux 软件 | 在 Termux 中启动服务并使用移动浏览器控制 |
| 远程 Dev 框 | 在服务器上保留代码进程, 从客户端设备查看 UI |
| 局域网共享 | 从同一网络的另一设备打开用户界面 |
| 无头工作流程 | 保留终端 + 浏览器拆分以提高生产力 |
| QQ 自定义路由 | 需要时设置倒置代理/隧道 |
| 快速实验 | `npx` 运行时没有完整的全局设置 |

* * *

## QQ 屏幕截图

### 技能中心

![Skills Hub](https://npmcn.com/package/%40brutalstrikedevs/codexui-android/docs/screenshots/skills-hub.png)

### 聊天

![Chat](https://npmcn.com/package/%40brutalstrikedevs/codexui-android/docs/screenshots/chat.png)

### 移动 UI

![Skills Hub Mobile](https://npmcn.com/package/%40brutalstrikedevs/codexui-android/docs/screenshots/skills-hub-mobile.png) ![Chat Mobile](https://npmcn.com/package/%40brutalstrikedevs/codexui-android/docs/screenshots/chat-mobile.png)

* * *

## 建筑

```text
┌─────────────────────────────┐
│  Browser (Desktop/Mobile)   │
└──────────────┬──────────────┘
               │ HTTP/WebSocket
┌──────────────▼──────────────┐
│         codexapp            │
│  (Express + Vue UI bridge)  │
└──────────────┬──────────────┘
               │ RPC/Bridge calls
┌──────────────▼──────────────┐
│      Codex App Server       │
└─────────────────────────────┘
```

* * *

## 所需经费

-   节点.js `18+`
-   QQ 代码应用程序服务器环境可用
-   QQ 浏览器访问主机/端口
-   QQ 麦克风权限( 只用于语音拼写)

* * *

## \* 解决问题

| 问题 | 修补 |
| --- | --- |
| 已经使用的端口 | 在自由端口上运行或停止旧进程 |
| `npx` 失败 | 更新 npm/ 节点, 然后重试 |
| Termux 安装失败 | `pkg update && pkg upgrade` 然后重新安装 `nodejs` |
| 不能从其他设备打开 | 检查防火墙、绑定地址和局域网路由 |

* * *

## 捐款

问题和PR是受欢迎的.  
带出错误报告,平台注释,以及设置改进.

* * *

## {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}##########################

如果您认为 Codex UI 应该可以从 **任何机器,任何操作系统,任何屏幕**并分享

为速度、可移动性 和一点点混乱所建

* * *

从 [铺设- voronin/ codex- web- 本地](https://github.com/pavel-voronin/codex-web-local) 由帕维尔·沃罗宁所著.

## 常见问题

### @brutalstrikedevs/codexui-android 是什么？

运行在 Codex 应用程序服务器上方的 Codex 的轻量级网络界面, 允许从任何浏览器远程访问

### 如何安装 @brutalstrikedevs/codexui-android？

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

### @brutalstrikedevs/codexui-android 支持 TypeScript 吗？

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

### @brutalstrikedevs/codexui-android 支持 ESM 还是 CommonJS？

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

### @brutalstrikedevs/codexui-android 需要什么版本的 Node\.js？

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

### @brutalstrikedevs/codexui-android 可以商用吗？

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

### @brutalstrikedevs/codexui-android 的下载量有多少？

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

### @brutalstrikedevs/codexui-android 还在维护吗？

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