4.0.0

Copilot API 4.0.0

这个版本主要补齐了 Admin 公网访问的安全能力，并加入可配置的上下文压缩。建议所有需要在 VPS / 服务器上暴露 Admin 后台的用户升级。

主要更新

• 新增 Admin 独立登录页，后台不再只能依赖 Caddy Basic Auth 保护。
• 新增 Admin 管理密钥机制，支持 ADMIN_SECRET、ADMIN_SECRET_HASH，也支持首次访问 /admin/setup 初始化。
• /admin 与 /admin/api/* 已接入统一会话保护，登录后通过 HttpOnly Cookie 保持后台会话。
• 未配置管理密钥时继续保留本地兼容模式；配置后即可配合域名反代公网访问。
• Admin 页面新增安全状态、登录状态、退出登录、管理密钥更新等入口。
• 新增可配置 Context Management / 上下文压缩能力，支持在达到阈值后进行自动裁剪或摘要后裁剪，降低长会话溢出风险。
• 更新 README / 中文文档，补充 Admin 登录、反代访问、环境变量与上下文压缩说明。
• 补充 Admin 鉴权、路由保护、会话安全、上下文压缩等测试覆盖。

升级建议

如果需要公网访问 Admin，建议至少配置一个管理密钥：

docker run -d \
  --name copilot-api \
  -p 4141:4141 \
  -e ADMIN_SECRET='your-admin-secret' \
  -v copilot-data:/data \
  --restart unless-stopped \
  ghcr.io/qlhazycoder/copilot-api:4.0.0

如果使用 Caddy / Nginx 反代，反代层继续负责 HTTPS 和转发即可；后台登录由 copilot-api 自己处理。

注意事项

• ADMIN_SECRET_HASH 优先级高于 ADMIN_SECRET 和配置文件中的管理密钥。
• 管理密钥和业务 API Key 是两套独立配置，请不要混用。
• 已经公开暴露 4141 端口的部署，升级后请尽快配置 ADMIN_SECRET 或完成 /admin/setup 初始化。

Full Changelog: 3.0.0...4.0.0

3.0.0

3.0.0

主要改动

• 引入基于 supported_endpoints 的能力驱动路由，统一模型解析逻辑，并为 Chat Completions、Messages、Responses、Gemini 入口补齐能力校验与错误处理。
• 新增上下文预算管理能力，按模型上下文窗口约束请求体，并补强相关 tokenizer / payload 处理链路。
• 重构配置与运行时管理，新增运行时模型刷新与配置更新能力，提升路由、状态与服务端行为的一致性。
• 增强 Admin 的模型管理体验：支持隐藏模型管理与“全局禁用隐藏模型”策略，相关限制已联动到 /v1/models、模型解析与映射保存路径。
• 补充并修复多组测试，包括 runtime integration、context budget、session propagation 与配置存储相关测试。

2.2.0

2.2.0

主要改动

• 添加复制模型名称功能及相关提示信息

2.1.0

2.1.0

主要改动

• 新增 usage log 清理能力：支持清理当前账户和所有账户的用量日志。

2.0.0

2.0.0

本次合并重构了本地 usage log 的记录与展示逻辑，目标是让同一对话下的请求归并更符合实际使用场景，同时能更直观看到高级额度的累计消耗。

主要改动

• 统一 messages、chat-completions、responses、gemini 四类入口的会话 ID 提取与透传逻辑，并补充对 metadata.user_id 中 JSON session_id 格式的解析支持。
• 将按对话去重规则调整为 conversationId + endpoint + model + multiplier，同一对话下仅在这些关键字段一致时复用同一条日志；关键字段变化时新增一条日志。
• 新增本地额度增量计算逻辑，通过 firstPremiumUsed、lastPremiumUsed 与 multiplier 组合计算当前日志条目的额度增量，覆盖首条请求本身的消耗。
• 调整 usage summary 刷新策略，使每次请求都能更新对应日志的最新用量数据，从而支持额度增量持续增长。
• 更新管理页 Usage 表展示，移除来源和状态码列，补充更符合使用场景的展示字段。
• 保留对话诊断日志，但改为仅在开发模式下输出，避免生产环境产生额外调试噪音。
• 补充并更新相关测试，覆盖会话透传、去重策略、额度增量计算、内部请求跳过日志等关键路径。
• 移除 tsconfig 中已弃用的 baseUrl 配置，保留 paths 别名映射以兼容现有 ~/ 导入。

1.5.0

新增
新增端到端请求追踪透传能力（trace propagation）。
新增网关 API Key 鉴权中间件。
Admin 模型用量链路增加关联处理。
修复与优化
修复 reasoning 字段自动注入行为。
优化 Admin 限流设置 UI 与占位提示。
降低 Admin 设置接口复杂度，修复 lint complexity 问题。