docs: govern and archive superseded notes

- add documentation governance and cleanup audit documents - update README and docs index to distinguish current vs historical sources - move superseded planning, SBAS, Gamma, and experiment notes into docs/archive - fix remaining archive text garbling in two documents
2026-04-27 08:06:09 +08:00
parent 5a0623fd9b
commit d108b33f80
26 changed files with 487 additions and 27 deletions
@@ -84,10 +84,19 @@ python run_worker.py
 ## 文档导航
- [当前状态快照](docs/CURRENT_STATUS_20260425.md)
+建议阅读顺序：
- [部署与运行说明](docs/DEPLOYMENT.md)
+
- [数据库自维护审计](docs/DATABASE_SELF_MAINTENANCE_AUDIT_20260425.md)
+1. [文档治理约定](docs/DOCUMENTATION_GOVERNANCE.md)
- [文档索引](docs/INDEX.md)
+2. [文档索引](docs/INDEX.md)
 3. [当前状态快照](docs/CURRENT_STATUS_20260425.md)
 4. [部署与运行说明](docs/DEPLOYMENT.md)
 5. [数据库自维护审计](docs/DATABASE_SELF_MAINTENANCE_AUDIT_20260425.md)
 说明：
 - `docs/INDEX.md` 是当前有效文档与历史参考文档的总入口。
 - `INIT.md` 是工作笔记，不应替代正式文档。
 - 历史材料可从 `docs/archive/INDEX.md` 进入。
 当前仍在生效的专题设计文档：
@@ -0,0 +1,148 @@
 # Codebase Cleanup Audit
 Updated: 2026-04-25
 ## Scope
 This audit focuses on three cleanup questions:
 1. Which files are clearly transitional or unused?
 2. Which documentation files are authoritative versus historical?
 3. Are the reported "garbled comments" real source corruption or terminal/display issues?
 ## Confirmed Cleanup Completed In This Wave
 The frontend had active implementations living under transitional filenames while older same-purpose files remained in place.
 Completed normalization:
 - Promoted active files from transitional names back to canonical names:
  - `frontend/src/DinsarProductsPanel.jsx`
  - `frontend/src/components/DinsarCatalogPanel.jsx`
  - `frontend/src/panels/DinsarResultPanel.jsx`
  - `frontend/src/components/ResultExportModal.jsx`
  - `frontend/src/components/panels/DinsarResultRow.jsx`
  - `frontend/src/LogManagementPanel.jsx`
 - Removed superseded duplicate implementations that were no longer referenced.
 - Updated imports so runtime entry points no longer depend on `.rewrite` or `.clean` suffixes.
 - Updated `INIT.md` so it no longer describes the old temporary naming scheme as current reality.
 ## High-Confidence Findings
 ### 1. Transitional frontend files had become the real implementation
 Before cleanup, the live entry points imported:
 - `DinsarProductsPanel.rewrite.jsx`
 - `DinsarResultPanel.rewrite.jsx`
 - `LogManagementPanel.clean.jsx`
 while older canonical filenames still existed beside them.
 This is a maintenance hazard because:
 - file names no longer reflect runtime truth
 - engineers can patch the wrong file
 - stale files increase review and search noise
 ### 2. Several "unused file" suspicions were correct, but not all of them
 Confirmed pattern:
 - some canonical frontend files were effectively dead
 - some `.rewrite` or `.clean` files were not dead at all; they were the active implementation
 Conclusion:
 - `rewrite` / `clean` suffix is not enough to classify a file as removable
 - reference tracing is required before deletion
 ### 3. Most observed Chinese garbling is a tooling/display problem, not necessarily source corruption
 Key project files such as:
 - `README.md`
 - `docs/DEPLOYMENT.md`
 - `docs/CURRENT_STATUS_20260425.md`
 - `backend/app/main.py`
 - `backend/app/config.py`
 read correctly when opened as UTF-8.
 This indicates that a significant part of the reported garbling comes from PowerShell/default encoding behavior rather than broken source text.
 ### 4. Some operational notes were stale even when the code was fine
 `INIT.md` still described the temporary `LogManagementPanel.clean.jsx` workflow after the codebase had already stabilized enough for normalization.
 That kind of drift is small, but it compounds quickly in a repo with many dated design notes.
 ## Remaining Cleanup Candidates
 These items were not removed automatically in this wave, but they should be considered next.
 ### A. Documentation governance
 Current situation:
 - `docs/INDEX.md` does a reasonable job separating current docs from historical docs
 - the repository still contains many dated design, TODO, experiment, and archive documents
 Recommended next step:
 - keep `docs/INDEX.md` as the contract
 - move any newly superseded design notes to `docs/archive/`
 - avoid leaving outdated process notes at repo root unless they are still operational
 ### B. Large-file refactors
 Large files remain a maintainability risk even when they are active:
 - `frontend/src/App.jsx`
 - `backend/app/services/timeseries_service.py`
 - `backend/app/models/orm.py`
 - `backend/app/services/dinsar_production_service.py`
 Recommended next step:
 - split by responsibility, not by arbitrary line count
 - keep public contracts stable while extracting helpers/modules
 ### C. Historical compatibility layers
 There are still intentional legacy bridges in the backend, for example:
 - compatibility catalog/data bridges
 - legacy manifest normalization paths
 - legacy environment variables in WSL runtime definitions
 These should not be removed blindly. They need a separate compatibility retirement review driven by real production usage.
 ## Recommendations
 ### Phase 1: Done
 - remove dead duplicate frontend files
 - normalize active transitional filenames
 - correct stale operational notes
 ### Phase 2: Safe repository hygiene
 - review root-level notes such as `INIT.md` for whether they still belong at repo root
 - move superseded design/process notes to `docs/archive/`
 - add a lightweight naming rule: no long-lived `.rewrite`, `.clean`, `.tmp`, `.bak` files in active UI paths
 ### Phase 3: Controlled architecture cleanup
 - split oversized service files
 - document which compatibility layers are still required by production data
 - retire legacy code only after proving there is no runtime dependency
 ## Practical Rule Going Forward
 Use this decision order for cleanup:
 1. Trace imports or runtime references.
 2. Normalize active files back to canonical names.
 3. Delete only the files that are both superseded and unreferenced.
 4. Update the nearest authoritative document in the same change.
@@ -0,0 +1,195 @@
 # 文档治理约定
 最后更新：2026-04-25
 ## 1. 目标
 本文件用于定义本仓库的文档治理规则，解决以下问题：
 - 哪些文档是当前事实来源
 - 哪些文档只是设计过程记录
 - 哪些文档应归档而不是继续留在主导航里
 - 新文档应如何命名、放置和维护
 本文件是长期有效的治理约定，不是一次性的状态快照。
 ## 2. 事实来源优先级
 当多个文档描述同一主题且内容不一致时，按以下优先级判断：
 1. `README.md`
   项目总览、当前架构收口、启动入口。
 2. `docs/INDEX.md`
   当前有效文档与历史参考文档的总入口。
 3. 当前状态 / 部署 / 审计类文档
   例如：
   - `CURRENT_STATUS_*`
   - `DEPLOYMENT.md`
   - `*_AUDIT_*`
 4. 当前执行中的设计 / 规格文档
   例如：
   - `*_DESIGN_*`
   - `*_SPEC_*`
 5. 计划 / TODO / 实验 / 过程记录
   例如：
   - `*_PLAN_*`
   - `*_TODO_*`
   - `*_EXPERIMENT_*`
   - 临时工作笔记
 6. `docs/archive/`
   默认只作为历史参考，不作为现行事实来源。
 ## 3. 文档分类
 ### 3.1 长期有效文档
 适合长期保留在 `docs/` 根目录并放入 `docs/INDEX.md` 的文档：
 - 总览：项目总览、部署说明、运行约束
 - 状态：当前状态快照、健康检查摘要
 - 审计：数据库、自维护、安全、代码库清理等审计结论
 - 设计：当前仍在执行中的架构设计
 - 规格：仍然有效的接口、产物、目录或包结构规范
 ### 3.2 过程型文档
 通常不应作为主事实来源，除非 `docs/INDEX.md` 显式列入“当前有效”：
 - 实施计划
 - TODO 清单
 - 阶段性实验记录
 - 迁移草案
 - 工作过程笔记
 ### 3.3 历史文档
 满足以下任一条件时，应优先考虑归档到 `docs/archive/`：
 - 已被更新文档明确取代
 - 描述的是已结束阶段
 - 只保留历史讨论价值，不再指导当前开发或部署
 ## 4. 放置规则
 ### 4.1 仓库根目录
 根目录只保留高频入口或必须靠近项目根的文件：
 - `README.md`
 - `.env.example`
 - 启动脚本
 - 极少数确实需要放在根目录的说明文件
 不应在根目录长期堆积阶段性分析、实验记录、临时修复说明。
 ### 4.2 `docs/`
 `docs/` 根目录用于放当前仍有导航价值的正式文档。
 ### 4.3 `docs/archive/`
 `docs/archive/` 用于放：
 - 已退役设计
 - 已完成修复的过程文档
 - 旧版方案
 - 只保留追溯价值的材料
 当归档材料数量继续增长时，应维护：
 - `docs/archive/INDEX.md`
 用于提供历史文档的结构化入口。
 ## 5. 命名规则
 建议优先使用以下命名模式：
 - `CURRENT_STATUS_YYYYMMDD.md`
  当前状态快照
 - `*_AUDIT_YYYYMMDD.md`
  审计结论
 - `*_DESIGN_YYYYMMDD.md`
  当前设计
 - `*_SPEC.md`
  稳定规格
 - `*_PLAN_YYYYMMDD.md`
  计划文档
 - `*_TODO_YYYYMMDD.md` 或 `*_TODO.md`
  待办事项
 - `*_EXPERIMENT_YYYYMMDD.md`
  实验记录
 规则：
 - 有日期的文档应表达“状态时间点”或“阶段结论”。
 - 没有日期的文档应尽量只用于长期有效的稳定说明。
 - 如果文档已经明显是阶段性材料，不要再继续使用无日期命名。
 ## 6. 索引维护规则
 每次新增或退役正式文档时，至少同步更新以下其中之一：
 - `README.md`
 - `docs/INDEX.md`
 推荐规则：
 - 新的正式文档进入 `docs/` 根目录时，必须决定是否加入 `docs/INDEX.md`
 - 文档失效时，必须从“当前有效”区移除
 - 被取代文档如仍需保留，应移动到 `docs/archive/`
 ## 7. 语言与编码规则
 ### 7.1 文档语言
 当前项目以中文工程文档为主，这没有问题。
 但为了降低终端编码、跨环境协作和代码审阅成本，建议：
 - 代码注释与 docstring：默认使用 English
 - 用户界面文案：可继续使用中文
 - 面向本地团队的正式说明文档：可使用中文
 - 如同一主题同时涉及代码约束与面向用户的描述，优先让代码侧说明保持 English
 ### 7.2 编码
 文本文件建议统一使用：
 - UTF-8
 - 尽量无 BOM
 如果 PowerShell 中看到乱码，不应立即判断源码损坏。应先：
 1. 在编辑器中确认文件实际编码
 2. 再决定是否需要修复源文件
 ## 8. `INIT.md` 的定位
 `INIT.md` 视为“开发/运维工作笔记”，不是系统架构、部署或运行事实的最高依据。
 使用原则：
 - 可以记录当前机器、本轮修复、局部操作注意事项
 - 不应替代 `README.md` 和 `docs/INDEX.md`
 - 如果其中内容已经成为长期规则，应迁移到正式文档中
 ## 9. 当前建议的下一步整理方向
 后续文档清理建议按以下顺序推进：
 1. 保持 `README.md` 与 `docs/INDEX.md` 为主导航入口
 2. 将明确失效的阶段性文档继续迁入 `docs/archive/`
 3. 收紧 `docs/` 根目录，只保留当前仍需导航的文档
 4. 逐步减少无明确角色的过程型文件
@@ -1,18 +1,21 @@
 # 文档索引
-本索引用来区分“当前有效文档”和“历史参考文档”。
+本页用于区分“当前有效文档”和“历史参考文档”。
 原则：
- 以本页列为“当前有效”的文档，才作为现网架构、部署和运维的事实依据。
+- 只有列在“当前有效”区域的文档，才作为现网架构、部署、运维和产品边界的事实依据。
- 没有列入“当前有效”区域的文档，默认只作为设计过程记录或历史参考。
+- 没有列入“当前有效”区域的材料，默认只作为设计过程记录、阶段性任务单或历史参考。
- 旧文档即使仍保留在 `docs/` 根目录，也不代表它仍然描述当前系统。
+- 历史文档即使还保留在仓库中，也不应被当作当前系统的真实规则。
 ## 1. 当前有效
 - [../README.md](../README.md)
  项目总览、当前架构和启动入口。
 - [DOCUMENTATION_GOVERNANCE.md](DOCUMENTATION_GOVERNANCE.md)
  文档治理约定，定义事实来源优先级、命名规则、归档规则与语言/编码约束。
 - [CURRENT_STATUS_20260425.md](CURRENT_STATUS_20260425.md)
  2026-04-25 的项目状态快照，包含结果目录、运行时、健康检查摘要。
@@ -22,6 +25,9 @@
 - [DATABASE_SELF_MAINTENANCE_AUDIT_20260425.md](DATABASE_SELF_MAINTENANCE_AUDIT_20260425.md)
  当前数据库自维护机制与现场数据库一致性审计结果。
 - [CODEBASE_CLEANUP_AUDIT_20260425.md](CODEBASE_CLEANUP_AUDIT_20260425.md)
  代码库清理审计，记录过渡文件、文档治理和编码显示问题的判定结果。
 - [PROJ_CONFIGURATION.md](PROJ_CONFIGURATION.md)
  PROJ / GDAL 相关专项配置说明。
@@ -39,9 +45,6 @@
 - [ISCE2_PRODUCTION_RELIABILITY_HARDENING_DESIGN_20260424.md](ISCE2_PRODUCTION_RELIABILITY_HARDENING_DESIGN_20260424.md)
  ISCE2 生产链路稳定性修补与约束。
 - [DINSAR_ENHANCEMENT_TASKS.md](DINSAR_ENHANCEMENT_TASKS.md)
  D-InSAR 生产相关任务清单。
 ## 3. 时序 InSAR / SBAS
 - [ISCE2_SBAS_TIMESERIES_DESIGN.md](ISCE2_SBAS_TIMESERIES_DESIGN.md)
@@ -51,38 +54,56 @@
 - 当前前端顶级显示名已经统一为“时序 InSAR”。
 - 当前默认接入仍然是 SBAS 路径，因此这两份文档仍然有效。
- `SBAS_*` 命名的一批旧文档大多是阶段性设计材料，不再作为总事实来源。
+- `SBAS_*` 命名的一批旧文档已经归档，只保留历史追溯价值。
 ## 4. 配对与前端导航
 - [PAIRING_ENHANCEMENT_DESIGN.md](PAIRING_ENHANCEMENT_DESIGN.md)
 - [PAIRING_SYSTEM_REFACTOR_PLAN_20260413.md](PAIRING_SYSTEM_REFACTOR_PLAN_20260413.md)
 - [FRONTEND_NAVIGATION_ARCHITECTURE.md](FRONTEND_NAVIGATION_ARCHITECTURE.md)
-## 5. Gamma / PyINT / WSL 预留
+说明：
 - `PAIRING_ENHANCEMENT_DESIGN.md` 保留配对语义、策略命名和产品交互边界设计价值。
 - 当前 pairing cache 的运行态事实，以 `CURRENT_STATUS_20260425.md` 和 `DATABASE_SELF_MAINTENANCE_AUDIT_20260425.md` 为准。
 ## 5. Gamma / PyINT
 - [GAMMA_WSL2_INTEGRATION_PLAN.md](GAMMA_WSL2_INTEGRATION_PLAN.md)
 - [PYINT_GAMMA_INTEGRATION_DESIGN_20260418.md](PYINT_GAMMA_INTEGRATION_DESIGN_20260418.md)
 - [PYINT_INPUT_ASSET_ADAPTATION_DESIGN_20260419.md](PYINT_INPUT_ASSET_ADAPTATION_DESIGN_20260419.md)
 - [PYINT_LT1_PRECISE_ORBIT_BRIDGE_DESIGN_20260419.md](PYINT_LT1_PRECISE_ORBIT_BRIDGE_DESIGN_20260419.md)
 - [PYINT_GAMMA_AB_FINDINGS_20260420.md](PYINT_GAMMA_AB_FINDINGS_20260420.md)
 说明：
- 这部分主要作为 Gamma / PyINT 接入的预留设计和实验记录。
+- 这部分保留当前仍有导航价值的 PyINT / Gamma 设计与结论。
- 真正的当前运行时事实，以 `WSL_RUNTIME_REFACTOR_DESIGN_20260422.md`、`.env` 和健康面板为准。
+- 旧的 `GAMMA_WSL2_INTEGRATION_PLAN.md` 已于 2026-04-26 归档，因为它描述的是已被替代的 `/idl` + 独立 Gamma 服务方案。
 - 真正的当前运行时事实，以 `WSL_RUNTIME_REFACTOR_DESIGN_20260422.md`、`README.md` 和健康面板为准。
 ## 6. 安全与审计
 - [SECURITY_AUDIT_2026-03-12.md](SECURITY_AUDIT_2026-03-12.md)
-## 7. 历史参考
+## 7. 工作笔记
 - [../INIT.md](../INIT.md)
 说明：
 - `INIT.md` 视为工作笔记，不是架构、部署和运行事实的最高依据。
 - 需要判断“当前真实规则”时，优先看 `README.md`、本页和长期有效文档。
 ## 8. 历史参考
 以下材料默认视为历史设计记录或过程文档：
 - [archive/INDEX.md](archive/INDEX.md)
 - `docs/archive/`
- `SBAS_*`
+- 已归档的 `SBAS_*` 阶段文档
- `WSL2_ISCE2_MINTPY_SBAS_INTEGRATION_PLAN_20260412.md`
+- 已归档的 `GAMMA_WSL2_INTEGRATION_PLAN.md`
- `项目汇报.md`
+- 已归档的 `PAIRING_SYSTEM_REFACTOR_PLAN_20260413.md`
- 各类 `*_EXPERIMENT_*` / `*_PROGRESS_*` / `*_TODO_*`
+- 已归档的 `DINSAR_ENHANCEMENT_TASKS.md`
 - 已归档的 `WSL2_ISCE2_MINTPY_SBAS_INTEGRATION_PLAN_20260412.md`
 - 已归档的 `项目汇报.md`
 - 已归档的各类 `*_EXPERIMENT_*` / `*_PROGRESS_*` / `*_TODO_*`
-最后更新：2026-04-25
+最后更新：2026-04-26
@@ -2,13 +2,15 @@
 **版本**: v2.0
 **日期**: 2026-03-08
-**状态**: 设计阶段
+**状态**: 概念设计，部分能力已落地
 > 更新说明（2026-04-26）：截至 2026-04-25，pairing cache、pairing health 状态和基础指标统计已经在现网落地。当前运行态事实请优先参考 `CURRENT_STATUS_20260425.md`、`DATABASE_SELF_MAINTENANCE_AUDIT_20260425.md` 和健康检查接口；本文档保留配对语义、策略命名、产品交互和后续演进方向的设计价值。
 ---
 ## 一、背景与目标
-### 1.1 现有系统局限
+### 1.1 设计起点（2026-03-08 基线）
 当前配对系统采用**单池全组合**模式：
 - 所有影像放入同一个池子，两两组合，用时间基线范围过滤
@@ -164,7 +164,7 @@ GET /api/ai-diagnosis?page=1&limit=20&result_id=123&risk_level=HIGH&sort=-create
 GET /api/ai-diagnosis/{id}
 ```
-**响��**：
+**响应**：
 ```json
 {
  "id": 42,
@@ -121,7 +121,7 @@
 |------|------|
 | `backend/app/services/envi_service.py` | ENVI 工作流核心（6 步流程、GCP 生成、文件稳定等待） |
 | `backend/app/services/envi_runner_cli.py` | 子进程入口（加载 .env、调用 run_workflow） |
-| `backend/app/services/job_handlers.py` | Job handler（子进程监控、keepalive、文件稳定检查��� |
+| `backend/app/services/job_handlers.py` | Job handler（子进程监控、keepalive、文件稳定检查） |
 | `backend/app/services/job_worker.py` | Worker 主循环（心跳、stale 检测） |
 | `backend/app/services/task_service.py` | Task 管理（僵尸检测在 get_active_tasks 中） |
 | `backend/app/routers/tasks.py` | Task API（含 force-cancel 端点） |
@@ -0,0 +1,85 @@
 # 历史文档索引
 最后更新：2026-04-26
 本页用于组织 `docs/archive/` 下的历史文档。
 原则：
 - 本目录中的材料默认不作为当前系统事实来源。
 - 它们保留用于追溯设计演进、阶段性判断和历史决策背景。
 - 当前真实规则优先看：
  - [../../README.md](../../README.md)
  - [../INDEX.md](../INDEX.md)
  - [../DOCUMENTATION_GOVERNANCE.md](../DOCUMENTATION_GOVERNANCE.md)
 ## 1. 2026-04-26 归档批次
 ### 1.1 旧 Gamma 直连方案
 - [GAMMA_WSL2_INTEGRATION_PLAN.md](GAMMA_WSL2_INTEGRATION_PLAN.md)
 说明：
 - 这份文档描述的是旧的 `/idl/jobs/dinsar` + 独立 Gamma service / status 端点方案。
 - 当前代码和文档已经转向多引擎生产中心、共享 WSL 运行时和 `pyint`/Gamma 集成路径，因此该文档只保留历史参考价值。
 ### 1.2 旧配对重构计划与任务板
 - [PAIRING_SYSTEM_REFACTOR_PLAN_20260413.md](PAIRING_SYSTEM_REFACTOR_PLAN_20260413.md)
 - [DINSAR_ENHANCEMENT_TASKS.md](DINSAR_ENHANCEMENT_TASKS.md)
 说明：
 - 这两份材料保留分阶段计划和当时边界判断的价值，但不再作为当前系统事实来源。
 - 当前 pairing 运行态事实以 `CURRENT_STATUS_20260425.md`、`DATABASE_SELF_MAINTENANCE_AUDIT_20260425.md` 和健康检查为准。
 - 当前 D-InSAR 生产设计以 `PRODUCTION_RESULTS_MULTI_ENGINE_DESIGN_20260423.md`、`ISCE2_MANAGED_DINSAR_IMPLEMENTATION_20260424.md`、`ISCE2_PRODUCTION_RELIABILITY_HARDENING_DESIGN_20260424.md` 为准。
 ## 2. 2026-04-25 归档批次
 ### 2.1 SBAS 阶段文档
 - [SBAS_FRONTEND_UX_SPEC_20260406.md](SBAS_FRONTEND_UX_SPEC_20260406.md)
 - [SBAS_IMPLEMENTATION_TODO_20260406.md](SBAS_IMPLEMENTATION_TODO_20260406.md)
 - [SBAS_PROGRESS_STATUS_20260406.md](SBAS_PROGRESS_STATUS_20260406.md)
 - [SBAS_RESULT_MANAGEMENT_AND_DISPLAY_SPEC_20260406.md](SBAS_RESULT_MANAGEMENT_AND_DISPLAY_SPEC_20260406.md)
 - [SBAS_SYSTEM_CHANGE_RISK_ASSESSMENT_20260406.md](SBAS_SYSTEM_CHANGE_RISK_ASSESSMENT_20260406.md)
 - [SBAS_SYSTEM_EMBEDDING_DESIGN_20260406.md](SBAS_SYSTEM_EMBEDDING_DESIGN_20260406.md)
 - [SBAS_SYSTEM_INTEGRATION_AUDIT_20260406.md](SBAS_SYSTEM_INTEGRATION_AUDIT_20260406.md)
 - [SBAS_TASK_PATH_MODE_EVALUATION_20260406.md](SBAS_TASK_PATH_MODE_EVALUATION_20260406.md)
 说明：
 - 这批文档描述的是时序 InSAR / SBAS 接入初期的阶段方案。
 - 当前仍有效的时序主文档保留在 `docs/` 根目录：
  - [../ISCE2_SBAS_TIMESERIES_DESIGN.md](../ISCE2_SBAS_TIMESERIES_DESIGN.md)
  - [../ISCE2_SBAS_PRODUCT_SPEC.md](../ISCE2_SBAS_PRODUCT_SPEC.md)
 ### 2.2 旧集成方案与汇报材料
 - [WSL2_ISCE2_MINTPY_SBAS_INTEGRATION_PLAN_20260412.md](WSL2_ISCE2_MINTPY_SBAS_INTEGRATION_PLAN_20260412.md)
 - [项目汇报.md](项目汇报.md)
 ### 2.3 PyINT 过程型材料
 - [PYINT_GAMMA_IMPLEMENTATION_TODO_20260418.md](PYINT_GAMMA_IMPLEMENTATION_TODO_20260418.md)
 - [PYINT_LT1_COREG_ORBIT_HYPOTHESIS_EXPERIMENT_20260420.md](PYINT_LT1_COREG_ORBIT_HYPOTHESIS_EXPERIMENT_20260420.md)
 - [PYINT_LT1_DEM_GEOMETRY_CHAIN_EXPERIMENT_20260420.md](PYINT_LT1_DEM_GEOMETRY_CHAIN_EXPERIMENT_20260420.md)
 - [PYINT_LT1_DEM_SOURCE_EXPERIMENT_RESULTS_20260420.md](PYINT_LT1_DEM_SOURCE_EXPERIMENT_RESULTS_20260420.md)
 - [PYINT_LT1_PAIR_SELECTION_EXPERIMENT_20260421.md](PYINT_LT1_PAIR_SELECTION_EXPERIMENT_20260421.md)
 说明：
 - 这批文档保留实验和实施过程价值，但不再放在主导航中。
 - 当前仍有导航价值的 PyINT 文档保留在 `docs/` 根目录。
 ## 3. 更早的历史文档
 本目录还保留以下较早批次的历史材料：
 - 安全审计与修复过程
 - 热修复记录
 - 旧版 AI / ENVI / 日志管理设计
 - 历史 TODO 与阶段性工作单
 如需判断它们是否仍然有效，以 `docs/INDEX.md` 的“当前有效”区为准。