Compare commits

..
3 Commits
Author SHA1 Message Date
yyyyyynnn 7cd783b786 Improve README and release bundles 2026-07-04 12:09:50 +08:00
yyyyyynnn ebf9581535 Add Codex-X app icon and bump release 2026-07-04 11:54:39 +08:00
yyyyyynnn 23c569f09b Fix Codex-X copyright author 2026-07-04 11:45:14 +08:00
26 changed files with 137 additions and 71 deletions
+10 -3
View File
@@ -16,7 +16,13 @@ jobs:
strategy:
fail-fast: false
matrix:
platform: [macos-latest, ubuntu-22.04, windows-latest]
include:
- platform: macos-latest
args: --bundles dmg
- platform: ubuntu-22.04
args: --bundles deb,rpm
- platform: windows-latest
args: --bundles msi
steps:
- name: Checkout
@@ -62,9 +68,10 @@ jobs:
Codex-X desktop release.
- macOS: `.dmg`
- Windows: `.msi` / `.exe`
- Linux: `.AppImage` / `.deb` / `.rpm`
- Windows: `.msi`
- Linux: `.deb` / `.rpm`
GitHub 会自动附带 Source code (zip/tar.gz)。
releaseDraft: false
prerelease: false
args: ${{ matrix.args }}
-1
View File
@@ -1,6 +1,5 @@
MIT License
Copyright (c) 2026 li lingbo
Copyright (c) 2026 yynxxxxx
Permission is hereby granted, free of charge, to any person obtaining a copy
+117 -59
View File
@@ -1,22 +1,120 @@
# Codex-X
<div align="center">
<img src="apps/desktop/src-tauri/icons/icon.png" alt="Codex-X Logo" width="160" />
Codex-X 是一个面向 OpenAI Codex / Codex CLI 的跨平台桌面配置管理器,用来可视化管理 Codex 的供应商、`config.toml`、`auth.json` 和指令提示词。
# Codex-X
> 当前桌面端基于 **Tauri 2 + React + TypeScript + Rust + SQLite**。
**Codex 提示词注入与配置切换管理器**
## 功能
一款面向 **OpenAI Codex / Codex CLI** 的跨平台桌面工具,重点提供 `gpt5.5-unrestricted.md` 指令提示词注入、Provider 切换、官方 Auth 管理与 TOML 可视化编辑。
- **供应商管理**:添加、编辑、切换 Codex 第三方 API Provider。
- **官方配置**:查看/编辑 OpenAI Official 的 `auth.json` 与官方模型配置。
- **TOML 编辑**:在供应商编辑页直接编辑并保存完整 `config.toml`。
- **指令提示词管理**:管理多个 `model_instructions_file` 模板,支持自定义提示词、启用、禁用。
- **cc-switch 导入**:从本机 cc-switch SQLite 数据库导入 Codex Provider。
- **跨平台路径**:默认读取 `CODEX_HOME`,否则使用用户目录下的 `.codex`。
- **更新检查**:通过 GitHub Releases 检测最新版本。
<p>
<img src="https://img.shields.io/github/v/release/yynxxxxx/Codex-X?label=version&color=blue" alt="version" />
<img src="https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-555" alt="platform" />
<img src="https://img.shields.io/badge/built%20with-Tauri%202-24C8DB" alt="tauri" />
<img src="https://img.shields.io/badge/license-MIT-green" alt="license" />
</p>
## 配置文件位置
<p>
<img src="https://img.shields.io/badge/React-18-61DAFB?logo=react&logoColor=white" />
<img src="https://img.shields.io/badge/TypeScript-5-3178C6?logo=typescript&logoColor=white" />
<img src="https://img.shields.io/badge/Rust-stable-000000?logo=rust&logoColor=white" />
<img src="https://img.shields.io/badge/SQLite-Ready-003B57?logo=sqlite&logoColor=white" />
<img src="https://img.shields.io/badge/Vite-Ready-646CFF?logo=vite&logoColor=white" />
</p>
</div>
Codex-X 默认读写:
---
## Codex-X 是什么?
Codex-X 不是单纯的配置文件编辑器,而是一个更偏向「Codex 增强启动器」的桌面管理工具。
它可以把预设或自定义的 **指令提示词模板** 写入 Codex 配置,例如项目内置的:
```text
examples/gpt5.5-unrestricted.md
```
你可以在 UI 中直接启用、禁用、切换多个提示词模板,也可以同时管理不同第三方供应商 API 和官方 OpenAI Codex 登录配置。
## 核心亮点
### 1. 指令提示词注入
- 一键启用 `gpt5.5-unrestricted.md`
- 支持多个提示词模板并存
- 启用前自动记录状态,方便回退
- 支持禁用当前提示词,让 Codex 恢复普通配置
### 2. Provider 可视化切换
- 添加第三方 Codex API Provider
- 编辑 Base URL / API Key / Model / TOML 配置
- 当前 Provider 状态清晰可见
- 支持从 cc-switch 数据库导入 Codex Provider
### 3. 官方 Codex 配置管理
- 读取 Codex 官方 `auth.json`
- 支持官方 ChatGPT 登录态 Auth 查看与编辑
- 区分官方 Auth 与第三方 API Key,不混在一起
### 4. TOML 配置编辑
- 可视化查看当前 Codex `config.toml`
- 在 Provider 编辑页直接编辑完整 TOML
- 保存后立即同步到 Codex 配置目录
### 5. 跨平台桌面软件
- macOS `.dmg`
- Windows `.msi`
- Linux `.deb` / `.rpm`
- GitHub Releases 自动构建发布
## 软件预览
<details open>
<summary><b>主界面 / Provider / TOML / Auth 截图</b></summary>
> 这里可以放软件主界面、供应商切换页面、TOML 编辑页面、官方 Auth 页面截图。
<!-- 示例:
<p align="center">
<img src="docs/screenshots/overview.png" width="760" />
</p>
-->
</details>
<details>
<summary><b>提示词注入前后效果图</b></summary>
> 这里可以放启用 `gpt5.5-unrestricted.md` 前后的 Codex 效果对比图。
<!-- 示例:
<p align="center">
<img src="docs/screenshots/prompt-before.png" width="760" />
<img src="docs/screenshots/prompt-after.png" width="760" />
</p>
-->
</details>
## 技术栈
| 类型 | 技术 |
| --- | --- |
| 桌面框架 | Tauri 2 |
| 前端 | React 18 / TypeScript / Vite |
| 后端 | Rust |
| 本地数据 | SQLite / rusqlite |
| 配置编辑 | TOML / JSON |
| 发布 | GitHub Actions / GitHub Releases |
## 配置路径
Codex-X 默认读取 Codex 配置目录:
```text
~/.codex/config.toml
@@ -31,71 +129,31 @@ CODEXX_HOME=/path/to/codex-x-data
CC_SWITCH_HOME=/path/to/.cc-switch
```
Codex-X 自身数据默认存放在:
Codex-X 自身数据库默认位于:
```text
~/.codexx/codexx.db
```
## Windows 权限说明
## 下载
Windows 正常情况下 Codex 配置位于:
请前往 Releases 页面下载:
```text
%USERPROFILE%\.codex
```
https://github.com/yynxxxxx/Codex-X/releases
这是用户目录,不需要管理员权限。只有当你手动把 `CODEX_HOME` 指向 `C:\Program Files`、`C:\Windows`、系统盘根目录等受保护目录时,写入才可能因为权限不足失败。Codex-X 不会静默提权,会直接显示具体 IO 错误。
## 开发
## 开发运行
```bash
pnpm install
pnpm dev
```
类型检查:
```bash
pnpm typecheck
```
构建桌面端:
```bash
pnpm --dir apps/desktop tauri build
```
## Release
本仓库使用 GitHub Actions 在打 tag 时自动构建三平台安装包:
```bash
git tag v0.2.0
git push origin v0.2.0
```
Release 页面会包含:
- macOS `.dmg`
- Windows `.msi` / `.exe`
- Linux `.AppImage` / `.deb` / `.rpm`
- GitHub 自动生成的 Source code `.zip` / `.tar.gz`
## 技术栈
- Tauri 2
- React 18
- TypeScript
- Vite
- Rust
- SQLite / rusqlite
- toml_edit
## 项目地址
<https://github.com/yynxxxxx/Codex-X>
## License
MIT
MIT © yynxxxxx
+3 -2
View File
@@ -1,6 +1,6 @@
{
"name": "codex-x",
"version": "0.2.0",
"version": "0.2.2",
"private": true,
"description": "Codex Switch & Instruct desktop manager",
"type": "module",
@@ -25,5 +25,6 @@
"@vitejs/plugin-react": "^4.2.0",
"typescript": "^5.3.0",
"vite": "^7.3.0"
}
},
"author": "yynxxxxx"
}
+1 -1
View File
@@ -337,7 +337,7 @@ dependencies = [
[[package]]
name = "codex-x"
version = "0.2.0"
version = "0.2.2"
dependencies = [
"chrono",
"dirs 5.0.1",
+2 -2
View File
@@ -1,8 +1,8 @@
[package]
name = "codex-x"
version = "0.2.0"
version = "0.2.2"
description = "Codex Switch & Instruct desktop manager"
authors = ["Codex-X Contributors"]
authors = ["yynxxxxx"]
license = "MIT"
edition = "2021"
rust-version = "1.85.0"
Binary file not shown.

After

Width:  |  Height:  |  Size: 17 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 56 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.0 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 5.7 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 13 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 20 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 22 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 69 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.9 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 82 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 3.3 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 6.9 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 9.7 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 4.0 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.4 MiB

Binary file not shown.
Binary file not shown.

After

Width:  |  Height:  |  Size: 70 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 2.1 KiB

After

Width:  |  Height:  |  Size: 237 KiB

+1 -1
View File
@@ -1,7 +1,7 @@
{
"$schema": "https://schema.tauri.app/config/2",
"productName": "Codex-X",
"version": "0.2.0",
"version": "0.2.2",
"identifier": "com.yynxxxxx.codexx",
"build": {
"frontendDist": "../dist",
+3 -2
View File
@@ -1,12 +1,13 @@
{
"name": "codex-x-workspace",
"private": true,
"version": "0.2.0",
"version": "0.2.2",
"scripts": {
"dev": "pnpm --dir apps/desktop tauri dev",
"build": "pnpm --dir apps/desktop tauri build",
"desktop:dev": "pnpm --dir apps/desktop tauri dev",
"desktop:build": "pnpm --dir apps/desktop tauri build",
"typecheck": "pnpm --dir apps/desktop typecheck"
}
},
"author": "yynxxxxx"
}