Henry_Du/BYW-VoiceHub
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
134 Commits 1 Branch 0 Tags
81fd05b39afccde525693875ef415b18f5dd43e6
Commit Graph
134 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
Henry_Du 81fd05b39a feat(微信订阅): 自测接口支持 dryRun（不消耗额度）与 sendToAll（区分没额度/字段错） 2026-10-11 12:04:03 +08:00
Henry_Du b64ee5cbc6 fix(排期): 发布按钮不再兼任删除，清空排期改为显式操作并加服务端守卫 2026-10-11 01:15:24 +08:00
Henry_Du 28238ab00f test(微信订阅): 补上 SONG_REJECTED 驳回模板的映射与截断回归测试 2026-10-11 01:06:37 +08:00
Henry_Du 5962df638d ci(deploy): 工作流从 4 个 job 精简为 2 个，并启用 BuildKit registry 构建缓存 
- 删掉 preflight（npm ci + nuxt build）与 meta-warmup：Dockerfile 自己在容器内
  跑 npm ci + node scripts/memory-build.js，这两个 job 的产物从来没被 docker build
  用到，纯白烧 3-6 分钟，meta-warmup 还在 build-image 之前抢同一个 runner 的内存。
- 删掉每个 job 各自跑的 apt 换源 / 清华镜像 / git URL 重写：对镜像构建没有任何影响。
- buildx 从「装不上就硬失败/一大段兜底脚本」简化为「装得上就用（带 registry 缓存），
  装不上就退普通 docker build」，部署永不因 buildx 缺席而失败。
- 新增 BuildKit registry 缓存（--cache-from/--cache-to type=registry，tag :buildcache）：
  依赖安装层跨 run 复用，第二次之后的部署会快很多。
- 镜像标签改在 build-image 内计算（原先依赖 meta-warmup 的 outputs）。
- 新增 .gitattributes 强制 yml/sh 用 LF（core.autocrlf=true 会把 heredoc 写坏）。
 2026-10-11 00:14:22 +08:00
Henry_Du 3eff710d5d feat(微信订阅): 接入歌曲排期模板并加固部署流程 
订阅消息（小程序侧唯一能主动触达用户的通道）：
- 新增 server/utils/wechatSubscribeFields.ts：按微信字段类型裁剪值（thing≤20、
  phrase 必须 5 个汉字、time/date/character_string 各自上限），空白压成一行，
  北京时间 time 由 playTime 的开始时间生成，解析不出退化为当天 00:00。
- wechatSubscribeService 内置 SONG_SELECTED 模板（站长新给的那个模板 ID），
  并转发上述纯函数；notificationService.createSongSelectedNotification 现在会带上
  playDate/playTime/sequence，三个排期接口（schedule / publish / bulk-publish）补传 sequence。
- 新增 test/wechatSubscribeFields.test.mjs（10 例，node --test 全绿）。
- test-subscribe 管理接口支持 vars 覆盖并返回真实发送值，方便站长核对字段名。

部署流程（Gitea Actions 容器里没有 buildx 插件，旧流程在此硬失败）：
- 每个 job 各自安装/探测 docker-buildx（v0.19.3，走 gh-proxy 再退直连），
  不把 `buildx version` 当唯一依据；装不上时降级为普通 `docker build` 继续发布，
  不再因为缺插件整条流水线失败。

注意：SONG_SELECTED 的字段名（thing2/date4/time1/character_string3/phrase5）是按常见
命名推断的，需在公众平台后台核对；不一致时用环境变量覆盖，模板 ID 变更后老用户需重新授权。
 2026-10-11 00:04:14 +08:00
Henry_Du ebf1c3a127 perf(auth): 登录去掉一次冗余查库 + 缓存 2FA 查询 + 修掉 session_key 进日志 
登录实测约 232ms，其中 bcrypt 约 72ms、网络往返约 80ms 是不可省的计算/物理成本，
剩下的都是我们自己的开销。这次把能省的两处省掉（实测约 40ms，占登录耗时约 19%）：

1. 去掉「数据库连接检查」的冗余预检
   原来每次登录先 await db.select().from(users).limit(1) 只为"测连接"，
   紧接着又会真的查用户，连不上一样会报错 —— 纯粹多一次数据库往返。
   现在把那次真实查询包进 try，只有它失败才回报 503「数据库服务暂时不可用」，
   错误码与文案完全不变。

2. 缓存「这个账号有没有开 2FA」
   登录每次都查 userIdentities 找 TOTP，但绝大多数账号根本没开 2FA。
   新增 server/utils/totp-cache.ts：
     · 查到**没有** TOTP → 缓存 10 分钟，后续登录直接跳过查询
     · 查到**有** TOTP   → **不缓存**（安全优先：绝不能因为缓存而让刚开 2FA 的人被跳过验证）
   开启/关闭 2FA 的接口必须调用 invalidateTotpCache(userId)，已在
   server/api/user/2fa/{enable,disable}.post.ts 接上 —— 否则会有最长 10 分钟的验证空窗。
   该缓存不参与密码校验，最坏情况只是多查一次库。

3. lastLogin / lastLoginIp 的 UPDATE 不再阻塞响应
   登录时间与登录 IP 是审计信息，晚写几十毫秒、甚至这次写失败，
   都不影响用户能否登录。改为不 await（保留 .catch，避免 unhandledRejection）。

4. 安全修复：微信登录不再把 session_key 打进日志
   server/api/auth/wechat/login.post.ts 原来打印整个 jscode2session 响应前 500 字，
   而该响应含 { session_key, openid, unionid }。
   session_key 是敏感凭据（可解密用户数据、配合其他接口换取手机号），
   长期落在服务端日志里等于凭据落盘。
   现在只打印：顶层键名、errcode/errmsg、以及 openid/session_key/unionid 的
   存在性与长度（不打印值）；仅在"响应根本不是对象"时才打印截断原文
   （那种情况它不可能是合法凭据，且是排查被代理拦成 HTML 的唯一线索）。

已验证：
- 缓存逻辑用假 db 真跑过 5 个场景（命中缓存省下查询、失效后立刻重查、
  有 2FA 不缓存、多用户互不干扰、只失效指定用户）
- 4 个改动文件的相对 import 路径均存在；totp-cache 的导出与两处 import 对得上
- login.post.ts 抽走 TOTP 查询后已清理不再使用的 userIdentities / and 导入
- 文件编码 UTF-8 无 BOM、无乱码、括号平衡
 2026-10-01 21:04:02 +08:00
Henry_Du 752a2eae87 feat(auth): 已登录账号绑定微信改为一键（不再要求填姓名密码） 
站长反馈：登陆进去的账号绑定微信就不用再写账号信息了吧。

原来的绑定只有一个入口 POST /api/auth/bind，它是**未登录**场景用的：
微信扫出来的是个陌生身份，得先"姓名 + 密码"验证身份，才知道该绑到谁头上。
用户已经在账号页里登录了，再让他输一遍账号信息就很别扭。

新增 POST /api/auth/wechat/bind-self { bindToken }：
- 必须已登录（用 event.context.user 直接落库，不再要密码）；
- bindToken 走原有 verifyBindingToken 校验；
- 该微信已经绑给**别人** → 409（不许抢绑）；
- 已经绑给**自己** → 幂等返回成功（重复点不报错）；
- 并发下唯一约束（23505）冲突也会复判一次，避免误报失败。

小程序端：
- utils/api.js 新增 bindWechatToSelf()（wx.login → wechat/login 拿 bindToken → 调新接口）；
- 「账号管理 → 绑定微信」与首页那条绑定提示都改成一步完成，
  不再跳绑定页填账号密码（绑定页保留给未登录场景：如登录页发现微信未绑账号时去注册/绑定）。
 2026-10-01 00:08:06 +08:00
Henry_Du cd6e235848 fix(users): 状态大小写不敏感 + 彻底修掉「无法编辑其它用户」 
站长反馈仍然无法编辑其它用户。上一版只把**小程序端**的状态改成小写，
但如果小程序没重新编译（或用的还是旧版本），发上来的仍是 `ACTIVE`，
服务端 `['active','withdrawn','graduate'].includes(status)` 依旧不通过 → 400
「用户状态只能是 active, withdrawn 或 graduate」——编辑任何用户都会失败。

这版把容忍度放到**服务端**，与客户端版本解耦：

- 新增 server/utils/user-status.ts：
  · USER_STATUSES = ['active','withdrawn','graduate']
  · normalizeUserStatus() 大小写不敏感（'ACTIVE' / ' Active ' → 'active'），认不出返回 null
  · USER_STATUS_RULE_MESSAGE 统一文案
- [id].put.ts：状态改用归一化值；另修正"自己只能改姓名"里的状态比较也忽略大小写
- [id]/status.put.ts、batch-status.put.ts：同样归一化；
  并修掉一个我自己引入的隐患（把归一化结果赋回 const 变量 → TypeError），
  batch-status 之前被误写成不存在的 statusesRaw，一并改正

效果：无论小程序是否重新编译，管理员都能编辑其它用户（含历史拼音账号只改年级）。
 2026-09-30 23:49:40 +08:00
Henry_Du deb71875c1 fix(users): 自己可改显示名、超管可在编辑里提升超管（修「保存失败/禁止修改自己的账户」） 
站长反馈：在 admin 模式下仍无法修改用户信息，弹「禁止在用户管理中修改自己的账户」；
另外角色下拉里没有「技术运维」。

1) 自己改自己：原来一律禁止 → 现在**只允许改姓名（显示名）**，其余（账号名/年级/班级/
   状态/角色/密码）只要动了就仍然拒绝。这样站长能在「用户管理」里把 admin 的显示名
   改成自己的名字（登录名仍是 admin，应急登录不受影响）。
   状态比较忽略大小写：库里是 active，客户端历史版本可能发 ACTIVE，不该因此判定"改了状态"。

2) 超管可在通用编辑接口里把别人提升为 SUPER_ADMIN（站长要求下拉里要有「技术运维」）：
   新增 allowPromoteBySuper 例外 —— 仅当登录者是 SUPER_ADMIN、目标角色设为 SUPER_ADMIN、
   且目标不是初始账号（ID=1，本来就是超管）时放行；非超管仍被 canChangeRoleOf 拦住。
   与 POST /api/admin/users/{id}/promote-super 效果一致，两条路都能走。
 2026-09-30 22:58:10 +08:00
Henry_Du dfb4891022 fix(users): 只校验"真的改过"的姓名/账号名，修回"管理员无法编辑其他用户" 
站长反馈：管理员无法编辑其他用户信息了。

根因：「姓名/账号名必须纯中文」的校验是**每次编辑都重新做一遍**的，
所以历史账号（早期用拼音/英文建的、名字里带「·」或空格的）连"改个年级"
都会被这条规则拦死 —— 管理员等于没法维护这些账号。admin 账号之前也是同一个毛病。

改成与服务端同一口径的"只校验改动过的字段"：
- 没改动 → 不校验（历史数据原样保留，不强迫改名）；
- 改了 → 必须满足规则（纯中文；admin 账号的姓名例外）；
- 主动把中文名改成拼音/带空格 → 仍然拦。

初始管理员（ID=1）的规则不变：登录名必须保持 admin、角色锁死、密码不在这里改。

（对应的小程序端同样改成"只校验改动字段"：编辑时记下原始姓名/账号名，
提交时比对；新增时两个字段都校验。）
 2026-09-30 22:02:14 +08:00
Henry_Du 792b3d4ef6 feat(users): 初始管理员可改显示名（登录名锁死 admin）+ 新增「提升为超级管理员」 
站长诉求：想自定义 admin 账号的资料，但**必须保留 admin/admin123 作为应急登录**；
同时想用自己绑了微信的中文账号做日常管理。

按"哪些能改、哪些必须锁死"拆开处理：

1) server/api/admin/users/[id].put.ts —— 原来对 ID=1 **一律 403**（连显示名都改不了），
   现在：
   · 允许改：姓名（显示名）、年级、班级、状态；
   · 锁死：登录名必须保持 admin（那就是 admin/admin123 的应急通道，改了就登不进去）；
   · 锁死：角色不能动（防止把自己降权导致没人能管站点）；
   · 锁死：密码不在这里改（避免被其它管理员顺手重置；要改用它登录后去「设置」里改）。

2) 新增 POST /api/admin/users/{id}/promote-super —— 把某个账号提升为超级管理员。
   之所以单开接口而不是放开通用编辑接口的 role：原 `canChangeRoleOf()` 明确禁止提升为
   SUPER_ADMIN，两个前端的角色下拉也故意不给这一项。这里是**显式、可审计**的通道：
   仅 SUPER_ADMIN 可调、不能提升自己、已经是超管的会提示、成功后清该用户认证缓存。

前端（小程序）配套：用户管理操作菜单改成 {label, run} 数组（有权限时才出现"提升为超级管理员"，
不再靠写死 tapIndex），点击有二次确认并列出会拿到的权限；编辑初始管理员时登录名输入框 disabled
并显示原因，姓名照常可改。
 2026-09-30 21:42:59 +08:00
Henry_Du 5039ab3f79 feat(auth): 账号名必须是纯中文，唯一例外是管理员账号 admin 
站长要求：账号名除了 admin 其它都必须是中文名。

原来「只能包含汉字」的校验散在 5 个写入路径上，而且**没有 admin 例外** ——
导致连 admin 账号自己都编辑不了（改任何字段都撞「姓名和用户名只能包含汉字」）。

- 新增 server/utils/username.ts：规则一处定义
  · isValidUsername：纯中文，或恰好是 admin
  · isValidPersonName：姓名纯中文，但 admin 账号的姓名不做限制
  · 统一提示文案（接口报错与客户端提示共用同一句）
- 5 个写入路径全部改用它，并删掉各自的 chineseRegex：
  admin/users 新建、admin/users 编辑、admin/users 批量导入、auth/register、user/profile
- 注册时明确拒绝 admin（系统保留账号）

已验证：两端规则对 9 个用例结论完全一致；5 处均无旧正则；
admin 可编辑，拼音名（zhangsan / zhang.san / 张三1 / 带空格）一律被拦。
 2026-09-30 20:50:09 +08:00
Henry_Du 1a334bbf5c chore(brand): 补上 Admin/WorkflowTutorial.vue 的品牌名（上一个提交漏了路径） 
上一个提交把路径写成 app/components/WorkflowTutorial.vue（实际在 Admin/ 下），
git 报 pathspec 不匹配 → 这个文件没进那次提交，这里补上。
 2026-09-30 20:25:10 +08:00
Henry_Du cccaf36990 feat(brand): 站点品牌名统一为「宝一外校园点歌系统」 
站长要求全站一致（小程序端已单独提交）。本次只改**用户可见文案与默认值**：

- 服务端默认值/兜底：system-settings-defaults、admin/system-settings(GET/POST)、
  site-config.get、utils/siteUtils —— 原来是 'VoiceHub' / '校园广播站点歌系统'
- 用户可见通知文案：MeoW 绑定验证码与标题、MeoW 测试通知、微信订阅测试通知
- 2FA 应用名（authenticator.keyuri）、WebAuthn rpName（出现在系统密钥弹窗里）
- 网页版界面：首页副标题、后台侧栏品牌名、登录/注册/找回/改密标题与文案、
  年度回顾（IntroSlide / ShareCard / 页面标题）、用户教程、通知发送预览、
  API 密钥与数据库导入说明、酷狗 sidecar 说明、打印页脚与歌单卡片页脚、Logo alt

**刻意不动**：localStorage/sessionStorage 的 `voicehub_*` 键、`voicehub:` 前缀的
STORAGE_KEY 与缓存/Redis 前缀、`window.voiceHubPlayer` 之类代码标识、MeoW 的
User-Agent、以及上游项目链接 `github.com/laoshuikaixue/VoiceHub`（那是对原项目的署名）。

注意：站点名**数据**（systemSettings.siteTitle）仍是你后台里设置的「宝一外校园点歌」，
代码只保证默认值与文案一致；要让全站显示完整名称，请在后台「站点配置 → 站点标题」
改成「宝一外校园点歌系统」。
 2026-09-30 20:24:55 +08:00
Henry_Du 9d3edc2c5e feat(kugou): 凭证支持环境变量兜底（配一次永久用）；补 deploy.yml 变量映射 
站长问「能不能跳转到酷狗 App 登录」—— 平台不允许（小程序无法启动任意原生 App），
而且即使跳过去，App 内的登录态也只在那台手机上，不会回传给服务端。
所以真正的便利做法是「凭证配一次、长期复用」：

- kugouService.kuGouFetch：cookie/token 增加 KUGOU_ADMIN_COOKIE / KUGOU_ADMIN_TOKEN
  兜底读环境变量；优先级 显式传入 > 库里绑定 > 环境变量
  （库里绑定的优先，所以之后想临时换一份 Cookie 仍可在后台粘一次覆盖）
- status.get.ts：bound 增加 source: 'db' | 'env' | 'none'，界面能说清凭证从哪来
- deploy.yml：KUGOU_ADMIN_COOKIE / KUGOU_ADMIN_TOKEN 三处齐全
  （step env: 映射 + ENV_PAYLOAD export + upsert_env_key），并用 ${VAR:-} 兜底 ——
  少任何一处都会像上次那样 unbound variable 直接把部署打挂

已用脚本校验：payload 占位符/参数 23/23 对应、远端脚本 30 个变量都有来源、
两个新变量三处齐全。
 2026-09-30 19:16:55 +08:00
Henry_Du af50ff1d95 feat(kugou): 支持粘贴浏览器 Cookie 绑定酷狗（不再必须扫码） 
站长要求去掉扫码：扫码必须拿另一台装了酷狗 App 的手机，很别扭。

技术上完全可行 —— kuGouFetch() 本来就是**无状态**的：它把库里
kugouAdminCookie 放进请求头、kugouAdminToken 放进 query 去调 sidecar。
扫码只是获取 cookie 的一种方式，不是同步的前置条件。

新增 POST /api/admin/kugou/bind-cookie {cookie, token?}：
- 写入前先用这份凭证探一次 /login/status，无效/过期的凭证**不落库**
  （避免出现看起来绑定了但同步全失败的假绑定）
- 有效则写入 systemSettings 的 kugouAdmin* 字段（与 qr-check 完全相同的落点）+ 刷新缓存
- 连不上 sidecar 时返回 502 并提示去「服务设置」检查酷狗 API 地址
- 只保存会话 Cookie，**不接收也不保存酷狗账号密码**

qr-create / qr-check 保留未删（网页版可能还在用）。
 2026-09-30 19:09:26 +08:00
Henry_Du 17f2aa7fcd fix(deploy): 把 WECHAT_MINI_SUBSCRIBE_TEMPLATES 加进 ENV_PAYLOAD（远端 unbound variable） 
上一次只补了 step 的 env: 映射，但那只是【本地】runner 侧；
远端脚本的变量是靠 ENV_PAYLOAD 逐个 export 过去的。于是远端
set -euxo pipefail 读到未定义的  直接退出：
  bash: line 71: WECHAT_MINI_SUBSCRIBE_TEMPLATES: unbound variable
部署到生产服务器这一步就这样挂了。

现在两处都齐：step env: 映射 + ENV_PAYLOAD 的 export（并用  兜底，
Secret 没配也不会 unbound）。

验证（Git Bash 实测）：
- printf 占位符 21 个 vs 参数 21 个一致，payload 含新变量
- source 生成的 env 脚本（set -u）→ 变量有定义、JSON 原样保留
- Secret 为空 → 定义为空字符串，同样安全
- 另外扫了整个远端脚本：引用的 29 个大写变量都有来源（payload 或自赋值）
 2026-09-27 15:37:58 +08:00
Henry_Du 64a81393b5 fix(notify): 环境变量只给模板 id 时保留内置的字段映射 
站长在 Gitea 里设了 WECHAT_MINI_SUBSCRIBE_TEMPLATES。若值里只写 id 不写 fields，
原来会把该模板的字段映射整个替换掉 → buildTemplateData 退回默认映射
（thing1/time2/thing3）→ 发给微信直接 47003。

现在按键合并：给了 fields 就用，没给就沿用内置的（SONG_REJECTED: thing6←songTitle,
thing4←reason）。坏 JSON / 裸字符串 / 空对象一律忽略，仍用内置模板。

已验证（8 项断言）：内置默认、只给 id（保住映射）、id+fields（完全覆盖）、三种坏值。
 2026-09-27 15:30:17 +08:00
Henry_Du 575e8b9f57 fix(deploy): .env 写入改成引号自适应（JSON 用单引号），并去掉 awk 的值截断隐患 
两个真实问题：
1) upsert_env_key 一律用双引号包裹 → JSON 值（含双引号）会写成
   KEY={a:b} 这种坏行，docker compose 解析会崩/取到残缺值；
   现在：值里含双引号就用单引号包（JSON 不含单引号，安全）。
2) 原来用 awk 'BEGIN{FS=OFS==} =...' 重建行，会把值里 = 之后的内容丢掉
   （base64 密钥常带 = 填充）→ 改用 grep -v + 追加，值原样保留。

已用 Git Bash 对函数本身做单测（8 项断言全过）：JSON 单引号包裹、带 = 的值不丢、
普通值双引号、重复更新不堆行、sed 取回后 JSON.parse 成功。
 2026-09-27 15:29:32 +08:00
Henry_Du 08a37e4e2f chore(deploy): 补上 WECHAT_MINI_SUBSCRIBE_TEMPLATES 的 secrets 映射 
少了这一行时，下面 upsert_env_key 拿到的永远是空值 ——
即使站长在仓库里配了 Secret 也不会写进服务器 .env（静默失效）。
驳回通知的模板已内置在 DEFAULT_TEMPLATES，这一项只在换模板/再加通知类型时才需要。
 2026-09-27 15:26:42 +08:00
Henry_Du d26996350e feat(auth): 注册时可顺带绑定微信（微信登录发现未绑账号 → 引导注册） 
- register.post.ts 接受可选 bindToken：注册成功后把该第三方身份插到新账号上
  · 绑不上**不影响注册**（账号已建好），返回 wechatBound=false + wechatBindError
  · 令牌无效/过期只记日志；唯一约束冲突按已绑定处理
  · 顺便把 token 返回给非浏览器客户端（小程序省掉一次重复登录）
 2026-09-27 14:17:20 +08:00
Henry_Du a2ba15c3ca feat(notify): 微信订阅消息推送（驳回通知已对接） 
- 新增 server/services/wechatSubscribeService.ts：access_token 缓存 + 模板配置 + 字段裁剪 + subscribe/send
  · 内置默认模板 SONG_REJECTED（模板 ID erAK**…，审核内容=thing6←歌名，驳回原因=thing4←驳回原因）
  · 环境变量 WECHAT_MINI_SUBSCRIBE_TEMPLATES 可按键覆盖默认模板
  · thing 字段按微信限制裁到 20 字（超长截 19 字 + 省略号），避免 47003
  · 发送永不抛异常；43101（用户没授权/没额度）只记 info
- 新增 server/api/user/wechat-subscribe-templates.get.ts：给小程序返回模板 ID（客户端要拿它去申请授权）
- 新增 server/api/admin/wechat/test-subscribe.post.ts：超管自测接口（token/openid/字段/微信原文一次看清）
- notificationService.ts：歌曲被选中/已播放/被驳回/系统通知 四处顺带发微信订阅消息
- .env.example + 部署流水线：WECHAT_MINI_SUBSCRIBE_TEMPLATES 可用仓库 Secret 下发
 2026-09-27 13:55:55 +08:00
Henry_Du a080144a86 fix(wechat): jscode2session 需显式 responseType=json，否则 ofetch 不解析响应 2026-09-27 08:47:56 +08:00
dsh-agent 565d6e0fcb feat(api): 新增通用二维码接口 /api/qrcode 
小程序没有任何 API 能直接唤起系统浏览器离开小程序打开网址，
唯一能真正离开小程序的官方途径是「长按图片 → 识别图中二维码」。
本接口把 URL 渲染成二维码图片（返回 base64 data URL），供小程序端
<img src> + show-menu-by-longpress 使用，让管理员能在微信内置浏览器里
打开完整网页版后台。

安全：需登录；只接受 http/https；长度上限 512。
 2026-09-26 21:38:50 +08:00
DeepSeek Harness 9db42861e1 fix(server): 补上 DatabaseManager 缺失的连接池与性能方法 
DatabaseManager 类从未定义 getConnectionPoolStatus / getPerformanceMetrics，
但有 4 个接口直接调用它们，导致运行时 TypeError 并返回 500：

  GET  /api/admin/database/pool-status
  GET  /api/admin/database/performance
  GET  /api/system/status
  POST /api/system/reconnect

两个函数本就实现在 utils/database-health.ts（getConnectionPoolStatus /
getDatabaseMetrics），这里补上委托方法，调用点无需改动。

验证：用项目的 .nuxt/tsconfig.server.json 做 A/B 类型检查，
改动前有 4 处 'Property does not exist on type DatabaseManager'，
改动后全部消失（总报错数 682 -> 678）。
 2026-09-26 16:21:28 +08:00
Henry_Du 3614ac6350 fix(schedule): 修复排期重排接口因变量遮蔽而必然报错 
sequence.post.ts 中 \const { schedules } = body\ 在 try 作用域内遮蔽了从
schema 导入的 Drizzle 表对象，导致 db.update(schedules) 实际传入的是请求体
数组而不是表，接口一被调用就抛错（网页版的拖拽排序同样受影响）。

改用 scheduleItems，并补注释说明该陷阱。
 2026-09-26 15:12:07 +08:00
Henry_Du 89cc80911e fix(deploy): 让部署工作流把 WECHAT_MINI_APPID / WECHAT_MINI_SECRET 同步进远端 .env 
此前工作流只透传写死的 6 个 OAuth 变量，即便在 Gitea 仓库密钥里配好 WECHAT_MINI_*，
也不会被读取，容器内始终缺少这两个变量（/api/auth/wechat/login 恒报 500 服务器未配置小程序凭据）。

- deploy job 的 env 块增加两个密钥映射
- ENV_PAYLOAD 增加对应 export，并补齐 printf 实参（保持格式串与实参一一对应）
- 远端 .env 合并逻辑：条件放宽为「OAuth 或小程序凭据任一已配置」，并 upsert 两个新键
- 日志前缀由 [OAuth] 统一为 [Runtime-env]，避免误导

已用 yaml 解析器校验工作流语法，编码与 CRLF 换行均保持不变。
 2026-09-26 14:56:03 +08:00
Henry_Du 39375c23f2 fix(open-api): schedules 的缓存/Redis 分支补齐 voteCount，消除分支间字段不一致 
上一步只给数据库分支补了 voteCount，但实测该接口通常命中缓存分支，
导致 voteCount 依然缺失。抽出 buildVoteCountMap() 供三条分支共用，
保证无论缓存命中与否，输出结构一致。
 2026-09-26 14:30:02 +08:00
Henry_Du 12dac95e1b feat(auth): 新增微信小程序登录（绑定策略：首次用学号密码绑定） 
- 新增 POST /api/auth/wechat/login：用 wx.login 的 code 换 openid；已绑定直接签发 JWT 返回，未绑定返回 bindToken
- bind.post.ts：支持从请求体读取 bindToken（小程序不便维护 cookie），绑定成功后返回 token，供 Authorization: Bearer 使用
- auth-route-policy.ts：把新接口登记进免鉴权白名单，否则会被鉴权中间件拦截
- .env.example：新增 WECHAT_MINI_APPID / WECHAT_MINI_SECRET
 2026-09-26 13:57:24 +08:00
Henry_Du a140ce8621 fix(open-api): 修复开放API两处缺陷并支持小程序取 token 
- songs.get.ts: 引用未定义变量 songsWithDetails 导致 /api/open/songs 缓存未命中时必然 500，改为 formattedSongs；并让缓存分支兼容 requester 为字符串的情况，避免返回 { name: undefined }
- schedules.get.ts: 数据库分支补齐 sequence / played / song.voteCount，与此前只有缓存分支才返回这些字段的行为对齐（缺少 sequence 会让前端无法显示歌曲序号）
- login.post.ts: 响应体返回 token，便于小程序/App 通过 Authorization: Bearer 访问（不影响原有 httpOnly cookie 行为）
 2026-09-26 13:48:27 +08:00
Henry_Du 6f5aa625e6 feat(admin): 导入酷狗页同时保留「自动同步」与「手动生成照片」两种模式 
KuGouImporter.client.vue 顶部新增模式切换 Tab（默认自动同步），切换到「手动生成照片」即复用原有 PlaylistCardPage 流程：AdminMultiDatePicker 多选日期 → 逐日出排期列表 → 每一日独立「生成该日图片」按钮 → PlaylistCardGenerator 弹窗下载 2:3 卡片 PNG。两套模式各自维护日期选择/排期读取状态，互不阻塞。

UI/Icon.vue 补 layout / image 两个 SVG 图标适配新入口。旧 PlaylistCardPage.client.vue 仍保留不作删除以免回退需求。
 2026-09-19 14:15:45 +08:00
Henry_Du 381f3debf1 fix(admin+server): 酷狗 baseUrl 默认值移除 127.0.0.1 + 新增后台配置入口与推荐快捷地址 
问题：容器内 SystemSettings.kugouApiBaseUrl 默认 http://127.0.0.1:3000 指向自己，sidecar 不可达。

修复：1) schema + migration 移除 kugouApiBaseUrl 默认值；kugouService + status API 兜底改空串（不再假设有 localhost），优先级 env(KUGOU_API_BASE) > DB。

2) 新增 POST /api/admin/kugou/settings：ADMIN+/SUPER 即时写 kugouApiBaseUrl 入库+刷新 CacheService。

3) KuGouImporter.client.vue 左栏新增 baseUrl 输入框（回车即存）+ 保存并测试按钮 + 两个推荐快捷按钮（容器宿主 http://172.19.0.1:3000、公网中继 https://bywmusic.bzw-hheb.top/kugou）+ 当前生效地址显式提示。

4) UI/Icon.vue 新增 server / globe / save 三个 SVG 图标与上述入口配套。
 2026-09-19 13:40:59 +08:00
Henry_Du 6b3a83ebeb fix(schema): 补导入 jsonb 以解决生产构建 ReferenceError 
schema.ts L1 从 drizzle-orm/pg-core 导入列表漏 jsonb，导致打包产物 nitro.mjs 加载阶段抛 ReferenceError: jsonb is not defined 直接崩溃退出。三处使用：kugouAdminUser、missingSongs、rawResponse。
 2026-09-19 12:26:17 +08:00
Henry_Du a0184fdeb0 feat(admin+server): 酷狗对接 - 扫码绑定管理员账号 / 按排期自动创建酷狗日歌单 + 同步歌曲 
数据模型：SystemSettings 新增 kugouApiBaseUrl / kugouAdminCookie / kugouAdminToken / kugouAdminUser / kugouAdminBoundAt 5 字段；新建 KuGouPlaylistSync 同步历史表（12 字段 + playDate 倒序索引）。迁移脚本：app/drizzle/migrations/20260919143000_add_kugou_integration.sql

后端 Server：新增 server/services/kugouService.ts 封装 KuGouMusicApi sidecar 转发（自动拼 Cookie / Token header）；新增 6 个 admin/kugou 路由：status / qr-create / qr-check / unbind / sync-schedule-playlists / sync-history。同步核心：逐日出非草稿排期 → kgHash 直取优先 → 失败用 cloudsearch/search 按标题+歌手三级召回 → /playlist/create + /playlist/tracks op=add 每 100 首分批；写同步历史（status、added/missing、歌单 URL）。

后台 UI：新建 Admin/KuGouImporter.client.vue 三栏布局——左栏 sidecar 健康卡+部署说明+扫码绑定/解绑弹窗；中栏多选排期日期+逐日出排期预览卡+按日同步；下栏最近 100 条同步历史（7 种状态 badge + 歌单链接跳转）。dashboard.vue L105 playlist-card 挂载点由 PlaylistCardPage 替换为 KuGouImporter；权限 permissions.js 5 个 ADMIN 族角色开放 playlist-card 页面访问（接口内部绑定/同步再强校验 ADMIN/SUPER_ADMIN）。

侧car要求：部署 KuGouMusicApi（参考文档 https://kugoumusicapi-docs.4everland.app），默认本机 http://127.0.0.1:3000，可通过 SystemSettings.kugouApiBaseUrl 或环境变量 KUGOU_API_BASE 覆盖。
 2026-09-19 11:57:02 +08:00
Henry_Du 573e168702 feat(admin-ui): 管理后台整体切换为浅色主题(ModernLight) + 新增 lightbulb 图标 
1. layout(管理控制台 dashboard.vue): main bg-[#09090b] text-zinc-100 → bg-[#f8fafc] text-zinc-900; header bg-zinc-950/60 border-zinc-800 → bg-white/80 border-zinc-200; 移动菜单按钮/新手引导按钮 text-zinc-300/400 hover:bg-zinc-800 → text-zinc-600 hover:bg-zinc-100 border-zinc-200

2. Admin/Sidebar.vue: bg-[#09090b] border-zinc-800 → bg-white border-zinc-200 + shadow-sm; 标题 text-zinc-100 → 900; activeTab bg-blue-600/10 text-blue-400 → bg-blue-50 text-blue-700 border-blue-200; 未选中 text-zinc-500 hover:text-zinc-200 hover:bg-zinc-800/40 → text-zinc-600 hover:text-zinc-900 hover:bg-zinc-100; 用户卡 avatar/首字母 bg-white/70 border-zinc-200 + 退出按钮 hover:bg-red-50 text-red-600

3. 批量 33 个 Admin 组件硬编码深色原子类 1414 处替换(bg-zinc-9xx / border-zinc-8xx / text-zinc-100,200,300 / shadow-black/ -> 对应 light 版本) + style 块原生 CSS rgba(255,255,255,x) 16 处改为 rgba(0,0,0,x) / var 浅色主题 + 硬编码 bg-[#0c0c0e] / border-white/10 / color:white / surface-primary fallback 对应浅色修正

4. 二轮批量追加: bg-zinc-950 + opacity 变体(80/60/50/40/30/20/10) 共 431 处 → bg-white 对应 opacity 版本；placeholder:text-zinc-800 → 500；text-blue/red/emerald/amber/rose/purple 400 版 → 700/600 深浅一致版；border color /500 /30 → 200；focus:ring /20 → /30；shadow color 阴影降低强度

5. hover:text-white 扫尾: 13 处 DataAnalysisPanel/DatabaseManager/NotificationSender/SemesterManager/SongManagement/UserSongsModal hover 文本从 white → zinc-900；按钮三态从 hover:bg-*600 白字 → hover:bg-*-100/200 对应深字色，和前台 indigo/浅色体系保持一致

6. BlacklistManager 前台可见提示 💡→ <Icon lightbulb amber-600 size=13>；ChangelogManager 徽章色从 emerald-300/blue-300/zinc-400 → emerald-700/blue-700/zinc-600 可读；Icon.vue 新增 lightbulb 分支 stroke 图标

7. 受影响文件: dashboard.vue + Sidebar.vue + Icon.vue + Admin/* (33个组件共 1874 处批量替换 + 20 处手工精细化修正)
 2026-09-19 08:30:59 +08:00
Henry_Du 357876a716 fix(ui+permission): 移除联合投稿 / emoji换SVG / 修复移动端浅色适配 / 已排期显示日期 / 隐藏.env提示 / 公开排期档期游客访问 
具体改动：

1. feat(投稿表单): 移除 RequestForm.vue 联合投稿功能整套模板+状态+payload+CSS(10处残留)

2. feat(图标): Icon.vue 新增 sparkles/star 图标; 首页档期卡片📅🎵✨和排期列表空状态🎵📅换成 lucide SVG Icon

3. fix(浅色适配): ScheduleList.vue 日期选择弹窗桌面端+移动端(content/header/h3/close-btn/item)全部改为 bg-primary + var text + indigo 主色, 修复竖屏选择日期标题白字看不见

4. feat(歌曲列表): SongList.vue scheduled-tag 内联追加 formatScheduleDate, 徽章+日期双胶囊显示

5. fix(登录): OAuthButtons.vue showPlaceholderHint 强制 false, 隐藏虚线框 .env 配置提示

6. fix(权限): server/middleware/auth.ts + auth-route-policy.ts 双白名单同步追加 /api/expected-play-dates GET 公共访问, 修复未登录 Authentication expired 401
 2026-09-19 00:43:46 +08:00
Henry_Du 25c7517405 fix(ui): 投稿须知卡片浅色化、搜索按钮indigo化、添加按钮几何风格 
- RequestForm 左侧投稿须知卡片：从 rgba(0,0,0,0.4) 黑透明改为 bg-secondary#f4f4f5 浅灰底+边+16px圆角，标题加粗深色
- 搜索输入框：从深色 input-bg 改为白底细灰边，indigo focus 环；搜索按钮从 blue 渐变胶囊升级为 indigo(#4f46e5→#6366f1) 渐变硬边12px+投影
- 联合投稿区域：section-label 改深字；添加按钮从 bg-tertiary+白字改为 浅灰底+深灰字 hover indigo 填充反白；标签 collaborator-tag 同步 indigo 淡底
 2026-09-18 23:48:16 +08:00
Henry_Du 87aa12d573 fix(ui): 优化投票/评论按钮样式、评论弹窗浅色化、投稿表单残留黑框修复 
- SongList 点赞按钮改用 indigo 渐变硬边圆角 12px，新增阴影；评论按钮从胶囊 blue 改为浅灰底 indigo 图标几何风格
- SongCommentsDialog 弹窗整体浅色化：bg-white 主底、评论卡片 zinc-50、输入框 focus indigo 环、发送按钮 indigo 主色系
- RequestForm 投稿表单：搜索结果容器从 rgba(0,0,0,0.4) 改为 bg-secondary 浅灰；备注输入框 bg-white；复选框/横条状态/手动输入按钮/提交按钮全套浅色 + indigo 主题
 2026-09-18 23:21:53 +08:00
Henry_Du 8a82cb77a7 fix(ui): 适配歌曲卡片、日期选择器、平台按钮及搜索占位图的浅色主题 
- 修复 SongList/ScheduleList 投稿人、热度、投稿时间文字对比度，统一引用 --text-secondary 主题变量
- 重构 CustomSelect 通用组件为浅色底 + indigo 主色系，适配前台投稿页日期选择
- 调整 RequestForm 平台按钮三态配色，激活态使用 indigo 渐变保持主题统一
- 重写 search.svg 全部 19 个 path fill 为深灰系列，解决浅色背景下占位图不可见问题
 2026-09-18 22:48:14 +08:00
Henry_Du 43f05a6e34 fix(ui): 适配前台浅色背景细节 
- 学校 logo 替换为黑字版本，修改 useSiteConfig 默认值和 fallback
- 首页通知卡片补齐浅色样式：status-tag（三态）、unread-indicator、
  invite-actions、accept-btn、reject-btn
- 投稿区域状态徽章由绝对定位改为搜索标题行内布局，背景改为浅色
- 消息设置页面整体改为浅色主题，主色系改为 indigo 以匹配 ModernLight
 2026-09-18 22:15:09 +08:00
Henry_Du 90e32ad086 ci(apt): Runner 自带命令已存在时跳过 apt-get update，避免卡 30-90s 
- 改动点: preflight + meta-warmup 两个系统准备 step 都引入 need_cmd/need_pkg 预探测
- 策略: git/curl/tar/xz/ca-certificates 任一缺包才跑一次 apt-get update + 批量 install，全部满足直接跳过
- 同时: apt 源替换前先 grep archive.ubuntu.com / security.ubuntu.com，避免破坏 Runner 已配的国内/公司镜像
 2026-09-18 21:36:31 +08:00
Henry_Du db685f26ba ci: 修复 npm ci EUSAGE @parcel/watcher 缺失并增加 install 兜底 
- 锁步: 本地 npm install --legacy-peer-deps 重新同步 package-lock，补齐 @parcel/watcher packages 段
- 兜底: deploy.yml 中 npm ci 全部重试仍失败后，自动降级 npm install --legacy-peer-deps 并写双份缓存
- 诊断: npm ci 失败时附带 node/npm/lockfileVersion 三元组，便于区分版本差与网络问题
 2026-09-18 20:49:42 +08:00
Henry_Du de52e4124c ci: preflight npm 升级到 11.x 以匹配 lockfile，修复 npm ci --install-links 报错 
- 根因: 本地 Node 24/npm 11.6.2 生成的 package-lock 与 Runner Node 22/npm 10.x 不兼容
- 修复: Preflight 安装依赖前先 sudo npm install -g npm@^11.6.2 对齐版本
- 增强: MAX_RETRY 2→3，失败时打印 node/npm/lockfileVersion 并附带自检命令
 2026-09-18 20:34:55 +08:00
Henry_Du 92704d6637 feat(front): 前台默认浅色模式并新增居中投稿按钮与实时空闲档期 
- 主题: useTheme 默认 ModernLight + variables.css SSR-safe 浅值并精修组件对比度
- 首页: 插入居中投稿 CTA + 紧邻档期概览卡片(今日排期/待播歌曲/空闲档期数)
- 数据: useSongs 新增 fetchExpectedPlayDates 接入空闲档期并走 revision 轮询实时刷新
- 视觉: 移动端优先，少圆角硬边几何 + 概览卡片 3→1 列响应式
 2026-09-13 19:32:27 +08:00
Henry_Du f80abe659f feat(frontend): 移动端底部导航与 Hero 插画及页脚浅色化 
- MobileBottomNav.vue(新增): 三 Tab 底部导航栏（点歌/排期/我的）
  lg 1024px 以上隐藏；iOS safe-area 兼容；点击平滑滚动或跳转 /account
- HeroIllustration.vue(新增): 纯 SVG 广播园艺六花瓣+麦克风插画
  紫粉蓝三色渐变花瓣+花蕊麦克风+三层虚线装饰环；viewBox 400×400
- SiteFooter.vue: 改浅色适配（白底+薄边+紫强调色 hover）
- index.vue: Hero 插图槽替换为 HeroIllustration；集成 MobileBottomNav；
  新增 handleMobileNav 响应底部导航点击事件
 2026-09-13 18:43:08 +08:00
Henry_Du 1a2031325b feat(frontend): 首页信息流与两大核心界面重构 
- index.vue: 移除 tabs 单选改为五区块纵向信息流（Hero/排期/歌曲/投稿/消息）
  新增 scrollToSection 平滑滚动与投稿成功自动跳转；为移动端底部导航预留 pb-24
- ScheduleList.vue: 移除左右分栏改为日期横条+时段分组紧凑卡片
  序号采用 28px w900 紫粉蓝渐变 bg-clip-text；卡片三态状态标签色区分
- RequestForm.vue: 序号选择从 pill 升级为 40×40 方格三态（free/taken/selected）
  taken 态删除线+灰色；selected 三色渐变+scale1.05；选中显示「已锁定第N首」提示
 2026-09-13 18:39:25 +08:00
Henry_Du e8eada885a feat(style): 前台强制切换浅色主题，保护后台管理页暗色 
- variables.css: 新增 body[data-frontend]:not(.admin-body) 作用域浅色系变量
  包含 --accent-purple/pink/blue 三色花点缀色，圆角上限 8px 硬边设计
- theme-protection.css: 前台页面及表单控件强制 color-scheme: light
- default.vue: onMounted 时为 body 注入 data-frontend=true 标记
- dashboard.vue: 根容器添加 admin-body class，阻断前台浅色变量污染
 2026-09-13 18:26:25 +08:00
Henry_Du c2114f0d82 fix(theme): 修复移动端深色主题被强锁浅色的问题 
- **移除 color-scheme: none**：`theme-protection.css` 之前对表单元素设置 `color-scheme: none`，会让 iOS/Chrome 等移动端浏览器在深色主题下仍将原生控件（滚动条、日期弹层、select 弹层、输入光标）渲染为浅色，造成"移动端都是浅色"的错觉。
- **按 data-theme 动态声明 color-scheme**：当 `data-theme` 结尾为 Dark 或等于 `dark` 时显式声明 `color-scheme: dark`，结尾为 Light 或等于 `light` 时声明 `color-scheme: light`，让浏览器的原生 UI 组件（包括表单弹层、滚动条、状态栏颜色）与我们的主题保持一致。
- **补充表单控件的深色 prefers-color-scheme 兜底**：在 `@media (prefers-color-scheme: dark)` 且未显式选择浅色主题时，同样把 color-scheme 锁为 dark，避免首次渲染闪烁。
- **修正 useTheme 中表单控件的 color-scheme 继承**：表单元素使用 `color-scheme: inherit`，从 :root 继承生效的 color-scheme，而不再强锁 none。
 2026-09-13 17:09:20 +08:00
Henry_Du 37fd18aaea fix(admin): 修复日期选择框尺寸过大与自动排入跨日期逻辑 
- **日期选择器尺寸优化**：AdminDatePicker 与 AdminMultiDatePicker 采用 w-9 h-9 的紧凑卡片，缩小字号、边距与圆角，贴合后台窄布局。
- **自动排入逻辑重构**：取消严格的 `expectedPlayDate === selectedDate` 过滤，改为按歌曲期望日期/时段自动分配 `playDate` 与 `playTimeId`；其他歌曲排到当前选中日期。
- **跨日期本地暂存池**：引入 `crossDateLocalPool` 保存尚未保存但已排入其他日期的临时排期，切换 `selectedDate` 或时段时正确回填对应日期的草稿，避免自动排入后切换视图导致丢失。
- **排期列表去重与过滤**：时段过滤逻辑修复 `playTimeId == null` 的边界，并在合并公开/草稿/本地暂存时按优先级去重。
 2026-09-13 16:18:09 +08:00
Henry_Du c4c30de416 feat(admin): 恢复按日期生成排期图片，重构多项体验问题 
- **导入酷狗功能恢复**：废弃纯文本解析，重写为通过多选日期加载对应排期，并支持“根据日期分别生成图片”的场景。
- **浅色打印主题**：在 SchedulePrinter 和 ScheduleItemPrint 中应用 !important 强制白底黑字，消除系统深色模式对预览与打印效果的干扰。
- **日期选择器精简**：彻底删除 AdminDatePicker 和 AdminMultiDatePicker 中的横向日期盘滚动功能，改用直观的选定日期展示，配合月历面板实现更稳定快捷的选择。
- **自动排入逻辑修复**：严格过滤并匹配歌曲的 `expectedPlayDate` 和 `preferredPlayTimeId`，修复无期望播出时间的歌曲被错误填入的问题。
 2026-09-13 15:49:05 +08:00