MailUI4Agents

jianf/MailUI4Agents

Fork 0

Commit Graph

Author	SHA1	Message	Date
JianFeeeee	7e5b11392f	fix(push): session_id 非空时必须是合法 UUID —— 它此前静默接受任意字符串，真 bug 就是这么活下来的 dsh（f07daac1 之后的 5fab8734）报：客户端一度把这个字段填成服务器地址（`AccountInfo.server` = `https://…/api/v1`），而这里只 TrimSpace、不看格式 ⇒ 不 400、不影响收信、不进日志；而投递路径也不看它（通知里的 session_id 来自邮件自己，见 notify/mail.go；dispatch 只用 token 的 Provider/Token）。两条路都不看 ⇒ 存了假值没有任何机制会报警，可它存在的唯一目的就是「点通知回到那条会话」。改动只有一条校验（非空才校验，空串仍合法 —— 契约允许"客户端还没进任何会话"）， 400 文案自带药方（写明"要么 UUID、要么留空"）。判据 `TestPushTokenSessionIDMustBeUUID` 四个用例：服务器地址顶替 / 随便一个词 / 空串 / 真 UUID。变体验证两个方向： · 去掉校验（连 import 一起去）⇒ 「非法」两条当场红（实际 200）； · 把判断写反（`err == nil` 才报错）⇒ 合法的真 UUID 也红 ⇒ 证明它不是"恒 400"。恢复后 `go test ./...` 全绿、`go vet` 干净。取舍：老客户端带旧值上报会吃 400，按契约 400 归静默 ⇒ 不打扰用户、只是那次不上报。 `push_tokens` 现为 0 行，没有历史脏值要清。	2026-09-17 19:42:41 +08:00
JianFeeeee	46fa7fa729	feat(push): 可选、配置式、多厂商的推送通道（HMS 为首个实现）用户要求：推送密钥必须是可选项（自部署后端不能写死推送方式），且要支持多厂商配置式接入 —— 每个用户各自部署服务器、自己选厂商、自己配凭证。所以落地成： · internal/push：通道抽象 + 工厂表（RegisterType），加厂商不改配置层与端点形状； HMS 只是第一个实现（internal/push/hms.go） · 配置在 PUSH_CONFIG（默认 <AGENTMAIL_DATA_DIR>/push.json），一项一个厂商，凭证走文件（app_secret_file / files.，建议 600）；环境变量只是可选覆盖 · 没配 = 整条推送路径连一次查库都不发生（shouldDispatch 早退）；单项配错（未知类型/密钥读不到/enabled:false）只跳过那一条，不影响启动 · push_tokens 表带 provider 维度 + 三个 /me/devices/push-token 端点；没配推送时端点照存并回 enabled:false（登记成功 != 服务端开了推送） · notify.Recipients 末尾异步挂钩：收件人名单直接用 SSE 那份 seen（两条通道共用同一份"谁该收到"的判据）；失败只记日志，绝不拖住收信 HMS 的形状是拿真凭证打线上接口问出来的（v1 + message.token[] + testMessage； payload/target 形状 v1 不认、v2 要服务账号 JWT）。未上架应用必须 test_message=true，单批 ≤10 token（MaxTokensPerRequest 声明）、每日 1000 条兜底（项目级额度）。实测：App ID + App Secret 能换到 access_token（3600s）；形状被线上服务接受。判据：repo 6 条 + push 12 条 + handler 3 组，全部做过变异验证* —— 过程中抓出两条假判据（异步分发与 t.Cleanup 赛跑而假绿；密钥文件优先级没被覆盖）并补掉。Go 全量测试与 go vet 干净。 ★ 未验：端到端真机送达（需要真机 token + 客户端按 com.jianf.agentmail 重编并签名，签名指纹还要在 AGC 登记）—— 从未真正发出过一条能到达设备的推送。详见 docs/HMS-PUSH-PLAN.md 的「实现状态」一节。	2026-09-15 11:21:00 +08:00

Author

SHA1

Message

Date

JianFeeeee

7e5b11392f

fix(push): session_id 非空时必须是合法 UUID —— 它此前静默接受任意字符串，真 bug 就是这么活下来的

dsh（f07daac1 之后的 5fab8734）报：客户端一度把这个字段填成**服务器地址**
（`AccountInfo.server` = `https://…/api/v1`），而这里只 TrimSpace、不看格式 ⇒
不 400、不影响收信、不进日志；而**投递路径也不看它**（通知里的 session_id 来自
邮件自己，见 notify/mail.go；dispatch 只用 token 的 Provider/Token）。
两条路都不看 ⇒ 存了假值没有任何机制会报警，可它存在的唯一目的就是
「点通知回到那条会话」。

改动只有一条校验（非空才校验，空串仍合法 —— 契约允许"客户端还没进任何会话"），
400 文案自带药方（写明"要么 UUID、要么留空"）。

判据 `TestPushTokenSessionIDMustBeUUID` 四个用例：服务器地址顶替 / 随便一个词 /
空串 / 真 UUID。**变体验证两个方向**：
  · 去掉校验（连 import 一起去）⇒ 「非法」两条当场红（实际 200）；
  · 把判断写反（`err == nil` 才报错）⇒ 合法的真 UUID 也红 ⇒ 证明它不是"恒 400"。
恢复后 `go test ./...` 全绿、`go vet` 干净。

取舍：老客户端带旧值上报会吃 400，按契约 400 归静默 ⇒ 不打扰用户、只是那次不上报。
`push_tokens` 现为 0 行，**没有历史脏值要清**。

2026-09-17 19:42:41 +08:00

JianFeeeee

46fa7fa729

feat(push): 可选、配置式、多厂商的推送通道（HMS 为首个实现）

用户要求：推送密钥必须是可选项（自部署后端不能写死推送方式），且要支持
多厂商配置式接入 —— 每个用户各自部署服务器、自己选厂商、自己配凭证。
所以落地成：

· internal/push：通道抽象 + 工厂表（RegisterType），加厂商不改配置层与端点形状；
  HMS 只是第一个实现（internal/push/hms.go）
· 配置在 PUSH_CONFIG（默认 <AGENTMAIL_DATA_DIR>/push.json），一项一个厂商，
  凭证走文件（app_secret_file / files.*，建议 600）；环境变量只是可选覆盖
· 没配 = 整条推送路径连一次查库都不发生（shouldDispatch 早退）；
  单项配错（未知类型/密钥读不到/enabled:false）只跳过那一条，不影响启动
· push_tokens 表带 provider 维度 + 三个 /me/devices/push-token 端点；
  没配推送时端点照存并回 enabled:false（登记成功 != 服务端开了推送）
· notify.Recipients 末尾异步挂钩：收件人名单直接用 SSE 那份 seen（两条通道
  共用同一份"谁该收到"的判据）；失败只记日志，绝不拖住收信

HMS 的形状是拿真凭证打线上接口问出来的（v1 + message.token[] + testMessage；
payload/target 形状 v1 不认、v2 要服务账号 JWT）。未上架应用必须 test_message=true，
单批 ≤10 token（MaxTokensPerRequest 声明）、每日 1000 条兜底（项目级额度）。
实测：App ID + App Secret 能换到 access_token（3600s）；形状被线上服务接受。

判据：repo 6 条 + push 12 条 + handler 3 组，全部做过**变异验证** ——
过程中抓出两条假判据（异步分发与 t.Cleanup 赛跑而假绿；密钥文件优先级没被覆盖）
并补掉。Go 全量测试与 go vet 干净。

★ 未验：端到端真机送达（需要真机 token + 客户端按 com.jianf.agentmail 重编并签名，
签名指纹还要在 AGC 登记）—— 从未真正发出过一条能到达设备的推送。
详见 docs/HMS-PUSH-PLAN.md 的「实现状态」一节。

2026-09-15 11:21:00 +08:00

2 Commits