codexmate 0.0.13 → 0.0.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (13) hide show
  1. package/README.en.md +429 -0
  2. package/README.md +231 -215
  3. package/cli.js +2450 -137
  4. package/doc/CHANGELOG.md +10 -3
  5. package/doc/CHANGELOG.zh-CN.md +7 -0
  6. package/lib/cli-utils.js +16 -0
  7. package/lib/workflow-engine.js +340 -0
  8. package/package.json +11 -4
  9. package/web-ui/app.js +515 -5
  10. package/web-ui/index.html +242 -19
  11. package/web-ui/logic.mjs +147 -1
  12. package/web-ui/styles.css +648 -10
  13. package/README.zh-CN.md +0 -419
package/README.md CHANGED
@@ -12,402 +12,418 @@
12
12
  [![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
13
13
  [![Node](https://img.shields.io/badge/node-%3E%3D14.0.0-green.svg)](https://nodejs.org)
14
14
 
15
- **A lightweight AI configuration assistant: quickly switch Codex providers/models and Claude Code configs, with a unified session browser**
15
+ **轻量级 AI 配置助手：快速切换 Codex 提供商/模型与 Claude Code 配置，统一浏览本地会话**
16
16
 
17
17
  </div>
18
18
 
19
19
  ---
20
20
 
21
- <p align="center">English · <a href="README.zh-CN.md">中文版</a></p>
21
+ <p align="center">中文 · <a href="README.en.md">English</a></p>
22
22
 
23
23
  ![Codex Mate Web UI](res/screenshot.png)
24
24
 
25
- ## Overview
25
+ ## 概览
26
26
 
27
- One tool to switch Codex/Claude Code providers & models and manage/browse local sessions in one click.
27
+ Codex Mate 让 Codex 与 Claude Code 的提供商/模型切换变成“一条命令或一次点击”，并在同一 Web 页面浏览、导出两者的本地会话记录。
28
28
 
29
- ## What You Get
29
+ ## 60 秒上手（源码一行安装）
30
30
 
31
- - One-command provider/model switching
32
- - Local config control with backups
33
- - Lightweight Web UI instead of heavy clients
34
- - Unified session browser (view/export/resume when available)
35
- - Session management: list/filter/export/delete local sessions; keyword search supports Codex and Claude
36
- - New in 0.0.10: Claude sessions are searchable by keywords (e.g., `claude code`, `claude-code`, numeric tokens)
31
+ 环境要求：`Node.js >= 14`、`Git`
37
32
 
38
- ## Feature Overview
39
-
40
- | Module | Problem | Key Capabilities |
41
- | --- | --- | --- |
42
- | Codex Config | Switching providers/models is painful | Provider/model switching, model management, CLI + Web entry points, template-confirmed writes |
43
- | Claude Code Config | Multiple profiles and inconsistent write paths | Profile management, default write to `~/.claude/settings.json` |
44
- | OpenClaw Config | OpenClaw configs are scattered | JSON5 profiles, apply to `~/.openclaw/openclaw.json`, AGENTS workspace management |
45
- | Session Browser | Local sessions are hard to track | List/filter sessions, keyword search (Codex + Claude), export to Markdown, copy resume command (when available), delete and batch cleanup |
46
- | Utilities | Compression/extraction requires extra tools | 7-Zip preferred, JS fallback |
47
-
48
- ## Why Codex Mate
49
-
50
- - Focused on three jobs: Codex provider/model switching + Claude Code config apply + OpenClaw config apply
51
- - Local-first: configs and API keys are written to local files, not the cloud
52
- - Lightweight: CLI + Web, no desktop app required
53
- - Reversible: auto-backup before first takeover
54
-
55
- ## Use Cases
56
-
57
- - Frequent provider/model switching, want a one-command flow
58
- - Use both Codex and Claude Code, want a single entry point
59
- - Need to browse/export local Codex + Claude Code sessions and copy resume commands when available
60
- - Use OpenClaw with multiple profiles, want quick switching
61
- - Multi-project or multi-environment setups that need quick config changes
62
- - Want a visual UI without a heavy client
63
-
64
- ## Scope and Boundaries
33
+ ```bash
34
+ git clone https://github.com/ymkiux/codexmate.git && cd codexmate && npm install && npm link && codexmate run
35
+ ```
65
36
 
66
- - Only configuration management for Codex, Claude Code, and OpenClaw, not a full all-in-one tool suite
67
- - No built-in proxy/relay/billing dashboard/cloud sync (kept lightweight)
68
- - Web UI runs only when you start it (`codexmate run`)
37
+ 浏览器打开 `http://localhost:3737`。
69
38
 
70
- ## 30-Second Start (No Install)
39
+ 首次使用建议再执行：
71
40
 
72
41
  ```bash
73
- npx codexmate@latest status
42
+ codexmate setup
43
+ codexmate status
74
44
  ```
75
45
 
46
+ 如果你只想临时试用，可直接用：
47
+
76
48
  ```bash
77
49
  npx codexmate@latest run
78
50
  ```
79
51
 
80
- Then open `http://localhost:3737` in your browser.
52
+ ## 三条高频路径
81
53
 
82
- ## Quick Start
54
+ 1. 快速切换 Codex 提供商与模型
83
55
 
84
- 1. Install (global):
85
56
  ```bash
86
- npm install -g codexmate
57
+ codexmate switch <提供商>
58
+ codexmate use <模型>
87
59
  ```
88
60
 
89
- Or run once without install:
90
- ```bash
91
- npx codexmate@latest status
92
- ```
61
+ 2. 一行写入 Claude Code 配置
93
62
 
94
- 2. Run the interactive setup:
95
63
  ```bash
96
- codexmate setup
64
+ codexmate claude <BaseURL> <API_KEY> <模型>
97
65
  ```
98
66
 
99
- 3. Check status:
100
- ```bash
101
- codexmate status
102
- ```
67
+ 3. 导出本地会话到 Markdown
103
68
 
104
- 4. Start the Web UI:
105
69
  ```bash
106
- codexmate run
70
+ codexmate export-session --source codex --session-id <ID>
107
71
  ```
108
72
 
109
- Then open `http://localhost:3737` in your browser.
73
+ ## 核心命令（最常用）
74
+
75
+ | 目标 | 命令 |
76
+ | --- | --- |
77
+ | 查看当前状态 | `codexmate status` |
78
+ | 启动 Web UI | `codexmate run` |
79
+ | 交互式初始化 | `codexmate setup` |
80
+ | 查看提供商/模型 | `codexmate list` / `codexmate models` |
81
+ | 切换提供商/模型 | `codexmate switch <提供商>` / `codexmate use <模型>` |
82
+ | 写入 Claude 配置 | `codexmate claude <BaseURL> <API_KEY> [模型]` |
83
+ | 导出会话 | `codexmate export-session --source <codex|claude> ...` |
84
+
85
+ ## 你能获得什么
86
+
87
+ - 更快的模型/提供商切换
88
+ - 更可控的本地配置管理
89
+ - 可视化 Web 操作，降低命令行负担
90
+ - 配置变更可回溯、有备份
91
+ - Codex + Claude Code 统一会话浏览（查看/导出/可用时复制恢复命令）
92
+ - 0.0.10 新增：Claude 会话支持关键词搜索（含 `claude code` / `claude-code` / 数字关键词）
93
+ - 0.0.14 新增：Skills 管理弹窗加入统计概览、筛选区优化与更细滚动条
94
+
95
+ ## 功能总览
96
+
97
+ | 模块 | 解决的问题 | 关键能力 |
98
+ | --- | --- | --- |
99
+ | Codex 配置 | 多提供商/多模型切换麻烦 | 提供商/模型切换、模型管理、CLI + Web 双入口、模板确认写入 |
100
+ | Skills 管理 | 本地自定义 skills 分散且难排查 | Skills 弹窗统计概览、关键词/状态筛选、多选删除、跨应用扫描导入 |
101
+ | Claude Code 配置 | 多方案共存、写入路径不统一 | 多配置方案管理、默认写入 `~/.claude/settings.json` |
102
+ | OpenClaw 配置 | OpenClaw 配置分散 | JSON5 多配置管理、应用到 `~/.openclaw/openclaw.json`、Workspace 指令文件管理 |
103
+ | 会话浏览 | 本地会话难以追踪 | 会话列表/筛选、关键词搜索（支持 Codex/Claude）、Markdown 导出、可用时复制恢复命令、删除与批量清理 |
104
+ | 附属工具 | 压缩/解压需额外工具 | 优先 7-Zip，JS 库兜底 |
105
+
106
+ ## 为什么选 Codex Mate
107
+
108
+ - 聚焦三件事：Codex 切换 + Claude Code 配置 + OpenClaw 配置
109
+ - 本地优先：配置与密钥落地本机
110
+ - 轻量：CLI + Web，无需桌面客户端
111
+ - 安全感：首次接管前自动备份
110
112
 
111
- ## Alternatives
113
+ ## 范围与边界
114
+
115
+ - 只做 Codex、Claude Code 与 OpenClaw 的配置管理，不做全量多工具一体化
116
+ - 不内置代理/转发/费用面板/云同步（保持轻量）
117
+ - Web UI 仅在你启动时运行（`codexmate run`）
118
+
119
+ ## 竞品/替代
112
120
 
113
121
  - cc-switch: https://github.com/farion1231/cc-switch
114
122
 
115
- ## Install
123
+ ## 安装
116
124
 
117
- ### Global (Recommended)
125
+ ### 从源码安装（推荐，一行命令）
118
126
 
119
127
  ```bash
120
- npm install -g codexmate
128
+ git clone https://github.com/ymkiux/codexmate.git && cd codexmate && npm install && npm link
121
129
  ```
122
130
 
123
- Package name on npm: `codexmate`.
124
-
125
- Want to update to the latest effects features each time? Install from GitHub (re-run to update):
131
+ 安装完成后建议先验证：
126
132
 
127
133
  ```bash
128
- npm install -g ymkiux/codexmate
134
+ codexmate status
135
+ codexmate run
129
136
  ```
130
137
 
131
- ### Run with npx (No Install)
138
+ ### 使用 npx（免安装）
132
139
 
133
140
  ```bash
134
141
  npx codexmate@latest status
142
+ npx codexmate@latest run
135
143
  ```
136
144
 
145
+ ### 全局安装（npm）
146
+
137
147
  ```bash
138
- npx codexmate@latest run
148
+ npm install -g codexmate
139
149
  ```
140
150
 
141
- ### From Source
151
+ npm 包名：`codexmate`。若希望每次执行都更新到仓库最新版本，可使用：
142
152
 
143
153
  ```bash
144
- git clone https://github.com/ymkiux/codexmate.git
145
- cd codexmate
146
- npm install
147
- npm link
154
+ npm install -g ymkiux/codexmate
148
155
  ```
149
156
 
150
- ### Requirements
157
+ ### 环境要求
151
158
 
152
159
  - Node.js >= 14
153
- - Windows / macOS / Linux
160
+ - 支持 Windows / macOS / Linux
154
161
 
155
- ## CLI Cheat Sheet
162
+ ## 命令行速查
156
163
 
157
- | Command | Description |
164
+ | 命令 | 说明 |
158
165
  | --- | --- |
159
- | `codexmate` | Show help and available commands |
160
- | `codexmate setup` | Interactive configuration wizard |
161
- | `codexmate status` | Show current status |
162
- | `codexmate list` | List all providers |
163
- | `codexmate switch <provider>` | Switch provider |
164
- | `codexmate use <model>` | Switch model |
165
- | `codexmate add <name> <URL> [API key]` | Add a provider |
166
- | `codexmate delete <provider>` | Delete a provider |
167
- | `codexmate claude <BaseURL> <API key> [model]` | Write Claude Code config to `~/.claude/settings.json` |
168
- | `codexmate models` | List all models |
169
- | `codexmate add-model <model>` | Add a model |
170
- | `codexmate delete-model <model>` | Delete a model |
171
- | `codexmate run` | Start the Web UI |
172
- | `codexmate mcp [serve] [--transport stdio] [--allow-write\|--read-only]` | Start MCP server over stdio (default read-only) |
173
- | `codexmate export-session --source <codex|claude> (--session-id <ID>|--file <PATH>) [--output <PATH>] [--max-messages <N|all|Infinity>]` | Export a session to Markdown |
174
-
175
- ## MCP (stdio)
176
-
177
- - Transport: `stdio` only
178
- - Default mode: read-only tool set
179
- - Write tools: enable by `--allow-write` or `CODEXMATE_MCP_ALLOW_WRITE=1`
180
- - Sensitive fields in `codexmate.claude.settings.get` are returned as masked values
166
+ | `codexmate` | 查看帮助与可用命令 |
167
+ | `codexmate setup` | 交互式配置向导 |
168
+ | `codexmate status` | 查看当前状态 |
169
+ | `codexmate list` | 列出所有提供商 |
170
+ | `codexmate switch <提供商名称>` | 切换提供商 |
171
+ | `codexmate use <模型名称>` | 切换模型 |
172
+ | `codexmate add <名称> <URL> [API密钥]` | 添加新提供商 |
173
+ | `codexmate delete <提供商名称>` | 删除提供商 |
174
+ | `codexmate claude <BaseURL> <API密钥> [模型]` | 一键写入 Claude Code 配置到 `~/.claude/settings.json` |
175
+ | `codexmate models` | 列出所有模型 |
176
+ | `codexmate add-model <模型名称>` | 添加模型 |
177
+ | `codexmate delete-model <模型名称>` | 删除模型 |
178
+ | `codexmate run` | 启动 Web 界面 |
179
+ | `codexmate mcp [serve] [--transport stdio] [--allow-write\|--read-only]` | 启动 MCP stdio 服务（默认只读） |
180
+ | `codexmate export-session --source <codex|claude> (--session-id <ID>|--file <PATH>) [--output <PATH>] [--max-messages <N|all|Infinity>]` | 导出指定会话为 Markdown |
181
+
182
+ ## MCP（stdio）
183
+
184
+ - 传输方式：仅支持 `stdio`
185
+ - 默认模式：只读工具集
186
+ - 写入工具开启方式：`--allow-write` 或 `CODEXMATE_MCP_ALLOW_WRITE=1`
187
+ - `codexmate.claude.settings.get` 的敏感字段默认脱敏返回
181
188
 
182
189
  ```bash
183
- # Read-only (recommended for external agents)
190
+ # 只读（推荐给外部 Agent 接入）
184
191
  codexmate mcp serve --read-only
185
192
 
186
- # Enable write tools explicitly
193
+ # 显式开启写工具
187
194
  codexmate mcp serve --allow-write
188
195
  ```
189
196
 
190
- Provided MCP domains:
197
+ 当前提供的 MCP 能力：
191
198
 
192
- - `tools`: status/provider/model/session/auth/proxy and config operations
193
- - `resources`: status/providers/sessions snapshots
194
- - `prompts`: built-in diagnose/switch/export templates
199
+ - `tools`：状态/提供商/模型/会话/认证/代理/配置等操作
200
+ - `resources`：status/providers/sessions 快照资源
201
+ - `prompts`：诊断/安全切换/会话导出模板
195
202
 
196
- ## Web UI
203
+ ## Web 界面
197
204
 
198
- Start the Web UI (auto opens browser):
205
+ 启动 Web 界面（自动打开浏览器）：
199
206
 
200
207
  ```bash
201
208
  codexmate run
202
209
  ```
203
210
 
204
- ### Codex Config Mode
211
+ ### Codex 配置模式
212
+
213
+ - 查看当前提供商和模型状态
214
+ - 快速切换提供商与模型
215
+ - 管理可用模型列表
216
+ - 编辑 `~/.codex/AGENTS.md` 指令文件（与 `config.toml` 同级）
217
+ - 打开 `~/.codex/skills` 的 Skills 管理弹窗（统计概览、关键词/状态筛选、多选删除、跨应用扫描导入）
218
+ - 添加/删除自定义提供商
219
+ - 支持 Linux / Windows 环境下的 Codex 配置管理
205
220
 
206
- - View current provider and model status
207
- - Quickly switch provider and model
208
- - Manage available model list
209
- - Edit `~/.codex/AGENTS.md` instruction file (same level as `config.toml`)
210
- - Add/delete custom providers
211
- - Supports Codex config management on Linux/Windows
221
+ ### Skills 管理弹窗
212
222
 
213
- ### Claude Code Config Mode (Windows / macOS / Linux)
223
+ - 提供 `总数 / 含 SKILL.md / 缺少 SKILL.md / 可导入` 四项统计，便于快速盘点
224
+ - 支持按目录名、显示名、描述关键词检索，并支持 `SKILL.md` 状态筛选
225
+ - 支持本地 skills 多选后批量删除
226
+ - 支持扫描其他应用中未托管 skill，并勾选后批量导入
214
227
 
215
- - Manage multiple Claude Code profiles
216
- - Configure API key, Base URL, and model
217
- - Default write to `env` in `~/.claude/settings.json`: `env.ANTHROPIC_API_KEY` / `env.ANTHROPIC_BASE_URL` / `env.ANTHROPIC_MODEL`
218
- - One-liner apply via CLI:
228
+ ### Claude Code 配置模式（Windows / macOS / Linux）
229
+
230
+ - 管理多个 Claude Code 配置方案
231
+ - 配置 API Key、Base URL 和模型
232
+ - 默认写入 `~/.claude/settings.json` 的 `env` 字段：`env.ANTHROPIC_API_KEY` / `env.ANTHROPIC_BASE_URL` / `env.ANTHROPIC_MODEL`
233
+ - CLI 一行应用示例：
219
234
 
220
235
  ```bash
221
236
  codexmate claude https://api.example.com/v1 sk-ant-xxx claude-3-7-sonnet
222
237
  ```
223
238
 
224
- - In the Web UI, each Claude configuration card now has a "Share Import Command" button that copies a one-click import command (for example: `codexmate claude <BaseURL> <API Key> <Model>`).
239
+ - Web 界面中每个 Claude 配置卡片新增“分享导入命令”按钮，可复制一条 `codexmate claude <BaseURL> <API Key> <模型>` 命令便于分享。
225
240
 
226
- ### OpenClaw Config Mode
241
+ ### OpenClaw 配置模式
227
242
 
228
- - Manage multiple OpenClaw JSON5 profiles
229
- - Apply to `~/.openclaw/openclaw.json`
230
- - Manage `AGENTS.md` under the OpenClaw Workspace (default: `~/.openclaw/workspace/AGENTS.md`)
243
+ - 管理多个 OpenClaw JSON5 配置方案
244
+ - 应用到 `~/.openclaw/openclaw.json`
245
+ - 管理 OpenClaw Workspace 下的 `AGENTS.md`（默认 `~/.openclaw/workspace/AGENTS.md`）
231
246
 
232
- ### Session Browser
247
+ ### 会话浏览模式
233
248
 
234
- - View local Codex and Claude Code sessions in one page
235
- - Filter by source (Codex / Claude / All)
236
- - Filter by session path (cwd), auto refresh on selection
237
- - Export selected sessions to Markdown
238
- - Copy resume command when available
239
- - Delete single sessions (local jsonl records)
240
- - Batch delete multiple sessions with partial failure summary
241
- - Delete individual records or multi-select within session details (writes back to original jsonl)
249
+ - 在同一 Web 页面查看 Codex 与 Claude Code 的本地会话列表
250
+ - 支持按来源筛选（Codex / Claude / 全部）
251
+ - 支持按已有会话路径（cwd）筛选，选择后自动刷新
252
+ - 支持一键导出指定会话为 Markdown
253
+ - 支持在可用时复制恢复命令
254
+ - 支持删除指定会话（本地 jsonl 记录）
255
+ - 支持勾选多条会话并批量删除，部分失败会汇总提示
256
+ - 支持在会话详情内单条删除记录或多选批量删除记录（写回原始 jsonl）
242
257
 
243
- ### Codex Template Confirmation Mode
258
+ ### Codex 模板确认模式
244
259
 
245
- - Codex config changes in Web UI go to a `config.toml` template editor first
246
- - Only writes to `config.toml` after you click "Confirm Apply Template"
247
- - Prevents direct one-click overwrites from the UI
260
+ - Web 中的 Codex 配置改动默认进入 `config.toml` 模板编辑器
261
+ - 仅在用户点击“确认应用模板”后才写入 `config.toml`
262
+ - 不再通过前端一键操作直接改写 `config.toml`
248
263
 
249
- ## Configuration Files
264
+ ## 配置文件
250
265
 
251
- Config directory: `~/.codex/`
266
+ 配置文件位于 `~/.codex/` 目录：
252
267
 
253
- - `config.toml` - Codex main config
254
- - `auth.json` - API auth info
255
- - `models.json` - Available model list
256
- - `provider-current-models.json` - Per-provider current model config
257
- - `codexmate-init.json` - First-run marker
258
- - `config.toml.codexmate-backup-*.bak` - Backup created on first takeover
268
+ - `config.toml` - Codex 主配置文件
269
+ - `auth.json` - API 认证信息
270
+ - `models.json` - 可用模型列表
271
+ - `provider-current-models.json` - 提供商当前模型配置
272
+ - `codexmate-init.json` - 首次初始化标记（用于避免重复重置）
273
+ - `config.toml.codexmate-backup-*.bak` - 首次初始化时自动备份的旧配置（若存在）
259
274
 
260
- Claude Code config files:
275
+ Claude Code 配置应用涉及：
261
276
 
262
- - `~/.claude/settings.json` - Runtime config (default write target)
263
- - `~/.claude/settings.json.codexmate-backup-*.bak` - Backup before first overwrite
277
+ - `~/.claude/settings.json` - Claude Code 运行时配置（默认写入目标）
278
+ - `~/.claude/settings.json.codexmate-backup-*.bak` - 首次改写前自动备份（若存在旧文件）
264
279
 
265
- OpenClaw config files:
280
+ OpenClaw 配置涉及：
266
281
 
267
- - `~/.openclaw/openclaw.json` - OpenClaw config (JSON5)
268
- - `~/.openclaw/workspace/AGENTS.md` - OpenClaw workspace instructions
282
+ - `~/.openclaw/openclaw.json` - OpenClaw 配置（JSON5）
283
+ - `~/.openclaw/workspace/AGENTS.md` - OpenClaw Workspace 指令文件
269
284
 
270
- ## First Run Initialization
285
+ ## 首次运行初始化说明
271
286
 
272
- When you run `codexmate` for the first time and an existing `~/.codex/config.toml` is detected that is not managed by Codex Mate:
287
+ 首次运行 `codexmate` 且检测到已有 `~/.codex/config.toml` 且不是 Codex Mate 管理的配置时，会发生以下行为：
273
288
 
274
- - The original file is backed up as `config.toml.codexmate-backup-<timestamp>.bak`
275
- - The original `config.toml` is preserved, and a first-run marker is written
276
- - Only when `CODEXMATE_FORCE_RESET_EXISTING_CONFIG=1` is set will the default config be rebuilt
277
- - Subsequent runs will not repeat this process
289
+ - 会先自动备份原文件为 `config.toml.codexmate-backup-时间戳.bak`
290
+ - 默认保留原 `config.toml` 不覆盖，并写入初始化标记
291
+ - 仅在显式设置环境变量 `CODEXMATE_FORCE_RESET_EXISTING_CONFIG=1` 时，才会重建默认配置
292
+ - 后续运行不会重复处理，避免影响已稳定使用的用户配置
278
293
 
279
- ## Examples
294
+ ## 使用示例
280
295
 
281
- ### Add a Custom API Provider
296
+ ### 添加自定义 API 提供商
282
297
 
283
298
  ```bash
284
299
  codexmate add myapi https://api.example.com/v1 sk-your-api-key
285
300
  codexmate switch myapi
286
301
  ```
287
302
 
288
- ### Switch to a Different Model
303
+ ### 切换到不同的模型
289
304
 
290
305
  ```bash
291
306
  codexmate use gpt-4-turbo
292
307
  ```
293
308
 
294
- ### Export a Session (CLI)
309
+ ### 导出会话（CLI）
295
310
 
296
311
  ```bash
297
312
  codexmate export-session --source codex --session-id 123456
298
313
  codexmate export-session --source claude --file "~/.claude/projects/demo/session.jsonl" --max-messages=all
299
314
  ```
300
315
 
301
- By default, exports are capped at 1000 messages. Use `--max-messages=all` (or `Infinity`) to export everything.
316
+ 默认最多导出 1000 条消息；如需完整导出可用 `--max-messages=all`（或 `Infinity`）。
302
317
 
303
- ### Configure Claude Code (Cross-Platform)
318
+ ### 配置 Claude Code（跨平台）
304
319
 
305
- 1. Start the Web UI: `codexmate run`
306
- 2. Switch to "Claude Code Config" mode in the browser
307
- 3. Add a profile (example Zhipu GLM): Name=ZhipuGLM, API Key=your API key, Base URL=`https://open.bigmodel.cn/api/anthropic`, Model=`glm-4.7`
308
- 4. Click the card to apply, or use "Save & Apply to Claude Config" in the editor
309
- 5. Default write to `~/.claude/settings.json`
310
- 6. Restart Claude Code to apply
320
+ 1. 启动 Web 界面：`codexmate run`
321
+ 2. 在浏览器中切换到 "Claude Code 配置" 模式
322
+ 3. 添加配置方案（例如智谱 GLM）：配置名称=智谱GLM，API Key=你的 API Key，Base URL=`https://open.bigmodel.cn/api/anthropic`，模型=`glm-4.7`
323
+ 4. 点击配置卡片直接应用，或在编辑弹窗点击“保存并应用到 Claude 配置”
324
+ 5. 默认写入 `~/.claude/settings.json`
325
+ 6. 重启 Claude Code，新的配置即生效
311
326
 
312
- ### Start the Web UI
327
+ ### 启动 Web 界面
313
328
 
314
329
  ```bash
315
330
  codexmate run
316
331
  ```
317
332
 
318
- By default it binds to `127.0.0.1`. To expose on LAN, use `--host` or `CODEXMATE_HOST`:
333
+ 默认仅监听 `127.0.0.1`。如需局域网访问，可用 `--host` 或 `CODEXMATE_HOST`：
319
334
 
320
335
  ```bash
321
336
  codexmate run --host 0.0.0.0
322
337
  ```
323
338
 
324
- Then open `http://localhost:3737` (or your chosen host). Note: binding to `0.0.0.0` is unsafe on untrusted networks.
339
+ 然后在浏览器中打开 `http://localhost:3737`（或你指定的地址）。注意：监听 `0.0.0.0` 在不可信网络下不安全。
325
340
 
326
- ## FAQ
341
+ ## 常见问题
327
342
 
328
- ### Q: Which operating systems are supported?
343
+ ### Q: 支持哪些操作系统？
329
344
 
330
- A: Codex features support Windows and Linux (CLI and Web). Claude Code config applies to Windows / macOS / Linux (writes to `~/.claude/settings.json`).
345
+ A: Codex 功能支持 Windows 和 Linux（CLI 与 Web）。Claude Code 配置应用默认支持 Windows / macOS / Linux（写入 `~/.claude/settings.json`）。
331
346
 
332
- ### Q: Where are API keys stored?
347
+ ### Q: API key 存储在哪里？
333
348
 
334
- A: API keys are stored locally in `~/.codex/config.toml` and are not uploaded.
349
+ A: API key 存储在本地配置文件 `~/.codex/config.toml` 中，不会上传到任何服务器。
335
350
 
336
- ### Q: Is the Web UI safe?
351
+ ### Q: Web 界面安全吗？
337
352
 
338
- A: The Web UI runs locally; all operations happen on your machine. API keys are masked in the UI.
353
+ A: Web 界面运行在本地，所有操作都在本地完成。API key 在界面中仅显示脱敏版本。
339
354
 
340
- ### Q: How do Claude Code configs take effect?
355
+ ### Q: Claude Code 配置后如何生效？
341
356
 
342
- A: After clicking "Apply to Claude Config", it writes to `~/.claude/settings.json`. Restart Claude Code to apply.
357
+ A: 点击“应用到 Claude 配置”后会写入 `~/.claude/settings.json`，重启 Claude Code 即生效。
343
358
 
344
- ### Q: How to uninstall?
359
+ ### Q: 如何卸载？
345
360
 
346
- A: Run `npm uninstall -g codexmate`.
361
+ A: 运行 `npm uninstall -g codexmate`。
347
362
 
348
- ## Extras: Compression/Extraction
363
+ ## 附属功能：压缩/解压
349
364
 
350
- Prefer 7-Zip for multithreaded zip/unzip. Fallback to the built-in JS library when unavailable.
365
+ 优先使用 7-Zip 多线程压缩/解压。缺失时回退内置 JS 库。
351
366
 
352
367
  ```bash
353
- # Compress file or folder (default compression level 5)
354
- codexmate zip <path>
368
+ # 压缩文件或文件夹（默认压缩级别 5）
369
+ codexmate zip <文件或文件夹路径>
355
370
 
356
- # Set compression level (0-9, 0=store only, 9=max)
357
- codexmate zip <path> --max:9
371
+ # 指定压缩级别（0-9，0=仅存储，9=极限压缩）
372
+ codexmate zip <路径> --max:9
358
373
 
359
- # Unzip a zip file (default to same-level folder)
360
- codexmate unzip <zip path>
374
+ # 解压 zip 文件（默认解压到同级目录下同名文件夹）
375
+ codexmate unzip <zip文件路径>
361
376
 
362
- # Unzip to a specific output directory
363
- codexmate unzip <zip path> <output dir>
377
+ # 解压到指定目录
378
+ codexmate unzip <zip文件路径> <输出目录>
364
379
  ```
365
380
 
366
- Examples:
381
+ 使用示例：
367
382
 
368
383
  ```bash
369
- # Compress a project folder
384
+ # 压缩项目文件夹
370
385
  codexmate zip ./my-project
371
386
 
372
- # Max compression
387
+ # 极限压缩
373
388
  codexmate zip ./my-project --max:9
374
389
 
375
- # Store only (fast)
390
+ # 快速压缩（仅存储）
376
391
  codexmate zip ./large-folder --max:0
377
392
 
378
- # Unzip
393
+ # 解压文件
379
394
  codexmate unzip ./my-project.zip
380
395
 
381
- # Unzip to a target location
396
+ # 解压到指定位置
382
397
  codexmate unzip ./backup.zip D:/restored
383
398
  ```
384
399
 
385
- Note: 7-Zip is optional. If missing, the built-in JS library is used. `--max` only applies to 7-Zip.
400
+ 注意：7-Zip 非必需。未安装时使用内置 JS 库；`--max` 仅对 7-Zip 生效。
386
401
 
387
- ## Tech Stack
402
+ ## 技术栈
388
403
 
389
- - **Node.js** - Runtime
390
- - **@iarna/toml** - TOML parser
391
- - **Vue.js 3** - Web UI framework
392
- - **Native HTTP** - Built-in Web server
404
+ - **Node.js** - 运行环境
405
+ - **@iarna/toml** - TOML 配置文件解析
406
+ - **Vue.js 3** - Web 界面框架
407
+ - **原生 HTTP** - 内建 Web 服务器
393
408
 
394
- ## Release (GitHub Actions)
409
+ ## 发布（GitHub Actions）
395
410
 
396
- Create a tag that matches `package.json` (for example `v0.0.9`). Then run the `release` workflow in GitHub Actions and input that tag. It will create a GitHub Release and attach the `npm pack` `.tgz` artifact.
411
+ 创建与 `package.json` 版本一致的标签（例如 `v0.0.14`）。然后在 GitHub Actions 中手动运行 `release` 工作流并输入该标签，系统会创建 GitHub Release，并附带 `npm pack` 生成的 `.tgz` 产物。
397
412
 
398
- ## License
413
+ ## 许可证
399
414
 
400
415
  Apache-2.0 © [ymkiux](https://github.com/ymkiux)
401
416
 
402
- ## Contributing
417
+ ## 贡献
403
418
 
404
- Issues and pull requests are welcome.
419
+ 欢迎提交 Issue 和 Pull Request。
405
420
 
406
- ## Changelog
421
+ ## 更新日志
407
422
 
408
- See [doc/CHANGELOG.md](doc/CHANGELOG.md) for the English version.
409
- See [doc/CHANGELOG.zh-CN.md](doc/CHANGELOG.zh-CN.md) for the Chinese version.
423
+ 英文版见 [doc/CHANGELOG.md](doc/CHANGELOG.md)。
424
+ 中文版见 [doc/CHANGELOG.zh-CN.md](doc/CHANGELOG.zh-CN.md)。
410
425
 
411
426
  ---
412
427
 
413
428
  Made with [ymkiux](https://github.com/ymkiux)
429
+