소스 검색

[Docs] 按复核意见修正第三轮说明:不再写死自指 hash(合成分支后会失真)+ 刷新中间态 stat 数字 + 交付状态与分支/编号映射对齐

lizuo 1 일 전
부모
커밋
67cf5e03ce
2개의 변경된 파일36개의 추가작업 그리고 25개의 파일을 삭제
  1. 20 12
      docs/ai-changes/20260921-audit-r3-bugs.md
  2. 16 13
      docs/ai-changes/20260921-audit-r3-restore.md

+ 20 - 12
docs/ai-changes/20260921-audit-r3-bugs.md

@@ -4,29 +4,36 @@
 
 | 项 | 值 |
 |---|---|
-| 对照网址 | http://39.97.59.228:8013/hrx/mky-vent-base/compare/master...fix/audit-r3-bugs-20260921 |
-| 依据文档 | `tools/verify/代码审核-第三轮-mky-vent-base-20260921.md`(R3-8、R3-9) |
-| 分支 | `fix/audit-r3-bugs-20260921` |
+| 对照网址 | http://39.97.59.228:8013/hrx/mky-vent-base/compare/master...fix/audit-r3-20260921 |
+| 依据文档 | `tools/verify/代码审核-第三轮-mky-vent-base-20260921.md`(该报告编号 B-1/B-2,对应本文档 R3-8/R3-9) |
+| 分支 | `fix/audit-r3-20260921`(由 `fix/audit-r3-bugs-20260921` 与 `fix/audit-r3-restore-20260921` 两条施工分支按提交 cherry-pick 合成;本文件原属 bug 组分支) |
 | 基线 | `upstream/master` = `4e311cb6`(behind=0) |
 | 日期 | 2026-09-21(Asia/Shanghai) |
-| 状态 | 仅本地提交、未推送,待人工审核 |
+| 交付版本 | `fix/audit-r3-20260921`(7 个提交:bug 组 3 + 恢复组 4) |
+| 状态 | 已推 fork(`origin` = lizuo/mky-vent-base)用于远程构建与人工审核;**未推 upstream、未推 master、未部署** |
 
 ## ② 提交清单
 
-- `ce74a288` `[Fix R3-8] 恢复 resetMicroContentWH 的 onTimeout 形参(修 4 调用方失配致遮罩永久卡死)`
-- `c046275a` `[Fix R3-9] 缩小重新生成去重删除范围(服务端时间戳基线,防误删历史同文案提问)`
-- `a54f990e` `[Docs] 第三轮审计 R3-B 批改动说明(docs/ai-changes)`
+- `[Fix R3-8] 恢复 resetMicroContentWH 的 onTimeout 形参(修 4 调用方失配致遮罩永久卡死)`
+- `[Fix R3-9] 缩小重新生成去重删除范围(服务端时间戳基线,防误删历史同文案提问)`
+- `[Docs] 第三轮审计 R3-B 批改动说明(docs/ai-changes)`
+
+> **本清单只列提交标题,不写死 hash**:本文档随分支提交,任何 amend / cherry-pick / rebase 都会让"自指 hash"失真
+> (第三方复核即发现旧稿引用了一个**已被 amend 掉的 docs 提交 hash**)。**hash 一律以本分支 `git log --oneline` 为准。**
 
 ## ③ 改动面
 
-`git diff --stat`(基线 `4e311cb6` → 本分支):
+`git diff --stat 4e311cb6 <R3-9 提交> -- src`(基线 `4e311cb6` → 两处修复后的实测输出):
 
 ```
- src/utils/domUtils.ts                            | 12 +++++++++-
- .../components/AiAssistantModal.vue               | 26 +++++++++++++++++-----
- 2 files changed, 32 insertions(+), 6 deletions(-)
+ src/utils/domUtils.ts                              | 12 ++++-
+ .../components/AiAssistantModal.vue                | 55 +++++++++++++++++++---
+ 2 files changed, 60 insertions(+), 7 deletions(-)
 ```
 
+> 复核修正:旧稿此处为"26 +++++ / 32 insertions / 6 deletions",是 R3-9 **收口前**的中间态数字;
+> 上表为复核后实测值(R3-8 单独为 `domUtils.ts` 1 文件 +11/−1;R3-9 收口将组件改动放大到 55 行)。
+
 另新增本说明目录:`docs/ai-changes/README.md`(本分支基线无该目录;规范要求仓库内补建)+ 本文件。
 
 ## ④ 逐项说明
@@ -78,5 +85,6 @@
 
 ## ⑧ 交付状态
 
-- 仅本地提交,**未推送、未部署**;推送与合并由父方/用户决定。
+- 已推 fork(`origin` = lizuo/mky-vent-base,分支 `fix/audit-r3-20260921`);**未推 upstream、未推 master、未部署**;交付合并由人工审核决定。
 - 基线:`upstream/master` = `4e311cb6`(behind=0,开工时已确认)。
+- 第三方复核(`tools/verify/复核-第三轮-基座R3-8R3-9-20260921.md`)结论:**代码零必改**;本文档原稿的"自指旧 hash + 中间态 stat 数字"两处已按复核意见修正(见 ②/③ 的修正说明)。

+ 16 - 13
docs/ai-changes/20260921-audit-r3-restore.md

@@ -4,13 +4,13 @@
 
 | 项 | 值 |
 |---|---|
-| 对照网址 | http://39.97.59.228:8013/hrx/mky-vent-base/compare/master...fix/audit-r3-restore-20260921 |
-| 依据文档 | `代码审核-第三轮-mky-vent-base-20260921.md`(B 批·修复恢复组) |
-| 分支 | `fix/audit-r3-restore-20260921` |
+| 对照网址 | http://39.97.59.228:8013/hrx/mky-vent-base/compare/master...fix/audit-r3-20260921 |
+| 依据文档 | `代码审核-第三轮-mky-vent-base-20260921.md`(该报告 A 组 A-1/A-2/A-3,对应本文档 R3-2/R3-3/R3-10) |
+| 分支 | `fix/audit-r3-20260921`(本组原施工分支 `fix/audit-r3-restore-20260921`,已按提交 cherry-pick 汇入最终分支) |
 | 基线 | `upstream/master` = `4e311cb6`(behind=0,分支起点) |
 | 日期 | 2026-09-21(Asia/Shanghai) |
-| 交付版本 | 本地提交,未推送 |
-| 状态 | 已完成自测(静态检查通过),**未推送、未部署**,待人工审核 |
+| 交付版本 | `fix/audit-r3-20260921`(7 个提交:bug 组 3 + 恢复组 4) |
+| 状态 | 已推 fork(`origin` = lizuo/mky-vent-base);**未推 upstream、未推 master、未部署**,待人工审核 |
 
 > **总原则**:本分支只恢复「地址配置化 / 凭据外置」两类**形态**,**不动自动登录/免密流程**。
 > 恢复来源为 09-14 已被人工审核"采纳"、但被团队 `7e9858ec`(回滚 13 文件)/`c913dbf9` 回退的
@@ -20,12 +20,15 @@
 
 ## ② 提交清单
 
-| # | Hash | 标题 |
-|---|---|---|
-| 1 | `021f3061` | [Fix R3-10] 恢复 /modelreq 相对路径与 glob.wsUrl(去硬编码 IP:端口) |
-| 2 | `22ce77a6` | [Fix R3-3] autoLoginToken 回空值(凭据外置,部署注入) |
-| 3 | `23f5f95a` | [Fix R3-2] .env 删除 mock 免密凭据默认值(外置部署注入) |
-| 4 | (本文档) | [Docs] 第三轮审计 R3 恢复组改动说明 |
+| # | 标题 |
+|---|---|
+| 1 | [Fix R3-10] 恢复 /modelreq 相对路径与 glob.wsUrl(去硬编码 IP:端口) |
+| 2 | [Fix R3-3] autoLoginToken 回空值(凭据外置,部署注入) |
+| 3 | [Fix R3-2] .env 删除 mock 免密凭据默认值(外置部署注入) |
+| 4 | [Docs] 第三轮审计 R3 恢复组改动说明 |
+
+> **只列提交标题、不写死 hash**:本文件的这几条提交在汇入最终分支时被 cherry-pick,hash 会变
+> (旧稿写死的 3 个施工提交 hash 在最终分支上已不可达)。**hash 一律以本分支 `git log --oneline` 为准。**
 
 ## ③ 改动面
 
@@ -132,7 +135,7 @@ grep -rn ":9999" src/layouts                                  → 0 命中(exi
 
 1. **`public/fileEdit.html` 超出任务所列 4 文件清单**:任务验收要求"残留 grep 零命中",
    而 `fileEdit.html` 的 `47.94.222.6:9050` 同属 `7e9858ec` 回退的 R3-10 范畴(`4b94efbd` 已含该文件),
-   故一并恢复并在本节显式声明;如审核认为应拆分,可单独 revert `021f3061` 中该文件。
+   故一并恢复并在本节显式声明;如审核认为应拆分,可单独 revert「[Fix R3-10] 恢复 /modelreq 相对路径与 glob.wsUrl」那个提交中的该文件。
 2. **部署注入由父方处理**:8092 的 6 条 `config.js` 补丁扩为 7 条(含 `autoLoginToken`)由父方在
    `tools/deploy/lib.sh` 完成,本分支未触碰 `tools/`。
 3. **免密/自动登录流程未动**:`?mock-login=1` 链接、`useAutoLogin.ts`、`permissionGuard.ts`、`user.ts`
@@ -141,7 +144,7 @@ grep -rn ":9999" src/layouts                                  → 0 命中(exi
 
 ## ⑧ 交付状态与上游同步
 
-- 仅本地 4 个提交(`021f3061` / `22ce77a6` / `23f5f95a` + 本文档),**未推送任何远端**;
+- 本组 4 个提交(R3-10 / R3-3 / R3-2 + 本文档)已 cherry-pick 汇入最终分支 `fix/audit-r3-20260921`,并**已推 fork**(`origin` = lizuo/mky-vent-base);**未推 upstream、未推 master**;
 - 未部署、未触碰生产;
 - 基线 `4e311cb6` = 当前 `upstream/master`,behind=0;
 - 待人工审核后由人工决定推送/合并。