spark-server/docs/daily/2026-09-24-change-list.md

每日变动 2026-09-24

11:12 — 新增 daily-change-list Agent Skill

概要

• 新增项目 skill：每次完成代码/配置/文档等实质性修改后，在 docs/daily/ 写入或追加当日变动 Markdown。
• 文件名格式：{yyyy}-{mm}-{dd}-change-list.md（示例：2026-09-24-change-list.md）。
• AGENTS.md 与 verify-before-done.mdc 已挂接该流程。

变更范围

类型	说明
文档 / 配置	Agent skill、daily 目录说明、Agent 与 verify 规则

主要文件

• .cursor/skills/daily-change-list/SKILL.md — skill 定义与模板
• docs/daily/README.md — 目录说明
• AGENTS.md — 第 7 条引用 skill
• .cursor/rules/verify-before-done.mdc — 完成前写入 daily

验证

• make test: skipped（仅 Agent/文档，无 Go 变更）

关联

• 用户请求：新增每日修改变动 markdown 流程

11:16 — daily 文件名改为 yyyy-mm-dd

概要

• 每日变动文件命名由 {yyyy}-{dd}-{mm} 调整为 {yyyy}-{mm}-{dd}（年月日 ISO 顺序）。

主要文件

• .cursor/skills/daily-change-list/SKILL.md
• docs/daily/README.md、AGENTS.md、.cursor/rules/verify-before-done.mdc
• docs/daily/2026-09-24-change-list.md（自 2026-24-09-change-list.md 重命名并更新文内日期）

验证

• make test: skipped（文档）

14:10 — Spark Messenger 主路径接入：好友拒绝 API + OpenAPI

概要

• 新增 POST /v1/friends/requests/reject，补齐 App 忽略/拒绝好友申请
• OpenAPI 补全 password-login / set-password / legal / feedback / subscriptions / reject
• 与 iOS SparkIMClient 主路径路由扩展配套

变更范围

类型	说明
功能	好友申请拒绝
文档	OpenAPI 路径补全
配置	client 模块与 popadmin 三页（同日 WIP）

主要文件

• internal/module/friend/logic/reject.go — Reject 用例
• internal/transport/http/handler/friend/handler.go / router.go — HTTP
• internal/transport/http/docs/openapi.yaml — 规范
• internal/module/client/**、migrations/0023_*.sql、deploy/popadmin/popadmin.js — 法律/反馈/订阅/密码

验证

• make test: skipped（本机 PATH 无 go）
• 需部署后刷新 https://sparkapi.wyrs365.com/docs

关联

• Spark Messenger 全页面接入检查

14:48 — 修复 make lint / make test

概要

• 修复 friend_test 中 Accept 双返回值与测试邮箱 OTP
• 修复 client 模块 goconst/gocritic/goimports；UpsertLegal/UpsertPlan 改为指针入参
• 补充 client/auth logic 单测以满足 65% 覆盖率门禁

主要文件

• internal/module/friend/logic/friend_test.go
• internal/module/client/logic/service.go、model/repo.go
• internal/module/client/logic/service_test.go
• internal/module/auth/logic/refresh_test.go、static_test.go
• internal/bootstrap/app.go、handler/friend/handler.go、handler/admin/client.go

验证

• make lint: pass
• make test: pass

15:22 — Git commit 前必须 make test

概要

• 新增 always-on 规则 git-commit-gate.mdc：Agent 与用户 commit 前须 make test 通过，禁止擅自 --no-verify
• 新增 scripts/git-hooks/pre-commit 与 make install-git-hooks 安装到 .git/hooks

主要文件

• .cursor/rules/git-commit-gate.mdc
• scripts/git-hooks/pre-commit
• Makefile、AGENTS.md

验证

• make test: pass

使用

make install-git-hooks   # 本机只需一次

14:55 — 意见反馈区分登录 / 游客

概要

• POST /v1/feedback 改为可选鉴权：有效 Bearer → auth_type=login + uid；无 token → auth_type=guest，必填 contact（邮箱或手机）
• 表增加 auth_type / contact；Admin list 支持 ?auth_type=login|guest；popadmin App反馈页加筛选下拉
• OpenAPI 同步说明

变更范围

类型	说明
功能	反馈登录/游客分流
数据库	migration 0024
管理端	popadmin 筛选
文档	OpenAPI

主要文件

• migrations/0024_feedback_auth_type_contact.sql
• internal/module/client/** — entity / logic / repo
• internal/transport/http/auth.go — /v1/feedback 可选鉴权
• internal/transport/http/handler/admin/client.go — auth_type 筛选
• internal/transport/http/docs/openapi.yaml
• deploy/popadmin/popadmin.js

验证

• make test: skipped（本机无 go）
• 需部署并执行 migration 后生效

关联

• 用户需求：意见反馈分登录与未登录

16:25 — 反馈用例补登录路径断言

概要

• 补充游客缺 contact 失败、登录态写入 auth_type/uid、AppVersion Header 回填的单测断言
• auth.go import 顺序整理

验证

• make test: skipped（本机无 go）