api-key-manager 4.3.0__tar.gz → 5.0.2__tar.gz

{api_key_manager-4.3.0 → api_key_manager-5.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: api-key-manager
-Version: 4.3.0
+Version: 5.0.2
 Summary: Batch manage API keys for 45+ AI providers with CLI and Web interfaces
 Author: Townrain
 License: MIT
@@ -28,6 +28,9 @@ Requires-Dist: python-multipart>=0.0.9
 Requires-Dist: cryptography>=42.0.0
 Requires-Dist: jinja2>=3.0.0
 Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pywebview>=5.0; platform_system == "Windows"
+Requires-Dist: pywebview>=5.0; platform_system == "Darwin"
+Requires-Dist: pywebview>=5.0; platform_system == "Linux"
 Provides-Extra: dev
 Requires-Dist: pytest>=8.0.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
@@ -35,9 +38,13 @@ Requires-Dist: pytest-cov>=5.0.0; extra == "dev"
 Requires-Dist: ruff>=0.4.0; extra == "dev"
 Dynamic: license-file
 
+[![PyPI version](https://img.shields.io/pypi/v/api-key-manager)](https://pypi.org/project/api-key-manager/)
+
+[English](README_EN.md) | 中文
+
 # API Key Manager
 
-批量管理 45+ AI 服务商 API 密钥的 Python 工具，支持 CLI 和 Web 两种界面。
+批量管理 45+ AI 服务商 API 密钥的 Python 工具，支持 CLI、Web 和桌面三种界面。
 
 ## 功能特性
 
@@ -55,8 +62,24 @@ Dynamic: license-file
 - **API 文档** - Swagger UI 和 Redoc 自动文档
 - **国际化** - 支持中英文错误信息
 - **SDK 支持** - Python 和 TypeScript 客户端库
+- **桌面应用** - 单 exe 便携安装，React 前端 + pywebview 桌面窗口
 - **Webhook 通知** - 事件驱动的 Webhook 通知系统
 
+## 快速开始
+
+### 桌面应用（v5.0.2）
+
+从 [Releases](https://github.com/Townrain/API-Key-Manager/releases) 下载 `KeyHub-Setup.exe`，选择任意目录安装即可。首次启动自动生成配置文件，所有数据保持在安装目录内。
+
+### CLI / Web
+
+```bash
+pip install api-key-manager
+python web.py
+```
+
+详细文档见下方。
+
 ## 系统架构
 
 ![系统架构流程图](docs/images/flowchart.png)
@@ -187,7 +210,12 @@ curl -X DELETE http://localhost:18001/api/providers/my-llm
 ### 安装
 
 ```bash
-# 克隆项目
+# 从 PyPI 安装（推荐）
+pip install api-key-manager
+```
+
+```bash
+# 或从源码安装（开发模式）
 git clone https://github.com/Townrain/API-Key-Manager.git
 cd key
 
@@ -568,7 +596,7 @@ async def detect_provider(client, key: str, suspected_provider: str = None) -> s
 
 ### 模型列表来源
 
-系统从 Cherry Studio 同步模型数据，生成 `models_registry.py` 文件，包含每个服务商的静态模型列表：
+系统从 OpenCode [models.dev](https://models.dev) 同步模型数据，生成 `models_registry.py` 文件（中国区服务商保留 Cherry Studio 数据）：
 
 ```python
 PROVIDER_MODELS = {
@@ -621,17 +649,19 @@ for i in range(0, len(models), batch_size):
 
 系统支持按类型筛选模型：
 
-| 类型 | 说明 | 筛选方法 |
-|------|------|----------|
-| 视觉模型 | 支持图像输入 | `is_vision_model()` |
-| 工具模型 | 支持函数调用 | `is_tool_model()` |
-| 推理模型 | 支持思维链 | `is_reasoning_model()` |
-| 联网模型 | 支持网络搜索 | `is_websearch_model()` |
-| 免费模型 | 免费额度 | `is_free_model()` |
-| 嵌入模型 | 文本嵌入 | `is_embedding_model()` |
-| 重排模型 | 搜索重排 | `is_rerank_model()` |
+| 类型 | 说明 | 筛选方法 | 数据来源 |
+|------|------|----------|----------|
+| 视觉模型 | 支持图像输入 | `is_vision_model()` | models.dev |
+| 工具模型 | 支持函数调用 | `is_tool_model()` | models.dev |
+| 推理模型 | 支持思维链 | `is_reasoning_model()` | models.dev |
+
+能力数据（vision / tooluse / reasoning）从 [models.dev](https://models.dev/api.json) 同步，基于显式布尔字段，存储在 `data/model_capabilities.json` 中。
+
+### 模型能力说明
 
-能力数据从 Cherry Studio 同步，存储在 `data/model_capabilities.json` 中。
+> **v4.4**: 能力检测从 Cherry Studio 正则迁移到 [OpenCode models.dev](https://models.dev) 显式字段。
+> 仅保留三个可靠能力：**vision**（`modalities.input`）、**tooluse**（`tool_call`）、**reasoning**（`reasoning`）。
+> 新增 `scripts/extract_from_opencode.py`，CI `.github/workflows/sync-opencode-models.yml` 每日自动同步。
 
 ## 项目结构
 ```
@@ -970,7 +1000,7 @@ const result = await client.checkSingle({ key: 'sk-xxx', provider: 'openai' });
 
 ### 5. 模型列表的时效性
 
-模型列表从 Cherry Studio 同步，每日更新一次。新发布的模型可能需要等待同步后才能被检测到。
+模型列表从 [models.dev](https://models.dev) 同步，每日更新一次。新发布的模型可能需要等待同步后才能被检测到。
 
 ## 预期的设计决策（安全审查说明）
 
@@ -1052,246 +1082,8 @@ def _load_keys_data(config_override: dict | None = None) -> dict:
 
 ## 更新日志
 
+详见 [CHANGELOG.md](CHANGELOG.md)
 
-### v4.3.0 (2026-06-24)
-
-- **测试覆盖率大幅提升**: 覆盖率从 79.15% 提升至 92.09%，新增 167 个测试
-  - `detector.py`: 60% → 96% — 检测逻辑全覆盖，防止 v4.2.1 类 bug 回归
-  - `web/routes/test.py`: 41% → 99% — 测试路由全覆盖
-  - `web/routes/providers.py`: 37% → 100% — 提供商 CRUD 全覆盖
-  - `web/routes/misc.py`: 53% → 100% — Webhook/日志/签名报告全覆盖
-  - `web/routes/models.py`: 72% → 97% — 模型端点全覆盖
-  - `web/routes/check.py`: 74% → 97% — 验证端点全覆盖
-
-- **新增测试文件**:
-  - `test_detector_unit.py` (31 tests) — 检测逻辑单元测试，覆盖 7 条核心路径
-  - `test_routes_test.py` (48 tests) — 测试路由端点测试
-  - `test_routes_providers.py` (32 tests) — 提供商 CRUD 路由测试
-  - `test_routes_misc.py` (26 tests) — Webhook/日志/签名报告路由测试
-  - `test_routes_models.py` (34 tests) — 模型列表/能力/SSE 路由测试
-  - `test_routes_check.py` (23 tests) — 验证/SSRF/自动保存路由测试
-
-- **检测逻辑回归测试**:
-  - 锁定 `detect_provider()` 全部 7 条分支路径
-  - 覆盖 v4.2.1 修复的两个 bug（格式匹配跳过验证、多候选直接返回）
-  - 覆盖 402 余额不足识别、签名匹配阈值、超时处理等边界情况
-
-- **Bug 修复**:
-  - 修复 `test_tester.py` 中 `test_run_test_progress_callback` 缺失 `test_config` fixture 参数
-
-
-### v4.2.1 (2026-06-23)
-
-- **检测逻辑修复**: 
-  - 修复格式匹配跳过验证的BUG：当有多个候选者时，不再直接返回，而是继续进行并发探测验证
-  - 修复变量命名误导：`is_valid` 重命名为 `got_models`
-  - 清理死代码：删除不可达的500分加分逻辑
-
-- **删除/复制API认证修复**:
-  - 修复 `deleteKey()` 和 `copyKey()` 使用原生 `fetch()` 导致认证失败的问题
-  - 改为使用 `safeFetch()` 自动携带 Authorization header
-
-### v4.2.0 (2026-06-23)
-
-- **统一认证系统**: 复用加密密钥作为API认证token
-  - 新增 `derive_api_token()` 函数，从加密密钥派生API token
-  - 使用独立的 salt（`key-manager-api-auth-token-v1`）避免与存储加密交叉
-  - PBKDF2HMAC 600K迭代，32字节token，缓存机制
-  - 修改 `auth_middleware()` 自动fallback到派生token
-  - 扩展认证白名单，静态文件不需要认证
-
-- **前端自动携带token**: 无需手动配置
-  - 在 `templates/index.html` 的 `<head>` 中注入 `window.__API_TOKEN__`
-  - 修改 `safeFetch()` 自动添加 `Authorization: Bearer <token>` 头
-  - 修改 `models.js` 的SSE请求也携带token
-  - 在 `state.js` 中添加 `apiToken` 字段
-
-- **单个密钥删除功能**:
-  - 新增 `POST /api/keys/delete` API端点
-  - 前端添加删除按钮（垃圾桶图标）
-  - 使用项目标准的 `showConfirm` 确认框
-
-- **自动保存检测密钥**:
-  - 检测密钥后自动保存到注册表
-  - 更新密钥状态和检测记录
-
-- **复制完整密钥功能**:
-  - 新增 `POST /api/keys/get-full-key` API端点
-  - 前端点击密钥可复制完整密钥
-
-- **测试验证**:
-  - 全量测试通过：687 passed, 1 skipped
-  - 覆盖率：75.72%（超过 60% 要求）
-  - 新增 5 个 `derive_api_token()` 单元测试
-
-- **可选加密开关**: 支持明文存储，便于本地开发
-  - 新增 `storage.encrypted` 配置项（默认 `true`）
-  - 设置 `encrypted: false` 可关闭加密，以明文 JSON 存储密钥
-  - `load()` 自动检测文件格式，兼容已有加密/明文文件
-  - 修复 `_load_keys_data()` 解密失败时抛出异常而非返回空字典（H1 修复）
-
-### v4.1.0 (2026-06-22)
-
-- **Web 模块技术债务优化**:
-  - 修复 `middleware.py` 中的死代码（`now - 300.0` 表达式未使用）
-  - 提取 `build_chat_url()` 工具函数，消除 3 处重复的 Chat URL 构造逻辑
-  - 提取 `resolve_provider()` 工具函数，消除 5 处重复的提供商检测+验证模式
-  - 修复 `keys.py` 中弃用的 `datetime.utcnow()`，改用 `datetime.now(timezone.utc)`
-  - 为所有静默异常块添加 `logger.debug()` 日志记录
-  - 将内联导入（`import re as _re`、`import time as _time`）移至模块顶部
-  - 统一 `test.py` 模型端点的错误响应格式，使用 `ErrorResponse` 替代原始 dict
-  - 删除 `_app.py` 中的重复注释
-  - 代码行数减少 ~110 行，新增 `web/utils.py` 共享工具模块
-
-- **操作日志清理功能**:
-  - 新增 `DELETE /api/logs` API 端点，支持清理当天或指定日期的主日志
-  - 新增 `ProjectLogger.clear_main_log()` 方法
-
-- **测试验证**:
-  - 全量测试通过：682 passed, 1 skipped
-  - 覆盖率：78.40%（超过 60% 要求）
-
-- **前端清理优化**:
-  - CSS: 添加缺失的 `--neon-cyan-dim` 变量，新增 `.btn-sm` `.btn-danger` `.url-input` `.toolbar-divider` 工具类
-  - CSS: Confirm 模态框和添加服务商表单的内联样式提取为 CSS 类
-  - CSS: 签名报告样式拆分到 `components/signature-report.css`
-  - CSS: 内联 `style=` 从 71 减少到 39，`onfocus`/`onblur` 从 10 减少到 0
-  - JS: 提取 `selectCustomOption`、`toggleCustomSelect`、`toggleLogs` 到 `ui-helpers.js`
-  - JS: 新增 `clearLogs()` 函数，带确认对话框
-  - HTML: `index.html` 从 531 行精简到 508 行
-
-### v4.0.0 (2026-06-21)
-
-- **前端模块化重构**: 将单体 `index.html` (4725行) 重构为模块化结构:
-  - CSS 拆分: 5个主题文件 + 7个组件文件
-    - `tokens.css` — CSS 变量
-    - `base.css` — 基础样式、布局、响应式
-    - `components.css` — 组件入口 (@import)
-    - `components/` — 7个独立组件 (button, form, card, table, stat, nav, overlay)
-    - `modals.css` — 模态框样式
-    - `animations.css` — 动画和过渡
-  - JS 模块化: 12个ES模块
-    - `state.js` — 全局状态管理
-    - `utils.js` — 纯工具函数
-    - `api/` — 9个API模块 (client, stats, keys, check, test, balance, models, providers, misc)
-    - UI模块: toast, progress, confirm, keys-table, providers, batch, modals, model-detect
-    - `init.js` — 入口点和事件绑定
-  - `index.html` 精简至 467行
-- **API模块拆分**: 按后端路由结构拆分前端API模块:
-  - `api/client.js` — 通用fetch逻辑 (safeFetch)
-  - `api/index.js` — 重新导出所有函数
-  - 每个路由模块对应独立文件
-- **静态文件服务**: 添加 `StaticFiles` 中间件
-- **错误处理增强**: loadKeys/loadStats 添加 try-catch 错误处理
-- **ES模块修复**: 修复 State 对象只读绑定问题
-
-- **Web模块重构**: 将单体 `web.py` (2094行) 重构为模块化包结构:
-  - `web/_app.py` — 应用入口 (239行)
-  - `web/middleware.py` — 中间件和错误处理器
-  - `web/progress.py` — ProgressTracker和SSE辅助
-  - `web/routes/` — 8个路由模块 (keys, check, test, balance, models, providers, stats, misc)
-- **测试套件重构**:
-  - 合并补充测试文件 (test_parser_supplement, test_validator_supplement, test_ssrf_supplement)
-  - 删除重复测试文件 (test_web_fixes)
-  - 修复 mock 路径以匹配新的 web 模块结构
-  - 提取共享 fixtures 和帮助函数到 conftest.py
-  - 移除冗余 @pytest.mark.asyncio 装饰器
-  - 修复速率限制中间件的测试隔离问题
-- **代码去重**: 消除 `api_check_single` 中的重复模型检查逻辑
-- **调试系统清理**: 移除 `sys.path.insert` hack，使用干净的可选导入模式
-- **重复路由修复**: 合并重复的 `GET /api/providers` 路由
-- **日志显示修复**: 修复日志显示为 `[object Object]` 的问题
-- **可扩展性**: 在 `routes/__init__.py` 中添加新路由、中间件和错误处理器的扩展指南
-
-- **提供商系统重构**:
-  - 删除 `check_model` 属性，改为先从 API 获取模型列表再测试
-  - 删除所有提供商中的冗余方法（build_headers, get_models, test_token_limit, test_concurrency, _probe, check_real）
-  - 标准提供商从 ~77 行减少到 ~5-8 行
-  - 总共减少 ~2,400 行冗余代码
-  - 添加 `chat_endpoint` 属性，自动从 `check_endpoint` 推导 chat completions 端点
-
-- **检测逻辑修复**:
-  - 修复检测逻辑不再因为 `/v1/models` 返回 200 就立即返回提供商
-  - `/v1/models` 只用于获取模型列表，不能判断提供商
-  - `/chat/completions` 返回 200 才能判断提供商
-  - 添加前缀匹配逻辑，支持共享前缀（如 `sk-`）的提供商检测
-  - 免费模型对检测非常重要，检测逻辑会测试所有模型包括免费模型
-
-- **文档更新**:
-  - 更新 README.md 的"提供商智能检测"部分，添加详细的检测流程说明
-  - 更新 docs/DEVELOPMENT.md 的"检测系统"部分
-  - 更新 docs/PROVIDER_REFACTORING_PLAN.md，添加"检测逻辑详解"部分
-  - 在 detector.py 中添加详细注释，说明 `/v1/models` 和 `/chat/completions` 的区别
-
-- **Bug 修复与改进**:
-  - 修复 SDK 文档方法名与实际不符（`get_keys()` → `keys()` 等）
-  - 修复删除密钥时报错 "No passphrase found"，新增自动生成加密密钥功能
-  - 修复签名验证报告端点 404 错误，改为动态生成报告
-  - 修复添加自定义服务商按钮缺失，新增前端 UI
-### v3.2.0 (2026-06-19)
-
-- **模型检测按模型测试**: 支持在模型检测模态框中直接测试Token限制和并发能力
-- **提供商管理UI**: 添加前端UI用于添加/管理自定义提供商
-- **移除check_model**: 从ProviderBase中移除check_model属性，提供商必须从API获取模型
-- **并发测试API改进**: 改进错误处理，提供详细错误信息
-- **提供商Token测试修复**: 修复提供商使用错误模型或错误API端点的问题
-- **余额API修复**: 修复支持余额查询的服务商的余额检测
-
-
-### v3.1.0 (2026-06-19)
-
-- **提供商自动发现**: 使用pkgutil自动发现替代47个显式导入
-- **提供商元数据属性**: 所有提供商声明display_name、key_prefixes等类属性
-- **默认实现**: test_token_limit、test_concurrency等方法现在是具体方法
-- **YAML配置支持**: 可在config.yaml中定义自定义提供商
-- **提供商Web API**: 添加/api/providers CRUD端点
-- **代码精简**: 39个标准提供商从~100行减少到~15行
-
-
-### v3.0.0 (2026-06-15)
-
-- **精确匹配修复**: 能力检测从子串匹配改为 ^$ 锚定精确匹配，修复 o1 误匹配 o1-mini 等问题
-- **API Bug 修复**: 修复 /api/stats/chart 运行时崩溃、/api/keys 和 /api/keys/export 丢失 key 字段
-- **测试补充**: 新增 8 个端点的测试（test/token, test/concurrency, models/capabilities, models/check, progress/stream 等）
-- **前端缓存优化**: 模型类型切换使用本地缓存过滤，不再重复请求 API
-- **Cherry Studio 同步工作流修复**: 修复 GitHub Actions 路径错误和验证脚本
-- **Autofill 样式修复**: 修复浏览器 autofill 导致输入框底色变白
-
-### v2.2.2 (2026-06-14)
-
-- **模型检测二级窗口**: 新增模型检测弹窗，支持搜索、类型筛选、全选、批量检测
-- **模型类型图标**: 显示模型能力图标（视觉/推理/联网/工具/嵌入/重排/免费）
-- **模型能力数据更新**: 从 Cherry Studio 同步最新模型能力数据（3184 条记录）
-- **检测逻辑优化**: DeepSeek 欠费密钥正确识别，不再误判为其他服务商
-- **指定模型检测**: 自动检测服务商时也支持指定模型检测
-
-### v2.2.1 (2026-06-14)
-
-- **检测逻辑修复**: 自动识别后必须调用 check() 验证 key 有效性
-- **签名匹配修复**: 状态码不再硬编码 401，使用实际状态码
-- **不可靠服务商**: ppio、nvidia、modelscope 不参与加分
-- **模型选择器**: 新增模型下拉框，支持选择具体模型检测
-- **Cherry Studio 同步**: 修复 ownedBy 映射（alibaba→dashscope 等）
-- **测试补充**: 新增 test_parser_supplement、test_ssrf_supplement、test_validator_supplement
-### v2.2.0 (2026-06-14)
-
-- **检测逻辑重构**: 添加三步检测逻辑（/v1/models → 并发测试）
-- **URL 修复**: 从 check_endpoint 提取版本路径，修复 OpenCode 等服务商 404 问题
-- **并发优化**: /v1/models 和 chat/completions 都并发调用
-- **超时控制**: 所有网络请求 5 秒超时
-- **模型同步**: 从 Cherry Studio 同步模型数据，支持 ownedBy 映射
-- **新增服务商**: OpenCode Go、OpenCode Zen
-
-### v2.1.2 (2026-06-11)
-
-- **Bug 修复**: 修复 `KeyManager.detect_provider()` 调用异步函数未 await 的问题
-- **测试扩展**: 提供商合约测试扩展至全部 44 个服务商
-- **测试新增**: 新增 `test_proxy.py`、`test_logger.py`、`test_tester.py`、`test_core.py`
-- **覆盖率提升**: 测试覆盖率从 74% 提升至 88%
-
-### v2.1.1
-
-- 初始发布版本
 
 ## 许可证