AiMaMi

面向 OpenAI Codex 的原生桌面伴侣 —— 统一管理账号、路由、会话与本地配置。

English · 简体中文

概述

Codex 的账号、会话、MCP、Skills、智能路由与中转配置分散在 ~/.codex 下的多个文件里。多账号切换、额度耗尽、第三方模型接入与路由维护、会话清理和配置漂移，都会把日常操作变成手改 TOML / JSON / SQLite。

AiMaMi 基于 Tauri 2 + React + Rust，把这些高频操作 —— 含智能路由与中转管理 —— 收敛到一个桌面应用里，在本地安全读写 Codex 数据，减少手工改文件带来的风险。

核心能力

智能路由说明： 中转模型经 AiMaMi 本地代理转发，使用期间需保持 AiMaMi 运行。

平台支持

技术栈

Tauri 2 · React 18 · TypeScript · Vite 6 · Tailwind CSS · shadcn/ui · Rust

快速开始

环境要求： Node.js · pnpm · Rust · Tauri 系统依赖

git clone https://github.com/borawong/AiMaMi.git
cd AiMaMi
pnpm install
pnpm tauri dev

pnpm build                                      # 前端构建检查
cargo check --manifest-path src-tauri/Cargo.toml  # Rust 检查
pnpm tauri build                                # 生产构建

项目结构

src/           React 前端
src-tauri/     Tauri 壳与 Rust 后端
src/locales/   国际化（中 / 英）
scripts/       构建与发布脚本
assets/        品牌与文档素材

架构

React UI ── invoke() ──▶ Tauri commands ──▶ core/
                                              ├── ~/.codex          (Codex 原生)
                                              └── ~/.codex/codexmate/ (AiMaMi 数据)
                         platform/            macOS / Windows 差异实现

参与贡献

欢迎提交 Issue 与 Pull Request。请先阅读 CONTRIBUTING.md，了解开发环境、提交前检查以及本地 Codex 数据安全注意事项。较大改动建议先开 Issue 讨论方案。

许可证

Apache License 2.0

免责声明

AiMaMi 是独立的 Codex 本地工作流工具，与 OpenAI 无隶属、背书或赞助关系。使用第三方中转服务请自行评估风险并遵守相应条款。