perf: reduce streaming render cost and refresh activity page on demand

- Segment streaming Markdown so completed blocks are reused and only the growing tail is re-parsed; fall back to whole-document parsing for document-wide constructs
- Memoize conversation sidebar rows and cache per-conversation derived activity, ordering and pending approvals
- Activity page loads on entry, refreshes every 15 s while visible, and has a single header refresh button
- Include pending settings, model download source, device sharing and knowledge gateway changes in the working tree
- Add Electron streaming input benchmark and regression tests

docs/architecture/model-download-source-design.md

@@ -12,8 +12,8 @@
 | 目标平台 | Windows、macOS、Linux，x64 与 arm64 |
 | 相关基线 | [统一界面设计系统](../../UI-DESIGN.md)、[文档解析与本地 OCR](../features/document-processing/prd.md)、[本地文本向量模型与连接设计](../features/knowledge-base/local-embedding-technical-design.md)、[全双工实时语音交互设计](../features/full-duplex-voice/technical-design.md) |
 
-本文定义“设置 → 平台功能”的二级页签结构，以及所有 GoodBuddy 托管本地模型共同使用的
-“模型下载源”设置。首期下载源为 ModelScope 和 Hugging Face，默认使用 ModelScope。
+本文定义“设置 → 平台功能”的二级页签结构，以及位于“设置 → 模型连接”、所有 GoodBuddy
+托管本地模型共同使用的“模型下载源”设置。首期下载源为 ModelScope 和 Hugging Face，默认使用 ModelScope。
 
 模型下载源是用户明确选择的供应链路径。当前来源不可用或没有所选模型时，GoodBuddy
 必须明确失败并提供设置入口，**不能静默切换到另一个下载源。**
@@ -25,7 +25,8 @@
 1. “平台功能”保留现有一级设置分类，在分类内部增加共享 `PageTabs`：
    - **通用设置**
    - **远程项目**
-2. “通用设置”首个功能为“模型下载源”。
+2. “模型下载源”位于“模型连接”页头，与模型类型页签同一行右对齐，在保存操作下方；
+   显示当前来源和次按钮，点击后在弹窗中选择并确认保存。
 3. 首期提供两个互斥选项：
    - `modelscope`，用户文案为 **ModelScope**，默认值。
    - `hugging-face`，用户文案为 **Hugging Face**。
@@ -47,8 +48,8 @@
    同一模型包的部分文件从 ModelScope 下载、部分文件从 Hugging Face 下载。
 8. 下载任务启动时冻结来源。任务运行期间切换全局设置，不改变、重启或迁移该任务；新的
    下载使用新来源。
-9. 当前来源失败时，不自动重试另一个来源。错误可以提供“前往通用设置更换下载源”，由
-   用户明确选择。
+9. 当前来源失败时，不自动重试另一个来源。向量、语音和 OCR 的更换下载源入口直接打开
+   “模型连接”页的下载源弹窗，由用户明确选择并确认。
 10. 魔法笔记设置由应用中心与笔记页共享，不在全局设置中重复提供入口。
 
 ---
@@ -59,10 +60,11 @@
 
 “平台功能”现已使用两个二级页签：
 
-- “通用设置”承载全局模型下载源。
+- “通用设置”承载快捷唤起、会话与通知、工作目录设置。
 - “远程项目”承载远程项目开关与 Agent 包管理。
 
 页签复用共享 `PageTabs`，默认打开“通用设置”，不会把当前页签写入应用设置。
+全局模型下载源由“模型连接”页头提供入口，布局和弹窗行为见第 7 节。
 
 ### 2.2 受管模型下载
 
@@ -99,7 +101,7 @@
 - 切换来源时不影响已安装、已选择或正在使用的模型。
 - 下载失败时知道实际使用了哪个来源。
 - 所选来源没有模型时得到明确说明，并可以主动前往设置切换。
-- 在“平台功能”的“通用设置”中选择模型下载源。
+- 在“模型连接”页头打开模型下载源弹窗，选择后确认保存。
 
 ### 3.2 产品目标
 
@@ -163,9 +165,12 @@
 
 ```text
 设置
+├─ 模型连接
+│  └─ 页头：模型类型页签同行右侧的当前来源与“模型下载源”按钮
+│     └─ 模型下载源弹窗
 └─ 平台功能
    ├─ 通用设置
-   │  └─ 模型下载源
+   │  └─ 快捷唤起、会话与通知、工作目录
    └─ 远程项目
       ├─ 远程项目开关
       └─ Agent 包管理
@@ -221,21 +226,20 @@
 
 ---
 
-## 7. 通用设置界面
+## 7. 模型下载源界面
 
 ### 7.1 布局
 
-通用设置按快捷唤起、会话与通知、工作目录与下载分成三张卡片。模型下载源位于
-“工作目录与下载”卡片内的工作目录输入之后；以下仅展示下载源控件，完整分组及通知
-开关行为见 [UI 设计规范](../../UI-DESIGN.md#138-设置中心)。
+“模型连接”页头在保存操作下方，将模型类型页签与下载源控件放在同一行：页签居左，
+“当前来源：ModelScope”和“模型下载源”次按钮整体右对齐。窄窗口保持同行，空间不足时
+导航行可横向滚动。点击按钮打开弹窗；通用设置的工作目录卡片不再提供下载源控件。共享布局规则见
+[UI 设计规范](../../UI-DESIGN.md#138-设置中心)。
 
 ```text
-平台功能
-管理通用平台行为与可选工作区能力
+模型连接                                          [保存]
+[文本] [向量] [重排] [语音]    当前来源：ModelScope [模型下载源]
 
-[ 通用设置 ] [ 远程项目 ]
-
-┌ 模型下载源 ────────────────────────────────────────────┐
+┌ 模型下载源（弹窗）───────────────────────────────── [×]┐
 │ 选择 GoodBuddy 托管本地模型后续下载使用的平台。         │
 │ 已安装模型和 ZIP 导入不受影响。                         │
 │                                                        │
@@ -244,19 +248,19 @@
 │                                                        │
 │ ○ Hugging Face                                         │
 │   适合可以稳定访问 Hugging Face 的网络环境              │
-│                                                        │
+│                                         [取消] [确认]  │
 └────────────────────────────────────────────────────────┘
 ```
 
-模型下载源保存属于即时设置，不增加与来源选项竞争的
-大型“保存全部”按钮。
+弹窗通过 Portal 挂载到 `document.body`，复用共享 Modal 样式、背景隔离和焦点管理。
+模型连接页头的保存操作与下载源弹窗的“确认”各自保存对应设置。
 
 ### 7.2 控件
 
 来源选项包含说明和未来可能的不可用原因，因此使用语义化 Radio Group，而不是原生
 `select` 或 `SegmentedControl`：
 
-- `fieldset` + `legend` 表达“模型下载源”。
+- 弹窗内使用 `fieldset` + 持久的屏幕阅读器 `legend` 表达“模型下载源”。
 - 每个选项使用 Radio 和整行可点击卡片。
 - 当前项同时显示选中 Radio、强调边框和选中背景。
 - 不能只用站点 Logo 或颜色表达选择。
@@ -285,12 +289,16 @@
 
 ### 7.4 保存交互
 
-- 用户选择另一个 Radio 后立即调用应用设置更新。
-- 保存期间禁用两个选项，保留最后确认值。
-- 成功后更新当前选择，并通过应用通知提示：
+- 打开弹窗时以已保存来源初始化草稿；选择 Radio 只修改草稿，不调用应用设置更新。
+- 点击“确认”才保存；草稿与已保存来源相同时直接关闭，不重复写入。
+- 取消、关闭按钮、Escape 或点击遮罩均丢弃草稿，已保存来源不变。
+- 保存期间禁用选项、确认、取消和关闭，阻止重复提交及遮罩、Escape 关闭。
+- 成功后更新页头当前来源并关闭弹窗，通过应用通知提示：
   `模型下载源已切换为 Hugging Face。`
-- 失败时恢复最后确认值，在 Radio Group 附近显示可重试错误。
+- 保存失败时保留弹窗和草稿，已保存来源不变；就地显示错误，允许再次点击“确认”重试。
+- 读取失败时显示错误和“重试”，禁用确认，不以默认值伪装为已保存来源。
 - 同一个失败不再同时显示页面横幅和全局错误通知。
+- 弹窗打开后聚焦关闭按钮，Tab 在弹窗内循环；关闭后焦点回到页头“模型下载源”按钮。
 
 来源变化不触发：
 
@@ -631,7 +639,7 @@ resolveModelDownloadPackage(files, source)
 
 ### 12.1 来源状态
 
-语音和 OCR 的当前模型详情各保留一个全局下载源标签。向量内置连接不重复显示平台功能中
+语音和 OCR 的当前模型详情各保留一个全局下载源标签。向量内置连接不重复显示模型连接页头中
 已经明确的全局来源，也不显示固定本地安装路径；下载仍使用已保存的全局来源。
 
 所有模型管理界面都显示当前模型是否可下载、活动操作的进度与取消入口，以及已安装模型
@@ -649,10 +657,12 @@ resolveModelDownloadPackage(files, source)
 
 ```text
 Hugging Face 暂不提供此模型的完整已验证文件。
-[前往通用设置]
+[模型下载源]
 ```
 
 不能显示可点击“下载”后才告诉用户缺少某个文件。
+向量、语音和 OCR 的“模型下载源”入口均导航到“模型连接”并直接打开同一弹窗。
+跨分类导航沿用设置中心的未保存修改确认，用户取消离开时保留原表单。
 
 ### 12.2 已安装模型
 
@@ -697,7 +707,7 @@ ZIP 是来源无关的离线迁移方式：
 - `正在从 {{source}} 下载`
 - `打开 {{source}} 模型仓库`
 - `当前下载源暂不提供此模型`
-- `前往通用设置更换下载源`
+- `模型下载源`（打开下载源弹窗）
 
 不再写死：
 
@@ -743,7 +753,7 @@ ZIP 是来源无关的离线迁移方式：
 失败状态提供：
 
 1. 重试当前来源。
-2. 前往“平台功能 → 通用设置”。
+2. 打开“模型连接”的模型下载源弹窗，选择并确认保存。
 3. 取消。
 
 用户切换来源后需要重新点击下载。不能在设置保存后自动恢复上一失败任务。
@@ -810,7 +820,7 @@ ModelScope 和 Hugging Face 都可能跳转到文件存储或 CDN。每个来源
 
 | 设置 | 位置 | 作用 |
 | --- | --- | --- |
-| 模型下载源 | 平台功能 → 通用设置 | GoodBuddy 托管本地模型 |
+| 模型下载源 | 模型连接页头 → 模型下载源弹窗 | GoodBuddy 托管本地模型 |
 | 检查更新源 | 关于与更新 | GoodBuddy 版本检查和下载页 |
 
 切换任一设置不得修改另一个设置。用户选择 ModelScope 不表示应用更新使用镜像节点；选择
@@ -850,9 +860,9 @@ Ollama 的模型下载由用户和 Ollama 管理。GoodBuddy 的模型下载源
 
 | 场景 | 行为 |
 | --- | --- |
-| 读取设置失败 | 显示平台功能阻塞错误，不猜测或写入来源 |
-| 保存来源失败 | 保留上一个确认值，显示就地错误 |
-| 当前来源无完整模型包 | 下载按钮禁用，显示前往通用设置 |
+| 读取设置失败 | 页头显示读取失败，弹窗提供就地重试并禁用确认，不猜测或写入来源 |
+| 保存来源失败 | 已保存来源不变，保留弹窗和草稿，显示就地错误并允许确认重试 |
+| 当前来源无完整模型包 | 下载按钮禁用，提供直接打开模型连接页下载源弹窗的入口 |
 | 当前来源网络不可用 | 当前下载失败或允许同来源重试，不请求另一来源 |
 | 当前来源返回 404 | 显示来源缺少固定文件，不请求另一来源 |
 | 重定向 Host 不受信任 | 立即失败并删除本次暂存 |
@@ -880,15 +890,19 @@ Ollama 的模型下载由用户和 Ollama 管理。GoodBuddy 的模型下载源
 - 更高未知版本拒绝，不覆盖文件。
 - 并发设置更新保持完整 JSON。
 
-### 17.2 平台功能界面
+### 17.2 设置界面
 
 - 默认选中“通用设置”Tab。
 - Tab 使用 `tablist`、`tab`、`tabpanel` 和 `aria-selected`。
 - 方向键、Home、End 和焦点恢复正确。
 - 切换平台功能页签不改变任何设置，全局设置不显示魔法笔记入口。
+- 模型连接页头的当前来源与次按钮位于模型类型页签同一行右侧、保存操作下方；通用设置不再显示下载源控件。
 - Radio Group 具有持久 Label。
-- 选择来源时保存一次，保存期间防止重复提交。
-- 保存失败恢复原值并保留可重试错误。
+- 选择 Radio 只更新草稿，确认后保存一次；未改变来源时确认不写入。
+- 取消、关闭、Escape 和遮罩关闭不改变已保存来源；保存期间禁止关闭及重复提交。
+- 保存失败保留草稿并允许确认重试；读取失败提供重试且禁用确认。
+- 弹窗使用 body Portal、焦点循环和关闭后焦点恢复。
+- 向量、语音和 OCR 的更换下载源入口直接打开模型连接页弹窗，跨分类时保留离开保护。
 - 窄窗口不隐藏页签或来源名称。
 
 ### 17.3 目录
@@ -939,7 +953,7 @@ Ollama 的模型下载由用户和 Ollama 管理。GoodBuddy 的模型下载源
 - 新增 `ModelDownloadSource` Schema 和默认值。
 - 将应用设置版本升级并迁移旧版本。
 - 在“平台功能”中增加 `PageTabs`。
-- 增加“通用设置”与模型下载源 Radio Group。
+- “通用设置”保留平台行为；模型下载源已移至模型连接页头，通过弹窗 Radio 草稿和确认保存。
 - 魔法笔记卡已迁入应用共同设置，全局页签已移除，见第 8 节。
 
 ### 阶段 2：共享目录和来源解析（已完成）
@@ -971,7 +985,9 @@ Ollama 的模型下载由用户和 Ollama 管理。GoodBuddy 的模型下载源
 
 - “平台功能”显示“通用设置”和“远程项目”两个可访问页签。
 - 默认打开“通用设置”。
-- “通用设置”提供 ModelScope 和 Hugging Face，默认 ModelScope。
+- “模型连接”页头在模型类型页签同行右侧、保存操作下方显示当前来源及“模型下载源”次按钮。
+- 下载源弹窗提供 ModelScope 和 Hugging Face，默认 ModelScope；Radio 只编辑草稿，确认才保存，取消不改变已保存来源。
+- 读取与保存失败均可就地重试；向量、语音和 OCR 的更换下载源入口直接打开该弹窗。
 - 来源选择说明影响范围，并明确已安装模型、ZIP、Ollama 和应用更新不受影响。
 - 切换来源不会下载、删除、切换或重新验证任何已安装模型。
 - 当前来源没有模型时，在点击下载前即可看到不可用原因。