docs: 发布 v0.3.10，更新 README, CHANGELOG 及物理发布日志

Author: peterfei

CHANGELOG.md

@@ -1,5 +1,24 @@
 # 更新日志
 
+## [0.3.10] - 2026-03-11
+### 🛡️ 极致稳定性加固与物理状态隔离
+
+#### 1. UI 极致稳定性优化
+- **智能粘性滚动**：引入 50px 物理阈值检测，仅在底部附近触发自动滚动，允许用户在流式生成过程中自由向上回溯，消除“滚动锁死”痛点。
+- **防闪屏渲染**：彻底重构 `VirtualMessageList`，消除加载状态切换时的组件全量卸载逻辑，实现长对话流式生成的视觉零抖动。
+
+#### 2. 物理级工作区隔离
+- **环境物理清理**：实现 `clearProjectState` 核心方法，在切换项目根目录时，强制清理打开文件、PIVO 任务树、选中节点及全局索引，彻底杜绝多项目间的状态交叉污染。
+- **资源即时同步**：写入类工具执行成功后，立即主动触发资源管理器刷新，确保文件系统变更毫秒级同步至 UI。
+
+#### 3. DebuggerAgent v0.5.0 物理加固
+- **强同步初始化**：将监听器激活时机从全局静态初始化改为指令发送时按需物理激活，确保 Tauri 事件总线 100% 挂载成功。
+- **路径归一化**：内联预览自动剥离项目根路径，保障 Rust 后端推送的绝对路径在前端 UI 中精准对齐。
+
+#### 4. ToolCall 协议与路径补全加固
+- **意图锁定补全**：针对长对话导致的路径丢失，实现 PIVO 任务目标优先的自动补齐逻辑，并配合 UI 级手动文件名输入框，彻底跳过 LLM 低效纠偏。
+- **防覆盖保护**：在合并 AI 参数时增加物理守卫，拒绝空字符串覆盖已锚定的合法路径。
+
 ## [0.3.9] - 2026-03-06
 ### 🚀 物理链路保真加固与 Symbol-First 认知革命
 

README.md

@@ -16,7 +16,7 @@
 
 ---
 
-### 🌟 v0.3.9 新特性：物理探测引擎与存储保真
+### 🌟 v0.3.10 新特性：物理探测引擎与存储保真
 - **Symbol-First 探测引擎**：引入“骨架优先”认知模式，毫秒级解析大文件物理结构，彻底解决 10KB+ 文件的上下文溢出问题。
 - **物理链路保真加固**：全量存储迁移至 IndexedDB，根治 LocalStorage 5MB 限制；修复大型 JSON 渲染漏洞。
 - **NVIDIA NIM 深度适配**：Rust 后端自动路径校准，完美支持 NIM 工业级推理协议，消除 404 配置陷阱。
@@ -51,7 +51,7 @@
 
 | 版本 | 主题 | 核心突破 |
 | :--- | :--- | :--- |
-| **v0.3.9** | **物理保真与认知升级** | **Symbol-First 探测引擎、全量 IndexedDB 迁移、NVIDIA NIM 集成、动态 Token 物理统计** |
+| **v0.3.10** | **物理保真与认知升级** | **Symbol-First 探测引擎、全量 IndexedDB 迁移、NVIDIA NIM 集成、动态 Token 物理统计** |
 | **v0.3.8** | **任务重构与高保真** | **PIVO 3.0 任务规划引擎、双屏协同交互、渲染削峰算法、Sentinel 权威哨兵** |
 | **v0.3.7** | **资产安全与沉浸预览** | **路径感知风险引擎、编辑器原位审批、自动聚焦变更点、Rust 执行层物理沙箱** |
 | **v0.3.6** | **UI 重构与结构化** | **模型胶囊面板、PIVO 2.0 异步预览、全链路结构化 PivoProjectTree 渲染** |

README_EN.md

@@ -1,6 +1,6 @@
 # IfAI
 
-### 🌟 v0.3.9 Highlights: Physical Fidelity & Cognitive Upgrade
+### 🌟 v0.3.10 Highlights: Physical Fidelity & Cognitive Upgrade
 - **Symbol-First Probing Engine**: New "skeleton-first" cognition mode, resolving context overflow for 10KB+ files via millisecond-level physical structure analysis.
 - **Physical Fidelity Reinforcement**: Full storage migration to IndexedDB (bye-bye 5MB LocalStorage limit); fixed large JSON rendering fidelity.
 - **NVIDIA NIM Deep Integration**: Rust-based URL auto-calibration for industrial-grade inference protocols, resolving 404 configuration pitfalls.

docs/RELEASE-v0.3.10.md

@@ -0,0 +1,28 @@
+# Release Notes v0.3.10 - 🛡️ 极致稳定性加固与物理状态隔离
+
+## 概述
+v0.3.10 是一个专注于**工程健壮性**与**极致交互体验**的关键版本。我们针对长对话下的参数丢失、多项目切换的状态残留以及流式生成的视觉跳变进行了物理级加固。
+
+## 核心改进
+
+### 1. UI 极致稳定性 (Smart UI)
+*   **智能粘性滚动**：引入 50px 物理阈值检测。只有当用户处于底部附近时，新的消息才会触发自动滚动。这允许用户在 AI 生成长代码时自由向上回溯查阅，彻底解决了“滚动条锁死”的交互痛点。
+*   **物理防闪屏**：重构了 `VirtualMessageList` 的渲染路径，确保 `isLoading` 状态切换时组件实例保持稳定，长对话加载现在平滑如镜。
+
+### 2. 物理级工作区隔离 (Workspace Isolation)
+*   **状态彻底重置**：实现了 `clearProjectState` 核心逻辑。当用户切换项目根目录时，系统会自动物理清理：
+    *   所有打开的文件标签页。
+    *   当前的 PIVO 任务树缓存。
+    *   全局搜索索引与节点选中状态。
+*   **杜绝交叉污染**：确保用户在 A 项目生成的 AI 逻辑不会误写进 B 项目的文件中。
+
+### 3. DebuggerAgent v0.5.0 链路加固
+*   **强同步激活**：修复了 Tauri 事件监听器在全局初始化时可能丢失的问题。现在监听器会在指令发出的瞬间物理激活，确保 100% 成功。
+*   **预览路径纠偏**：解决了内联预览无法打开绝对路径文件的 Bug，现在系统能自动对齐 Rust 后端与前端的物理路径坐标。
+
+### 4. ToolCall 协议安全哨兵
+*   **意图锁定机制**：针对超过 500 行的长内容生成，引入了物理级参数补全。如果 AI 漏传路径，系统会优先匹配 PIVO 任务目标，确保写入永不落空。
+*   **UI 级纠偏**：如果物理回收失败，UI 将提供红色输入框由用户手动补全，跳过 LLM 昂贵的重试流程。
+
+## 物理保真度
+该版本代码已通过物理链路验证，重点加固了 Store 层与 Rust 后端的通讯一致性。建议所有用户立即更新以获得最稳定的自动化重构体验。