更新文档

This commit is contained in:
2025-09-06 17:47:31 +08:00
parent b2e6f40269
commit 7d15edd0c1

View File

@@ -17,7 +17,7 @@
## 📖 项目概述
基于 Tauri 2 的 Claude Code 图形界面,提供项目管理、AI代理、使用分析功能。
基于 Tauri 2 的 Claude Code 图形界面,集成项目管理、AI代理、使用分析、MCP服务器、API中转站等强大功能。
> 基于 [Asterisk Claudia](https://github.com/getAsterisk/claudia) 改进,参考 [Claude Suite](https://github.com/xinhai-ai/claude-suite) 和 [PackyCode Cost](https://github.com/94mashiro/packycode-cost)。
@@ -37,31 +37,55 @@
- 自动检测 Claude 项目,快速恢复会话
- 版本控制检查点,支持分支回滚
- 实时同步项目状态和历史
- Git Panel 集成,查看文件变更 diff
### 🤖 AI 代理系统
- 创建自定义代理,后台独立执行
- 详细运行日志,精细权限控制
- 非阻塞操作,高效任务管理
- 支持多代理并发运行
### 🔗 API 中转站
- 支持 PackyCode、Custom平台
- 实时额度查询,一键切换配置
- 自动同步到 Claude 设置
- 支持 PackyCode(公交车/滴滴车、DeepSeek、GLM、Qwen、Kimi 等平台
- 实时额度查询,公交车/滴滴车服务切换
- Token 脱敏显示,安全配置管理
- 自动同步到 Claude 设置,一键刷新 DNS
### 📊 使用分析
- 实时成本跟踪Token 详细统计
- 可视化图表,数据导出分析
- 按模型、项目、时间段分类
- SQLite 缓存优化,毫秒级查询响应
### 🎨 编辑增强
- Monaco 编辑器40+ 语言高亮
- 智能补全,实时诊断错误
- 多光标编辑,代码自动格式化
- 主题快速切换,深色/浅色模式
### 📁 文件监听
- 跨平台实时监听,外部修改同步
- 防抖机制,轮询降级方案
- 基于 Rust notify 高性能
- 支持大型项目文件变更追踪
### 🔌 MCP 服务器
- Model Context Protocol 支持
- 服务器配置管理,一键启用/禁用
- 支持多服务器并发管理
- 与 Claude 设置深度集成
### 🖥️ 终端集成
- 内置终端支持,执行命令行操作
- 会话数据持久化,历史记录保留
- 支持多终端标签页
- 自动识别系统 Shell
### 🎯 Claude Code Review (CCR)
- 集成 Claude Code Review 功能
- 一键启动/停止 CCR 服务
- 自动检测安装状态
- 支持打开 CCR UI 界面
## 🚀 安装使用
@@ -70,12 +94,23 @@
- `claude` 命令在 PATH 中可用
### 快速开始
1. 启动 Claudia
2. 选择 CC 代理 或 CC 项目模式
1. 下载并安装 Claudia
2. 启动应用,选择 CC 代理或 CC 项目模式
3. 创建代理或管理会话
4. 配置中转站享受更好的服务体验
### 中转站配置
菜单 → 中转站管理 → 创建 → 输入 Token → 启用
1. 菜单 → 中转站管理
2. 点击"创建中转站"
3. 选择服务类型PackyCode 公交车/滴滴车等)
4. 输入 API Token
5. 点击启用按钮
### 性能优化说明
- **用量分析**: 首次扫描后自动缓存,后续查询毫秒级响应
- **文件监听**: 采用防抖机制,避免频繁触发
- **大项目支持**: 优化了内存使用,支持大型代码库
- **实时响应**: 所有操作异步执行,界面始终流畅
## 🔨 从源码构建
@@ -110,9 +145,12 @@ bun run tauri build # 生产构建
## 🛠️ 开发
### 技术栈
- **前端**: React 18 + TypeScript + Vite 6 + Tailwind CSS v4
- **后端**: Rust + Tauri 2 + SQLite
- **编辑器**: Monaco Editor
- **前端**: React 18 + TypeScript + Vite 6 + Tailwind CSS v4 + shadcn/ui
- **后端**: Rust + Tauri 2 + SQLite (rusqlite)
- **编辑器**: Monaco Editor (VS Code 内核)
- **国际化**: i18next + fluent (中英双语)
- **文件监听**: notify crate (跨平台)
- **包管理**: Bun (替代 npm/yarn)
### 开发命令
```bash
@@ -126,8 +164,21 @@ bun run check # 完整检查
```
claudia/
├── src/ # React 前端
│ ├── components/ # UI 组件
│ ├── hooks/ # 自定义 Hooks
│ ├── lib/ # 工具库和 API
│ ├── locales/ # 国际化资源
│ └── stores/ # Zustand 状态管理
├── src-tauri/ # Rust 后端
└── docs/ # 文档
│ ├── commands/ # Tauri 命令
│ ├── claude/ # Claude CLI 集成
│ └── utils/ # 工具函数
├── docs/ # 项目文档
│ ├── RELAY_STATION_*.md # 中转站文档
│ ├── PERFORMANCE_*.md # 性能优化文档
│ └── ... # 其他技术文档
└── .github/ # GitHub 配置
└── workflows/ # CI/CD 工作流
```
## 🔒 安全特性
@@ -135,6 +186,8 @@ claudia/
- 进程隔离,精细权限控制
- 本地存储,无数据收集
- 开源透明,代码可审计
- API Token 脱敏显示
- 配置文件加密存储
## 🤝 贡献
@@ -144,13 +197,15 @@ claudia/
## 📄 许可证
AGPL 许可证 - 详见 [LICENSE](LICENSE)
本项目采用 AGPL-3.0 许可证 - 详见 [LICENSE](LICENSE)
## 🙏 致谢
- [Tauri](https://tauri.app/) - 安全桌面应用框架
- [Asterisk Claudia](https://github.com/getAsterisk/claudia) - 原始项目
- [Claude](https://claude.ai) by Anthropic
- [Tauri](https://tauri.app/) - 安全高效的桌面应用框架
- [Asterisk Claudia](https://github.com/getAsterisk/claudia) - 原始项目灵感
- [Claude](https://claude.ai) by Anthropic - AI 核心能力
- [Monaco Editor](https://microsoft.github.io/monaco-editor/) - 强大的代码编辑器
- [shadcn/ui](https://ui.shadcn.com/) - 现代化 UI 组件库
---