refactor: remove README and REFACTOR_PROGRESS files; enhance MainLayout with sidebar icons and improved navigation item display

2026-02-18 10:40:50 +08:00 · 2025-12-09 01:46:58 +08:00
parent 2ca662e971
commit 5d5334afb1
4 changed files with 123 additions and 212 deletions
--- a/README.md
+++ b/README.md
@@ -1,180 +0,0 @@
-# CLI Proxy Web UI - React Version
-
-CLI Proxy API Management Center 的 React + TypeScript 重构版本。
-
-## ✨ 特性
-
- 🎯 完全使用 TypeScript 编写,类型安全
- ⚛️ 基于 React 18 + Vite 构建,开发体验极佳
- 🎨 SCSS 模块化样式,支持亮色/暗色主题
- 🌍 完整的国际化支持 (中文/英文)
- 📦 单文件部署,无需构建服务器
- 🔒 安全的本地存储,支持数据加密
- 📱 响应式设计,支持移动端
-
-## 🚀 快速开始
-
-### 开发模式
-
-```bash
-# 安装依赖
-npm install
-
-# 启动开发服务器
-npm run dev
-
-# 访问 http://localhost:5173
-```
-
-### 生产构建
-
-```bash
-# 构建生产版本
-npm run build
-
-# 产物在 dist/index.html
-# 直接双击打开或部署到服务器
-```
-
-### 代码检查
-
-```bash
-# TypeScript 类型检查
-npm run type-check
-
-# ESLint 代码检查
-npm run lint
-```
-
-## 📁 项目结构
-
-```
-src/
-├── components/        # 公共组件
-│   ├── common/       # 基础组件 (Button, Input, Card, Modal...)
-│   └── layout/       # 布局组件 (MainLayout, Sidebar, Header...)
-├── pages/            # 页面组件
-│   ├── LoginPage.tsx
-│   ├── SettingsPage.tsx
-│   ├── ApiKeysPage.tsx
-│   ├── AiProvidersPage.tsx
-│   ├── AuthFilesPage.tsx
-│   ├── OAuthPage.tsx
-│   ├── UsagePage.tsx
-│   ├── ConfigPage.tsx
-│   ├── LogsPage.tsx
-│   └── SystemPage.tsx
-├── services/         # API 服务
-│   ├── api/         # API 客户端
-│   └── storage/     # 本地存储服务
-├── stores/          # Zustand 状态管理
-│   ├── useAuthStore.ts
-│   ├── useConfigStore.ts
-│   ├── useThemeStore.ts
-│   └── useLanguageStore.ts
-├── hooks/           # 自定义 Hooks
-├── types/           # TypeScript 类型定义
-├── utils/           # 工具函数
-├── i18n/            # 国际化配置
-├── styles/          # 全局样式
-└── router/          # 路由配置
-```
-
-## 🔧 技术栈
-
- **框架**: React 18
- **语言**: TypeScript 5
- **构建工具**: Vite 7
- **路由**: React Router 7 (Hash 模式)
- **状态管理**: Zustand 5
- **样式**: SCSS Modules
- **国际化**: i18next
- **HTTP 客户端**: Axios
- **代码检查**: ESLint + TypeScript ESLint
-
-## 📝 使用说明
-
-### 首次使用
-
-1. **清理旧数据** (如果从旧版本升级)
-   - 打开 `CLEAR_STORAGE.html` 文件
-   - 点击"清空 LocalStorage"按钮
-   - 这将清理旧版本的存储数据
-
-2. **打开应用**
-   - 双击 `dist/index.html` 文件
-   - 或使用 HTTP 服务器访问 (推荐)
-
-3. **配置连接**
-   - 输入 CLI Proxy API 服务器地址
-   - 输入管理密钥
-   - 点击"连接"按钮
-
-### 部署方式
-
-#### 方式 1: 本地文件 (file:// 协议)
-直接双击 `dist/index.html` 即可使用。应用已配置为使用 Hash 路由,支持 file:// 协议。
-
-#### 方式 2: HTTP 服务器 (推荐)
-```bash
-# 使用 Python
-cd dist
-python -m http.server 8080
-
-# 使用 Node.js (需要安装 serve)
-npx serve dist
-
-# 访问 http://localhost:8080
-```
-
-#### 方式 3: Nginx/Apache
-将 `dist/index.html` 部署到 Web 服务器即可。
-
-## 🐛 故障排除
-
-### 白屏问题
-
-如果打开后显示白屏:
-
-1. 检查浏览器控制台是否有错误
-2. 确认是否清理了旧版本的 localStorage 数据
-3. 尝试使用 HTTP 服务器访问而不是 file:// 协议
-
-### LocalStorage 错误
-
-如果看到 "Failed to parse stored data" 错误:
-
-1. 打开 `CLEAR_STORAGE.html`
-2. 清空所有存储数据
-3. 刷新页面重新登录
-
-### 路由问题
-
-应用使用 Hash 路由 (#/login, #/settings),确保 URL 中包含 `#` 符号。
-
-## 📊 构建信息
-
- **TypeScript**: 0 errors ✅
- **ESLint**: 0 errors, 137 warnings ⚠️
- **Bundle Size**: 473 KB (144 KB gzipped)
- **Build Time**: ~5 seconds
-
-## 🔄 从旧版本迁移
-
-旧版本 (原生 JS) 的数据存储格式已变更。首次使用新版本时:
-
-1. 旧的 localStorage 数据会自动迁移
-2. 如果迁移失败,请手动清理 localStorage
-3. 重新输入连接信息即可
-
-## 📄 License
-
-Same as CLI Proxy API
-
-## 🤝 贡献
-
-欢迎提交 Issue 和 Pull Request!
-
---
-
-**注意**: 此版本是原 CLI Proxy Web UI 的 React 重构版本,与原版功能保持一致。