mirror of https://github.com/catlog22/Claude-Code-Workflow.git synced 2026-02-05 01:50:27 +08:00

Files

catlog22 b00113d212 feat: Enhance embedding management and model configuration

- Updated embedding_manager.py to include backend parameter in model configuration.
- Modified model_manager.py to utilize cache_name for ONNX models.
- Refactored hybrid_search.py to improve embedder initialization based on backend type.
- Added backend column to vector_store.py for better model configuration management.
- Implemented migration for existing database to include backend information.
- Enhanced API settings implementation with comprehensive provider and endpoint management.
- Introduced LiteLLM integration guide detailing configuration and usage.
- Added examples for LiteLLM usage in TypeScript.

2025-12-24 14:03:59 +08:00

5.2 KiB

Raw Blame History

API Settings 页面实现完成

创建的文件

1. JavaScript 文件

位置: ccw/src/templates/dashboard-js/views/api-settings.js (28KB)

主要功能:

✅ Provider Management (提供商管理)
- 添加/编辑/删除提供商
- 支持 OpenAI, Anthropic, Google, Ollama, Azure, Mistral, DeepSeek, Custom
- API Key 管理（支持环境变量）
- 连接测试功能
✅ Endpoint Management (端点管理)
- 创建自定义端点
- 关联提供商和模型
- 缓存策略配置
- 显示 CLI 使用示例
✅ Cache Management (缓存管理)
- 全局缓存开关
- 缓存统计显示
- 清除缓存功能

2. CSS 样式文件

位置: ccw/src/templates/dashboard-css/31-api-settings.css (6.8KB)

样式包括:

卡片式布局
表单样式
进度条
响应式设计
空状态显示

3. 国际化支持

位置: ccw/src/templates/dashboard-js/i18n.js

添加的翻译:

英文：54 个翻译键
中文：54 个翻译键
包含所有 UI 文本、提示信息、错误消息

4. 配置更新

dashboard-generator.ts

✅ 添加 31-api-settings.css 到 CSS 模块列表
✅ 添加 views/api-settings.js 到 JS 模块列表

navigation.js

✅ 添加 api-settings 路由处理
✅ 添加标题更新逻辑

dashboard.html

✅ 添加导航菜单项 (Settings 图标)

API 端点使用

该页面使用以下后端 API（已存在）:

Provider APIs

GET /api/litellm-api/providers - 获取所有提供商
POST /api/litellm-api/providers - 创建提供商
PUT /api/litellm-api/providers/:id - 更新提供商
DELETE /api/litellm-api/providers/:id - 删除提供商
POST /api/litellm-api/providers/:id/test - 测试连接

Endpoint APIs

GET /api/litellm-api/endpoints - 获取所有端点
POST /api/litellm-api/endpoints - 创建端点
PUT /api/litellm-api/endpoints/:id - 更新端点
DELETE /api/litellm-api/endpoints/:id - 删除端点

Model Discovery

GET /api/litellm-api/models/:providerType - 获取提供商支持的模型列表

Cache APIs

GET /api/litellm-api/cache/stats - 获取缓存统计
POST /api/litellm-api/cache/clear - 清除缓存

Config APIs

GET /api/litellm-api/config - 获取完整配置
PUT /api/litellm-api/config/cache - 更新全局缓存设置

页面特性

Provider 管理

+-- Provider Card ------------------------+
| OpenAI Production          [Edit] [Del] |
| Type: openai                            |
| Key: sk-...abc                          |
| URL: https://api.openai.com/v1         |
| Status: ✓ Enabled                       |
+-----------------------------------------+

Endpoint 管理

+-- Endpoint Card ------------------------+
| GPT-4o Code Review          [Edit] [Del]|
| ID: my-gpt4o                            |
| Provider: OpenAI Production             |
| Model: gpt-4-turbo                      |
| Cache: Enabled (60 min)                 |
| Usage: ccw cli -p "..." --model my-gpt4o|
+-----------------------------------------+

表单功能

Provider Form:
- 类型选择（8 种提供商）
- API Key 输入（支持显示/隐藏）
- 环境变量支持
- Base URL 自定义
- 启用/禁用开关
Endpoint Form:
- 端点 ID（CLI 使用）
- 显示名称
- 提供商选择（动态加载）
- 模型选择（根据提供商动态加载）
- 缓存策略配置
  - TTL（分钟）
  - 最大大小（KB）
  - 自动缓存文件模式

使用流程

1. 添加提供商

点击 "Add Provider"
选择提供商类型（如 OpenAI）
输入显示名称
输入 API Key（或使用环境变量）
可选：输入自定义 API Base URL
保存

2. 创建自定义端点

点击 "Add Endpoint"
输入端点 ID（用于 CLI）
输入显示名称
选择提供商
选择模型（自动加载该提供商支持的模型）
可选：配置缓存策略
保存

3. 使用端点

ccw cli -p "Analyze this code..." --model my-gpt4o

代码质量

✅ 遵循现有代码风格
✅ 使用 i18n 函数支持国际化
✅ 响应式设计（移动端友好）
✅ 完整的表单验证
✅ 用户友好的错误提示
✅ 使用 Lucide 图标
✅ 模态框复用现有样式
✅ 与后端 API 完全集成

测试建议

基础功能测试:
- 添加/编辑/删除提供商
- 添加/编辑/删除端点
- 清除缓存
表单验证测试:
- 必填字段验证
- API Key 显示/隐藏
- 环境变量切换
数据加载测试:
- 模型列表动态加载
- 缓存统计显示
- 空状态显示
国际化测试:
- 切换语言（英文/中文）
- 验证所有文本正确显示

下一步

页面已完成并集成到项目中。启动 CCW Dashboard 后：

导航栏会显示 "API Settings" 菜单项（Settings 图标）
点击进入即可使用所有功能
所有操作会实时同步到配置文件

注意事项

页面使用现有的 LiteLLM API 路由（litellm-api-routes.ts）
配置保存在项目的 LiteLLM 配置文件中
支持环境变量引用格式：${VARIABLE_NAME}
API Key 在显示时会自动脱敏（显示前 4 位和后 4 位）

5.2 KiB Raw Blame History Unescape Escape