修复审查发现的认证配置邮件协议及前端问题

补齐安全运行时清理、配置候选恢复、泛域名证书事务提交、邮件副本与协议边界、插件隐私和安装回滚回归,并更新修复状态及待验收清单。
This commit is contained in:
xuans committed 2026-09-06 13:02:02 +08:00
1 parent addfcea1cd
commit 6f79441585
71 files changed
+2853 -664

No files matched your search

+119 -11
View File
@@ -4,26 +4,77 @@
- 请求:对全部代码逐行审查,不能用搜索命中、编译成功或测试通过代替逐行检查。
- 开始时间:2026-09-06 01:46:05,时区 Asia/Shanghai。
- 基线:`9849f8f11c9f49efd1bc877d7fedd8da265e32df`,分支 `main`。
- 原始审查基线:`9849f8f11c9f49efd1bc877d7fedd8da265e32df`,分支 `main`。
- 审查前已建立中文提交检查点,远端 `smail/main` 已核验一致。
- 当前结论:**审查进行中,尚未完成全仓逐行覆盖;发现的问题尚未修复。**
- 本轮只新增隔离审查测试、覆盖工具和报告,未修改业务源码,未清空真实数据库,未停止开发服务。
- 修复阶段开始时间:2026-09-06 11:03:06;修改前检查点 `addfcea1cdb59f1fd28bd1639c54502cb05990de` 已提交并推送。
- 当前结论:**已实施业务修复并通过本节所列自动化回归,仍有部分修复及待真实验收项;尚未完成全仓逐行覆盖。**
- 本文保留 R01–R51 原始发现、原位置与失败证据,它们是历史审查记录,不代表修复后的当前行为。当前状态以“修复状态”和“修复后最终回归与构建”两节为准。
- 修复范围包含原始基线之后已有提交中的修复及本次补充;测试使用隔离数据库与配置目录,未清空真实运行数据库,未将新构建部署到用户正在使用的实例。
## 需求确认与任务清单
按用户明确要求,审查范围包括业务源码、测试、构建部署脚本、配置模板及前端页面。锁文件、第三方资源、二进制资源单独分类,不伪装成已逐行审查的业务代码。
- [✓] 核验工作区及审查前 Git 检查点。
- [x] 运行原有前后端测试基线,结果通过,等待结合新增场景复审。
- [✓] 运行原有前后端测试基线,保留原始通过及新增失败证据。
- [~] 建立逐文件、行范围和哈希覆盖账本。
- [~] 检查认证恢复、迁移、邮件列表、IMAP、配置与前端交互。
- [~] 用隔离 SQLite、真实本地协议和真实前端函数验证问题。
- [✓] 用隔离 SQLite、真实本地协议和真实前端函数验证已登记问题并执行修复回归。
- [x] 修复认证授权、配置事务、邮件协议、隐私、前端交互及部署回滚问题,等待适用环境复审。
- [~] 补齐外部邮箱刷新或验证码过期后的绑定恢复流程。
- [✓] 完成前端 55/55、独立前端审查 11/11、后端全量与 race、独立审查普通与 race 回归。
- [✓] 完成 Windows 八阶段内存回滚验证、Telegram 隔离测试及前后端构建。
- [ ] 补齐全仓其余文件的逐行审查。
- [ ] 浏览器 MCP 验收完整业务流程。
- [ ] MySQL、PostgreSQL 实库及 Linux/Windows 部署验收。
- [ ] 全部发现项修复后的独立复审;本轮未执行修复。
- [ ] 部署新产物并完成真实证书续期、邮件投递及在途请求排空验收。
- [~] 全部发现项修复后的独立复审;自动化场景已通过,但不等于完整功能验收。
## 已确认问题
## 修复状态
状态约定:本表 `[x]` 表示代码修改及列出的自动化场景已完成,仍需对应的浏览器、外部服务或部署复审;`[~]` 表示仍有明确未完成的代码流程。上方测试任务的 `[✓]` 仅指该项测试本身复核通过,不扩大为产品验收通过。
| 原始编号 | 当前状态与修复内容 | 自动化证据与仍需验收的边界 |
| --- | --- | --- |
| R01、R03、R28 | [x] 不支持的源索引明确拒绝;迁移排空响应取消;保留历史自增高水位。 | `dbmigration_findings_test.go`;SQLite 迁移回归通过,MySQL/PostgreSQL 实库待验。 |
| R02 | [x] 登录二次验证重发进入登录前安全路由,仍保留挑战、限频及 CSRF 边界。 | `TestAuditAnonymousLoginResendMustReachController`;真实验证码投递与浏览器待验。 |
| R04 | [x] 邮件计数与分页查询分离,不再把偏移带入计数。 | `TestAuditPaginationMustPreserveTotal`;普通列表页面待浏览器验收。 |
| R05 | [x] 恢复完成时复查绑定的 WebAuthn 凭据及账户安全状态,撤销后的旧票据不能改密。 | `recovery_findings_test.go`;真实安全密钥设备流程待验。 |
| R06 | [x] 直接使用响应拦截器返回的 Blob;错误 Blob 不生成下载,允许重试。 | `frontend-findings.test.mjs` 的 CSV/JSON 内容及错误响应断言;浏览器下载待验。 |
| R07、R35 | [x] 写信页接收 `fileRef`,邮件列表接收 `taskTableDataRef`,连接真实模板与组合函数。 | 真实 SFC 编译挂载的附件和列表测试;系统文件选择框、实际表格待浏览器验收。 |
| R08、R11 | [x] 区分内容身份和邮箱关系身份,为副本创建独立状态对象,保持 COPY 后移动、FETCH 的 UID 一致。 | `imap_findings_test.go` 的副本、移动与 FETCH 回归;未宣告原生 MOVE,客户端仍使用回退流程。 |
| R09 | [x] 安全服务使用加锁快照发布与读取;先停止入口,再撤下服务引用及会话清理器。 | `runtime_findings_test.go`、`lifecycle_findings_test.go` 普通与 race 通过;完整 HTTP 在途排空待验。 |
| R10、R12–R15 | [x] 保存只读选择状态,统一动态 UID 与序号解析,修复默认文件夹枚举、UIDNEXT 和有效邮件计数。 | `imap_findings_test.go`、`imap_wire_findings_test.go`;同时覆盖 Poll/IDLE、DONE 与清理。 |
| R16 | [x] 传递目标角色,并用安全版本条件更新及失效流程保护角色变更。 | `TestAuditAuthorizedRoleChangeMustSucceed`;角色变化后的真实 HTTP 会话失效待验。 |
| R17 | [x] 恢复 Cookie 的签发和清除采用覆盖新旧接口的 `/api/` 路径,保留上下文校验。 | `TestAuditRecoveryCookieMustReachVersionedAPI` 的 TLS/CookieJar 新旧接口对照;自签名 HTTPS 浏览器 Cookie/CSRF 待验。 |
| R18–R23 | [x] POP3 建立会话快照及连续编号,统一可见集合与删除视图,支持 RSET、正确单行响应和非负 TOP 参数。 | `pop3_action_findings_test.go` 及解析器测试;LIST/STAT 字节大小、dot-stuffing 和 RETR 额外空行另行专项验收。 |
| R24–R27 | [x] 收件人响应不暴露密送地址;保留标准 Reply-To、带逗号姓名和附件 Content-ID;IMAP 重建字节稳定。 | `message_findings_test.go` 与真实解析、存储、响应回归;网页 `cid:` 显示及外部客户端待验。 |
| R29 | [x] 配置重试前处理未决事务,成功重试不再被旧失败事务在重启时回滚。 | `TestAuditSuccessfulConfigRetryMustSurviveRestart`:重启后代次仍为 2,策略仍为 8 MiB。 |
| R30 | [x] 候选有唯一 ID,提供受授权的脱敏查询、恢复和取消;页面刷新恢复候选,垃圾邮件设置同步适配。 | `TestAuditPendingIdentityAndRecovery`、配置前端及审查测试;跨会话恢复保留近期身份验证,已落盘候选不能取消。 |
| R31 | [~] 同页面输错验证码或取消弹窗后保留原挑战,可再次输入,不重复绑定。 | 前端重试及后端约束测试通过;刷新、验证码过期后的挑战恢复与重发入口尚未完成,不能标为完全修复。 |
| R32、R33 | [x] 外部邮箱绑定执行近期认证,规范化后拒绝当前用户自己的主邮箱。 | `TestAuditExternalBindingMustRequireRecentAuthentication`、`TestAuditExternalBindingMustRejectOwnPrimaryMailbox`;真实邮件投递待验。 |
| R34 | [x] 修正正常附件下载路由解析,保留邮件归属及索引校验。 | `TestAuditAttachmentPageDownloadMustReturnStoredContent` 的真实 TLS 路由;浏览器点击下载待验。 |
| R36 | [x] Windows 升级按目标记录备份和安装状态,回滚只处理本次实际替换的文件。 | 最新八个失败阶段均保留旧主程序与旧管理程序;这是内存隔离控制流验证,不是正式服务部署。 |
| R37 | [x] 编辑规则使用独立草稿,新建和取消重置状态,新建提交 ID 为 0。 | `rule-frontend.test.mjs`;列表未被未保存条件污染,实际请求走新增接口。 |
| R38、R39、R41 | [x] 完整证书链去重,按 X.509 校验泛域名覆盖,迁移保留 DNS 挑战方式。 | `ssl_findings_test.go` 及原有 SSL 测试;不请求真实 CA。自动 DNS 只申请 `*.主域名`,不加入根域名 SAN。 |
| R40 | [x] 证书先写入独立托管版本,再通过分区配置事务提交引用;不提前替换现用目录。 | `TestAuditPartitionedRenewalMustCommitBeforeSwitch`、`TestAuditStagedSSLDoesNotReplaceCurrent`;发布失败保留已提交候选,超级管理员可受授权恢复,但自动恢复与真实 CA 续期尚未验收。 |
| R42 | [x] 旧配置迁移保留 SQLite 原路径,避免静默连接到新空库。 | `TestAuditLegacyMigrationMustPreserveSQLiteLocation`;原目录标记数据仍可读取。 |
| R43 | [x] 移除特殊域名的 DKIM 放行,只依据实际签名校验结果。 | `TestAuditInvalidDKIMMustNotPassForSpecialDomain`;普通域名与原特殊域名均拒绝无效签名。 |
| R44、R45 | [x] SEARCH 独立搜索键求交,OR 节点内部求并,删除搜索使用与 STORE/FETCH 一致的标记。 | `TestAuditSearchKeysMustIntersect`、`TestAuditSearchDeletedMustMatchStoredFlag` 的本地 TLS 协议测试。 |
| R46–R48 | [x] Telegram 附件发送遵守隐私开关,普通文本 HTML 转义,Unicode 截断保持有效字符和闭合标记。 | `telegram_findings_test.go`:关闭上传 0 个附件、开启对照 2 个;真实 Telegram API 待验。 |
| R49 | [x] 协议开关采用受控值,请求成功才提交新状态,失败恢复服务端一致状态。 | `protocol-frontend.test.mjs` 成功与失败对照通过;浏览器及真实协议连接关闭待验。 |
| R50 | [x] Telegram 设置改为主程序原生 `.vue/.js/.css` 页面,不依赖受限 iframe 存储或网络访问。 | `test/frontend/telegram-settings.test.mjs`;其他插件继续保留 `sandbox="allow-scripts"`,完整新页面部署待验。 |
| R51 | [x] 插件 RPC 用明确字符串映射传递失败信息,在适配层与 Go `error` 转换。 | `TestAuditSendAfterFailureMustReachPlugin` 的成功与失败回调对照;外部插件进程待验。 |
### 修复期间追加的边界问题
1. **大邮箱 UID 查询上限**:`session_messages.go` 每批最多读取 500 个 UID,保持会话序号;EXPUNGE 分批读取后汇总并单事务删除。`TestAuditLargeSelectedMailboxMustBatchUIDQueries` 使用 10,001 封邮件,修复前 `count=0 err=invalid UID list`,最终普通测试 4.73 秒、race 179.29 秒通过。失败证据:`test-log/run-2026-09-06T04-25-22-809Z-39264/backend.log`。
2. **SSL 提交覆盖签发期间的其他配置**:旧配置读写共用 `legacyConfigMu`,SSL 提交重读最新配置,只合并 SSL/HTTPS 字段;域名或证书策略改变时拒绝旧结果。`TestAuditLegacySSLCommitPreservesLatestUnrelatedSettings` 修复前把端口覆盖回 8080,最终断言保留 9080。失败证据:`test-log/run-2026-09-06T04-32-01-312Z-3768/backend.log`。本项不是通用旧版整份配置写入的完整 CAS,不宣称所有并发更新都已解决。
3. **停止验证运行时后残留旧服务引用**:`ClearSecurityRuntime()` 在锁内清空五项服务,再清登录挑战;有无清理运行时均撤下引用,重复停止安全。`TestAuditStopVerificationWithdrawsPublishedServices` 先失败,最终两组均通过,并验证真实控制器返回 `NeedLogin`。失败证据:`test-log/run-2026-09-06T04-33-27-630Z-42076/backend.log`。HTTP 仍使用 `Close()`,这不等于完整在途请求排空已验收。
此外,微信推送增加业务响应码及响应解析检查,不能把 HTTP 成功误判为业务成功;`TestAuditWeChatBusinessResponses` 的隔离回归通过,未向真实微信端点投递。
## 原始已确认问题(历史发现)
优先级:P1 为安全授权、数据完整性或核心功能问题;P2 为特定场景故障及一致性问题。编号固定,便于后续复现和修复。
@@ -396,7 +447,7 @@
- 影响:本应保持原安装的普通升级失败会破坏可用安装,导致服务下次无法启动或本地管理程序丢失。
- 建议:按目标记录备份和替换状态,仅清理本次真正安装的新文件;成功备份后才能覆盖,回滚失败时必须保留恢复材料并明确报告。
- 边界:没有执行真实安装脚本主体、删除磁盘文件、停止服务、调用系统安装工具或改变 ACL;此处确认的是实际控制流在指定异常下的结果,双平台部署验收仍未完成。
- 复现:`node test/review/run-windows.mjs`,六个失败阶段内存验证。
- 原始复现:`node test/review/run-windows.mjs`,当时六个失败阶段内存验证;修复后已扩展为八阶段,结果见最终回归节。
### R37 / P2:规则编辑取消后点击新建,提交的仍是对旧规则的修改
@@ -561,13 +612,15 @@
- Windows 正式模式插件隔离存在明确不可用分支,仍需核对功能开关、实际调用链和文档承诺。
- SMTP MX 回退、IMAP 动态序列其他命令、HTML 入库与插件路径等尚需继续检查;UIDNEXT 和 UID FETCH 通配符的已验证问题见 R13、R14。
## 复现与验证记录
## 原始复现与验证记录
以下命令和日志保留审查阶段的先失败证据;修复后的同名测试现已通过,不应将历史失败日志解释为当前程序仍出现相同故障。
```powershell
# 原有测试基线
node test/run.mjs all -count=1 ./...
# 独立审查测试:当前预期会失败,失败断言用于暴露尚未修复的业务问题
# 独立审查测试:审查阶段曾失败,用于暴露当时尚未修复的问题
node test/review/run.mjs
node test/review/run.mjs -race
node test/review/run.mjs --pop3-only
@@ -620,13 +673,68 @@ node test/review/coverage.mjs
- R49 协议开关失败回滚:`test-log/review-protocol-20260906-041737.log`,失败请求状态一致性断言失败,成功请求对照通过。
- 包含候选配置与外部邮箱重试的五项前端失败复现:`test-log/review-frontend-2026-09-05T19-15-56-197Z/frontend.log`。
- 前端两项复现日志:`test-log/frontend-review-20260906-022032.log`。
- 测试源码:`test/review/`;Go overlay 将测试注入对应包,不改业务源码;运行产物放在 `test-log/`。
- 测试源码:`test/review/`;Go overlay 将测试注入对应包,不为执行测试改写业务源码;修复阶段的业务修改另由 Git 差异记录,运行产物放在 `test-log/`。
- `^TestAudit` 还会匹配项目原有审计接口测试,因此测试用例总数不等于新增问题数。
- 未运行带 `--fix` 的 lint,不用自动格式化或文本替换悄悄改动业务源码。
## 修复后最终回归与构建
### 自动化回归
本批测试使用隔离库、临时配置及本地协议夹具,没有清空真实运行库,也没有执行用户要求的“清库后按生产环境重新初始化”验收。
| 验证 | 最终结果 | 本地证据 |
| --- | --- | --- |
| 前后端全量 | 前端 55/55,后端全量通过 | `test-log/run-2026-09-06T04-34-53-174Z-29120/` |
| 后端全量 race | 通过 | `test-log/run-2026-09-06T04-34-53-169Z-15200/backend.log` |
| 独立审查 race | 通过,包含最后三项补充修复 | `test-log/run-2026-09-06T04-34-53-289Z-17348/backend.log` |
| 独立审查普通 | 通过,包含最后三项补充修复 | `test-log/run-2026-09-06T04-40-27-845Z-16924/backend.log` |
| 独立前端审查 | 11/11 | `test-log/review-frontend-final-20260906-123539.log` |
| Windows 升级回滚 | 八个失败阶段,两份旧程序均保留 | `test-log/review-windows-1788669339410/windows.log` |
| Telegram | 隔离测试通过 | `test-log/review-telegram-2026-09-06T04-35-50-100Z/telegram.log` |
主要复核命令:
```powershell
node test/run.mjs all -count=1 -timeout=180s ./...
node test/run.mjs backend -race -count=1 -timeout=240s ./...
node test/review/run.mjs -race -timeout=240s
node test/review/run.mjs -timeout=240s
node --test test/review/frontend-findings.test.mjs test/review/rule-frontend.test.mjs test/review/protocol-frontend.test.mjs
node test/review/run-windows.mjs
node test/review/run-telegram.mjs
```
独立审查 race 日志中的隔离 IMAP 连接空闲超时不代表用户后端故障;相关用例和包最终通过。`^TestAudit` 也会运行项目原有审计接口测试,因此测试数量不等于问题数量。
### 构建产物
- 前端:`out/frontend`,已同步到 Go 嵌入目录 `backend/listen/http_server/dist`;1858 个模块转换,构建 9.03 秒,postbuild 成功。日志:`test-log/review-build-frontend-20260906-124143.log`。
- 前端仍有超过 500 kB 的分块警告,属于待优化项;PowerShell 将标准错误流显示为 `NativeCommandError`,但本次构建及 postbuild 已成功,不能据此判为构建失败。
- 后端:`out/review-fixes-20260906-124516/`,包含主程序、管理员工具及配置工具,均包含最后三项补充修复。日志:`test-log/review-build-backend-20260906-124516.log`。
- 构建元数据:`Version=review-fixes-20260906-124516`,`GitHash=addfcea1cdb59f1fd28bd1639c54502cb05990de-dirty`,`BuildTime=2026-09-06T04:45:17Z`,`GoVersion=go1.26.6`。这是最终提交前工作树的验证产物,不冒充最终提交哈希构建。
| 文件 | SHA-256 |
| --- | --- |
| `smail.exe` | `67BA0822498E8724CC51E811793CFE2347D4AC642CE8EAB82B4062DBDC63AF52` |
| `smail-admin.exe` | `F1F2F7655224661276AF44A16947303405B275938D3C241CFC0A6DF32785EC6B` |
| `smail-config.exe` | `FB05E8673E2B807F46CC51D0366E6269841927D3AA82D6320249C6699371C228` |
旧目录 `out/review-fixes-20260906-121853/` 不含最后三项修复,不用于本节结果对应的部署。旧产物保留,没有清理用户文件。根 `config/`、`ssl/`、`test-log/`、`out/` 及嵌入产物不纳入本次源码提交。
### 仍需继续的验收
- R31 的刷新、过期挑战恢复与重发入口尚需实现并测试。
- R40 的已提交候选受授权恢复需要真实运行验证,自动恢复和真实 CA 签发、续期未闭环。
- 登录刷新保持会话、setup、忘记密码、登录二次验证、强制改密、普通邮箱列表、审计 Blob 下载、自签名 HTTPS Cookie/CSRF 尚需浏览器 MCP 真实验收。
- MySQL/PostgreSQL 的索引与自增迁移、角色变更后的 HTTP 会话失效、Linux/Windows 正式部署、真实邮件及插件投递待验。
- HTTP 完整在途排空、POP3 字节大小及转义、网页内嵌图片显示等专项仍需补充。
- **用户正在运行的实例尚未部署本批新程序;测试通过及构建成功不意味着页面或运行中的后端已更新。**
## 覆盖说明
- 覆盖记录源:`test/review/reviewed-ranges.json`。
- 账本基线仍为 `9849f8f11c9f49efd1bc877d7fedd8da265e32df`,只对应原始审查版本;没有修改基线来伪造修复后的覆盖率。覆盖工具会拒绝与该基线不一致的 HEAD,当前修复差异复核也不等于新版本全仓逐行覆盖。
- 生成账本包含每个受版本控制文件的路径、分类、行数、SHA-256、阅读行范围及发现编号。
- `read-not-accepted` 只表示全文已读,不表示无问题,也不表示复审通过。
- `partial-read` 表示只读取部分行;`not-recorded` 表示没有登记,接续摘要中模糊描述的已读内容不冒充全文覆盖。