SakuraByteCore · ymkiux · Apr 21, 2026 · Apr 20, 2026 · Apr 20, 2026 · Apr 20, 2026
diff --git a/README.md b/README.md
@@ -14,7 +14,7 @@
 [![Stars](https://img.shields.io/github/stars/SakuraByteCore/codexmate?label=stars&style=flat)](https://github.com/SakuraByteCore/codexmate/stargazers)
 [![Issues](https://img.shields.io/github/issues/SakuraByteCore/codexmate?label=issues&style=flat)](https://github.com/SakuraByteCore/codexmate/issues)
 
-[Quick Start](#quick-start) · [Commands](#command-reference) · [Web UI](#web-ui) · [MCP](#mcp) · [中文](README.zh.md)
+[Docs](https://sakurabytecore.github.io/codexmate/) · [Quick Start](#quick-start) · [Commands](#command-reference) · [Web UI](#web-ui) · [MCP](#mcp) · [中文](README.zh.md)
 
 </div>
 
@@ -150,6 +150,21 @@ Default listen address is `0.0.0.0:3737` for LAN access, and browser auto-open i
 
 > Safety note: the unauthenticated management UI is exposed to your current LAN by default. Use trusted networks only; for local-only access, set `CODEXMATE_HOST=127.0.0.1` or pass `--host 127.0.0.1`.
 
+### Install Codex CLI / Claude Code CLI (optional)
+
+Codex Mate can pass through to the official CLIs (e.g. `codexmate codex ...`). Install them first:
+
+```bash
+# Codex CLI (default)
+npm install -g @openai/codex
+
+# Codex CLI on Termux (Android)
+npm install -g @mmmbuto/codex-cli-termux@latest
+
+# Claude Code
+npm install -g @anthropic-ai/claude-code
+```
+
 ### Run from source
 
 ```bash

diff --git a/README.zh.md b/README.zh.md
@@ -14,7 +14,7 @@
 [![Stars](https://img.shields.io/github/stars/SakuraByteCore/codexmate?label=stars&style=flat)](https://github.com/SakuraByteCore/codexmate/stargazers)
 [![Issues](https://img.shields.io/github/issues/SakuraByteCore/codexmate?label=issues&style=flat)](https://github.com/SakuraByteCore/codexmate/issues)
 
-[快速开始](#快速开始) · [命令速查](#命令速查) · [Web 界面](#web-界面) · [MCP](#mcp) · [English](README.md)
+[文档](https://sakurabytecore.github.io/codexmate/) · [快速开始](#快速开始) · [命令速查](#命令速查) · [Web 界面](#web-界面) · [MCP](#mcp) · [English](README.md)
 
 </div>
 
@@ -153,6 +153,21 @@ codexmate run
 
 > 安全提示：默认监听会在当前局域网暴露未鉴权的管理界面。若包含 API Key、provider 配置或 skills 管理，请仅在可信网络中使用；如需仅本机访问，可设置 `CODEXMATE_HOST=127.0.0.1` 或启动时传入 `--host 127.0.0.1`。
 
+### 安装 Codex CLI / Claude Code（可选）
+
+Codex Mate 支持透传调用官方 CLI（例如 `codexmate codex ...`），建议先安装：
+
+```bash
+# Codex CLI（默认）
+npm install -g @openai/codex
+
+# Termux（Android）上的 Codex CLI
+npm install -g @mmmbuto/codex-cli-termux@latest
+
+# Claude Code
+npm install -g @anthropic-ai/claude-code
+```
+
 ### 从源码运行
 
 ```bash

diff --git a/tests/unit/config-tabs-ui.test.mjs b/tests/unit/config-tabs-ui.test.mjs
diff --git a/tests/unit/provider-switch-regression.test.mjs b/tests/unit/provider-switch-regression.test.mjs
@@ -227,10 +227,7 @@ test('performProviderSwitch keeps provider when provider models fail to load', a
         ['loadModelsForProvider', 'beta'],
         ['applyCodexConfigDirect', { silent: true }]
     ]);
-    assert.deepStrictEqual(context.messages, [{
-        text: '模型列表获取失败，但已切换提供商；请检查 URL/密钥或手动设置模型',
-        type: 'error'
-    }]);
+    assert.deepStrictEqual(context.messages, []);
 });
 
 test('updateProvider keeps existing key when edit key input is blank', async () => {

diff --git a/tests/unit/web-ui-behavior-parity.test.mjs b/tests/unit/web-ui-behavior-parity.test.mjs
@@ -362,6 +362,7 @@ test('captured bundled app skeleton only exposes expected data key drift versus
         'sessionListVisibleCount'
     ];
     allowedExtraCurrentKeys.push(
+        'lang',
         'configTemplateDiffVisible',
         'configTemplateDiffLoading',
         'configTemplateDiffError',
@@ -412,6 +413,10 @@ test('captured bundled app skeleton only exposes expected data key drift versus
     const extraCurrentMethodKeys = currentMethodKeys.filter((key) => !headMethodKeys.includes(key)).sort();
     const missingCurrentMethodKeys = headMethodKeys.filter((key) => !currentMethodKeys.includes(key)).sort();
     const allowedExtraCurrentMethodKeys = [
+        'initI18n',
+        'normalizeLang',
+        'setLang',
+        't',
         'cancelScheduledSessionListViewportFill',
         'canSubmitProvider',
         'expandVisibleSessionList',

diff --git a/web-ui/app.js b/web-ui/app.js
@@ -29,7 +29,9 @@ document.addEventListener('DOMContentLoaded', () => {
     const app = createApp({
         data() {
             return {
-                mainTab: 'config',
+                lang: 'zh',
+                // 默认选中首个主标签：Docs
+                mainTab: 'docs',
                 configMode: 'codex',
                 currentProvider: '',
                 currentModel: '',
@@ -419,6 +421,9 @@ document.addEventListener('DOMContentLoaded', () => {
         },
 
         mounted() {
+            if (typeof this.initI18n === 'function') {
+                this.initI18n();
+            }
             this.initSessionStandalone();
             this.updateCompactLayoutMode();
             if (!this.taskOrchestrationTabEnabled && this.mainTab === 'orchestration') {

diff --git a/web-ui/logic.runtime.mjs b/web-ui/logic.runtime.mjs
@@ -108,16 +108,20 @@ export function shouldForceCompactLayoutMode(options = {}) {
     const coarsePointer = !!options.coarsePointer;
     const noHover = !!options.noHover;
     const isSmallPhysicalScreen = shortEdge > 0 && shortEdge <= 920;
-    const isNarrowViewport = viewportWidth > 0 && viewportWidth <= 960;
+    const isNarrowViewport = viewportWidth > 0 && viewportWidth <= 720;
     const pointerSuggestsTouchOnly = coarsePointer && noHover;
 
-    if (isMobileUa) {
-        return isNarrowViewport || isSmallPhysicalScreen;
-    }
-    if (!pointerSuggestsTouchOnly) {
-        return false;
+    if (viewportWidth > 0) {
+        if (!isNarrowViewport) {
+            return false;
+        }
+        if (isMobileUa) {
+            return true;
+        }
+        return pointerSuggestsTouchOnly && maxTouchPoints > 0;
     }
-    if (maxTouchPoints <= 0) {
+
+    if (!pointerSuggestsTouchOnly || maxTouchPoints <= 0) {
         return false;
     }
     return isSmallPhysicalScreen;

diff --git a/web-ui/modules/app.computed.dashboard.mjs b/web-ui/modules/app.computed.dashboard.mjs
@@ -44,9 +44,13 @@ export function createDashboardComputed() {
             const action = this.normalizeInstallAction(this.installCommandAction);
             return targets.map((target) => {
                 const id = target && typeof target.id === 'string' ? target.id : '';
+                const termuxCommand = id === 'codex'
+                    ? this.getInstallCommand(id, action, 'termux')
+                    : '';
                 return {
                     ...target,
-                    command: this.getInstallCommand(id, action)
+                    command: this.getInstallCommand(id, action),
+                    termuxCommand
                 };
             });
         },
@@ -107,15 +111,15 @@ export function createDashboardComputed() {
             const platform = this.resolveInstallPlatform();
             if (platform === 'win32') {
                 return [
-                    'PowerShell 报权限不足（EACCES/EPERM）时，请以管理员身份执行安装命令。',
-                    '安装后若仍提示找不到命令，重开终端并执行：where codex / where claude。',
-                    '公司网络受限时，可先切换镜像源快捷项（npmmirror / 腾讯云 / 自定义）。'
+                    this.t('docs.tip.win.1'),
+                    this.t('docs.tip.win.2'),
+                    this.t('docs.tip.win.3')
                 ];
             }
             return [
-                '出现 EACCES 权限错误时，优先修复 Node 全局目录权限，不建议直接 sudo npm。',
-                '安装后若命令未生效，重开终端并执行：which codex / which claude。',
-                '公司网络受限时，可先切换镜像源快捷项（npmmirror / 腾讯云 / 自定义）。'
+                this.t('docs.tip.unix.1'),
+                this.t('docs.tip.unix.2'),
+                this.t('docs.tip.unix.3')
             ];
         }
     };

diff --git a/web-ui/modules/app.computed.main-tabs.mjs b/web-ui/modules/app.computed.main-tabs.mjs
@@ -132,34 +132,34 @@ function createTaskDraftReadiness(metrics) {
 export function createMainTabsComputed() {
     return {
         mainTabKicker() {
-            if (this.mainTab === 'config') return 'Configuration';
-            if (this.mainTab === 'sessions') return 'Sessions';
-            if (this.mainTab === 'usage') return 'Usage';
-            if (this.mainTab === 'orchestration') return 'Tasks';
-            if (this.mainTab === 'market') return 'Skills';
-            if (this.mainTab === 'plugins') return 'Plugins';
-            if (this.mainTab === 'docs') return 'Docs';
-            return 'Settings';
+            if (this.mainTab === 'config') return this.t('kicker.config');
+            if (this.mainTab === 'sessions') return this.t('kicker.sessions');
+            if (this.mainTab === 'usage') return this.t('kicker.usage');
+            if (this.mainTab === 'orchestration') return this.t('kicker.orchestration');
+            if (this.mainTab === 'market') return this.t('kicker.market');
+            if (this.mainTab === 'plugins') return this.t('kicker.plugins');
+            if (this.mainTab === 'docs') return this.t('kicker.docs');
+            return this.t('kicker.settings');
         },
         mainTabTitle() {
-            if (this.mainTab === 'config') return '本地配置控制台';
-            if (this.mainTab === 'sessions') return '会话与导出';
-            if (this.mainTab === 'usage') return '本地用量与趋势';
-            if (this.mainTab === 'orchestration') return '任务编排';
-            if (this.mainTab === 'market') return 'Skills 安装与同步';
-            if (this.mainTab === 'plugins') return '插件与模板';
-            if (this.mainTab === 'docs') return 'CLI 安装与文档';
-            return '系统与数据设置';
+            if (this.mainTab === 'config') return this.t('title.config');
+            if (this.mainTab === 'sessions') return this.t('title.sessions');
+            if (this.mainTab === 'usage') return this.t('title.usage');
+            if (this.mainTab === 'orchestration') return this.t('title.orchestration');
+            if (this.mainTab === 'market') return this.t('title.market');
+            if (this.mainTab === 'plugins') return this.t('title.plugins');
+            if (this.mainTab === 'docs') return this.t('title.docs');
+            return this.t('title.settings');
         },
         mainTabSubtitle() {
-            if (this.mainTab === 'config') return '管理本地配置与模型。';
-            if (this.mainTab === 'sessions') return '浏览与导出会话。';
-            if (this.mainTab === 'usage') return '查看近 7 / 30 天用量。';
-            if (this.mainTab === 'orchestration') return '规划、排队、执行与回看本地任务。';
-            if (this.mainTab === 'market') return '管理本地 Skills。';
-            if (this.mainTab === 'plugins') return '管理模板化 prompt 与可复用插件。';
-            if (this.mainTab === 'docs') return '查看 CLI 安装命令与排障。';
-            return '管理下载、目录与回收站。';
+            if (this.mainTab === 'config') return this.t('subtitle.config');
+            if (this.mainTab === 'sessions') return this.t('subtitle.sessions');
+            if (this.mainTab === 'usage') return this.t('subtitle.usage');
+            if (this.mainTab === 'orchestration') return this.t('subtitle.orchestration');
+            if (this.mainTab === 'market') return this.t('subtitle.market');
+            if (this.mainTab === 'plugins') return this.t('subtitle.plugins');
+            if (this.mainTab === 'docs') return this.t('subtitle.docs');
+            return this.t('subtitle.settings');
         },
         taskOrchestrationSelectedRun() {
             return this.taskOrchestration && this.taskOrchestration.selectedRunDetail

diff --git a/web-ui/modules/app.methods.codex-config.mjs b/web-ui/modules/app.methods.codex-config.mjs
@@ -132,9 +132,6 @@ export function createCodexConfigMethods(options = {}) {
             await modelsTask;
 
             if (this.currentProvider === name) {
-                if (this.modelsSource === 'error') {
-                    this.showMessage('模型列表获取失败，但已切换提供商；请检查 URL/密钥或手动设置模型', 'error');
-                }
                 if (this.modelsSource === 'remote' && this.models.length > 0 && !this.models.includes(this.currentModel)) {
                     this.currentModel = this.models[0];
                     this.modelsHasCurrent = true;

diff --git a/web-ui/modules/app.methods.index.mjs b/web-ui/modules/app.methods.index.mjs
@@ -28,6 +28,7 @@ import { createSessionTrashMethods } from './app.methods.session-trash.mjs';
 import { createStartupClaudeMethods } from './app.methods.startup-claude.mjs';
 import { createSkillsMethods } from './skills.methods.mjs';
 import { createPluginsMethods } from './plugins.methods.mjs';
+import { createI18nMethods } from './i18n.mjs';
 import {
     CONFIG_MODE_SET,
     getProviderConfigModeMeta
@@ -41,6 +42,7 @@ import {
 
 export function createAppMethods() {
     return {
+        ...createI18nMethods(),
         ...createStartupClaudeMethods({
             api,
             defaultModelContextWindow: DEFAULT_MODEL_CONTEXT_WINDOW,

diff --git a/web-ui/modules/app.methods.install.mjs b/web-ui/modules/app.methods.install.mjs
@@ -78,6 +78,13 @@ export function createInstallMethods() {
         },
 
         resolveInstallPlatform() {
+            const navUserAgent = typeof navigator !== 'undefined' && typeof navigator.userAgent === 'string'
+                ? navigator.userAgent.trim().toLowerCase()
+                : '';
+            // Termux runs on Android; Codex CLI needs a Termux-friendly build.
+            if (navUserAgent.includes('termux') || navUserAgent.includes('android')) {
+                return 'termux';
+            }
             const navPlatform = typeof navigator !== 'undefined' && typeof navigator.platform === 'string'
                 ? navigator.platform.trim().toLowerCase()
                 : '';
@@ -86,8 +93,11 @@ export function createInstallMethods() {
             return 'linux';
         },
 
-        buildInstallCommandMatrix(packageManager) {
+        buildInstallCommandMatrix(packageManager, platformOverride = '') {
             const manager = this.normalizeInstallPackageManager(packageManager);
+            const platform = platformOverride ? String(platformOverride).trim().toLowerCase() : this.resolveInstallPlatform();
+            const codexPackage = platform === 'termux' ? '@mmmbuto/codex-cli-termux' : '@openai/codex';
+            const codexInstallPackage = platform === 'termux' ? '@mmmbuto/codex-cli-termux@latest' : '@openai/codex';
             const matrix = {
                 claude: {
                     install: '',
@@ -104,34 +114,36 @@ export function createInstallMethods() {
                 matrix.claude.install = 'pnpm add -g @anthropic-ai/claude-code';
                 matrix.claude.update = 'pnpm up -g @anthropic-ai/claude-code';
                 matrix.claude.uninstall = 'pnpm remove -g @anthropic-ai/claude-code';
-                matrix.codex.install = 'pnpm add -g @openai/codex';
-                matrix.codex.update = 'pnpm up -g @openai/codex';
-                matrix.codex.uninstall = 'pnpm remove -g @openai/codex';
+                matrix.codex.install = `pnpm add -g ${codexInstallPackage}`;
+                matrix.codex.update = `pnpm up -g ${codexPackage}`;
+                matrix.codex.uninstall = `pnpm remove -g ${codexPackage}`;
                 return matrix;
             }
             if (manager === 'bun') {
                 matrix.claude.install = 'bun add -g @anthropic-ai/claude-code';
                 matrix.claude.update = 'bun update -g @anthropic-ai/claude-code';
                 matrix.claude.uninstall = 'bun remove -g @anthropic-ai/claude-code';
-                matrix.codex.install = 'bun add -g @openai/codex';
-                matrix.codex.update = 'bun update -g @openai/codex';
-                matrix.codex.uninstall = 'bun remove -g @openai/codex';
+                matrix.codex.install = `bun add -g ${codexInstallPackage}`;
+                matrix.codex.update = `bun update -g ${codexPackage}`;
+                matrix.codex.uninstall = `bun remove -g ${codexPackage}`;
                 return matrix;
             }
             matrix.claude.install = 'npm install -g @anthropic-ai/claude-code';
             matrix.claude.update = 'npm update -g @anthropic-ai/claude-code';
             matrix.claude.uninstall = 'npm uninstall -g @anthropic-ai/claude-code';
-            matrix.codex.install = 'npm install -g @openai/codex';
-            matrix.codex.update = 'npm update -g @openai/codex';
-            matrix.codex.uninstall = 'npm uninstall -g @openai/codex';
+            matrix.codex.install = `npm install -g ${codexInstallPackage}`;
+            matrix.codex.update = platform === 'termux'
+                ? `npm install -g ${codexInstallPackage}`
+                : `npm update -g ${codexPackage}`;
+            matrix.codex.uninstall = `npm uninstall -g ${codexPackage}`;
             return matrix;
         },
 
-        getInstallCommand(targetId, actionName) {
+        getInstallCommand(targetId, actionName, platformOverride = '') {
             const targetKey = typeof targetId === 'string' ? targetId.trim() : '';
             if (!targetKey) return '';
             const action = this.normalizeInstallAction(actionName);
-            const currentMap = this.buildInstallCommandMatrix(this.installPackageManager);
+            const currentMap = this.buildInstallCommandMatrix(this.installPackageManager, platformOverride);
             const current = currentMap[targetKey] && typeof currentMap[targetKey][action] === 'string'
                 ? currentMap[targetKey][action]
                 : '';

diff --git a/web-ui/modules/app.methods.startup-claude.mjs b/web-ui/modules/app.methods.startup-claude.mjs
@@ -102,7 +102,6 @@ export function createStartupClaudeMethods(options = {}) {
         },
 
         async loadModelsForProvider(providerName, options = {}) {
-            const silentError = !!options.silentError;
             const targetProvider = typeof providerName === 'string' ? providerName.trim() : '';
             const requestSeq = (Number(this.codexModelsRequestSeq) || 0) + 1;
             this.codexModelsRequestSeq = requestSeq;
@@ -131,9 +130,6 @@ export function createStartupClaudeMethods(options = {}) {
                     return;
                 }
                 if (res.error) {
-                    if (!silentError) {
-                        this.showMessage('获取模型列表失败', 'error');
-                    }
                     this.models = [];
                     this.modelsSource = 'error';
                     this.modelsHasCurrent = true;
@@ -147,9 +143,6 @@ export function createStartupClaudeMethods(options = {}) {
                 if (!isLatestRequest()) {
                     return;
                 }
-                if (!silentError) {
-                    this.showMessage('获取模型列表失败', 'error');
-                }
                 this.models = [];
                 this.modelsSource = 'error';
                 this.modelsHasCurrent = true;