feat: 重构项目结构并添加平台同步基础架构

- 重构项目目录结构,将功能模块移至 modules/ 目录
- 创建平台同步基础架构,包括发布器基类和 GitHub 发布器
- 新增 UI 状态管理模块 (modules/ui/state.py) 统一管理会话状态
- 更新依赖配置,添加平台同步所需依赖 (httpx, pyperclip)
- 整理文档结构,将所有文档分类移至 docs/ 目录
- 添加 .cursorrules 文件定义项目开发规范
- 清理根目录重复文件,保持项目结构整洁
This commit is contained in:
刘国栋
2026-01-30 10:21:29 +08:00
parent 77d5ec70f8
commit 8f7f082c3d
102 changed files with 33742 additions and 1526 deletions
+94
View File
@@ -0,0 +1,94 @@
# 平台扩展安装说明
## 已支持的平台
### 基础平台(已包含依赖)
- DeepSeek
- OpenAI (GPT)
- Tongyi (通义千问)
- Groq
- Moonshot (Kimi)
### 新增平台(需要额外安装)
#### 1. 豆包(字节跳动)
**安装命令:**
```bash
pip install 'volcengine-python-sdk[ark]'
```
**API Key 格式:**
```
access_key:secret_key:endpoint_id
```
用冒号分隔三个值:
- `access_key`: 火山引擎 Access Key
- `secret_key`: 火山引擎 Secret Key
- `endpoint_id`: 接入点名称(Endpoint ID
**获取方式:**
1. 访问 [火山引擎官网](https://www.volcengine.com/)
2. 注册账号并完成实名认证
3. 在控制台获取 Access Key 和 Secret Key
4. 创建模型接入点,获取 Endpoint ID
**使用示例:**
在侧边栏"生成&优化 LLM"或"验证用LLM"中选择"豆包(字节跳动)",输入格式化的 API Key。
---
#### 2. 文心一言(百度)
**安装命令:**
```bash
pip install qianfan
```
**API Key 格式:**
```
app_key:app_secret
```
用冒号分隔两个值:
- `app_key`: 百度智能云 App Key
- `app_secret`: 百度智能云 App Secret
**获取方式:**
1. 访问 [百度智能云千帆平台](https://cloud.baidu.com/product/qianfan.html)
2. 注册账号并完成认证
3. 创建应用,获取 App Key 和 App Secret
**使用示例:**
在侧边栏"生成&优化 LLM"或"验证用LLM"中选择"文心一言(百度)",输入格式化的 API Key。
---
## 快速安装所有平台
如果需要使用所有平台,可以运行:
```bash
pip install 'volcengine-python-sdk[ark]' qianfan
```
---
## 注意事项
1. **API Key 格式**:豆包和文心一言的 API Key 需要使用冒号分隔多个值
2. **依赖冲突**:某些包可能有版本冲突,如遇到问题请单独安装
3. **可选安装**:这些平台是可选的,如果不使用可以不安装,不影响其他功能
---
## 故障排除
### 豆包安装失败
- 确保 Python 版本 >= 3.7
- Windows 系统可能需要启用长路径支持
- 尝试:`pip install 'volcengine-python-sdk[ark]' -U`
### 文心一言初始化失败
- 确保已安装 `qianfan`
- 检查 API Key 格式是否正确(app_key:app_secret
- 确认环境变量或参数中的 AK/SK 是否正确