From deda642bd63e6570bdc308e22917257c269677a5 Mon Sep 17 00:00:00 2001
From: Ed1s0nZ <zhaoyf1104@gmail.com>
Date: Sat, 10 Oct 2026 20:46:29 +0800
Subject: [PATCH] docs: document SQLite startup repair release readiness

---
 CHANGELOG.md                                      |  4 ++++
 .../startup-schema-reconcile/review-readiness.md  | 15 +++++++++++++++
 2 files changed, 19 insertions(+)
 create mode 100644 docs/feature/startup-schema-reconcile/review-readiness.md

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 11bb02c0..a221a34b 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,6 +2,10 @@
 
 ## Unreleased
 
+### Added
+
+- 启动时以统一最新 SQLite 定义自动检查全部项目管理表，缺表建表、缺字段补字段，无需维护逐字段迁移列表；保留已有数据和额外表/字段，结构补齐失败回滚并阻止启动。HITL 与通知表纳入统一初始化，历史漏洞外键迁移保留额外列、索引、触发器及依赖记录。
+
 ### Fixed
 
 - C2 Profile 和 WebShell 删除不存在对象统一返回 404，删除数据库故障返回通用 500 文案，不再暴露 SQL 错误；漏洞和批量任务列表无匹配记录时统一返回 `[]`，补充 HTTP 合同回归验证。
diff --git a/docs/feature/startup-schema-reconcile/review-readiness.md b/docs/feature/startup-schema-reconcile/review-readiness.md
new file mode 100644
index 00000000..cf0e2043
--- /dev/null
+++ b/docs/feature/startup-schema-reconcile/review-readiness.md
@@ -0,0 +1,15 @@
+# SQLite 结构补齐合并准备记录
+
+- Phase: F6 complete (implementation and verification ready; not merged/released)
+- Branch: codex/startup-schema-reconcile
+- Code commit: 7f8dab4e
+- Verification commit: f2f4416a
+- Changelog: Unreleased / Added
+
+## 自检结论
+
+启动的建表与补字段依据统一 SQL，仓库生产 Go 代码无独立字段迁移列表。检查覆盖数据库入口及原处理器中的表。新增结构在事务内提交；错误携带表/字段，不被警告吞掉。历史语义迁移单独保留并验证数据不丢失。已有列类型和约束变更仍需独立设计；SQLite 不能安全添加的列会阻止启动。
+
+需求、设计、计划、实现与验证文档齐备。数据库、知识库调用、处理器与应用初始化测试通过。改动仅涉及 SQLite 结构来源、初始化及相关兼容入口，未运行真实数据升级、生产部署或合并发布。
+
+后续可审阅此分支并按项目流程合并；本次请求的代码修改及验证已完成。