docs/前端合并审阅问题与修复复盘.md

@@ -247,11 +247,28 @@ git diff --check passed
 
 ## 11. 当前边界与后续事项
 
-本轮修复解决了前端壳子的工程正确性和接口边界，不代表全部前端页面已经完成。后续仍需要：
+首次修复解决了前端壳子的工程正确性和接口边界。之后已继续补齐全部业务路由页面；Tauri Host、Stronghold 和真实文件系统仍属于桌面集成阶段。后续仍需要：
 
-- 实现 Search、Chat、Agent、Task、Skill、Plugin、Theme 和 Settings 页面；
 - 为 Service DTO 映射增加自动化契约测试；
 - 为 SSE Parser 增加跨 Chunk 单元测试；
 - 用 Tauri Command 替换 Mock Workspace Service；
-- 完成 Citation 定位、Agent Permission Dialog 和 Trace 可视化；
 - 在 CI 中加入前端构建和后端测试两个必需检查。
+
+## 12. 全页面完成后的第二轮审阅与修复
+
+全部页面接通后再次审阅，发现编译通过并不等于交互状态正确。本轮问题与处理如下：
+
+| 编号 | 问题 | 原因与后果 | 解决方案 |
+| --- | --- | --- | --- |
+| F-08 | Markdown 没有真实渲染 | 写作与源码模式共用同一个 `textarea`，Chat 也把 Markdown 当纯文本显示 | 使用 `marked` 解析 GFM，使用 DOMPurify 清洗 HTML；编辑页提供源码输入和实时预览，Chat 回答复用安全渲染器 |
+| F-09 | 重命名后路径仍是旧值 | 只修改节点名称，没有同步节点、子节点、打开文件和编辑器路径，后续保存或删除会作用于旧路径 | 新增递归路径迁移，同时更新 `openFiles`、活动路径和 Editor 当前路径；Mock 内容缓存也随路径迁移 |
+| F-10 | 删除活动文件后正文错位 | Workspace 切换了活动文件，但 Editor 仍保留已删除文件正文 | 删除文件或文件夹时统一清理其所有打开路径；若存在下一个文件则加载，否则关闭编辑器 |
+| F-11 | 异步读取和保存存在竞态 | 快速切换文件可能让较早请求覆盖较新文件；保存过程中继续编辑会被错误标记为已保存 | 使用读取版本号丢弃过期结果；保存使用路径和正文快照，只有快照仍是最新内容时才标记 `saved` |
+| F-12 | Agent 权限弹窗跨 Run 残留 | 切换 Run、ToolResult 和终态事件没有释放 PermissionRequest | 加载 Run 前清空请求，并在 ToolResult、Completed、Failed、Cancelled 时同步清理；同时更新本地 Run 状态 |
+| F-13 | Chat 丢弃非文本 SSE 事件 | Store 只处理 TextDelta 和 Error，Tool Call 请求会留下空消息 | 增加 Thinking、ToolCall Start/Delta/End、Usage 和 Citation 状态处理及页面卡片展示 |
+| F-14 | Task 字段表现为保存但实际丢失 | 前端展示后端不支持的 Priority/Source，更新请求又漏掉后端已支持的 `note_id` | 暂时移除不可持久化字段的编辑与筛选；补齐 `note_id` 更新与解除关联的 `null` 语义 |
+| F-15 | 编辑器设置不生效 | Settings Store 与 Editor/Theme 没有联动，自动保存固定为 1500ms | 自动保存、默认模式、拼写检查、字号、行高和行宽改为实际驱动编辑器，并保存到 Local Storage |
+| F-16 | Vector 降级提示永远不可达 | `vectorUnavailable` 只声明不赋值，向量错误直接清空结果 | 对明确的向量、Embedding、模型和 Provider 不可用错误自动重试 FTS，并显示降级状态 |
+| F-17 | 护眼主题与 Plugin 导航状态异常 | Sepia 只有预览卡没有 Token；Plugin 路由被错误映射为 Skill 激活状态 | 增加 Sepia Design Token，并按真实路由名计算主导航选中项 |
+
+安全边界：Markdown 解析结果不得直接使用未经清洗的 `v-html`。DOMPurify 是渲染链路的必需依赖，后续升级 `marked` 或允许扩展 Markdown 时也必须保留清洗步骤。