From 7d15edd0c1f6ba58bbce674d1f8ff13dd09ae8c1 Mon Sep 17 00:00:00 2001 From: YoVinchen Date: Sat, 6 Sep 2025 17:47:31 +0800 Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 85 +++++++++++++++++++++++++++++++++++++++++++++---------- 1 file changed, 70 insertions(+), 15 deletions(-) diff --git a/README.md b/README.md index e038c4b..0949be5 100644 --- a/README.md +++ b/README.md @@ -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 组件库 ---