docs: finalize preservation migration acceptance

2026-08-01 10:31:16 +08:00
parent deb84c4069
commit 104e6aa396
9 changed files with 127 additions and 61 deletions
@@ -5,14 +5,15 @@
 > 严格审计候选标签：`xiaobai-preservation-slice-11-audit-candidate-20260731`
 > 跨日复验候选标签：`xiaobai-preservation-slice-11-audit-candidate-20260801`
 > 独立维护候选标签：`xiaobai-preservation-slice-11-audit-candidate-standalone-20260801`
-> 当前结论：自动验收完成，等待用户人工验收；尚未执行正式切换、Docker或NAS部署
+> 最终完成标签：`xiaobai-preservation-complete-20260801`
+> 当前结论：自动与用户人工验收均已完成；本地迁移交付完成，尚未执行正式切换、Docker或NAS部署

 ## 1. 本切片做了什么

 本切片不增加功能、不调整视觉，也不继续拆分业务代码。它逐项审计切片10保留的待定资产，
 把有完整证据的无效实现放入可单独回档的试删候选，并为人工接管和后续切换准备文档。

-试删候选：
+经试删和人工验收后确认废弃：

 - `app/demo_data.py`：没有运行导入、动态注册、数据库或配置责任的旧演示数据构造器。
 - `app/frontend/heaven-loading.js`：页面未加载的旧问天动画；正式入口继续使用
@@ -78,26 +79,30 @@ Playwright通过。架构热点字节数已改为换行归一化后的UTF-8大

 机器可读记录见`browser-acceptance.json`。截图和更广的桌面/移动基线继续沿用切片10证据目录。
 切片10截图的事后像素复核见`screenshot-pixel-audit.json`；九组有效截图平均色差低于0.3/255，
-集合竞价候选图因登录状态失效被明确排除，仍等待用户人工视觉验收。
+集合竞价候选图因登录状态失效被明确排除，未作为自动截图证据。2026-08-01用户随后在`8797`
+真实登录状态下逐页检查全部页面并测试全部功能，确认视觉与功能迁移成功；所见问题几乎都
+属于原版遗留问题，未发现阻止验收的迁移回归。完整人工结论见`manual-acceptance.md`。

 ## 4. 数据与部署边界

 - API/数据库比较使用两个隔离副本：`slice11-final-original`与`slice11-final-migrated`。
 - 没有写入根目录正式`data/review.db`，没有修改`.env`或私有Skill。
 - 没有占用`8765`，没有执行Docker构建、NAS测试或服务器切换。
- 原版根目录仍是正式运行基线；`app/`只是等待人工验收的候选。
+- `app/`已经完成本地迁移验收；原版根目录仍是当前部署基线和切换前回档来源。
 - `next/`保持冻结，没有作为代码、样式、测试或文档来源。

 ## 5. 回档与最终确认

-切片11提交和两个候选标签只代表“候选可验收”，不代表删除已被永久确认。人工验收前可按
-`uncertain-code-audit.md`从切片10标签单独恢复任一候选；不需要回退其他已通过迁移切片。
+2026-08-01用户完成全部页面和功能人工验收，确认迁移在视觉和功能上成功，并确认人工检查中
+发现的问题几乎都属于原版遗留问题。切片11的2个文件和5个无消费者函数据此从“候选试删”改为
+“确认废弃”；恢复标签继续保留作历史兼容应急，不代表删除结论仍待裁决。

-用户人工确认后才允许：
+本地迁移收尾已执行：

-1. 把试删候选状态改为“确认废弃”。
-2. 建立最终完成标签。
-3. 决定本地或Docker正式切换时间。
-4. 另行制定根目录兼容外壳和旧实现的清理计划。
+1. 试删候选状态改为“确认废弃”。
+2. 建立最终完成标签并推送Gitea。
+3. `app/`作为后续结构治理的唯一开发目录。
+
+正式数据库、原版部署、Docker和NAS仍未切换；切换时间与根目录清理必须由用户另行批准。

 人工维护、验证、切换和回退步骤见`docs/migration/人工维护与本地切换指南.md`。
@@ -5,7 +5,7 @@
 > 结论口径：自动证据通过不替代用户人工验收，也不授权部署切换

 本审计回答的不是“测试是否为绿色”，而是迁移总纲、批准目录、产品表面和人工维护目标是否
-分别有可复验的证据。状态只使用：`自动闭环`、`人工待验`、`明确保留`和`未执行`。
+分别有可复验的证据。状态只使用：`自动闭环`、`人工闭环`、`明确保留`和`未执行`。

 ## 1. 目标与证据矩阵

@@ -22,8 +22,8 @@
 | 后台任务可追踪和重试 | 3个任务登记调度、锁、超时、重试和输出版本；运行状态持久化 | `jobs.config.json`；job runner tests | 自动闭环 |
 | LLM唯一治理边界 | 问师、问天、复盘助手和策略编译经统一网关执行会员、额度、模型回退、流式和审计规则 | 切片07/09；LLM gateway/stream tests | 自动闭环 |
 | 前端唯一请求出口、Shell和页面职责 | 只有`frontend/shared/api.js`调用`fetch`；Shell、状态、弹窗、页面生命周期及页面模块已归位 | frontend boundary tests；切片10源码重组哈希 | 自动闭环 |
-| CSS、主题、动画和移动行为不改写 | 原七层CSS和问天动画按字节/源码移动；令牌层与加载顺序受测试保护 | CSS governance；切片10/11浏览器证据 | 自动闭环 |
-| 不确定代码先记录再试删 | 2个文件和5个无消费者函数仅为候选试删；历史表兼容责任继续保留 | `uncertain-code-audit.md`；cleanup contract | 人工待验 |
+| CSS、主题、动画和移动行为不改写 | 原七层CSS和问天动画按字节/源码移动；令牌层与加载顺序受测试保护；用户逐页确认无迁移视觉回归 | CSS governance；切片10/11浏览器证据；`manual-acceptance.md` | 人工闭环 |
+| 不确定代码先记录再试删 | 2个文件和5个无消费者函数经自动与人工验收确认废弃；历史表兼容责任继续保留 | `uncertain-code-audit.md`；cleanup contract；`manual-acceptance.md` | 人工闭环 |
 | 可由人工维护者复验 | 候选README/架构说明、工具分类、API/架构生成器、统一验证命令均可从`app/`独立运行；系统临时目录导出实测242项候选测试通过 | `app/tools/README.md`；maintenance tool tests；独立导出复验 | 自动闭环 |
 | 正式数据库与部署不受影响 | 验收只使用隔离SQLite副本和非8765端口 | 各切片README；运行记录 | 自动闭环 |
 | Docker/NAS和正式入口切换 | 用户已明确本轮不做NAS Docker测试；人工验收前禁止切换 | 迁移状态和切换指南 | 未执行 |
@@ -70,14 +70,14 @@
   242项测试、注册表、24个JavaScript文件和SQLite检查。架构热点大小按归一化UTF-8计算，
   CRLF/LF不再导致清单失效；正式仓库最终通过305项测试和45项Playwright。

-## 4. 仍需用户完成的最终裁决
+## 4. 最终人工裁决与部署边界

-自动部分完成后仍不能执行以下动作：
+2026-08-01用户在隔离端口`8797`浏览全部页面并测试全部功能，确认视觉与功能迁移成功；发现的
+问题几乎都属于原版遗留问题，未发现阻止验收的迁移回归。该结论已经关闭以下迁移裁决：

-1. 把切片11的试删候选从“待人工确认”改成“确认废弃”。
-2. 声称所有页面的视觉、交互手感和动画已经由用户确认等价。
-3. 建立最终完成标签，或把`app/`切换为本地/容器正式入口。
-4. 删除根目录原版、正式数据库备份或冻结的失败记录。
+1. 切片11试删候选确认为废弃，恢复标签继续保留。
+2. 页面视觉、功能、交互和动画的人工验收完成。
+3. 允许建立本地迁移完成标签并推送Gitea。

-本地人工验收入口及逐页清单以`人工维护与本地切换指南.md`为准。发现差异时只回退对应候选，
-不使用破坏性Git操作覆盖原版或正式数据。
+该结论不授权切换正式数据库、Docker或NAS，也不授权删除根目录原版、数据库备份或冻结的
+`next/`记录。部署切换继续以`人工维护与本地切换指南.md`为准，并须单独获得用户批准。
@@ -0,0 +1,33 @@
+# 切片 11：用户人工验收记录
+
+> 验收日期：2026-08-01  
+> 验收地址：`http://127.0.0.1:8797/`  
+> 数据边界：迁移审计数据库副本，未写正式数据库  
+> 结论：通过
+
+## 验收范围
+
+用户在迁移版中浏览了全部页面，并测试了全部可操作功能。验收覆盖页面视觉、布局、主题、
+交互、动画、行情读取、LLM功能及主要写入流程。验收期间使用的Tushare、iFinD和主LLM均完成
+真实最小调用验证，迁移版能够读取数据库中加密保存的原配置。
+
+## 用户结论
+
+迁移版在视觉和功能上迁移成功。人工检查中发现的问题几乎全部属于原版已经存在的遗留问题；
+未发现阻止本次验收的`app/`目录迁移回归。
+
+## 最终裁决
+
+1. 接受`app/`与原版在功能、视觉、交互和动画上的保真结果。
+2. 确认切片11登记的`demo_data.py`、旧问天加载文件和5个无消费者前端函数可以永久废弃。
+3. 保留`wencai_saved_queries`及证据不足的相邻资产，继续承担旧数据库兼容责任。
+4. 允许建立本地迁移完成提交和标签并推送Gitea。
+5. 本次验收不授权切换Docker/NAS、删除原版或改写正式数据库；部署切换必须另行决定。
+
+## 证据关系
+
+- 自动完成度审计：`completion-audit.md`
+- 不确定代码处置：`uncertain-code-audit.md`
+- 浏览器自动记录：`browser-acceptance.json`
+- API和数据库差分：`api-diff.json`、`database-diff.json`
+- 回档基线：`xiaobai-preservation-slice-10-20260731`
@@ -3,9 +3,11 @@
 > 审计基线：`dec3cd12365df5e7d4c391369f14c457cf56d7d9`
 > 恢复标签：`xiaobai-preservation-slice-10-20260731`
 > 原则：只有静态引用、动态注册、运行路径和兼容责任同时排除后才试删；其余继续保留
-> 当前状态：试删后的自动、API、数据库和浏览器验收已通过，等待用户人工确认
+> 当前状态：自动与人工验收均已通过，试删项于2026-08-01确认废弃

-本日志记录试删前的原位置、内容指纹、证据、决定和恢复方式。试删不等于永久废弃；自动回归通过后仍需用户在迁移版真实页面完成人工验收，才能把删除结论视为最终确认。
+本日志记录试删前的原位置、内容指纹、证据、决定和恢复方式。试删阶段不等于永久废弃；
+2026-08-01用户完成迁移版全部页面和功能人工检查，确认视觉与功能迁移成功，所见问题几乎都
+属于原版遗留问题，未发现阻止验收的迁移回归。该人工结论关闭了本日志的最终确认门槛。

 ## 1. `app/demo_data.py`

@@ -15,7 +17,7 @@
 - 动态/注册路径：没有模块名字符串、插件注册或反射加载。
 - 产品事实：`app/README.md`明确主行情不再回退演示数据；行情服务和Repository只负责排除历史`source=demo`缓存，未依赖本文件。
 - 兼容责任：不参与数据库schema、历史记录解释或配置读取。
- 决定：进入试删。
+- 最终决定：确认废弃；切片10标签继续保留单项恢复能力。
 - 恢复：从切片10标签恢复`app/demo_data.py`。

 ## 2. `app/frontend/heaven-loading.js`
@@ -26,7 +28,7 @@
 - 动态/注册路径：没有脚本清单、页面注册表或运行时代码引用旧路径；新旧文件虽然都导出`window.HeavenLoadingCanvas`，但浏览器只能执行v2。
 - 运行证据：切片10已覆盖观势、观气和观心解读加载动画，v2节点、动画名及可见行为与原版基线一致。
 - 兼容责任：不是数据库、配置或历史数据资产。
- 决定：进入试删。
+- 最终决定：确认废弃；切片10标签继续保留单项恢复能力。
 - 恢复：从切片10标签恢复该文件。

 ## 3. 五个疑似无引用前端函数
@@ -35,11 +37,11 @@

 | 函数 | 位置 | 原用途线索 | 决定 |
 |---|---|---|---|
-| `commonReviewColumns` | `frontend/shared/export.js` | 旧通用导出列定义；当前每个导出入口均显式传列 | 试删 |
-| `outcomeClass` | `frontend/app.js` | 旧昨日涨停结果样式映射；当前渲染不调用 | 试删 |
-| `screenerResultMatchesSelection` | `frontend/pages/screener/page.js` | 旧选股结果存在性包装；已由`activeScreenerResultEntry`直接承担 | 试删 |
-| `selectRegime` | `frontend/pages/screener/page.js` | 旧阶段手动切换；当前阶段由盘后数据写入且无按钮绑定 | 试删 |
-| `showHeartRitualCurtain` | `frontend/pages/heaven/page.js` | 旧观心幕帘过场；当前流程直接调用`activateHeartRises` | 试删 |
+| `commonReviewColumns` | `frontend/shared/export.js` | 旧通用导出列定义；当前每个导出入口均显式传列 | 确认废弃 |
+| `outcomeClass` | `frontend/app.js` | 旧昨日涨停结果样式映射；当前渲染不调用 | 确认废弃 |
+| `screenerResultMatchesSelection` | `frontend/pages/screener/page.js` | 旧选股结果存在性包装；已由`activeScreenerResultEntry`直接承担 | 确认废弃 |
+| `selectRegime` | `frontend/pages/screener/page.js` | 旧阶段手动切换；当前阶段由盘后数据写入且无按钮绑定 | 确认废弃 |
+| `showHeartRitualCurtain` | `frontend/pages/heaven/page.js` | 旧观心幕帘过场；当前流程直接调用`activateHeartRises` | 确认废弃 |

 本次只删除这5个函数，不连带删除`selectedRegime`、`heartRitualCurtain`隐藏节点、`heartCurtainTimer`或相关CSS。后者与仍在使用的选股状态、观心节点和复合选择器相邻，尚不足以证明可独立删除，默认保留。

@@ -76,4 +78,14 @@
 - 桌面日间/夜间及390x844移动端真实页面检查通过，问天三页和观气底部内容可达。
 - `wencai_saved_queries`及三个方法保持存在，并由清理契约测试持续保护。

-因此上述删除保持“候选试删”状态；只有用户人工验收后才改为“确认废弃”。
+## 7. 人工最终确认
+
+- 验收日期：2026-08-01。
+- 验收运行时：隔离端口`8797`与迁移审计数据库副本。
+- 验收范围：用户逐页浏览全部页面并测试全部可操作功能。
+- 验收结论：视觉与功能迁移成功；发现的问题几乎都是原版遗留问题，未发现阻止验收的迁移回归。
+- 删除结论：`demo_data.py`、旧问天加载文件和上述5个无消费者函数正式确认为废弃；
+  `wencai_saved_queries`及证据不足的相邻DOM、状态和CSS继续保留。
+
+确认废弃不取消恢复证据。若后续发现历史兼容责任，可从
+`xiaobai-preservation-slice-10-20260731`按本日志记录单项恢复，不回退其他迁移成果。