api-worker/helloagents/CHANGELOG.md

变更日志

[Unreleased]

微调

• [worker]: Durable Object 迁移改用 new_sqlite_classes 以兼容免费计划
  • 类型: 微调（无方案包）
  • 文件: apps/worker/wrangler.toml
• [admin-ui]: 令牌创建表单使用 FormData.forEach 以兼容缺少 entries 的类型定义
  • 类型: 微调（无方案包）
  • 文件: apps/ui/src/App.tsx
• [admin-ui]: 清理站点列表未使用变量以通过 lint
  • 类型: 微调（无方案包）
  • 文件: apps/ui/src/features/SitesView.tsx
• [worker]: 时间工具函数移除非空断言以满足 lint
  • 类型: 微调（无方案包）
  • 文件: apps/worker/src/utils/time.ts
• [admin-ui]: 站点管理新增一键测试并汇总结果提示
  • 类型: 微调（无方案包）
  • 文件: apps/ui/src/App.tsx, apps/ui/src/features/SitesView.tsx, apps/ui/src/core/sites.ts, tests/ui/sites.test.ts
• [admin-ui]: 编辑站点时站点类型/状态选择与当前值一致
  • 类型: 微调（无方案包）
  • 文件: apps/ui/src/features/SitesView.tsx:567-689
• [ci]: push 变更检测在 before 提交缺失时按全量变更处理并拉全历史
  • 类型: 微调（无方案包）
  • 文件: .github/workflows/deploy.yml:45-100
• [admin-ui]: 处理剪贴板异常时忽略未使用的错误变量
  • 类型: 微调（无方案包）
  • 文件: apps/ui/src/App.tsx:500
• [worker]: 创建渠道时 metadata_json 为空则写入 null 以满足类型约束
  • 类型: 微调（无方案包）
  • 文件: apps/worker/src/routes/newapiChannels.ts:293
• [admin-ui]: 令牌查看自动复制并提示
  • 类型: 微调（无方案包）
  • 文件: apps/ui/src/App.tsx:440-455
• [docs]: 补充本地开发流程、API 接口与 GitHub Actions 自动部署说明
  • 类型: 微调（无方案包）
  • 文件: README.md:12-272
• [worker]: 补齐 admin 静态目录占位以通过 wrangler assets 检查
  • 类型: 微调（无方案包）
  • 文件: apps/ui/dist/.gitkeep
• [worker]: 修正 wrangler assets 配置并为非 API 路由回退静态资源
  • 类型: 微调（无方案包）
  • 文件: apps/worker/wrangler.toml:15-19, apps/worker/src/index.ts:114-127
• [tooling]: 修复 bun check 脚本名称（移除尾随空格）
  • 类型: 微调（无方案包）
  • 文件: package.json
• [docs]: 补充云端部署与本地迁移的区分说明
  • 类型: 微调（无方案包）
  • 文件: README.md
• [ci]: 自动部署加入远程 D1 迁移步骤
  • 类型: 微调（无方案包）
  • 文件: .github/workflows/deploy.yml
• [ci]: 对齐 CloudPaste 风格的 SPA 自动部署流程与数据库初始化
  • 类型: 微调（无方案包）
  • 文件: .github/workflows/deploy.yml
• [docs]: 说明 SPA_DEPLOY 自动部署开关
  • 类型: 微调（无方案包）
  • 文件: README.md
• [admin-ui]: 渠道创建移除 ID 字段并校验名称唯一
  • 类型: 微调（无方案包）
  • 文件: apps/ui/src/main.tsx:250-287, 664-829
• [worker]: 全局记录收到的请求概要
  • 类型: 微调（无方案包）
  • 文件: apps/worker/src/index.ts
• [worker]: base_url 为空时返回空字符串避免崩溃
  • 类型: 微调（无方案包）
  • 文件: apps/worker/src/utils/url.ts
• [tooling]: dev 脚本改为 Bun workspace 执行
  • 类型: 微调（无方案包）
  • 文件: package.json
• [admin-ui]: 本地开发增加 Vite proxy 解决前后端端口不一致
  • 类型: 微调（无方案包）
  • 文件: apps/ui/vite.config.ts, README.md
• [worker]: 补充 wrangler.toml 示例配置占位
  • 类型: 微调（无方案包）
  • 文件: apps/worker/wrangler.toml
• [admin-ui]: 渠道 ID 与日志渠道可见，操作反馈更清晰
  • 类型: 微调（无方案包）
  • 文件: apps/ui/src/main.ts
• [worker]: 使用日志关联渠道/令牌，base_url 自动纠正
  • 类型: 微调（无方案包）
  • 文件: apps/worker/src/routes/usage.ts, apps/worker/src/routes/channels.ts, apps/worker/src/routes/proxy.ts
• [worker]: 渠道 ID 支持自定义，令牌可二次查看
  • 类型: 微调（无方案包）
  • 文件: apps/worker/src/routes/channels.ts, apps/worker/src/routes/tokens.ts, apps/worker/src/db/schema.sql, apps/worker/migrations/0002_add_token_plain.sql
• [admin-ui]: 渠道 ID 可录入、令牌查看按钮
  • 类型: 微调（无方案包）
  • 文件: apps/ui/src/main.ts
• [tests]: 补充 URL 规范化单测
  • 类型: 微调（无方案包）
  • 文件: tests/worker/url.test.ts
• [proxy]: 增加失败轮询重试与相关配置
  • 类型: 微调（无方案包）
  • 文件: apps/worker/src/routes/proxy.ts, apps/worker/src/env.ts, apps/worker/wrangler.toml
• [docs]: 更新代理重试与本地配置说明
  • 类型: 微调（无方案包）
  • 文件: README.md, helloagents/modules/proxy.md
• [worker]: 放宽路由严格匹配以兼容 /api/channel/ 尾斜杠
  • 类型: 微调（无方案包）
  • 文件: apps/worker/src/index.ts
• [worker]: 新增 /api/group 兼容接口并放行鉴权
  • 类型: 微调（无方案包）
  • 文件: apps/worker/src/index.ts, apps/worker/src/routes/newapiGroups.ts, tests/worker/newapi.test.ts
• [proxy]: 流式请求自动补 stream_options.include_usage 以获取 usage
  • 类型: 微调（无方案包）
  • 文件: apps/worker/src/routes/proxy.ts

[0.8.4] - 2026-02-25

变更

• [checkin/settings]: 定时签到改为始终启用，仅保留签到时间配置
  • 方案: 202602251706_checkin-always-on
• [admin-ui]: 设置页移除定时签到启用开关
  • 方案: 202602251706_checkin-always-on

[0.8.3] - 2026-02-25

修复

• [checkin]: 后端定时自动签到接入 Durable Object Alarm 调度
  • 方案: 202602251604_checkin-do-alarm
  • 决策: checkin-do-alarm#D001(采用 Durable Object Alarm)
• [checkin]: 修改签到时间后当日可再次触发自动签到
  • 方案: 202602251604_checkin-do-alarm

[0.8.2] - 2026-02-23

修复

• [proxy]: Responses 流式 usage 解析支持 response.usage
  • 方案: 202602230044_usage-parse-fix

[0.8.1] - 2026-02-23

变更

• [admin-ui]: 站点管理新增搜索与排序，移动端提供排序控件
  • 方案: 202602230005_site-sort-search
• [tests]: 增加站点搜索与排序单测
  • 方案: 202602230005_site-sort-search

[0.8.0] - 2026-02-22

变更

• [channels]: 连通测试改为遍历调用令牌并汇总模型与结果统计
  • 方案: 202602222335_multi-token-test-checkin-default-off
• [admin-ui]: 新增站点默认关闭自动签到，连通测试提示令牌统计
  • 方案: 202602222335_multi-token-test-checkin-default-off
• [tests]: 新增多令牌连通测试聚合单测
  • 方案: 202602222335_multi-token-test-checkin-default-off

修复

• [checkin]: 签到结果增加二次校验与非 JSON 响应判定
  • 类型: 微调（无方案包）
  • 文件: apps/worker/src/services/checkin.ts
• [checkin]: 已签到判定兼容 checkin_date 与“今日已签到”消息
  • 类型: 微调（无方案包）
  • 文件: apps/worker/src/services/checkin.ts

变更

• [sites/admin-ui]: 移除历史签到记录关联入口与 orphans 返回，简化站点签到提示
  • 类型: 微调（无方案包）
  • 文件: apps/worker/src/routes/sites.ts, apps/ui/src/features/SitesView.tsx, apps/ui/src/App.tsx, apps/ui/src/core/types.ts, apps/ui/src/core/constants.ts, helloagents/modules/sites.md, helloagents/modules/checkin.md, helloagents/modules/admin-ui.md
• [checkin/db]: 移除 checkin_sites 表与 /api/checkin-sites 路由，签到字段迁移至 channels
  • 类型: 微调（无方案包）
  • ⚠️ EHRB: 数据删除 - 用户已确认风险
  • 检测依据: DROP TABLE
  • 文件: apps/worker/src/index.ts, apps/worker/src/routes/sites.ts, apps/worker/src/services/checkin.ts, apps/worker/src/services/channel-repo.ts, apps/worker/src/services/channel-types.ts, apps/worker/src/db/schema.sql, apps/worker/migrations/0005_move_checkin_to_channels.sql, helloagents/modules/checkin.md, helloagents/modules/sites.md
• [sites/proxy/admin-ui]: 移除调用令牌的模型权限字段，改为按顺序选择令牌
  • 类型: 微调（无方案包）
  • 文件: apps/worker/src/routes/sites.ts, apps/worker/src/routes/proxy.ts, apps/worker/src/services/call-token-selector.ts, apps/worker/src/services/channel-call-token-repo.ts, apps/worker/src/services/channel-call-token-types.ts, apps/ui/src/features/SitesView.tsx, apps/ui/src/App.tsx, apps/ui/src/core/types.ts, apps/ui/src/core/constants.ts, tests/worker/call-token-selector.test.ts, helloagents/modules/admin-ui.md, helloagents/modules/proxy.md, helloagents/plan/202602221951_site-redesign/proposal.md
• [admin-ui]: 新增站点默认开启自动签到，并限制调用令牌列表高度
  • 类型: 微调（无方案包）
  • 文件: apps/ui/src/core/constants.ts, apps/ui/src/features/SitesView.tsx, helloagents/modules/admin-ui.md
• [admin-ui]: 站点弹窗设置最大高度并允许表单滚动，避免调用令牌过多导致超出屏幕
  • 类型: 微调（无方案包）
  • 文件: apps/ui/src/features/SitesView.tsx
• [checkin]: 对齐 /api/user/checkin 接口并增加 New-Api-User 头支持
  • 类型: 微调（无方案包）
  • 文件: apps/worker/src/services/checkin.ts, apps/worker/src/routes/checkin-sites.ts, apps/ui/src/features/CheckinSitesView.tsx, apps/worker/migrations/0002_add_checkin_sites.sql
• [checkin]: 站点字段命名为 userid，结果展示移动到列表列
  • 类型: 微调（无方案包）
  • 文件: apps/worker/src/routes/checkin-sites.ts, apps/ui/src/features/CheckinSitesView.tsx, apps/ui/src/core/types.ts
• [checkin]: 一键签到写回结果并跳过今日已签到站点
  • 类型: 微调（无方案包）
  • 文件: apps/worker/src/routes/checkin-sites.ts, apps/ui/src/features/CheckinSitesView.tsx, apps/ui/src/core/types.ts, apps/ui/src/core/utils.ts, apps/ui/src/App.tsx
• [settings]: 增加定时签到开关与时间配置（中国时间）
  • 类型: 微调（无方案包）
  • 文件: apps/worker/src/routes/settings.ts, apps/ui/src/features/SettingsView.tsx, apps/ui/src/core/types.ts, apps/ui/src/core/constants.ts, apps/ui/src/App.tsx, tests/worker/settings.test.ts
• [admin-ui]: 今日签到状态区分未签到与签到失败
  • 类型: 微调（无方案包）
  • 文件: apps/ui/src/features/CheckinSitesView.tsx
• [checkin]: 签到失败也标记当日状态，避免显示为未签到
  • 类型: 微调（无方案包）
  • 文件: apps/worker/src/routes/checkin-sites.ts
• [db]: 合并签到相关迁移到单一脚本
  • 类型: 微调（无方案包）
  • 文件: apps/worker/migrations/0002_add_checkin_sites.sql

[0.7.1] - 2026-02-22

变更

• [db]: 合并 0002-0005 迁移为单一 0002 并同步 schema
  • 方案: 202602222203_merge-migrations

[0.7.0] - 2026-02-22

变更

• [sites]: 站点重设计，支持系统令牌与多调用令牌、上游类型扩展与官方地址默认值
  • 方案: 202602221951_site-redesign
  • 决策: site-redesign#D001(调用令牌独立表), site-redesign#D002(系统令牌复用 checkin_sites), site-redesign#D003(done-hub 仅默认地址)
• [proxy]: 按调用令牌模型权限选择上游并移除 done-hub 多地址切换
  • 方案: 202602221951_site-redesign
• [admin-ui]: 站点管理重构为系统令牌 + 多调用令牌，并支持新上游类型
  • 方案: 202602221951_site-redesign
• [checkin]: 签到支持自定义地址优先并保留 new-api 自动签到
  • 方案: 202602221951_site-redesign
• [db]: 新增 channel_call_tokens 以存储多调用令牌
  • 方案: 202602221951_site-redesign

[0.6.0] - 2026-02-22

变更

• [sites]: 新增站点聚合接口与类型分类，支持自动关联签到记录
  • 方案: 202602221813_unify-sites
  • 决策: unify-sites#D001(渠道为主 + 签到绑定)
• [admin-ui]: 站点管理合并渠道与签到配置，支持类型字段与一键签到
  • 方案: 202602221813_unify-sites
• [checkin]: 签到记录关联渠道，仅对 new-api 站点执行
  • 方案: 202602221813_unify-sites
• [proxy]: done-hub 站点按多地址配置选择上游
  • 方案: 202602221813_unify-sites
• [db]: checkin_sites 增加 channel_id 关联字段与索引
  • 方案: 202602221813_unify-sites

[0.5.0] - 2026-02-22

新增

• [checkin]: 新增签到站点管理与一键签到
  • 方案: 202602221450_checkin-sites

[0.4.11] - 2026-02-22

变更

• [admin-ui]: 管理台移动端适配（导航抽屉、列表卡片、表格横向滚动）
  • 方案: 202602220036_mobile-ui

[0.4.10] - 2026-02-21

变更

• [ci]: D1 数据库名称调整为 api-worker
  • 方案: 202602212345_db-name-api-worker

[0.4.9] - 2026-02-21

变更

• [ci]: 部署流程新增 init 动作并仅首次初始化
  • 方案: 202602212329_deploy-init-action

[0.4.8] - 2026-02-21

变更

• [ci]: 部署流程支持按变更范围选择前端/后端并默认按迁移变更执行
  • 方案: 202602211446_deploy-workflow-auto

[0.4.7] - 2026-02-21

变更

• [tooling]: UI 目录从 apps/admin 迁移为 apps/ui 并同步配置
  • 方案: 202602211405_rename-admin-ui
• [ci]: 部署流程改用 apps/ui 与 api-worker-ui
  • 方案: 202602211405_rename-admin-ui
• [docs]: 文档与知识库路径更新为 apps/ui
  • 方案: 202602211405_rename-admin-ui

[0.4.6] - 2026-02-21

变更

• [tooling]: 统一工作区包名与脚本为 api-worker / api-worker-ui
  • 方案: 202602161825_rename-api-worker-ui
• [worker]: Worker 部署名称更新为 api-worker
  • 方案: 202602161825_rename-api-worker-ui
• [docs]: README 与知识库名称同步为 api-worker / api-worker-ui
  • 方案: 202602161825_rename-api-worker-ui

[0.4.5] - 2026-02-16

变更

• [admin-ui]: 令牌管理改为列表视图并支持分页弹窗创建
  • 方案: 202602161600_token-list-ui

[0.4.4] - 2026-02-16

修复

• [admin-ui]: 使用日志默认每页 50 条并修正本地时间显示
  • 方案: 202602161433_usage-log-fixes
• [usage/proxy]: 使用日志补充首 token 延迟、流式与推理强度记录
  • 方案: 202602161433_usage-log-fixes

[0.4.3] - 2026-02-16

变更

• [admin-ui]: 使用日志支持分页与指标拆分展示
  • 方案: 202602161355_usage-view-metrics

[0.4.2] - 2026-02-16

变更

• [deployment]: 管理台通过 Worker Static Assets 部署并补齐手动/自动部署流程
  • 方案: 202602161013_worker-assets-deploy

[0.4.1] - 2026-02-15

变更

• [admin-ui]: 管理台入口拆分为模块、扁平化 features，并将 AppShell 调整为 AppLayout
  • 方案: 202602152325_admin-ui-modularize
  • 决策: admin-ui-modularize#D001(功能域拆分)

[0.4.0] - 2026-02-15

新增

• [channels]: New API 标签批量权重/启用/停用接口
  • 方案: 202602152211_newapi-tag-sync

[0.3.1] - 2026-02-15

修复

• [proxy]: 增强 usage 解析以修复使用日志与数据面板 token 统计为 0
  • 方案: 202602151843_fix-usage-tokens

[0.3.0] - 2026-02-15

变更

• [admin-ui]: 管理台改为 Hono + TSX DOM 渲染并接入 Tailwind v4
  • 方案: 202602151628_admin-ui-hono-tsx-tailwind
  • 决策: admin-ui-hono-tsx-tailwind#D001(采用 Hono JSX DOM + Tailwind)

[0.2.1] - 2026-02-15

变更

• [tooling]: 切换为 Bun 作为包管理器，补充部署说明与 fix 命令
  • 方案: 202602150153_bun-tooling

[0.2.0] - 2026-02-15

新增

• [channels/auth/models]: 新增 New API 兼容渠道管理接口、用户模型接口与管理员令牌鉴权
  • 方案: 202602150127_newapi-channel-compat
  • 决策: newapi-channel-compat#D001(新增兼容层并保留扩展字段)

[0.1.0] - 2026-02-14

新增

• [核心服务]: 初始化 Worker + D1 后端与 Vite 管理台，提供渠道/模型/令牌/日志/面板与 OpenAI 兼容代理
  • 方案: 202602142217_new-api-lite
  • 决策: new-api-lite#D001(单 Worker + Hono), new-api-lite#D002(Vite + Pages), new-api-lite#D003(Token 默认全渠道), new-api-lite#D004(日志保留可配置)

修复

• [{模块名}]: {修复描述}
  • 方案: {YYYYMMDDHHMM}_{fix}

微调

• [{模块名}]: {微调描述}
  • 类型: 微调（无方案包）
  • 文件: {文件路径}:{行号范围}

回滚

• [{模块名}]: 回滚至 {版本/提交}
  • 原因: {回滚原因}
  • 方案: {原方案包}