71 lines
2.1 KiB
Markdown
71 lines
2.1 KiB
Markdown
# CLAUDE.md
|
||
|
||
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
|
||
|
||
## 项目概述
|
||
|
||
这是一个 Electron + React + TypeScript 的桌面应用，用于管理和切换 Claude Code 的不同供应商配置（Anthropic、OpenRouter 等）。
|
||
|
||
## 开发命令
|
||
|
||
```bash
|
||
# 开发模式（同时启动 Vite 开发服务器和 Electron 主进程监听）
|
||
npm run dev
|
||
|
||
# 仅构建主进程
|
||
npm run build:main
|
||
|
||
# 仅构建渲染进程
|
||
npm run build:renderer
|
||
|
||
# 完整构建
|
||
npm run build
|
||
|
||
# 启动应用（需要先构建）
|
||
npm start
|
||
# 或
|
||
electron .
|
||
|
||
# 打包发布
|
||
npm run dist
|
||
```
|
||
|
||
## 代码架构
|
||
|
||
### 三层架构设计
|
||
|
||
1. **主进程 (src/main/)**
|
||
- `index.ts`: Electron 主进程入口，处理窗口创建和 IPC 通信
|
||
- `services.ts`: 核心业务逻辑，包含供应商状态检查和 Claude Code 配置文件操作
|
||
- `preload.ts`: 预加载脚本，提供安全的 IPC API 接口
|
||
|
||
2. **渲染进程 (src/renderer/)**
|
||
- `App.tsx`: 主应用组件，状态管理和业务逻辑协调
|
||
- `components/`: React 组件
|
||
- `ProviderList.tsx`: 供应商列表显示和操作
|
||
- `AddProviderModal.tsx`: 添加供应商的模态框
|
||
- `EditProviderModal.tsx`: 编辑供应商的模态框
|
||
|
||
3. **共享类型 (src/shared/types.ts)**
|
||
- 定义主进程和渲染进程间的数据结构
|
||
- 声明 `window.electronAPI` 接口用于类型安全的 IPC 调用
|
||
|
||
### 数据流
|
||
|
||
- 使用 `electron-store` 在主进程中持久化供应商配置
|
||
- 通过 IPC 在主进程和渲染进程间通信
|
||
- 供应商状态通过 HTTP 请求实时检测
|
||
- 切换供应商时直接修改 `~/.claude/settings.json` 文件
|
||
|
||
### 关键文件操作
|
||
|
||
- Claude Code 配置文件路径: `~/.claude/settings.json`
|
||
- 配置更新通过 `services.ts` 中的 `switchProvider()` 函数完成
|
||
- 应用配置存储在 `electron-store` 默认位置
|
||
|
||
## 构建配置
|
||
|
||
- 主进程使用 `tsconfig.main.json` 配置
|
||
- 渲染进程使用 `tsconfig.json` + Vite 构建
|
||
- 开发时渲染进程运行在 `localhost:3000`
|
||
- 生产时渲染进程文件位于 `dist/renderer/` |