feat(startup): finalize v1.1 startup optimization and docs sync for v1.7.0

Author: Jacobinwwey

docs/diataxis/en/explanation/startup-node-update-acceleration-plan.md

@@ -237,3 +237,32 @@ npm run perf:startup:matrix -- --root tmp/startup-logs --single-platform-label w
   - `TFS`: `2299.40ms -> 1679.50ms`, improvement `26.96%`
 - Final report:
   - `tmp/startup-logs/report-planb-final-windows.md`
+
+## 17) v1.1 Optimization + Risk Guardrail Hardening (March 31, 2026)
+
+- Runtime optimization additions:
+  - Worker delta now supports low-alpha adaptive policy:
+    - `lowAlphaDeltaEpsilonMultiplier` (raises epsilon near stable phase to reduce payload size)
+    - `lowAlphaFullSyncEveryTicks` (relaxes periodic full-sync frequency near stable phase)
+  - Worker tick payload now includes node index fast-path (`nodes[].i`) to reduce main-thread id-map lookup overhead.
+  - Main thread startup tick application is frame-coalesced:
+    - multiple tick messages in one frame are merged,
+    - position updates apply once per frame,
+    - redundant empty-delta paints are skipped.
+- Risk mitigation additions:
+  - Warm snapshot apply now has strict runtime validation:
+    - fingerprint consistency check,
+    - snapshot age guard (`STARTUP_LAYOUT_SNAPSHOT_MAX_AGE_MS`),
+    - node/edge count consistency check,
+    - position coverage floor (`>=90%`) to avoid partial snapshot corruption.
+  - Invalid snapshots are auto-rejected with structured warning logs and cold-start fallback.
+- Observability additions:
+  - `T5 stable_layout` checkpoint now emits `tickSummary`:
+    - `fullTicks`, `deltaTicks`, `deltaRatio`,
+    - `avgPayloadNodes`, `maxPayloadNodes`,
+    - `tickFramesApplied`, `skippedEmptyDeltaFrames`.
+
+Expected effect:
+- Lower startup transfer pressure in low-alpha settle phase.
+- Lower main-thread no-op paint ratio under high tick cadence.
+- Better safety against stale/corrupt snapshot recovery regressions.

docs/diataxis/en/reference/interfaces-and-runtime.md

@@ -23,7 +23,7 @@ This reference tracks canonical API/runtime contracts.
   - `get_app_runtime_config`
 - Runtime bridge readiness sequencing via `whenReady()`.
 
-## Startup Perf Telemetry and Pilot Profile (v1.6.9+ pilot)
+## Startup Perf Telemetry and Pilot Profile (v1.7.0+ pilot)
 
 - Frontend startup checkpoints are emitted as one-shot logs:
   - `T0 app_boot`
@@ -43,10 +43,14 @@ This reference tracks canonical API/runtime contracts.
   - `startupProfile.deltaEnabled`
   - `startupProfile.deltaEpsilonPx`
   - `startupProfile.fullSyncEveryTicks`
+  - `startupProfile.lowAlphaDeltaEpsilonMultiplier`
+  - `startupProfile.lowAlphaFullSyncEveryTicks`
 - Worker -> main-thread tick transport contract (Phase 2):
   - `tickMode: 'full' | 'delta'`
   - `isDelta: boolean`
-  - `nodes: [{ id, x, y }]` (delta mode only includes changed nodes)
+  - `nodes: [{ id, i, x, y }]` (`i` is the worker node index fast-path; delta mode only includes changed nodes)
+  - Startup tick application is frame-coalesced on main thread to reduce redundant repaint pressure.
+  - `T5 stable_layout` details include `tickSummary` (`fullTicks`, `deltaTicks`, `deltaRatio`, payload stats).
 - Multi-platform startup pilot profiles:
   - `desktop_windows_pilot`: `26 FPS`, `400ms` edge delay, `1500ms` SVG cap window (`18000` links).
   - `desktop_macos_pilot`: `24 FPS`, `430ms` edge delay, `1700ms` SVG cap window (`15000` links).

docs/diataxis/zh/explanation/startup-node-update-acceleration-plan.md

@@ -237,3 +237,32 @@ npm run perf:startup:matrix -- --root tmp/startup-logs --single-platform-label w
   - `TFS`：`2299.40ms -> 1679.50ms`，提升 `26.96%`
 - 最终报告：
   - `tmp/startup-logs/report-planb-final-windows.md`
+
+## 17) v1.1 优化与风险护栏加固（2026-03-31）
+
+- 运行时优化新增：
+  - Worker Delta 在低 alpha 阶段支持自适应策略：
+    - `lowAlphaDeltaEpsilonMultiplier`（稳定期增大 epsilon，降低传输载荷）
+    - `lowAlphaFullSyncEveryTicks`（稳定期放宽全量同步周期）
+  - Worker tick 载荷新增节点索引快速路径（`nodes[].i`），减少主线程按 id 回查开销。
+  - 主线程启动期 tick 改为“帧级合并应用”：
+    - 同一帧内多条 tick 合并，
+    - 每帧仅一次位置回写与渲染触发，
+    - 空 delta 帧自动跳过，减少无效重绘。
+- 风险规避新增：
+  - Warm Snapshot 应用前增加严格校验：
+    - 指纹一致性校验，
+    - 快照时效校验（`STARTUP_LAYOUT_SNAPSHOT_MAX_AGE_MS`），
+    - 节点/边数量一致性校验，
+    - 位置覆盖率下限（`>=90%`）校验，规避局部损坏快照误恢复。
+  - 非法快照自动拒绝并记录结构化告警日志，回退至冷启动路径。
+- 观测增强新增：
+  - `T5 stable_layout` 增加 `tickSummary` 输出：
+    - `fullTicks`、`deltaTicks`、`deltaRatio`，
+    - `avgPayloadNodes`、`maxPayloadNodes`，
+    - `tickFramesApplied`、`skippedEmptyDeltaFrames`。
+
+预期效果：
+- 进一步降低稳定阶段 Worker->主线程传输压力。
+- 降低高频 tick 下主线程无效重绘比例。
+- 提升快照恢复链路对陈旧/损坏数据的容错能力。

docs/diataxis/zh/reference/interfaces-and-runtime.md

@@ -23,7 +23,7 @@
   - `get_app_runtime_config`
 - Runtime bridge 通过 `whenReady()` 保障调用时序。
 
-## 启动性能观测与试点 Profile（v1.6.9+ 试点）
+## 启动性能观测与试点 Profile（v1.7.0+ 试点）
 
 - 前端启动关键点采用单次日志输出：
   - `T0 app_boot`
@@ -43,10 +43,14 @@
   - `startupProfile.deltaEnabled`
   - `startupProfile.deltaEpsilonPx`
   - `startupProfile.fullSyncEveryTicks`
+  - `startupProfile.lowAlphaDeltaEpsilonMultiplier`
+  - `startupProfile.lowAlphaFullSyncEveryTicks`
 - Worker -> 主线程 tick 传输契约（Phase 2）：
   - `tickMode: 'full' | 'delta'`
   - `isDelta: boolean`
-  - `nodes: [{ id, x, y }]`（delta 模式仅包含变化节点）
+  - `nodes: [{ id, i, x, y }]`（`i` 为 Worker 节点索引快速路径；delta 模式仅包含变化节点）
+  - 主线程对启动期 tick 采用帧级合并应用，降低重复重绘压力。
+  - `T5 stable_layout` 附带 `tickSummary`（`fullTicks`、`deltaTicks`、`deltaRatio` 与载荷统计）。
 - 多平台启动试点 profile：
   - `desktop_windows_pilot`：`26 FPS`、`400ms` 边延迟、`1500ms` SVG 窗口（`18000` 条边）。
   - `desktop_macos_pilot`：`24 FPS`、`430ms` 边延迟、`1700ms` SVG 窗口（`15000` 条边）。

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "noteconnection",
-  "version": "1.6.9",
+  "version": "1.7.0",
   "description": "Hierarchical Knowledge Graph Visualization System",
   "main": "dist/src/server.js",
   "bin": {

package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://schema.tauri.app/config/2",
   "productName": "NoteConnection",
-  "version": "1.6.9",
+  "version": "1.7.0",
   "identifier": "com.jacobinwwey.noteconnection",
   "build": {
     "beforeDevCommand": "",