# codex-manager

**Repository Path**: swimly/codex-manager

## Basic Information

- **Project Name**: codex-manager
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-24
- **Last Updated**: 2026-07-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Codex Manager

<p align="center">
  <strong>Codex CLI、Trae、Relay 代理站以及 AI 聊天会话的统一管理系统</strong>
</p>

---

## 核心功能

### 智能配置管理
- 自动检测 Codex CLI / Trae 安装环境
- 可视化编辑 `config.toml`，实时预览配置效果
- 支持模型切换，快速对比不同配置
- 配置版本历史管理，支持差异对比和回滚

### Relay 代理站管理
- 多 Relay 代理站配置与监控
- 应用绑定与智能切换
- 分组/模型性能测试工具
- 支持图片对话和 API 代理

### 会话数据管理
- 统一浏览来自 Codex、Trae、ChatGPT 的所有会话
- 智能搜索，快速定位历史对话
- 线程详情查看，支持工作区和消息记录
- 数据导出与迁移

### 备份与恢复
- 一键导出 Codex/Trae 全量数据
- 完整清单文件，记录所有文件元数据
- 安全恢复，支持选择性导入

### 账号与授权
- 多官方账号统一管理
- 一键切换账号认证
- 用量统计与使用分析
- Qclaw 微信账号集成

---

## 系统架构

```
codex-manager/
├── client/                 # Vue 3 前端应用
│   ├── src/
│   │   ├── views/          # 页面组件
│   │   ├── router/         # 路由配置
│   │   ├── services/       # API 服务层
│   │   └── stores/         # Pinia 状态管理
│   └── package.json
├── server/                 # NestJS 后端服务
│   ├── src/
│   │   ├── codex/          # Codex 配置管理
│   │   ├── relay/          # Relay 代理站
│   │   ├── session/        # 会话数据
│   │   ├── backup/         # 备份恢复
│   │   ├── account/        # 账号管理
│   │   └── qclaw/          # Qclaw 集成
│   └── package.json
└── package.json            # 根配置
```

---

## 快速开始

### 环境要求

- **Node.js** >= 18
- **pnpm** (推荐) 或 npm

### 安装

```bash
# 克隆项目
git clone <your-repo-url>
cd codex-manager

# 安装依赖
pnpm install
```

### 开发模式

```bash
# 启动完整开发环境（自动启动前后端）
pnpm run dev

# 或分别启动
pnpm run dev:server   # 启动后端 API (端口 40171)
pnpm run dev:client   # 启动前端开发服务器 (端口 40172)
```

访问 `http://localhost:40172` 进入管理界面。

### 构建与生产部署

```bash
# 构建前端和后端
pnpm run build

# 启动生产服务器（自动服务静态文件）
pnpm run start
```

生产环境默认端口：`40171`

### 运行测试

```bash
cd server
pnpm run test:session
```

---

## 前端功能页面

| 路由 | 功能 |
|---|---|
| `/` | 仪表盘 - 系统概览 |
| `/apps` | 应用管理 - Codex CLI 和 Trae 配置 |
| `/relays` | 中转站 - Relay 代理站管理 |
| `/accounts` | 官方账号 - 多账号管理 |
| `/qclaw` | QClaw - 微信账号集成 |
| `/chat` | 聊天工作区 - AI 对话 |
| `/sessions` | 会话中心 - 历史会话浏览 |
| `/usage` | 用量统计 - 使用分析 |
| `/backups` | 备份恢复 - 数据管理 |

---

## 环境变量配置

| 变量 | 默认值 | 说明 |
|---|---|---|
| `PORT` | `40171` | 后端服务端口 |
| `HOST` | `127.0.0.1` | 后端监听地址 |
| `CODEX_MANAGER_FRONTEND_PORT` | `40172` | 前端端口（用于 CORS 配置） |

---

## API 接口

所有 API 路由以 `/api` 为前缀，返回 JSON 格式数据。

### 认证与授权
- `GET /api/health` - 健康检查

### 配置管理
- `GET /api/codex/*` - Codex CLI 和配置管理
- `PUT /api/codex/config` - 更新配置
- `GET /api/codex/config/history` - 配置历史

### Relay 代理站
- `GET /api/relay/*` - Relay 站点管理
- `POST /api/relay/test` - 测试 Relay 连接

### 会话数据
- `GET /api/session/*` - 会话浏览和搜索
- `GET /api/session/:source/:id` - 会话详情

### 备份恢复
- `POST /api/backup/export` - 导出数据
- `POST /api/backup/import` - 导入数据

### 账号管理
- `GET /api/account/*` - 账号管理
- `POST /api/account/login` - 账号登录

### Qclaw 集成
- `GET /api/qclaw/*` - Qclaw 配置管理

---

## 数据存储

用户数据存储在 `~/.codex-manager/` 目录：

```
.codex-manager/
├── relay-stations.json     # Relay 代理站配置
├── backups/               # 备份文件目录
│   ├── manifest.json      # 备份清单
│   └── archives/          # 备份归档
└── accounts/              # 账号凭证
    └── credentials.enc    # 加密的账号信息
```

---

## 技术栈

### 前端
- **框架**: Vue 3.5 + Composition API
- **构建**: Vite 5
- **状态管理**: Pinia
- **路由**: Vue Router 4
- **UI 组件**: Lucide 图标
- **样式**: CSS + PostCSS + Autoprefixer
- **类型**: TypeScript 5

### 后端
- **框架**: NestJS 11
- **运行时**: Node.js 18+
- **HTTP**: Express
- **类型**: TypeScript

### 开发工具
- **包管理**: pnpm workspaces
- **并发**: concurrently
- **代码检查**: ESLint

---

## 开发指南

### 添加新页面

1. 在 `client/src/views/` 创建 Vue 组件
2. 在 `client/src/router/index.ts` 注册路由
3. 配置 `meta` 信息（标题、图标、导航组）

### 添加新 API

1. 在 `server/src/` 创建 NestJS Module/Controller/Service
2. 在 `app.module.ts` 注册新模块
3. 实现 RESTful API 端点

### 数据源扩展

会话模块支持多种数据源（`session/sources/`）：
- `codex-session.source.ts` - Codex CLI 会话
- `trae-session.source.ts` - Trae 会话
- `chatgpt-export.source.ts` - ChatGPT 导出

---

## 常见问题

### 启动失败？

```bash
# 清理端口占用
pnpm run dev:clean

# 重新安装依赖
rm -rf node_modules server/node_modules client/node_modules
pnpm install
```

### 配置不生效？

检查 `~/.codex-manager/` 目录权限，确保程序有读写权限。

### 数据丢失？

所有数据保存在用户目录下，程序更新不会丢失数据。建议定期使用备份功能。

---

## 更新日志

- v1.0.0 - 初始版本
  - Codex CLI 配置管理
  - Relay 代理站管理
  - 会话数据浏览
  - 备份恢复功能

---

## 贡献指南

欢迎提交 Issue 和 Pull Request！

1. Fork 项目
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启 Pull Request

---

## 许可证

本项目采用 MIT 许可证。详见 LICENSE 文件。