codexmate 0.0.31 → 0.0.33
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.
- package/README.md +92 -308
- package/README.zh.md +94 -318
- package/cli/local-bridge.js +227 -0
- package/cli/update.js +162 -0
- package/cli.js +357 -112
- package/lib/cli-sessions.js +16 -6
- package/lib/win-tray.js +119 -0
- package/package.json +2 -2
- package/web-ui/app.js +4 -0
- package/web-ui/logic.sessions.mjs +17 -1
- package/web-ui/modules/app.computed.session.mjs +51 -315
- package/web-ui/modules/app.methods.agents.mjs +19 -0
- package/web-ui/modules/app.methods.claude-config.mjs +71 -2
- package/web-ui/modules/app.methods.codex-config.mjs +20 -0
- package/web-ui/modules/app.methods.providers.mjs +53 -7
- package/web-ui/modules/app.methods.session-actions.mjs +1 -1
- package/web-ui/modules/app.methods.session-browser.mjs +29 -1
- package/web-ui/modules/app.methods.startup-claude.mjs +4 -0
- package/web-ui/modules/i18n.dict.mjs +21 -3
- package/web-ui/partials/index/layout-header.html +1 -2
- package/web-ui/partials/index/modal-config-template-agents.html +12 -1
- package/web-ui/partials/index/modals-basic.html +14 -3
- package/web-ui/partials/index/panel-config-claude.html +57 -85
- package/web-ui/partials/index/panel-config-codex.html +60 -226
- package/web-ui/partials/index/panel-dashboard.html +0 -33
- package/web-ui/partials/index/panel-docs.html +21 -53
- package/web-ui/partials/index/panel-sessions.html +37 -20
- package/web-ui/partials/index/panel-trash.html +33 -38
- package/web-ui/partials/index/panel-usage.html +71 -304
- package/web-ui/styles/controls-forms.css +11 -0
- package/web-ui/styles/docs-panel.css +57 -83
- package/web-ui/styles/layout-shell.css +26 -24
- package/web-ui/styles/modals-core.css +33 -0
- package/web-ui/styles/responsive.css +5 -67
- package/web-ui/styles/sessions-list.css +274 -8
- package/web-ui/styles/sessions-toolbar-trash.css +185 -15
- package/web-ui/styles/sessions-usage.css +336 -788
package/README.zh.md
CHANGED
|
@@ -1,371 +1,147 @@
|
|
|
1
|
-
|
|
1
|
+
<div align="center">
|
|
2
2
|
|
|
3
|
-
<img src="site/.vitepress/public/images/logo.png" alt="Codex Mate logo" width="
|
|
3
|
+
<img src="site/.vitepress/public/images/logo.png" alt="Codex Mate logo" width="160" />
|
|
4
4
|
|
|
5
5
|
# Codex Mate
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
**一站式本地 AI 编程智能体管理面板。统一管理 Codex、Claude Code 与 OpenClaw,支持 Provider 切换、会话管理与任务编排。纯本地优先,你的智能体控制中心。**
|
|
8
8
|
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
[
|
|
12
|
-
[
|
|
13
|
-
|
|
14
|
-
[](https://nodejs.org/)
|
|
15
|
-
[](LICENSE)
|
|
16
|
-
[](https://github.com/SakuraByteCore/codexmate/stargazers)
|
|
17
|
-
[](https://github.com/SakuraByteCore/codexmate/issues)
|
|
9
|
+
<p>
|
|
10
|
+
<a href="https://sakurabytecore.github.io/codexmate/">[项目文档]</a>
|
|
11
|
+
<a href="#快速开始">[快速开始]</a>
|
|
12
|
+
<a href="README.md">[English]</a>
|
|
13
|
+
</p>
|
|
18
14
|
|
|
19
|
-
[
|
|
15
|
+
[](https://www.npmjs.com/package/codexmate)
|
|
16
|
+
[](https://github.com/SakuraByteCore/codexmate/actions/workflows/release.yml)
|
|
17
|
+
[](https://www.npmjs.com/package/codexmate)
|
|
18
|
+
[](#快速开始)
|
|
19
|
+
[](https://nodejs.org/)
|
|
20
|
+
[](LICENSE)
|
|
21
|
+
[](https://github.com/SakuraByteCore/codexmate/stargazers)
|
|
22
|
+
[](https://github.com/SakuraByteCore/codexmate/issues)
|
|
20
23
|
|
|
21
24
|
<br />
|
|
22
|
-
|
|
25
|
+
|
|
26
|
+
<img src="site/.vitepress/public/images/readme-hero.png" alt="Codex Mate 界面预览" width="100%" />
|
|
23
27
|
|
|
24
28
|
</div>
|
|
25
29
|
|
|
26
30
|
---
|
|
27
31
|
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
Codex Mate 提供一套本地优先的 CLI + Web UI,用于统一管理:
|
|
32
|
+
> [!TIP]
|
|
33
|
+
> **本地优先**:所有配置和会话均存储在您的主目录中。无需遥测,无需云端账户。
|
|
31
34
|
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
- Claude Code 配置方案(写入 `~/.claude/settings.json`)
|
|
35
|
-
- Claude Code `CLAUDE.md` 编辑(写入 `~/.claude/CLAUDE.md`)
|
|
36
|
-
- OpenClaw JSON5 配置与 Workspace `AGENTS.md`
|
|
37
|
-
- Codex / Claude Code Skills 市场(安装目标切换、本地 skills 管理、跨应用导入、ZIP 分发)
|
|
38
|
-
- Codex / Claude / Gemini CLI / CodeBuddy Code 本地会话浏览、筛选、导出、删除与 Usage 统计概览
|
|
39
|
-
- 插件(提示词模板):模板复用、变量填写、一键复制
|
|
40
|
-
- 任务编排:规划 / 排队 / 执行 / 回看
|
|
35
|
+
> [!IMPORTANT]
|
|
36
|
+
> 本项目目前处于早期开发阶段。我们正在寻找开发者共同构建本地智能体生态!
|
|
41
37
|
|
|
42
|
-
|
|
38
|
+
## 什么是 Codex Mate?
|
|
43
39
|
|
|
44
|
-
|
|
40
|
+
你是否曾因管理多个本地 AI 智能体而感到疲惫?每个工具都有自己的配置格式、会话存储和 Skills 目录。
|
|
45
41
|
|
|
46
|
-
|
|
47
|
-
| --- | --- | --- |
|
|
48
|
-
| 多工具管理 | Codex + Claude Code + OpenClaw 统一入口 | 多文件、多目录分散修改 |
|
|
49
|
-
| 使用方式 | CLI + 本地 Web UI | 纯手改 TOML / JSON / JSON5 |
|
|
50
|
-
| 会话处理 | 支持浏览、筛选、Usage 统计、导出、批量清理 | 需要手动定位和处理文件 |
|
|
51
|
-
| Skills 复用 | 本地 Skills 市场 + 跨应用导入 + ZIP 分发 | 目录手动复制,容易遗漏 |
|
|
52
|
-
| 使用可见性 | 统一查看配置、会话、Usage 与运行状态 | 依赖手工翻文件和零散命令 |
|
|
53
|
-
| 可回滚性 | 首次接管前自动备份 | 易误覆盖、回滚成本高 |
|
|
54
|
-
| 自动化接入 | 提供 MCP stdio(默认只读) | 需自行封装脚本 |
|
|
55
|
-
|
|
56
|
-
## 核心特性
|
|
57
|
-
|
|
58
|
-
**配置管理**
|
|
59
|
-
- provider / model 切换(`switch` / `use`)
|
|
60
|
-
- Codex `config.toml` 模板确认后写入
|
|
61
|
-
- OpenAI 桥接 provider:将 Codex 写到本地 `/bridge/openai/<provider>/v1`,并为 OpenAI 兼容上游归一化 Responses API 请求
|
|
62
|
-
- Claude Code 多配置方案管理与一键应用
|
|
63
|
-
- Claude Code `CLAUDE.md` 编辑(写入 `~/.claude/CLAUDE.md`)
|
|
64
|
-
- 分享命令前缀切换(`npm start` / `codexmate`),用于复制 provider / Claude 导入命令
|
|
65
|
-
- OpenClaw JSON5 配置方案管理
|
|
66
|
-
|
|
67
|
-
**会话管理**
|
|
68
|
-
- 同页查看 Codex、Claude、Gemini CLI 与 CodeBuddy Code 会话
|
|
69
|
-
- 会话来源与默认路径(本地优先,可通过环境变量覆盖):
|
|
70
|
-
- Codex:`~/.codex/sessions/*.jsonl`(或 `$CODEX_HOME/sessions`、`$XDG_CONFIG_HOME/codex/sessions`)
|
|
71
|
-
- Claude:`~/.claude/projects/**/**/*.jsonl`(或 `$CLAUDE_HOME/projects`、`$XDG_CONFIG_HOME/claude/projects`)
|
|
72
|
-
- Gemini:`~/.gemini/tmp/*/chats/*.json`(或 `$GEMINI_HOME/tmp`、`$XDG_CONFIG_HOME/gemini/tmp`)
|
|
73
|
-
- CodeBuddy:`~/.codebuddy/projects/**/**/*.jsonl`(或 `$CODEBUDDY_CODE_HOME_DIR/projects`)
|
|
74
|
-
- 支持本地会话置顶,置顶状态持久化保存并优先排序显示
|
|
75
|
-
- 关键词搜索、来源筛选、cwd/角色/时间筛选,并支持复制筛选链接
|
|
76
|
-
- 复制恢复命令(Codex/Gemini/CodeBuddy):`codex resume <sessionId>` / `gemini -r <sessionId>` / `codebuddy -r <sessionId>`
|
|
77
|
-
- 搜索体验优化:短周期结果缓存,避免输入时重复扫描
|
|
78
|
-
- Usage 子页:近 7 天 / 近 30 天会话趋势、消息趋势、来源占比、高频路径
|
|
79
|
-
- 会话导出 Markdown(Web UI + `codexmate export-session`,支持 `--session-id` 或 `--file`)
|
|
80
|
-
- 会话与消息级删除(支持批量),并提供本地回收站用于恢复/彻底删除
|
|
81
|
-
- 大会话预览优化(快速 tail 预览路径)
|
|
82
|
-
|
|
83
|
-
**Skills 市场**
|
|
84
|
-
- 在 Codex 与 Claude Code 之间切换 skills 安装目标
|
|
85
|
-
- 查看本地已安装 skills、根目录与状态
|
|
86
|
-
- 扫描 `Codex` / `Claude Code` / `Agents` 可导入来源
|
|
87
|
-
- 支持跨应用导入、ZIP 导入 / 导出、批量删除
|
|
88
|
-
|
|
89
|
-
**插件**
|
|
90
|
-
- 提示词模板:本地保存/编辑/复用(支持变量)
|
|
91
|
-
- 编写 → 填参 → 一键复制的工作流(模板数据保存在浏览器存储)
|
|
92
|
-
|
|
93
|
-
**任务编排**
|
|
94
|
-
- DAG 节点拆分与波次并发
|
|
95
|
-
- 支持计划预览、执行、队列与运行详情
|
|
96
|
-
|
|
97
|
-
**工程能力**
|
|
98
|
-
- MCP stdio 能力(tools/resources/prompts)
|
|
99
|
-
- 自动化钩子(`/hooks/*`)+ 外发 webhook 通知
|
|
100
|
-
- Codex `/v1/responses` 的 OpenAI 桥接转换:优先尝试上游 `/responses`,必要时回退 `/chat/completions`,并归一化 function tools
|
|
101
|
-
- Zip 压缩/解压(优先系统工具,失败回退 JS 库)
|
|
102
|
-
|
|
103
|
-
## 自动化(信号 → 行动)
|
|
104
|
-
|
|
105
|
-
运行 `codexmate run` 后,可接收外部 webhook 并转为任务队列:
|
|
106
|
-
|
|
107
|
-
- 入口:`POST /hooks/<source>`(当前支持 `github`、`gitlab`)
|
|
108
|
-
- 规则:`~/.codex/codexmate-automation.json`
|
|
109
|
-
- 动作:`task.queue.add`(可选 `startQueue: true`)
|
|
110
|
-
- 通知:`notifiers[]` 支持 `type: "webhook"`(适配 Slack/飞书等入站 webhook)
|
|
111
|
-
|
|
112
|
-
## 架构总览
|
|
42
|
+
**Codex Mate** 提供了一个统一的控制平面,让混乱重归有序。这是一个本地优先的 CLI + Web UI,旨在无缝管理 [Codex](https://github.com/openai/codex)、[Claude Code](https://github.com/anthropic-ai/claude-code) 和 [OpenClaw](https://github.com/moeru-ai/openclaw)。
|
|
113
43
|
|
|
114
|
-
###
|
|
44
|
+
### 有什么独特之处?
|
|
115
45
|
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
MCP["MCP 调用"]
|
|
122
|
-
end
|
|
123
|
-
|
|
124
|
-
subgraph Mate["Codex Mate(本地控制台)"]
|
|
125
|
-
API["本地 HTTP API"]
|
|
126
|
-
CFG["配置管理"]
|
|
127
|
-
SESS["会话/Usage 管理"]
|
|
128
|
-
SKL["Skills 管理"]
|
|
129
|
-
PLG["插件:提示词模板"]
|
|
130
|
-
end
|
|
46
|
+
不同于简单的封装,Codex Mate 充当了 **本地智能体桥接器**:
|
|
47
|
+
- **统一会话浏览器**:在一个地方搜索并导出所有工具的会话。
|
|
48
|
+
- **OpenAI 兼容桥接**:通过归一化 Responses API,让 Codex 能够与任何支持 OpenAI 格式的 UI 配合使用。
|
|
49
|
+
- **Skills 市场**:本地优先的市场,支持在不同的智能体应用之间共享和导入 Skills。
|
|
50
|
+
- **任务编排器**:支持带有依赖跟踪的复杂任务规划与执行。
|
|
131
51
|
|
|
132
|
-
|
|
133
|
-
CODEX["~/.codex/*"]
|
|
134
|
-
CLAUDE["~/.claude/settings.json + CLAUDE.md"]
|
|
135
|
-
OPENCLAW["~/.openclaw/*.json5 + ~/.openclaw/openclaw.json + workspace/AGENTS.md"]
|
|
136
|
-
SKILLS["~/.{codex,claude,agents}/skills"]
|
|
137
|
-
SESSFILES["sessions / usage / trash / runs"]
|
|
138
|
-
BROWSER["浏览器存储(模板)"]
|
|
139
|
-
end
|
|
140
|
-
|
|
141
|
-
CLI --> API
|
|
142
|
-
WEB --> API
|
|
143
|
-
MCP --> API
|
|
144
|
-
WEB --> PLG
|
|
145
|
-
|
|
146
|
-
API --> CFG
|
|
147
|
-
API --> SESS
|
|
148
|
-
API --> SKL
|
|
149
|
-
PLG --> BROWSER
|
|
150
|
-
|
|
151
|
-
CFG --> CODEX
|
|
152
|
-
CFG --> CLAUDE
|
|
153
|
-
CFG --> OPENCLAW
|
|
154
|
-
SKL --> SKILLS
|
|
155
|
-
SESS --> SESSFILES
|
|
156
|
-
```
|
|
52
|
+
---
|
|
157
53
|
|
|
158
|
-
|
|
54
|
+
## 当前进展
|
|
159
55
|
|
|
160
|
-
|
|
|
56
|
+
| 特性 | 状态 | 描述 |
|
|
161
57
|
| --- | --- | --- |
|
|
162
|
-
|
|
|
163
|
-
|
|
|
164
|
-
|
|
|
165
|
-
|
|
|
166
|
-
|
|
|
58
|
+
| **Provider 管理** | ✅ | 切换 Codex、Claude 和 OpenClaw 的 provider/model |
|
|
59
|
+
| **状态实时同步** | ✅ | 实时感知 Codex/Claude 的配置与运行状态变更 |
|
|
60
|
+
| **会话浏览器** | ✅ | 列表、筛选及导出会话 (Codex/Claude/Gemini) |
|
|
61
|
+
| **Usage 统计** | ✅ | 可视化消息趋势与热门项目统计 |
|
|
62
|
+
| **本地 Skills 市场** | ✅ | 跨应用的智能体 Skills 导入与导出 |
|
|
63
|
+
| **任务队列** | ✅ | 基于 DAG 的任务执行与日志查看 |
|
|
64
|
+
| **OpenAI 桥接** | ✅ | 将 Codex Responses API 转换为标准 OpenAI 格式 |
|
|
65
|
+
| **提示词模板** | ✅ | 支持变量的可复用提示词插件 |
|
|
66
|
+
| **MCP 集成** | ✅ | 通过 MCP stdio 暴露本地工具与资源 |
|
|
67
|
+
| **自动更新** | ✅ | 通过 `codexmate update` 快速更新 CLI |
|
|
68
|
+
|
|
69
|
+
---
|
|
167
70
|
|
|
168
71
|
## 快速开始
|
|
169
72
|
|
|
170
|
-
### npm
|
|
73
|
+
### 通过 npm 安装
|
|
171
74
|
|
|
172
75
|
```bash
|
|
173
76
|
npm install -g codexmate
|
|
174
77
|
codexmate setup
|
|
175
|
-
codexmate status
|
|
176
78
|
codexmate run
|
|
177
79
|
```
|
|
178
80
|
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
> 安全提示:默认监听会在当前局域网暴露未鉴权的管理界面。若包含 API Key、provider 配置或 skills 管理,请仅在可信网络中使用;如需仅本机访问,可设置 `CODEXMATE_HOST=127.0.0.1` 或启动时传入 `--host 127.0.0.1`。
|
|
182
|
-
|
|
183
|
-
### curl 一键安装(独立包,无需 npm)
|
|
184
|
-
|
|
185
|
-
下载包含 `node_modules` 的自包含安装包,不依赖 npm:
|
|
81
|
+
### 通过 curl 安装 (独立包)
|
|
186
82
|
|
|
187
83
|
```bash
|
|
188
84
|
curl -fsSL https://raw.githubusercontent.com/SakuraByteCore/codexmate/main/scripts/install.sh | bash
|
|
189
85
|
```
|
|
190
86
|
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
| 变量 | 默认值 | 说明 |
|
|
194
|
-
| --- | --- | --- |
|
|
195
|
-
| `CODEXMATE_INSTALL_DIR` | `~/.codexmate` | 安装目录 |
|
|
196
|
-
| `CODEXMATE_BIN_DIR` | `~/.local/bin` | 软链接目录 |
|
|
197
|
-
|
|
198
|
-
### 安装 Codex CLI / Claude Code / Gemini CLI / CodeBuddy Code(可选)
|
|
199
|
-
|
|
200
|
-
Codex Mate 支持透传调用官方 CLI(例如 `codexmate codex ...`),建议先安装:
|
|
201
|
-
|
|
202
|
-
```bash
|
|
203
|
-
# Codex CLI(默认)
|
|
204
|
-
npm install -g @openai/codex
|
|
205
|
-
|
|
206
|
-
# Termux(Android)上的 Codex CLI
|
|
207
|
-
npm install -g @mmmbuto/codex-cli-termux@latest
|
|
208
|
-
|
|
209
|
-
# Claude Code
|
|
210
|
-
npm install -g @anthropic-ai/claude-code
|
|
211
|
-
|
|
212
|
-
# Gemini CLI
|
|
213
|
-
npm install -g @google/gemini-cli
|
|
214
|
-
|
|
215
|
-
# CodeBuddy Code
|
|
216
|
-
npm install -g @tencent-ai/codebuddy-code
|
|
217
|
-
```
|
|
218
|
-
|
|
219
|
-
### 从源码运行
|
|
220
|
-
|
|
221
|
-
```bash
|
|
222
|
-
git clone https://github.com/SakuraByteCore/codexmate.git
|
|
223
|
-
cd codexmate
|
|
224
|
-
npm install
|
|
225
|
-
npm start run
|
|
226
|
-
```
|
|
87
|
+
### 支持的智能体
|
|
227
88
|
|
|
228
|
-
|
|
89
|
+
- **Codex**: `npm install -g @openai/codex`
|
|
90
|
+
- **Claude Code**: `npm install -g @anthropic-ai/claude-code`
|
|
91
|
+
- **Gemini CLI**: `npm install -g @google/gemini-cli`
|
|
92
|
+
- **CodeBuddy**: `npm install -g @tencent-ai/codebuddy-code`
|
|
229
93
|
|
|
230
|
-
|
|
231
|
-
npm start run --no-browser
|
|
232
|
-
```
|
|
233
|
-
|
|
234
|
-
> 约定:自动化测试仅验证服务与 API,不依赖打开页面。
|
|
235
|
-
|
|
236
|
-
### 开发辅助脚本
|
|
237
|
-
|
|
238
|
-
```bash
|
|
239
|
-
npm run reset
|
|
240
|
-
npm run reset 79
|
|
241
|
-
```
|
|
242
|
-
|
|
243
|
-
- `npm run reset`:直接重置到默认 `origin/main`
|
|
244
|
-
- `npm run reset 79`:直接同步到 PR `#79` 的最新 head 快照
|
|
245
|
-
- 脚本会自动完成本地分支切换、工作区清理、未跟踪文件清理与最终状态校验
|
|
246
|
-
|
|
247
|
-
## 命令速查
|
|
248
|
-
|
|
249
|
-
| 命令 | 说明 |
|
|
250
|
-
| --- | --- |
|
|
251
|
-
| `codexmate status` | 查看当前配置状态 |
|
|
252
|
-
| `codexmate setup` | 交互式初始化 |
|
|
253
|
-
| `codexmate list` / `codexmate models` | 查看提供商 / 模型 |
|
|
254
|
-
| `codexmate switch <provider>` / `codexmate use <model>` | 切换 provider / model |
|
|
255
|
-
| `codexmate add <name> <URL> [API_KEY] [--bridge openai]` | 添加提供商;`--bridge openai` 会为 OpenAI 风格上游创建本地 Codex Responses 兼容桥接 |
|
|
256
|
-
| `codexmate delete <name>` | 删除提供商 |
|
|
257
|
-
| `codexmate claude <BaseURL> <API_KEY> [model]` | 写入 Claude Code 配置 |
|
|
258
|
-
| `codexmate workflow <list\|get\|validate\|run\|runs>` | MCP 工作流管理 |
|
|
259
|
-
| `codexmate codex [args...] [--follow-up <文本> 可重复]` | Codex CLI 透传入口(默认补 `--yolo`,可追加 queued follow-up) |
|
|
260
|
-
| `codexmate qwen [args...]` | Qwen CLI 透传入口 |
|
|
261
|
-
| `codexmate run [--host <HOST>] [--no-browser]` | 启动 Web UI |
|
|
262
|
-
| `codexmate mcp serve [--read-only\|--allow-write]` | 启动 MCP stdio 服务 |
|
|
263
|
-
| `codexmate export-session --source <codex\|claude\|gemini\|codebuddy> ...` | 导出会话为 Markdown |
|
|
264
|
-
| `codexmate zip <path> [--max:0-9]` / `codexmate unzip <zip> [out]` | 压缩 / 解压 |
|
|
265
|
-
| `codexmate unzip-ext <zip-dir> [out] [--ext:suffix[,suffix...]] [--no-recursive]` | 批量提取目录下 ZIP 内指定后缀文件(默认 `.json`,默认递归) |
|
|
266
|
-
|
|
267
|
-
### Codex follow-up 追加(可选)
|
|
268
|
-
|
|
269
|
-
```bash
|
|
270
|
-
codexmate codex --follow-up "先扫描项目" --follow-up "再修复失败测试"
|
|
271
|
-
codexmate codex --model gpt-5.3-codex --follow-up "步骤1" --follow-up "步骤2"
|
|
272
|
-
```
|
|
273
|
-
|
|
274
|
-
> 说明:`--follow-up` / `--queued-follow-up` 都可用,支持重复。
|
|
275
|
-
|
|
276
|
-
## Web 界面
|
|
277
|
-
|
|
278
|
-
### Codex 配置模式
|
|
279
|
-
- provider / model 切换
|
|
280
|
-
- 模型管理
|
|
281
|
-
- OpenAI 桥接 provider:将 Codex Responses API 转换给 OpenAI 兼容上游
|
|
282
|
-
- `~/.codex/AGENTS.md` 编辑
|
|
283
|
-
|
|
284
|
-
### Claude Code 配置模式
|
|
285
|
-
- 多配置方案管理
|
|
286
|
-
- 默认写入 `~/.claude/settings.json`
|
|
287
|
-
- `~/.claude/CLAUDE.md` 编辑
|
|
288
|
-
- 支持复制分享导入命令
|
|
289
|
-
|
|
290
|
-
### OpenClaw 配置模式
|
|
291
|
-
- JSON5 多方案管理
|
|
292
|
-
- 应用到 `~/.openclaw/openclaw.json`
|
|
293
|
-
- 管理 `~/.openclaw/workspace/AGENTS.md`
|
|
294
|
-
|
|
295
|
-
### Plugins 模式(提示词模板)
|
|
296
|
-
- 入口:顶部切到 **Plugins** → **提示词模板**
|
|
297
|
-
- 支持管理自定义模板(导入/导出 JSON)
|
|
298
|
-
- 变量管理:在 **管理** 中可“新增变量”(插入 `{{var}}`),并在 Variables 区填写变量值
|
|
299
|
-
- 生成与复制:变量填写后可在 **Preview** 里一键复制最终提示词
|
|
300
|
-
- 内置模板:仅提供一个“代码注释润色”,只读不可编辑
|
|
301
|
-
|
|
302
|
-
### 会话模式
|
|
303
|
-
- Codex + Claude 会话统一列表
|
|
304
|
-
- Browser / Usage 双子视图切换
|
|
305
|
-
- 支持本地会话置顶、持久化保存与置顶优先排序
|
|
306
|
-
- 搜索、筛选、导出、删除、批量清理
|
|
307
|
-
- Usage 视图提供近 7 天 / 近 30 天会话趋势、消息趋势、来源占比与高频路径统计
|
|
308
|
-
- 费用估算当前只统计可识别模型单价的非 Claude 会话
|
|
309
|
-
|
|
310
|
-
### Skills 市场标签页
|
|
311
|
-
- 在 `Codex` 与 `Claude Code` 之间切换 skills 安装目标
|
|
312
|
-
- 展示当前目标的本地 skills 根目录、已安装项和可导入项
|
|
313
|
-
- 扫描 `Codex` / `Claude Code` / `Agents` 目录中的可导入来源
|
|
314
|
-
- 支持跨应用导入、ZIP 导入 / 导出、批量删除
|
|
315
|
-
|
|
316
|
-
### 设置标签页
|
|
317
|
-
- 支持切换分享命令前缀:`npm start` / `codexmate`
|
|
318
|
-
- 影响 Web UI 中复制出来的 provider 分享命令与 Claude 导入命令
|
|
319
|
-
|
|
320
|
-
## MCP
|
|
321
|
-
|
|
322
|
-
> 传输:`stdio`
|
|
94
|
+
---
|
|
323
95
|
|
|
324
|
-
|
|
325
|
-
- 默认:只读工具集
|
|
326
|
-
- 写入开启:`--allow-write` 或 `CODEXMATE_MCP_ALLOW_WRITE=1`
|
|
327
|
-
- 包含域:`tools`、`resources`、`prompts`
|
|
96
|
+
## 架构总览
|
|
328
97
|
|
|
329
|
-
|
|
98
|
+
```mermaid
|
|
99
|
+
%%{ init: { 'flowchart': { 'curve': 'catmullRom' } } }%%
|
|
100
|
+
flowchart TD
|
|
101
|
+
User([用户])
|
|
102
|
+
CLI[CLI 命令]
|
|
103
|
+
WebUI[Web 界面]
|
|
104
|
+
MCP[MCP 服务]
|
|
105
|
+
|
|
106
|
+
subgraph Mate [Codex Mate 核心]
|
|
107
|
+
API[HTTP API]
|
|
108
|
+
Config[配置引擎]
|
|
109
|
+
Session[会话管理器]
|
|
110
|
+
Skills[Skills 市场]
|
|
111
|
+
Tasks[任务运行器]
|
|
112
|
+
end
|
|
113
|
+
|
|
114
|
+
subgraph Local [本地文件系统]
|
|
115
|
+
CodexDir[~/.codex]
|
|
116
|
+
ClaudeDir[~/.claude]
|
|
117
|
+
ClawDir[~/.openclaw]
|
|
118
|
+
State[会话/Usage/回收站]
|
|
119
|
+
end
|
|
330
120
|
|
|
331
|
-
|
|
332
|
-
|
|
333
|
-
|
|
121
|
+
User --> CLI & WebUI & MCP
|
|
122
|
+
CLI & WebUI & MCP --> API
|
|
123
|
+
|
|
124
|
+
API --> Config & Session & Skills & Tasks
|
|
125
|
+
|
|
126
|
+
Config --> CodexDir & ClaudeDir & ClawDir
|
|
127
|
+
Session --> State
|
|
128
|
+
Skills --> Local
|
|
334
129
|
```
|
|
335
130
|
|
|
336
|
-
|
|
337
|
-
|
|
338
|
-
- `~/.codex/config.toml`
|
|
339
|
-
- `~/.codex/auth.json`
|
|
340
|
-
- `~/.codex/models.json`
|
|
341
|
-
- `~/.codex/provider-current-models.json`
|
|
342
|
-
- `~/.codex/codexmate-openai-bridge.json`
|
|
343
|
-
- `~/.claude/settings.json`
|
|
344
|
-
- `~/.claude/CLAUDE.md`
|
|
345
|
-
- `~/.openclaw/openclaw.json`
|
|
346
|
-
- `~/.openclaw/workspace/AGENTS.md`
|
|
347
|
-
|
|
348
|
-
## 环境变量
|
|
131
|
+
---
|
|
349
132
|
|
|
350
|
-
|
|
351
|
-
| --- | --- | --- |
|
|
352
|
-
| `CODEXMATE_PORT` | `3737` | Web 服务端口 |
|
|
353
|
-
| `CODEXMATE_HOST` | `0.0.0.0` | Web 服务监听地址(如需仅本机访问,显式设为 `127.0.0.1`) |
|
|
354
|
-
| `CODEXMATE_NO_BROWSER` | 未设置 | 设为 `1` 后不自动打开浏览器 |
|
|
355
|
-
| `CODEXMATE_MCP_ALLOW_WRITE` | 未设置 | 设为 `1` 后默认允许 MCP 写工具 |
|
|
356
|
-
| `CODEXMATE_FORCE_RESET_EXISTING_CONFIG` | `0` | 设为 `1` 时首次可强制重建托管配置 |
|
|
133
|
+
## 特别鸣谢
|
|
357
134
|
|
|
358
|
-
|
|
135
|
+
感谢所有贡献者对 Codex Mate 的辛勤付出 ❤️
|
|
359
136
|
|
|
360
|
-
|
|
361
|
-
|
|
362
|
-
|
|
363
|
-
- `@iarna/toml`、`json5`
|
|
137
|
+
<a href="https://github.com/SakuraByteCore/codexmate/graphs/contributors">
|
|
138
|
+
<img src="https://contrib.rocks/image?repo=SakuraByteCore/codexmate" />
|
|
139
|
+
</a>
|
|
364
140
|
|
|
365
|
-
##
|
|
141
|
+
## Star 历史
|
|
366
142
|
|
|
367
|
-
|
|
143
|
+
[](https://star-history.com/#SakuraByteCore/codexmate&Date)
|
|
368
144
|
|
|
369
|
-
##
|
|
145
|
+
## 开源协议
|
|
370
146
|
|
|
371
147
|
Apache-2.0
|