codexmate 0.0.7 → 0.0.9

package/README.zh-CN.md

@@ -7,6 +7,8 @@
 
 [English](README.md) | 中文
 
+![Codex Mate Web UI](res/screenshot.png)
+
 ## 概览
 
 Codex Mate 让 Codex 与 Claude Code 的提供商/模型切换变成“一条命令或一次点击”，并在同一 Web 页面浏览、导出两者的本地会话记录。
@@ -19,6 +21,12 @@ Codex Mate 让 Codex 与 Claude Code 的提供商/模型切换变成“一条命
 - 配置变更可回溯、有备份
 - Codex + Claude Code 统一会话浏览（查看/导出/可用时复制恢复命令）
 
+## 概览
+
+一键切换 Codex/Claude Code 提供商与模型，并把本地会话统一管理/浏览/导出。
+
+- 会话管理：列表/筛选/导出/删除 Codex/Claude 本地会话；关键词搜索支持 Codex/Claude
+
 ## 功能总览
 
 | 模块 | 解决的问题 | 关键能力 |
@@ -26,30 +34,30 @@ Codex Mate 让 Codex 与 Claude Code 的提供商/模型切换变成“一条命
 | Codex 配置 | 多提供商/多模型切换麻烦 | 提供商/模型切换、模型管理、CLI + Web 双入口、模板确认写入 |
 | Claude Code 配置 | 多方案共存、写入路径不统一 | 多配置方案管理、默认写入 `~/.claude/settings.json` |
 | OpenClaw 配置 | OpenClaw 配置分散 | JSON5 多配置管理、应用到 `~/.openclaw/openclaw.json`、Workspace 指令文件管理 |
-| 会话浏览 | 本地会话难以追踪 | 会话列表/筛选、Markdown 导出、可用时复制恢复命令、删除与批量清理 |
+| 会话浏览 | 本地会话难以追踪 | 会话列表/筛选、关键词搜索（支持 Codex/Claude）、Markdown 导出、可用时复制恢复命令、删除与批量清理 |
 | 附属工具 | 压缩/解压需额外工具 | 优先 7-Zip，JS 库兜底 |
 
-## 为什么选择 Codex Mate
+## 为什么选 Codex Mate
 
-- 聚焦三件事：Codex 提供商/模型切换 + Claude Code 配置应用 + OpenClaw 配置应用
-- 本地优先：配置与 API Key 写入本地文件，不走云端
-- 轻量好用：CLI + Web 双入口，无需安装桌面端
-- 可回退：首次接管前自动备份旧配置
+- 聚焦三件事：Codex 切换 + Claude Code 配置 + OpenClaw 配置
+- 本地优先：配置与密钥落地本机
+- 轻量：CLI + Web，无需桌面客户端
+- 安全感：首次接管前自动备份
 
 ## 适用场景
 
-- 频繁切换提供商/模型，想要一条命令完成
+- 频繁切换提供商/模型，想一条命令搞定
 - 同时用 Codex 与 Claude Code，需要统一入口
-- 需要浏览/导出本地会话记录，并在可用时复制恢复命令
-- 使用 OpenClaw 多配置，希望快速切换
-- 多项目/多环境切换，希望快速改写配置
-- 想可视化改配置但又不想上大体量客户端
+- 浏览/导出本地会话记录，必要时复制恢复命令
+- OpenClaw 多配置快速切换
+- 多项目/多环境快速改写配置
+- 想用可视化界面但不装笨重客户端
 
 ## 范围与边界
 
 - 只做 Codex、Claude Code 与 OpenClaw 的配置管理，不做全量多工具一体化
 - 不内置代理/转发/费用面板/云同步（保持轻量）
-- Web UI 仅在你启动时运行（`codexmate start`）
+- Web UI 仅在你启动时运行（`codexmate run`）
 
 ## 30 秒上手（免安装）
 
@@ -58,7 +66,7 @@ npx codexmate@latest status
 ```
 
 ```bash
-npx codexmate@latest start
+npx codexmate@latest run
 ```
 
 然后在浏览器中打开 `http://localhost:3737`。
@@ -87,7 +95,7 @@ codexmate status
 
 4. 启动 Web 界面：
 ```bash
-codexmate start
+codexmate run
 ```
 
 然后在浏览器中打开 `http://localhost:3737`。
@@ -96,10 +104,6 @@ codexmate start
 
 - cc-switch: https://github.com/farion1231/cc-switch
 
-## 界面预览
-
-![Codex Mate Web UI](res/screenshot.png)
-
 ## 安装
 
 ### 全局安装（推荐）
@@ -123,7 +127,7 @@ npx codexmate@latest status
 ```
 
 ```bash
-npx codexmate@latest start
+npx codexmate@latest run
 ```
 
 ### 从源码安装
@@ -152,18 +156,19 @@ npm link
 | `codexmate use <模型名称>` | 切换模型 |
 | `codexmate add <名称> <URL> [API密钥]` | 添加新提供商 |
 | `codexmate delete <提供商名称>` | 删除提供商 |
+| `codexmate claude <BaseURL> <API密钥> [模型]` | 一键写入 Claude Code 配置到 `~/.claude/settings.json` |
 | `codexmate models` | 列出所有模型 |
-| `codexmate add-model <模型名称>` | 添加模型 |
-| `codexmate delete-model <模型名称>` | 删除模型 |
-| `codexmate start` | 启动 Web 界面 |
-| `codexmate export-session --source <codex|claude> (--session-id <ID>|--file <PATH>) [--output <PATH>] [--max-messages <N|all|Infinity>]` | 导出指定会话为 Markdown |
+| `codexmate add-model <模型名称>` | 添加模型 |
+| `codexmate delete-model <模型名称>` | 删除模型 |
+| `codexmate run` | 启动 Web 界面 |
+| `codexmate export-session --source <codex|claude> (--session-id <ID>|--file <PATH>) [--output <PATH>] [--max-messages <N|all|Infinity>]` | 导出指定会话为 Markdown |
 
 ## Web 界面
 
 启动 Web 界面（自动打开浏览器）：
 
 ```bash
-codexmate start
+codexmate run
 ```
 
 ### Codex 配置模式
@@ -180,6 +185,13 @@ codexmate start
 - 管理多个 Claude Code 配置方案
 - 配置 API Key、Base URL 和模型
 - 默认写入 `~/.claude/settings.json` 的 `env` 字段：`env.ANTHROPIC_API_KEY` / `env.ANTHROPIC_BASE_URL` / `env.ANTHROPIC_MODEL`
+- CLI 一行应用示例：
+
+```bash
+codexmate claude https://api.example.com/v1 sk-ant-xxx claude-3-7-sonnet
+```
+
+- Web 界面中每个 Claude 配置卡片新增“分享导入命令”按钮，可复制一条 `codexmate claude <BaseURL> <API Key> <模型>` 命令便于分享。
 
 ### OpenClaw 配置模式
 
@@ -243,43 +255,43 @@ codexmate add myapi https://api.example.com/v1 sk-your-api-key
 codexmate switch myapi
 ```
 
-### 切换到不同的模型
-
-```bash
-codexmate use gpt-4-turbo
-```
-
-### 导出会话（CLI）
-
-```bash
-codexmate export-session --source codex --session-id 123456
-codexmate export-session --source claude --file "~/.claude/projects/demo/session.jsonl" --max-messages=all
-```
-
-默认最多导出 1000 条消息；如需完整导出可用 `--max-messages=all`（或 `Infinity`）。
-
-### 配置 Claude Code（跨平台）
-
-1. 启动 Web 界面：`codexmate start`
+### 切换到不同的模型
+
+```bash
+codexmate use gpt-4-turbo
+```
+
+### 导出会话（CLI）
+
+```bash
+codexmate export-session --source codex --session-id 123456
+codexmate export-session --source claude --file "~/.claude/projects/demo/session.jsonl" --max-messages=all
+```
+
+默认最多导出 1000 条消息；如需完整导出可用 `--max-messages=all`（或 `Infinity`）。
+
+### 配置 Claude Code（跨平台）
+
+1. 启动 Web 界面：`codexmate run`
 2. 在浏览器中切换到 "Claude Code 配置" 模式
 3. 添加配置方案（例如智谱 GLM）：配置名称=智谱GLM，API Key=你的 API Key，Base URL=`https://open.bigmodel.cn/api/anthropic`，模型=`glm-4.7`
 4. 点击配置卡片直接应用，或在编辑弹窗点击“保存并应用到 Claude 配置”
 5. 默认写入 `~/.claude/settings.json`
 6. 重启 Claude Code，新的配置即生效
 
-### 启动 Web 界面
-
-```bash
-codexmate start
-```
-
-默认仅监听 `127.0.0.1`。如需局域网访问，可用 `--host` 或 `CODEXMATE_HOST`：
-
-```bash
-codexmate start --host 0.0.0.0
-```
-
-然后在浏览器中打开 `http://localhost:3737`（或你指定的地址）。注意：监听 `0.0.0.0` 在不可信网络下不安全。
+### 启动 Web 界面
+
+```bash
+codexmate run
+```
+
+默认仅监听 `127.0.0.1`。如需局域网访问，可用 `--host` 或 `CODEXMATE_HOST`：
+
+```bash
+codexmate run --host 0.0.0.0
+```
+
+然后在浏览器中打开 `http://localhost:3737`（或你指定的地址）。注意：监听 `0.0.0.0` 在不可信网络下不安全。
 
 ## 常见问题
 
@@ -351,7 +363,7 @@ codexmate unzip ./backup.zip D:/restored
 
 ## 发布（GitHub Actions）
 
-创建与 `package.json` 版本一致的标签（例如 `v0.0.1`）。然后在 GitHub Actions 中手动运行 `release` 工作流并输入该标签，系统会创建 GitHub Release，并附带 `npm pack` 生成的 `.tgz` 产物。
+创建与 `package.json` 版本一致的标签（例如 `v0.0.8`）。然后在 GitHub Actions 中手动运行 `release` 工作流并输入该标签，系统会创建 GitHub Release，并附带 `npm pack` 生成的 `.tgz` 产物。
 
 ## 许可证