-
-
-
-https://github.com/user-attachments/assets/bf0bdf9d-ba91-45af-9ac4-7274f57075cf
-
-> [!TIP]
-> **⭐ Star the repo and follow [@getAsterisk](https://x.com/getAsterisk) on X for early access to `asteria-swe-v0`**.
-
-## 🌟 Overview
-
-**Claudia** is a powerful desktop application that transforms how you interact with Claude Code. Built with Tauri 2, it provides a beautiful GUI for managing your Claude Code sessions, creating custom agents, tracking usage, and much more.
-
-Think of Claudia as your command center for Claude Code - bridging the gap between the command-line tool and a visual experience that makes AI-assisted development more intuitive and productive.
-
-## 📋 Table of Contents
-
-- [🌟 Overview](#-overview)
-- [✨ Features](#-features)
- - [🗂️ Project & Session Management](#️-project--session-management)
- - [🤖 CC Agents](#-cc-agents)
-
- - [📊 Usage Analytics Dashboard](#-usage-analytics-dashboard)
- - [🔌 MCP Server Management](#-mcp-server-management)
- - [⏰ Timeline & Checkpoints](#-timeline--checkpoints)
- - [📝 CLAUDE.md Management](#-claudemd-management)
-- [📖 Usage](#-usage)
- - [Getting Started](#getting-started)
- - [Managing Projects](#managing-projects)
- - [Creating Agents](#creating-agents)
- - [Tracking Usage](#tracking-usage)
- - [Working with MCP Servers](#working-with-mcp-servers)
-- [🚀 Installation](#-installation)
-- [🔨 Build from Source](#-build-from-source)
-- [🛠️ Development](#️-development)
-- [🔒 Security](#-security)
-- [🤝 Contributing](#-contributing)
-- [📄 License](#-license)
-- [🙏 Acknowledgments](#-acknowledgments)
-
-## ✨ Features
-
-### 🗂️ **Project & Session Management**
-- **Visual Project Browser**: Navigate through all your Claude Code projects in `~/.claude/projects/`
-- **Session History**: View and resume past coding sessions with full context
-- **Smart Search**: Find projects and sessions quickly with built-in search
-- **Session Insights**: See first messages, timestamps, and session metadata at a glance
-
-### 🤖 **CC Agents**
-- **Custom AI Agents**: Create specialized agents with custom system prompts and behaviors
-- **Agent Library**: Build a collection of purpose-built agents for different tasks
-- **Background Execution**: Run agents in separate processes for non-blocking operations
-- **Execution History**: Track all agent runs with detailed logs and performance metrics
+## 🎯 项目背景
-### 📊 **Usage Analytics Dashboard**
-- **Cost Tracking**: Monitor your Claude API usage and costs in real-time
-- **Token Analytics**: Detailed breakdown by model, project, and time period
-- **Visual Charts**: Beautiful charts showing usage trends and patterns
-- **Export Data**: Export usage data for accounting and analysis
+> **为什么要重复造轮子？**
+>
+> 因为原版 Claudia-Suita 在我的电脑上无法正常运行，所以决定基于原项目进行改进和优化。虽然是"重复造轮子"，但这个轮子更适合我的使用场景，也希望能帮助到有类似需求的朋友。
-### 🔌 **MCP Server Management**
-- **Server Registry**: Manage Model Context Protocol servers from a central UI
-- **Easy Configuration**: Add servers via UI or import from existing configs
-- **Connection Testing**: Verify server connectivity before use
-- **Claude Desktop Import**: Import server configurations from Claude Desktop
+本项目基于 [Asterisk 的 Claudia](https://github.com/getAsterisk/claudia) 改进，并参考了以下优秀项目：
+- [Claude Suite](https://github.com/xinhai-ai/claude-suite) - Claude-Suite 中转站
+- [PackyCode Cost](https://github.com/94mashiro/packycode-cost) - PackyCode 额度查询
-### ⏰ **Timeline & Checkpoints**
-- **Session Versioning**: Create checkpoints at any point in your coding session
-- **Visual Timeline**: Navigate through your session history with a branching timeline
-- **Instant Restore**: Jump back to any checkpoint with one click
-- **Fork Sessions**: Create new branches from existing checkpoints
-- **Diff Viewer**: See exactly what changed between checkpoints
+## 🌟 概述
-### 📝 **CLAUDE.md Management**
-- **Built-in Editor**: Edit CLAUDE.md files directly within the app
-- **Live Preview**: See your markdown rendered in real-time
-- **Project Scanner**: Find all CLAUDE.md files in your projects
-- **Syntax Highlighting**: Full markdown support with syntax highlighting
+**Claudia** 是一个功能强大的桌面应用程序，它改变了您与 Claude Code 交互的方式。基于 Tauri 2 构建，它为管理您的 Claude Code 会话、创建自定义代理、跟踪使用情况等提供了美观的图形界面。
-## 📖 Usage
+将 Claudia 视为您的 Claude Code 指挥中心 - 在命令行工具和视觉体验之间架起桥梁，使 AI 辅助开发更加直观和高效。
-### Getting Started
+## 📋 目录
-1. **Launch Claudia**: Open the application after installation
-2. **Welcome Screen**: Choose between CC Agents or CC Projects
-3. **First Time Setup**: Claudia will automatically detect your `~/.claude` directory
+- [🎯 项目背景](#-项目背景)
+- [🌟 概述](#-概述)
+- [✨ 功能特性](#-功能特性)
+ - [🗂️ 项目和会话管理](#️-项目和会话管理)
+ - [🤖 CC 代理](#-cc-代理)
+ - [🔗 API 中转站管理](#-api-中转站管理)
+ - [📊 使用分析仪表板](#-使用分析仪表板)
+ - [🔌 MCP 服务器管理](#-mcp-服务器管理)
+ - [⏰ 时间线和检查点](#-时间线和检查点)
+ - [📝 CLAUDE.md 管理](#-claudemd-管理)
+- [📖 使用指南](#-使用指南)
+- [🚀 安装](#-安装)
+- [🔨 从源码构建](#-从源码构建)
+- [🛠️ 开发](#️-开发)
+- [🔒 安全性](#-安全性)
+- [🤝 贡献](#-贡献)
+- [📄 许可证](#-许可证)
+- [🙏 致谢](#-致谢)
-### Managing Projects
+## 🆕 主要改进
+
+相比原版 Claudia，本版本主要新增和改进了以下功能：
+
+### ✅ 已完成功能
+
+1. **API 中转站管理系统（代理商切换）**
+ - ✅ 完整实现 PackyCode 中转站支持（滴滴车/公交车服务）
+ - ✅ Custom 自定义中转站配置
+ - ✅ 实时额度查询和管理
+ - ✅ 多中转站切换管理（一键切换不同代理商）
+ - ✅ 自动配置同步到 Claude 设置文件
+
+2. **优化的费用计算**
+ - ✅ 更精确的 Token 费用计算算法
+ - ✅ 支持缓存费用单独统计
+ - ✅ 不同模型费率差异化处理
+ - ✅ 实时费用追踪和成本分析
+ - ✅ 按项目、模型、日期多维度统计
+
+3. **完整的国际化（i18n）**
+ - ✅ 全面的中文界面支持
+ - ✅ 中英文一键切换
+ - ✅ 前后端统一的国际化系统
+ - ✅ 本地化的提示、错误信息和说明
+ - ✅ 语言设置持久化存储
+
+4. **Bug 修复和性能优化**
+ - ✅ 修复了原版在某些环境下无法运行的问题
+ - ✅ 修复了 JSON 配置文件解析错误
+ - ✅ 优化了数据库操作性能
+ - ✅ 改进了界面响应速度
+ - ✅ 解决了中转站配置同步问题
+
+## ✨ 功能特性
+
+### 🗂️ **项目和会话管理**
+- **可视化项目浏览器**：浏览 `~/.claude/projects/` 中的所有 Claude Code 项目
+- **会话历史**：查看并恢复带有完整上下文的过往编码会话
+- **智能搜索**：通过内置搜索快速查找项目和会话
+- **会话洞察**：一目了然地查看首条消息、时间戳和会话元数据
+
+### 🤖 **CC 代理**
+- **自定义 AI 代理**：创建具有自定义系统提示和行为的专门代理
+- **代理库**：为不同任务构建专用代理集合
+- **后台执行**：在独立进程中运行代理，实现非阻塞操作
+- **执行历史**：跟踪所有代理运行，包含详细日志和性能指标
+
+### 🔗 **API 中转站管理** 🆕
+全新的 API 中转站功能，支持多种中转服务，让您灵活选择 API 提供商：
+
+#### ✅ 已实现功能
+- **PackyCode 中转站**
+ - 🚗 **滴滴车服务** - 共享 API，经济实惠
+ - 支持实时额度查询
+ - 显示账户余额、套餐信息
+ - 日/月使用量统计
+ - 🚌 **公交车服务** - 独享线路，稳定快速
+ - 多节点选择（直连、备用、紧急节点）
+ - 实时额度查询
+ - 智能节点切换
+ - 📊 **额度管理功能**
+ - 实时查询 API 使用额度
+ - 可视化展示日/月预算使用情况
+ - 账户余额和套餐信息一目了然
+ - 支持多账户管理
+ - 自动刷新和手动刷新
+ - 无需启用即可查询额度
+
+- **Custom 自定义中转站** ✅
+ - 支持自定义 API URL 和认证方式
+ - 灵活配置各种兼容的 API 服务
+ - 适用于私有部署或其他第三方服务
+
+#### 🚧 开发中功能
+- **NewAPI** - 兼容 NewAPI 平台（开发中）
+- **OneAPI** - 支持 OneAPI 标准（开发中）
+- **YourAPI** - YourAPI 平台集成（开发中）
+
+### 📊 **使用分析仪表板**
+- **成本跟踪**：实时监控您的 Claude API 使用和成本
+- **Token 分析**：按模型、项目和时间段的详细分类
+- **可视化图表**：展示使用趋势和模式的精美图表
+- **数据导出**：导出使用数据用于会计和分析
+- **费用计算优化** 🆕：
+ - 精确的 Token 费用计算
+ - 支持不同模型的费率差异
+ - 缓存费用单独统计
+ - 参考了 [PackyCode Cost](https://github.com/94mashiro/packycode-cost) 的计算逻辑
+
+### 🔌 **MCP 服务器管理**
+- **服务器注册**：从中央 UI 管理模型上下文协议服务器
+- **简单配置**：通过 UI 添加服务器或从现有配置导入
+- **连接测试**：使用前验证服务器连接性
+- **Claude Desktop 导入**：从 Claude Desktop 导入服务器配置
+
+### ⏰ **时间线和检查点**
+- **会话版本控制**：在编码会话的任何时点创建检查点
+- **可视化时间线**：通过分支时间线浏览您的会话历史
+- **即时恢复**：一键跳转到任何检查点
+- **分叉会话**：从现有检查点创建新分支
+- **差异查看器**：查看检查点之间的确切更改
+
+### 📝 **CLAUDE.md 管理**
+- **内置编辑器**：直接在应用内编辑 CLAUDE.md 文件
+- **实时预览**：实时查看渲染的 Markdown
+- **项目扫描器**：查找项目中的所有 CLAUDE.md 文件
+- **语法高亮**：完整的 Markdown 支持和语法高亮
+
+## 📖 使用指南
+
+### 快速开始
+
+1. **启动 Claudia**：安装后打开应用程序
+2. **欢迎界面**：选择 CC 代理或 CC 项目
+3. **首次设置**：Claudia 将自动检测您的 `~/.claude` 目录
+
+### 管理项目
```
-CC Projects → Select Project → View Sessions → Resume or Start New
+CC 项目 → 选择项目 → 查看会话 → 恢复或开始新会话
```
-- Click on any project to view its sessions
-- Each session shows the first message and timestamp
-- Resume sessions directly or start new ones
+- 点击任何项目查看其会话
+- 每个会话显示第一条消息和时间戳
+- 直接恢复会话或开始新会话
-### Creating Agents
+### 创建代理
```
-CC Agents → Create Agent → Configure → Execute
+CC 代理 → 创建代理 → 配置 → 执行
```
-1. **Design Your Agent**: Set name, icon, and system prompt
-2. **Configure Model**: Choose between available Claude models
-3. **Set Permissions**: Configure file read/write and network access
-4. **Execute Tasks**: Run your agent on any project
+1. **设计您的代理**：设置名称、图标和系统提示
+2. **配置模型**：在可用的 Claude 模型之间选择
+3. **设置权限**：配置文件读写和网络访问
+4. **执行任务**：在任何项目上运行您的代理
-### Tracking Usage
+### 配置中转站
```
-Menu → Usage Dashboard → View Analytics
+菜单 → 中转站管理 → 创建中转站 → 配置
```
-- Monitor costs by model, project, and date
-- Export data for reports
-- Set up usage alerts (coming soon)
+1. **创建中转站**：
+ - 点击"创建中转站"按钮
+ - 选择适配器类型（如 PackyCode）
+ - 选择服务类型（滴滴车或公交车）
+ - 输入 API Token
+ - 保存配置
-### Working with MCP Servers
+2. **查看额度**：
+ - PackyCode 中转站自动显示额度信息
+ - 包含账户余额、日/月使用量、套餐信息
+ - 支持手动刷新
+ - 无需启用即可查询
+
+3. **管理中转站**：
+ - 启用/禁用中转站（同时只能启用一个）
+ - 编辑配置信息
+ - 删除不需要的中转站
+
+### 跟踪使用情况
```
-Menu → MCP Manager → Add Server → Configure
+菜单 → 使用仪表板 → 查看分析
```
-- Add servers manually or via JSON
-- Import from Claude Desktop configuration
-- Test connections before using
+- 按模型、项目和日期监控成本
+- 导出数据用于报告
+- 设置使用警报（即将推出）
-## 🚀 Installation
+### 使用 MCP 服务器
-### Prerequisites
+```
+菜单 → MCP 管理器 → 添加服务器 → 配置
+```
-- **Claude Code CLI**: Install from [Claude's official site](https://claude.ai/code)
+- 手动或通过 JSON 添加服务器
+- 从 Claude Desktop 配置导入
+- 使用前测试连接
-### Release Executables Will Be Published Soon
+## 🚀 安装
-## 🔨 Build from Source
+### 前提条件
-### Prerequisites
+- **Claude Code CLI**：从 [Claude 官方网站](https://claude.ai/code) 安装
-Before building Claudia from source, ensure you have the following installed:
+### 发布版本即将推出
-#### System Requirements
+## 🔨 从源码构建
-- **Operating System**: Windows 10/11, macOS 11+, or Linux (Ubuntu 20.04+)
-- **RAM**: Minimum 4GB (8GB recommended)
-- **Storage**: At least 1GB free space
+### 前提条件
-#### Required Tools
+在从源码构建 Claudia 之前，请确保您已安装以下内容：
-1. **Rust** (1.70.0 or later)
+#### 系统要求
+
+- **操作系统**：Windows 10/11、macOS 11+ 或 Linux（Ubuntu 20.04+）
+- **内存**：最低 4GB（推荐 8GB）
+- **存储**：至少 1GB 可用空间
+
+#### 必需工具
+
+1. **Rust**（1.70.0 或更高版本）
```bash
- # Install via rustup
+ # 通过 rustup 安装
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
```
-2. **Bun** (latest version)
+2. **Bun**（最新版本）
```bash
- # Install bun
+ # 安装 bun
curl -fsSL https://bun.sh/install | bash
```
3. **Git**
```bash
- # Usually pre-installed, but if not:
+ # 通常已预装，如果没有：
# Ubuntu/Debian: sudo apt install git
# macOS: brew install git
- # Windows: Download from https://git-scm.com
+ # Windows: 从 https://git-scm.com 下载
```
4. **Claude Code CLI**
- - Download and install from [Claude's official site](https://claude.ai/code)
- - Ensure `claude` is available in your PATH
+ - 从 [Claude 官方网站](https://claude.ai/code) 下载并安装
+ - 确保 `claude` 在您的 PATH 中可用
-#### Platform-Specific Dependencies
+#### 平台特定依赖
**Linux (Ubuntu/Debian)**
```bash
-# Install system dependencies
+# 安装系统依赖
sudo apt update
sudo apt install -y \
libwebkit2gtk-4.1-dev \
@@ -216,203 +309,150 @@ sudo apt install -y \
**macOS**
```bash
-# Install Xcode Command Line Tools
+# 安装 Xcode 命令行工具
xcode-select --install
-# Install additional dependencies via Homebrew (optional)
+# 通过 Homebrew 安装其他依赖（可选）
brew install pkg-config
```
**Windows**
-- Install [Microsoft C++ Build Tools](https://visualstudio.microsoft.com/visual-cpp-build-tools/)
-- Install [WebView2](https://developer.microsoft.com/microsoft-edge/webview2/) (usually pre-installed on Windows 11)
+- 安装 [Microsoft C++ Build Tools](https://visualstudio.microsoft.com/visual-cpp-build-tools/)
+- 安装 [WebView2](https://developer.microsoft.com/microsoft-edge/webview2/)（Windows 11 通常已预装）
-### Build Steps
+### 构建步骤
-1. **Clone the Repository**
+1. **克隆仓库**
```bash
- git clone https://github.com/getAsterisk/claudia.git
+ git clone https://github.com/yovinchen/claudia.git
cd claudia
```
-2. **Install Frontend Dependencies**
+2. **安装前端依赖**
```bash
bun install
```
-3. **Build the Application**
+3. **构建应用程序**
- **For Development (with hot reload)**
+ **开发环境（带热重载）**
```bash
bun run tauri dev
```
- **For Production Build**
+ **生产构建**
```bash
- # Build the application
+ # 构建应用程序
bun run tauri build
- # The built executable will be in:
+ # 构建的可执行文件位于：
# - Linux: src-tauri/target/release/
# - macOS: src-tauri/target/release/
# - Windows: src-tauri/target/release/
```
-4. **Platform-Specific Build Options**
-
- **Debug Build (faster compilation, larger binary)**
- ```bash
- bun run tauri build --debug
- ```
-
- **Universal Binary for macOS (Intel + Apple Silicon)**
- ```bash
- bun run tauri build --target universal-apple-darwin
- ```
+## 🛠️ 开发
-### Troubleshooting
+### 技术栈
-#### Common Issues
+- **前端**：React 18 + TypeScript + Vite 6
+- **后端**：Rust with Tauri 2
+- **UI 框架**：Tailwind CSS v4 + shadcn/ui
+- **数据库**：SQLite（通过 rusqlite）
+- **包管理器**：Bun
+- **国际化**：i18next（支持中英文切换）
-1. **"cargo not found" error**
- - Ensure Rust is installed and `~/.cargo/bin` is in your PATH
- - Run `source ~/.cargo/env` or restart your terminal
-
-2. **Linux: "webkit2gtk not found" error**
- - Install the webkit2gtk development packages listed above
- - On newer Ubuntu versions, you might need `libwebkit2gtk-4.0-dev`
-
-3. **Windows: "MSVC not found" error**
- - Install Visual Studio Build Tools with C++ support
- - Restart your terminal after installation
-
-4. **"claude command not found" error**
- - Ensure Claude Code CLI is installed and in your PATH
- - Test with `claude --version`
-
-5. **Build fails with "out of memory"**
- - Try building with fewer parallel jobs: `cargo build -j 2`
- - Close other applications to free up RAM
-
-#### Verify Your Build
-
-After building, you can verify the application works:
-
-```bash
-# Run the built executable directly
-# Linux/macOS
-./src-tauri/target/release/claudia
-
-# Windows
-./src-tauri/target/release/claudia.exe
-```
-
-### Build Artifacts
-
-The build process creates several artifacts:
-
-- **Executable**: The main Claudia application
-- **Installers** (when using `tauri build`):
- - `.deb` package (Linux)
- - `.AppImage` (Linux)
- - `.dmg` installer (macOS)
- - `.msi` installer (Windows)
- - `.exe` installer (Windows)
-
-All artifacts are located in `src-tauri/target/release/`.
-
-## 🛠️ Development
-
-### Tech Stack
-
-- **Frontend**: React 18 + TypeScript + Vite 6
-- **Backend**: Rust with Tauri 2
-- **UI Framework**: Tailwind CSS v4 + shadcn/ui
-- **Database**: SQLite (via rusqlite)
-- **Package Manager**: Bun
-
-### Project Structure
+### 项目结构
```
claudia/
-├── src/ # React frontend
-│ ├── components/ # UI components
-│ ├── lib/ # API client & utilities
-│ └── assets/ # Static assets
-├── src-tauri/ # Rust backend
+├── src/ # React 前端
+│ ├── components/ # UI 组件
+│ │ └── RelayStationManager.tsx # 中转站管理组件
+│ ├── lib/ # API 客户端和工具
+│ ├── locales/ # 国际化文件
+│ └── assets/ # 静态资源
+├── src-tauri/ # Rust 后端
│ ├── src/
-│ │ ├── commands/ # Tauri command handlers
-│ │ ├── checkpoint/ # Timeline management
-│ │ └── process/ # Process management
-│ └── tests/ # Rust test suite
-└── public/ # Public assets
+│ │ ├── commands/ # Tauri 命令处理器
+│ │ │ ├── relay_stations.rs # 中转站管理
+│ │ │ └── relay_adapters.rs # 中转站适配器
+│ │ ├── checkpoint/ # 时间线管理
+│ │ └── process/ # 进程管理
+│ └── tests/ # Rust 测试套件
+└── public/ # 公共资源
```
-### Development Commands
+### 开发命令
```bash
-# Start development server
+# 启动开发服务器
bun run tauri dev
-# Run frontend only
+# 仅运行前端
bun run dev
-# Type checking
+# 类型检查
bunx tsc --noEmit
-# Run Rust tests
+# 运行 Rust 测试
cd src-tauri && cargo test
-# Format code
+# 格式化代码
cd src-tauri && cargo fmt
```
-## 🔒 Security
+## 🔒 安全性
-Claudia prioritizes your privacy and security:
+Claudia 优先考虑您的隐私和安全：
-1. **Process Isolation**: Agents run in separate processes
-2. **Permission Control**: Configure file and network access per agent
-3. **Local Storage**: All data stays on your machine
-4. **No Telemetry**: No data collection or tracking
-5. **Open Source**: Full transparency through open source code
+1. **进程隔离**：代理在独立进程中运行
+2. **权限控制**：为每个代理配置文件和网络访问
+3. **本地存储**：所有数据都保存在您的机器上
+4. **无遥测**：无数据收集或跟踪
+5. **开源**：通过开源代码实现完全透明
-## 🤝 Contributing
+## 🤝 贡献
-We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
+我们欢迎贡献！请查看我们的[贡献指南](CONTRIBUTING.md)了解详情。
-### Areas for Contribution
+### 贡献领域
-- 🐛 Bug fixes and improvements
-- ✨ New features and enhancements
-- 📚 Documentation improvements
-- 🎨 UI/UX enhancements
-- 🧪 Test coverage
-- 🌐 Internationalization
+- 🐛 Bug 修复和改进
+- ✨ 新功能和增强
+- 📚 文档改进
+- 🎨 UI/UX 增强
+- 🧪 测试覆盖
+- 🌐 国际化
-## 📄 License
+## 📄 许可证
-This project is licensed under the AGPL License - see the [LICENSE](LICENSE) file for details.
+本项目根据 AGPL 许可证授权 - 有关详细信息，请参阅 [LICENSE](LICENSE) 文件。
-## 🙏 Acknowledgments
+## 🙏 致谢
-- Built with [Tauri](https://tauri.app/) - The secure framework for building desktop apps
+- 使用 [Tauri](https://tauri.app/) 构建 - 用于构建桌面应用的安全框架
- [Claude](https://claude.ai) by Anthropic
+- 原始项目 by [Asterisk 的 Claudia](https://github.com/getAsterisk/claudia)
+- 参考项目：
+ - [Claude Suite](https://github.com/xinhai-ai/claude-suite) - Claude-Suite 中转站
+ - [PackyCode Cost](https://github.com/94mashiro/packycode-cost) - PackyCode 额度查询
+- 中文化和新功能 by [YovinChen](https://github.com/yovinchen)
---
