goodbuddy/docs/pr-articles/2026-09-26-unreleased/review.md

# 0.13.8 起综合宣传稿核查记录

## 2026-09-28 截至 86347af 的增量核查

本节为最新依据，下方各轮记录保留历史状态。上次内容截止 `66f77b8`，稿件提交为 `0cdf042`；本轮固定检查 `0cdf042..86347af0b1cc8726c1166b3f9fa3d7f12a0cc5e3`，共 17 个新增提交。全文范围为 `v0.13.7..86347af`，开始检查时工作区干净。沿用用户确认的标题及综合稿结构，打包类维护不进入正文。

桌面 `v0.15.2` 和 `agent-v0.15.0` 同指向 `47ba54f`。已提交双语说明确认远程故事图谱配套 Desktop 0.15.2／Agent 0.15.0，正文据此替换上一轮“Agent 0.15.0 尚未包含”的旧说明；其余本轮产品修复均在该 tag 之后，已完成但发布归属待确认。本轮未在线核验公开安装包或下载链接。

| 提交 | 内容与入文处理 | 实现依据与边界 |
| --- | --- | --- |
| `4baf4ec` | 修复节重点补入直连文本手动压缩 | `App.tsx`、`ipc.ts`、`model-runtime.ts`；手动跳过自动开关和阈值，保存摘要供后续使用，保留最近轮次和完整历史。仅本地直连文本，排除图像、远程通道和 SSH 项目；运行中禁用，无较早历史会提示 |
| `1603871` | 修复节补入长请求工具授权 | `knowledge-mcp-gateway.ts`、`native-client-coordinator.ts`；移除桌面网关固定十分钟有效期，保留令牌校验和请求结束、取消、失败清理撤销。原生客户端独立授权随客户端生命周期释放；未移除工具调用超时或扩大权限，没有修改远端 gbagent 实现 |
| `58e6808` | 修复节补入取消、失败和重新编辑 | `App.tsx`、`ChatTimeline.tsx`、`message-terminal-status.ts`、数据库元数据；保留正文，状态提示去重，取消中性显示，历史恢复保留终态。仅最后一条失败/取消且有文字可恢复时显示重新编辑；不自动重发，不扩大为远程取消执行机制修复 |
| `13ff182` | 合入已有性能改进节 | 活动面板、消息更新、附件引用及 `MagicNoteStorage`；减少无关渲染、无变化保存、置顶附件扫描及启动正文重复读取。保留恢复和清理，不宣传整体渲染提速或冷启动倍数 |
| `86347af`、`120076a` | 改进节介绍最终搜索交互及快捷键提示 | `App.tsx`、`styles.css`、中英文文案；以最终实现为准，搜索与新建同一行，按需展开，失焦或点会话保留词，关闭/Escape 清空，列表不跳动。输入框按系统显示快捷键，唤起键仅在可用时显示，保存设置即更新；不沿用中间提交的常驻搜索框描述 |
| `393a07c` | 合入聊天采集章节 | `MagicNotesPanel.tsx` 与样式；范围帮助按需查看，标题/正文超限贴近对应字段，操作靠右，窄面板按钮不拉伸。没有更改保存范围或容量 |
| `c11f204`、`8650907`、`10f3b4f`、`50e8fde` | 合并简述侧栏浏览与应用/设置入口 | 细滚动条、等宽带标签入口、菜单箭头、分隔线与间距；触摸和强制高对比保留系统滚动条，不将视觉调整拆成多个新功能 |
| `1c6264d`、`d8f0ef1` | 日常操作简述 | `WorkspaceFilesPanel.tsx` 将操作与路径归组，只有未暂存时省略标题；浏览器前往改图标，保留提示与可访问名称 |
| `594222a` | 按用户要求仅留内部记录 | 桌面包依赖和非运行文件精简；不进入宣传正文，也不写成运行速度提升 |
| `be23c13` | 仅记录需求规划 | Office 同会话编辑及验收要求，无对应完整实现，不宣称已支持 Word、Excel、PowerPoint 实时编辑 |
| `76e781a`、`47ba54f` | 更新版本依据，测试维护不单独宣传 | 桌面/Agent 双语说明、MCP 目录测试；发布资料中的 Host/cloud 方案仍为规划。`0cdf042` 本身为上一稿提交，不重复计入新功能 |

排序以用户能继续工作为依据：手动压缩、工具访问与终止状态在修复段展开；搜索与快捷键归入操作改进；笔记、性能及小控件合入原有内容。没有改变用户指定标题，也没有增加开发状态标签。

本轮只读核查 Git diff、生产实现及已提交文档。历史测试记录只作证据：手动压缩提交记录 13 项定向与 Electron 本地 HTTP 测试，授权提交记录 34 项定向，性能提交记录 5397 通过、84 跳过；均非本轮执行结果，不据此声称当前提交全平台验收通过。本轮产品测试、构建、截图与模型请求均为 0，原配图缺口保留。

交付检查：deai-writing 扫描阻断项 0、复核项 14、读取错误 0；逐项核对后保留版本、素材、升级和功能范围限定，以及实际设置分组名称。独立只读事实复核无发现，`git diff --check -- docs/pr-articles` 通过，仅有既有行尾提示；未新增图片或链接。结束检查时 HEAD 仍为 `86347af`。核查期间其他任务新增了功能矩阵、package 与发布说明改动，未修改或纳入本轮依据；本轮仅编辑正文、核查记录及索引，未提交、推送或对外发布。

## 2026-09-28 故事图谱读取与讨论编辑增量核查

本节保留上一轮依据，当前版本归属以文首最新记录为准。本轮固定范围 `65a2139..66f77b83c2b6ebe0018a6c5c2bc72e1b4c1e43b1`，共 5 个提交；全文范围为 `v0.13.7..66f77b8`。保留工作区已有宣传稿修改，仅追加本轮变化，未纳入其他未提交功能文档。

| 提交 | 内容与入文处理 | 依据与边界 |
| --- | --- | --- |
| `66f77b8` | 新增助手只读查询故事图谱；更新继续讨论的完整正文编辑说明 | `story-graph-reader.ts`、`story-graph-tools.ts`、`knowledge-mcp-gateway.ts`、IPC、本地与远程 Runtime 接线；读取已有事实、上下文和来源，按精确 scope 查询，不发起回顾、不写图谱。支持 Model、Harness、本地及远程 OpenCode/Continue；远程须部署对应 Desktop/Agent 改动，不能归入 Agent 0.15.0 |
| `66f77b8` | 同步修正原生终端 Ask 的旧限制 | `native-client-coordinator.ts`、`native-terminal-client.ts` 已放行 Main 分配的内置只读工具，自定义 MCP 仍仅 Execute。`SupervisionDiscussion.tsx` 与 `RightAssistantSidebar.tsx` 精确发送可见草稿，不重新拼接已删除引用，失败保留草稿 |
| `013e72f` | 笔记章节补充入口及控件精简 | `App.tsx`、`MagicNotesPanel.tsx`、`MagicNoteSource.tsx`；工作栏与会话采集入口保留，移除侧栏/顶栏重复快捷按钮，操作靠右，保留输入可访问名称及校验。正文已有入口修订予以保留 |
| `83a3ea2` | 官网文案、下载入口及移动布局，不进入应用功能正文 | `sites/index.html`、`sites/en.html`、`sites/styles.css`；未把网站宣传调整计作桌面新增功能 |
| `6159039` | 诊断日志维护，仅记内部依据 | `desktop-diagnostics.ts`、`window.ts` 保留 Renderer 退出原因和退出码，便于排障；不据此宣称解决窗口崩溃或内存不足 |
| `4e52392` | 打包修复不进入正文，只修正版本与升级依据 | 最新桌面 tag `v0.15.1` 承接未公开发布的 0.15.0，Agent 保持 0.15.0 并要求 Desktop 0.15.1；本轮其余提交均在此 tag 之后，已完成但发布归属待核验 |

故事图谱依据及历史验证见[监督实施进度](../../features/conversation-supervision/progress.md)与[工具设计](../../features/conversation-supervision/story-graph-mcp-design.md)。已提交记录包含真实 SQLite、MCP、受控 Linux Host 工具调用与讨论布局验证；没有把确定性推理探针写成真实模型建议质量验收，也没有宣称跨平台安装包已验收。跨范围事实复用、任意时刻历史重建和记忆读取替换未纳入宣传。

本轮仅静态核查提交并编辑文档，未运行产品测试、构建、模型请求或拍摄截图；配图缺口沿用原清单。使用 deai-writing 审校正文；未提交或对外发布。

交付检查：文字扫描阻断项 0、复核项 13、读取错误 0。按原文行号复核，保留版本、升级、素材和功能边界，以及真实设置分组名称；无须为清零删除限定。`git diff --check -- docs/pr-articles` 通过，仅有既有 LF/CRLF 提示；结束核查时 HEAD 仍为 `66f77b8`。

## 2026-09-28 截至 65a2139 的增量核查

本节保留上一轮核查结果；当前截止点、版本归属与控件行为以文首最新记录为准。

- 本轮固定范围 `0f8bf40..65a21390debe0dd04871417a363a9d87a29339e6`，共 11 个提交；目标提交带 `v0.15.0` tag。文章总范围为 `v0.13.7..65a2139`，标题沿用用户指定措辞。
- 已确认版本归属，删除正文 R02；R01 保留公开发布状态、安装包和下载链接核验，C01 改为目标版本的操作配图核验。目录暂保留原路径，文章仍未发布。
- 依据已提交 Agent 0.15.0 说明，远程升级顺序更新为 Desktop 0.15.0 后再更新 Host。遥测与 Continue 更新检查修复对新启动 Runtime 生效，已有进程不热更新。不把桌面 tag 当作 Agent 独立发布渠道或所有安装包已可下载的证明。
- 工作区已有构建脚本、依赖与桌面/Agent 发布说明修改，均排除在本轮提交核查之外，未改动。

| 内容 | 入文处理 | 实现依据与边界 |
| --- | --- | --- |
| 桌面通知开关 | 新增功能，独立短节 | `f35198d`；`application-settings-contracts.ts`、`application-settings-store.ts`、`ipc.ts`、`PlatformFeaturesSettingsSection.tsx`。默认开启、持久保存、保存后立即生效；控制后台任务结果系统通知，应用内提示不变；未宣传操作系统必定送达 |
| 通用设置分组 | 功能改进，合入设置节 | `f35198d`；按快捷键、会话与通知、工作区与下载整理入口 |
| 流式会话排序 | 问题修复，日常操作首项 | `8e60736`；`chat-conversation.ts`、`assistant-database.ts`。置顶优先，其余按最新消息创建时间；流式 delta 与工具进度不反复重排，新消息仍可前移 |
| 输入区工具按钮 | 问题修复，简述 | `ee1bf8a`；`App.tsx`、`styles.css`。附件、语音、选项尺寸/图标/间距/悬停统一，保留录音与展开状态 |
| 监督继续讨论 | 更新现有主介绍，不重复列为独立新增 | `d47f967`；`RightAssistantSidebar.tsx`、`SupervisionDiscussion.tsx`、`SupervisorWorkspace.tsx`、`ipc.ts`。侧栏无需先开来源，可编辑问题；上下文仅取所选来源关联的事件/实体/关系与来源正文；图谱会话来源可打开会话、发送后导航。知识实体写回控件已移除；正文已有 `5cdffee` 修订，本轮保留并补齐细节 |
| 自动监督空状态 | 功能改进，合入自动监督节 | `d47f967`；`HeartbeatCenter.tsx`。无运行、条目、记忆或跟进活动时隐藏空统计及历史等区域，不改变计划执行能力 |
| 版本与配套资料 | 更新范围、升级提示和内部证据 | `5a6ba6c`、`d9e1e42`、`5cdffee`；版本说明、功能矩阵、文章和候选图片归档不再计作新功能 |
| 测试同步与夹具修复 | 不进入宣传正文 | `1259496`、`b8b6007`、`706726b`、`65a2139`；聚焦/导航等待、Linux 窄面板键盘及知识库轮询夹具修正；发布提交中的测试调整也不作为产品能力宣传 |

历史验证：`65a2139` 记录完整冻结 Linux 套件 5371 通过、51 跳过，Windows App 300 通过及 typecheck/lint/双语说明校验通过。通知功能提交注明原生系统通知送达未人工验证；这些均为已有记录，本轮没有重跑产品测试、模型调用或构建。旧记录中早期失败和待验收状态不等于最新固定提交的测试结果，也不能用本轮静态核查代替跨平台实机验收。

本轮继续使用 deai-writing 审校新增文字；配图缺口不变，没有新截图。仅修改正文、核查记录和索引，不提交或发布。

交付检查：文字扫描阻断项 0、人工复核项 12；逐条保留必要的版本、内容和功能范围限定，“通用设置”一项为真实界面分组及入口列举。`git diff --check -- docs/pr-articles` 通过，仅提示既有行尾策略；正文无开发状态标签、打包修复条目或过时 R02。完成时 HEAD 仍为 `65a2139`。

## 2026-09-28 发布候选归档

- 用户授权将当前工作区宣传文档与素材一并提交、推送，并由代理自行审核后继续
  Desktop/Agent 0.15.0 发布，不再逐次等待提交确认。
- 下方 2026-09-27 记录及正文中的 `0f8bf40` 截止点保留为当时的内容核查截面，
  其中“发布准备未提交”“Agent 实机未完成”等是历史状态，不代表当前发布进度。
  当前候选、实机与 CI 结果以 [0.15.0 发布准备记录](../../development/release-preparation-0.15.0.md)
  和两个独立发布渠道为准，正式版本未完成公开核验前不宣称已经发布。
- 新增候选 `deepseekweb.png`、`obsidian.png`、`storygraph.png` 已逐张检查，
  未发现可见 API Key、密码或令牌。原图按用户授权归档，不裁切或改写；
  DS 图仍有本机用户名、路径和浏览器书签，图谱包含既有会话摘要，
  不能直接当作隔离公开演示素材。正式宣传配图仍遵循下方素材核验及重拍要求。
- 本次提交原始候选素材不等于确认其构建 SHA，也不授权发布文章到外部媒体。
  不因候选截图归档宣称跨平台安装包或完整对话验收通过。

## 2026-09-27 增量更新

本节保留 2026-09-27 的核查结论；当前截止点、版本归属和后续变化见文首最新核查。

- 用户要求检查“上一次到目前最新提交中间的功能更新”，并更新已有草稿；沿用已确认的综合稿结构，直接补充。
- 上次截止 `51166136157a646530e1ad9f6a0242c1c6390e95`；本轮固定至 `0f8bf405db7ca21a85cc70009ad083eb837e1e03`，共 17 个提交。全文总范围为 `v0.13.7..0f8bf40`。
- 目标提交没有 tag；已核查正式版仍截至 `v0.13.16`。用户确认所述功能均已开发完成，正文已去除开发状态标签；后续已提交功能只保留发布版本待确认的说明。工作区的 `package.json`、锁文件、Agent Runtime 锁、功能矩阵和未跟踪 `release-preparation-0.15.0.md` 不作为已发布依据，也未修改。
- 选题：保留工作回顾主线，新增聊天采集、Obsidian 与原生客户端三个独立使用场景；知识库统一列表和图谱页签归入改进；运行配置和交互问题归入修复。按用户要求，打包类修复只保留内部核查依据，不进入宣传正文。标题随覆盖范围更新。
- `1094433` 将数据库格式升至 48。正文已替换仅适用于 0.13.15→0.13.16 的升级说明，明确完整备份和旧客户端回退限制。

### 本轮完整盘点

下表“实现”只指进入固定提交。逐项依据提交 diff、生产实现和已提交的功能记录；本轮未执行产品测试、打包、真实模型调用或远程 Host 验收。

| 内容 | 分类与入口 | 功能与边界 | 提交及证据 |
| --- | --- | --- | --- |
| 本机 Obsidian 接入 | 新增／设置→能力与工具→MCP | 注册仓库发现、指定文件夹、独立测试与保存、开关和 Runtime 分配；搜索、读取、写入、追加、局部修改等。默认关闭；直连模型及受管理本机 OpenCode/Continue 支持，DSH 与远程不支持；Ask 只读、Execute 可写；不是知识库复制或同步 | `55efca3`；`src/main/obsidian/obsidian-service.ts`、`src/shared/obsidian-tools.ts`、[Obsidian 进度](../../features/obsidian/progress.md) |
| 聊天采集到魔法笔记 | 新增／助手消息、会话菜单 | 单条助手正文或完整会话用户/助手正文，预览编辑、追加或原子创建笔记；保留来源回跳，源删除后内容保留；不复制工具日志/附件，单记录 500 KiB，生成中不可采集 | `1094433`；`App.tsx`、`ChatTimeline.tsx`、`magic-notes-contracts.ts`、[笔记进度](../../features/magic-notes/progress.md) |
| 快速笔记与草稿 | 工作栏“+ → 笔记” | 标题/正文搜索、摘要、文字追加；切项目/会话保留草稿，关闭/替换/禁用有确认，重启不恢复；仍是全局笔记，完整画布/待办编辑在工作区；采集本身不调模型，自动评论沿用设置 | `1094433`；`MagicNotesPanel.tsx`、`MagicNoteSource.tsx`、`use-magic-note-draft.tsx` |
| 来源存储升级 | 兼容性／启动 | schema 48 保存来源元数据，不改写文件化正文；旧客户端不能直接打开升级数据库 | `1094433`；`assistant-database.ts`、笔记技术设计 |
| 本地原生客户端 | 新增／聊天输入区 | Continue/OpenCode 工作栏终端、DS 系统浏览器 Web；沿用项目与模型，独立历史；DS 可复用、重开、停止，关闭网页不停止服务。远程协调入口未接通；Continue/DS 需标准 Node，托管准备可能联网；Continue/OpenCode 原生 Ask 暂无 MCP | `f81f342`；`native-client-coordinator.ts`、`native-terminal-client.ts`、`native-dsh-web-client.ts`、[客户端方案](../../features/assistant-workbar/runtime-native-client-proposal.md) |
| DSH 依赖升级 | 新功能配套／内部版本 | DSH 0.1.7-rc.2、Cordis 4.0.4；不把依赖版本当模型名或稳定版承诺，正文并入原生客户端 | `f81f342`；提交中的 package/锁文件 |
| 知识库统一列表 | 改进／知识库文档页 | 单文档来源合行、目录分组、失败来源保留、来源与文档统一搜索、紧凑拖放区域；归属语义不改变 | `5177b47`；`knowledge-workspace/DocumentsView.tsx`、[知识库界面](../../features/knowledge-base/ui-design.md) |
| 文档操作及任务批次 | 改进兼修复／列表、解析预览、任务页 | 保留 URL，突出查看与更多菜单，解析结果导航和图片操作归位；按批次展开历史，计数/筛选跟随对象；多文档来源范围修正，不同来源操作不互相阻塞 | `ceb275b`、`67dedc2`；`DocumentsView.tsx`、`KnowledgeTasksView.tsx`、`DocumentResultPreview.tsx` |
| 图谱侧栏页签 | 改进／故事线图谱 | 事件、实体、关系计数与独立滚动，切页签保留选择，画布选中联动类别；没有新增图谱导出或回放 | `40c108d`；`SupervisorWorkspace.tsx` |
| 遥测配置传播 | 修复／启动 | 补到 DS Web、远程 Runtime、模型桥 helper；不影响主动联网，不是新设置页或无联网保证；对应 Agent 发布归属待定，不能归给 Agent 0.13.4 | `eb53c82`；`runtime-privacy-environment.ts`、Agent profile/helper |
| Continue 更新状态 | 修复／原生终端 | 禁用更新时更新服务不再发出检查状态；不称终端卡死已修复，不涉及关闭桌面更新 | `0f0b6ac`；`continue-host-adapter.ts` |
| DS Web portable 依赖 | 内部维护／不进入宣传正文 | 修正 CLI、嵌套依赖和 Web 资源复制，新增 CLI 入口存在性检查；仅保留核查依据，未据此宣称最终包完整验证 | `5ecc19d`；`build/native-dsh-resources.cjs`、`build/build-portable.cjs`、package 复制规则与测试 |
| 控件、弹层与窄布局 | 修复／多页面 | 危险按钮、深浅主题、禁用与焦点、Continue 字段；MCP/图片嵌套弹层可交互、项目 Escape 范围、帮助与原生浏览器遮挡；HTML 键盘与 Escape；工作栏添加按钮和模型协议文字 | `8b15399`、`11facf0`、`2713a81`；`styles.css`、`dialog-focus.ts`、`StaticHtmlPreview.tsx`、`WorkbarShell.tsx`、[弹层复核](../../quality/overlay-review-2026-09-27.md) |
| DS 输入区精简 | 改进／输入区 | 删除常驻独立会话/服务说明，保留重开与停止；正文合入界面调整，实际生命周期照实说明 | `0f8bf40`；`RuntimeNativeClientActions.tsx` |
| IPC 与聊天组件抽取 | 维护／不单独宣传 | 模型设置 IPC、聊天历史组件及文档归属说明；不当作新增用户功能 | `4edf06b`、`44cd944`；`model-settings-ipc.ts`、`ChatHistoryPane.tsx` |
| 导航测试修正及文章素材 | 维护／不单独宣传 | 嵌套页签断言修正；上一稿提交及 Continue/OpenCode 图片入库 | `4a2986c`、`11facf0`、`5ecc19d` |

### 验证证据与限制

- Obsidian 已提交记录包含 Windows Electron 设置操作、本机 OpenCode/Continue 读写及解包应用连接验证；未扩大为所有平台安装包或物理断网通过。
- 聊天采集记录包含真实 App/Preload/IPC/SQLite、502 条历史、来源回跳、214px 面板输入和源删除保留；502 是样例，非产品上限。schema 和正文容量另查契约。
- 原生客户端有本地真实模型历史证据，但部分组件/IPC 使用测试模拟；Continue 后续记录有完整 Windows 生产 App 操作。DS 正常 UI、最终 portable 和跨平台整体验收不能据此视为全通过。部分历史模型验证有 TLS override，不作为严格 TLS 验证证据。
- 遥测修复有 16 项定向测试记录，修改后的 Agent 实机与后台联网监测尚未完成；DS 打包有 3 项复制规则回归，非最终包真实对话。
- `2713a81` 全量记录为 5309 通过、3 失败、83 跳过；项目焦点修正后定向 331 通过，其余两个 HeartbeatCenter 断言由 `4a2986c` 修正，后续 96 项通过及 typecheck/lint 通过。最终固定提交未重跑全量，不能合写为全量全绿。
- 知识库有定向及 Electron 布局回归，真实导入/解析链路未在对应改动轮重跑。历史证据详见[知识库进度](../../features/knowledge-base/progress.md)、[工作栏进度](../../features/assistant-workbar/progress.md)、[控件与响应式复核](../../quality/responsive-controls-review-2026-09-27.md)。

### 配图更新

已逐张读取四张现有图片，未改动或裁切原文件；`continue.png`、`opencode.png` 已由 `5ecc19d` 跟踪，`obsidian.png`、`deepseekweb.png` 是用户工作区未跟踪素材。图片只作候选，尚未绑定可核验构建 SHA，因此未直接作为最终配图插入正文。本轮没有新拍截图，也没有将上一轮构建检查结论冒称为本轮重新验证。

| 编号 | 内容与路径 | 最新状态 |
| --- | --- | --- |
| 01–05 | 原工作回顾、来源、图表、批次、待办图 | 仍待补，原计划保留；最终截图需反映最新图谱页签 |
| 06 | 聊天采集与来源返回；`assets/06-chat-note-source.png` | 必补；现有四张图均不能证明该流程 |
| 07 | Obsidian；候选 `obsidian.png`，计划 `assets/07-obsidian-notes.png` | 建议；现图设置可读、浅色中文，能展示范围和分配，不能证明读写结果；需核验构建来源或补拍公开示例 |
| 08 | 原生客户端；候选 `continue.png`、`opencode.png`、`deepseekweb.png`，计划 `assets/08-native-clients.png` | 建议；前两张展示工作栏终端并含本机路径及聊天；Continue 有模型能力警告；DS 图含书签、头像和本机用户路径。发布前重拍或生成明确标注的脱敏副本，并确认构建来源 |
| R01/R02/C01 | 最终版本、后续提交的发布归属、回顾控件 | 仍待最终安装包核验；R02 覆盖 0.13.16 之后已完成的功能与修复 |

### 本轮交付检查

仅更新正文、核查记录和索引；产品测试、构建、新截图及真实模型调用为 0。

- Python 3.13.13 执行 deai-writing 扫描：阻断项 0、复核项 16、读取错误 0。按命中行逐条核对：15 项为发布状态、功能范围、升级或取消语义等必要限定，1 项是“模型准确理解”的能力边界表述，保留。
- 独立只读复核未发现重大事实过度宣称、版本混淆或前后矛盾；新增 8 个相对 Markdown 链接目标均存在，图 06–08 的编号、场景、文件名与优先级对应，R01/R02/C01 和索引一致。
- 四张候选素材均已打开审阅；没有插入不存在的计划图片链接，没有把启动界面当作完整流程验收。
- `git diff --check -- docs/pr-articles` 通过，仅提示既有 LF→CRLF 行尾策略。完成时再次确认 HEAD 仍为 `0f8bf405db7ca21a85cc70009ad083eb837e1e03`。
- 未提交 Git、打 tag 或对外发布；既有版本准备与图片文件保持原状。

## 状态与范围

- 状态：草稿，未对外发布，截图待补。首次建档与检查日期：2026-09-26。
- 用户要求：“0.13.8到目前的所有功能，准备一个新的草稿”。据此直接起草，未另设选题批准步骤。
- 起点包含 0.13.8 的新增变化，因此比较基线采用其前一版 `v0.13.7`，而非排除 0.13.8 的 `v0.13.8..HEAD`。
- 基线解引用提交：`fe093bc15f94d90c478e1e96fef0f9feb7b819e9`。
- 本轮正式 tag 核查截止 `v0.13.16`：`0759d5dcffb3273411fe7c486bbcde904dd23e48`。Agent 配套截止 `agent-v0.13.4`。
- 核查期间 HEAD 新增 `51166136157a646530e1ad9f6a0242c1c6390e95`。本稿固定到该提交，范围为 `v0.13.7..5116613`；其相对 0.13.16 的变化在正文单列未发布补充。最终宣传目标 tag 未定，沿用 `unreleased` 目录，不推测下一版号。
- `0.13.14` 桌面发布失败，产品内容由 `0.13.15` 恢复版承接；Agent 发布独立。未在线验证各平台包及最新 CI，不把本地 tag 当作全部工件可下载的证明。
- `8dce1d7` 的发布说明沿用了原 0.13.7 多项内容。已按基线实际 diff 去重，画布、PDF 批注、HTTP OCR 接入、远程 Continue、应用管理、会话置顶不重复当作新增。
- 开始及后续检查均有其他任务的未提交修改，涉及 DSH Runtime、MCP、能力设置、构建与依赖、工作栏方案；随后出现 Obsidian 新目录。它们只登记为工作区进行中内容，未核验为已交付功能，不纳入正文。没有修改或撤销这些文件。

## 选题与篇幅

综合稿固定按“新增功能 → 功能改进 → 问题修复”排列，修复放最后。用户已要求直接起草，以下是编辑取舍记录，不冒称用户逐项确认了提纲。

| 主次 | 入文内容 | 理由与处理 |
| --- | --- | --- |
| 主线 | 监督者工作回顾、故事线图谱与来源、任务反馈后续操作 | 新增完整工作入口，用户可从历史记录整理进展、检查依据并继续讨论；展开介绍，同时说明采集范围与人工复核边界 |
| 主线的使用改进 | 自动监督、活动记录、分页批次与续跑 | 决定长时间范围能否持续处理、失败后如何继续，单独放在改进段，不把原有每日每周计划重新包装成新增 |
| 独立新增 | 模型连接复制、Mermaid PNG 导出 | 各自可直接完成一个新动作，短节说明入口与限制 |
| 日常改进 | 待办调宽与分组折叠、任务筛选、用量、设置、历史读写 | 按使用场景合并；待办操作是现有工作区扩展，采用“功能改进”分类，不照抄 feat 前缀 |
| 主要修复 | 远程完成确认与恢复、进程回收、启动迁移、搜索、回顾完整性 | 影响工作能否继续和数据处理可信度，保留具体条件及 Agent 配套要求 |
| 简述修复 | 菜单、工作栏拖动、时长、队列附件、通知及页面布局 | 分别归入改进或修复，避免每个控件占一节 |
| 未发布补充 | `5116613` 回顾控制、取消、单次执行限制 | 用户要求截至目前，因而纳入，但与 0.13.16 严格区分；最终版本确定后合并对应段落 |
| 不进入正文 | CI 上传、测试调度与夹具、发布元数据、社群二维码、开发规划 | 清单保留追溯，不算应用内新能力；OSS 上传加速不能写成客户端下载提速 |

## 完整盘点

以下“已实现”指进入固定目标提交，不代表本轮完成所有平台实机验证。文件证据以 Git 对应提交为准，工作区文件可能继续变化。相同功能的连续修复合并计一项。

| 功能 | 分类／状态 | 原来与现在、入口 | 条件与边界 | 来源与验证线索 |
| --- | --- | --- | --- | --- |
| 监督者工作回顾 | 新增／目标代码具备 | 应用中心启用监督者；全局或单项目、近 1/7/30 天回顾，查看总结、变化和未解决事项 | 默认关闭；来源为消息、任务当前信息、已有知识引用等，不扫描全部笔记或附件原件 | `7d487f9`、`bf8ece0`；`SupervisorWorkspace.tsx`、`supervisor-service.ts`、`supervision-review-store.ts`；见监督进度记录 |
| 故事线图谱与来源 | 新增／目标代码具备 | 选取事件、实体、关系，查看保存的依据；实体确认、改名、撤销，关系确认、移除 | 按顺序浏览事件，不是完整状态回放；间距不代表时长；无关系类型编辑与撤销恢复入口 | `7d487f9`；`SupervisorWorkspace.tsx`、`assistant-database.ts`；有组件、存储和隔离视觉证据 |
| 任务／会话监督反馈 | 新增／目标代码具备 | 任务中心项目概览下跟随目标、固定、刷新、查看来源和图谱 | 仅匹配目标结果；Experiment 未接入 | `7d487f9`、`b16fc90`、`c71c0ad`；`RightAssistantSidebar.tsx`、`workbar-contracts.ts` |
| 继续讨论和本地实体预览 | 新增／目标代码具备 | 确认上下文后加入目标会话队列；预览后创建本地知识实体 | 继续内容上限 12000 字符，实体描述 2000；外部库只读；无关联会话的任务不能发送 | `7d487f9`；`ipc.ts`、`supervision-contracts.ts`、`RightAssistantSidebar.tsx`；IPC 定向验证 |
| 活动与批次查看 | 新增／目标代码具备 | 查看手动／自动运行、范围、状态、阶段、事实与来源树 | 活动每页 50 条，详情每页 10 批；已保存批次可跨重启保留 | `bf8ece0`、`db5e43d`；`SupervisorActivity.tsx`、`SupervisionBatchDetails.tsx`、`supervision-review-store.ts` |
| 自动监督增量 | 改进／目标代码具备 | 在既有每日／每周计划上接入监督；报告与回顾分开记录来源进度，无待处理输入时跳过模型 | 手动回顾重新分析区间；删除报告／计划不清检查点；关闭应用不执行计划 | `bf8ece0`、`db5e43d`；`heartbeat-service.ts`、`assistant-database.ts`；历史增量实模证据 |
| 自动计划与开关 | 改进／目标代码具备 | 五页签分工，弹窗创建编辑，选择多项目、时间及时区、窗口与保留期限 | 窗口 1–720 小时、保留 1–365 天；启用不自动建计划；关闭保留数据，取消常驻仅影响导航 | `bf8ece0`、`db5e43d`；`HeartbeatCenter.tsx`、`HeartbeatSettings.tsx` |
| 分页、批次、失败续跑 | 修复兼改进／目标代码具备 | 替代有限条数截断；分页读取、长文本分片，成功批次独立保存，合并及发布失败可重试 | 来源变化需新回顾；在途输出不保证保存；处理覆盖不等于模型语义无遗漏 | `db5e43d`；`supervision-production.ts`、`supervisor-service.ts`、`supervision-review-store.ts`；506 来源隔离存储回归等 |
| 监督参数 | 改进／目标代码具备 | 设置并发、超时、读取条数、批次文本及消息量、响应容量 | 默认并发 1，范围 1–4；报告／整理单次超时默认 240 秒，范围 30–600；容量默认 1024 KiB，范围 100–16384；没有总费用预算 | `db5e43d`、`e6ac073`；`SupervisionReviewSettings.tsx`、`supervision-review-contracts.ts` |
| 连续处理与结果校验 | 修复／截至 0.13.16 | 取消累计固定时长暂停；修复旧实体引用、导航输出校验、任意摘要长度限制，精确定位历史结果 | 主动暂停、单次超时仍保留；0.13.16 续跑期间同卡片暂停控件存在缺口 | `db5e43d`、`e6ac073`；生产服务与契约；定向／实模证据见下文 |
| 模型连接复制 | 新增／0.13.8 | LLM 连接详情复制地址、认证、协议、模型和请求定制，保存副本 | 最多 20 条；已保存密钥在主进程复制，不回传明文 | `8dce1d7`；`SettingsPanel.tsx`、`runtime-settings-store.ts`，组件和凭据复制测试 |
| 模型地址错误定位 | 修复／0.13.8 | 保存时显示错误连接名称、切回连接并关联 URL 字段 | 校验格式不是验证服务可用；HTTP/HTTPS、最多 2048 字符 | `8dce1d7`；`SettingsPanel.tsx`、`contracts.ts`，组件／schema 回归 |
| 设置导航与操作归位 | 改进／0.13.8 | 长表单标题页签吸顶；高级参数折叠；工作目录归入平台通用；Skills/MCP 标题精简与操作归位 | 既有能力的入口调整，不扩大 Runtime 或 MCP 支持范围 | `8dce1d7`；`SettingsPrimitives.tsx`、`PlatformFeaturesSettingsSection.tsx`、相关设置组件及测试 |
| HTTP OCR 过滤设置 | 改进／0.13.10 | 直接选保留内容，恢复默认；重排参数间距 | HTTP OCR 接入本身基线已有；取决于远端服务 | `6c4c054`；`HttpOcrSettings.tsx`、文档解析设置测试 |
| 任务筛选与长列表 | 改进／0.13.8 | 展开即可选全部／进行中／暂停／已结束，默认进行中；减少屏幕外绘制和重复查找 | 不删除历史，不新增分页；无整机性能倍数结论 | `6739e8e`；`RightAssistantSidebar.tsx`、`task-center.css` |
| 后台执行统计与隐藏面板 | 改进／0.13.10 | 统计移至只读 worker，任务面板隐藏后保留状态并减少更新 | 非所有数据库操作后台化，浏览器和终端保留所需生命周期 | `a0b35d1`；`execution-stats-reader.ts`、`execution-stats-worker.ts`、`WorkbarShell.tsx`；worker 和组件测试 |
| 用量汇总 | 改进／0.13.12 | 项目／会话先总计，展开 Runtime／模型；按模型视图保留 | 基于应用记录，不是账单；命中率按汇总分子分母算 | `cdd5737`；`ActivityPanel.tsx`、`token-usage.ts`；25 项定向记录 |
| 回复时长缓存 | 修复／0.13.12 | 切回已查看会话先恢复时长再刷新 | Renderer 生命周期内缓存，不跨重启、不推算未知执行时长 | `f754120`；`use-execution-stats.ts`；15 项定向记录 |
| 活动历史读写 | 改进／0.13.12–0.13.13 | 仅保存变化记录，复用已提交历史减少全量读取，保留顺序与重复 ID | 缓存随关闭、清空和外部提交失效；保留回滚与重试 | `984f16f`、`bf8ff7f`；`assistant-database.ts`、`activity-history-io.test.ts`；受控 WAL 和扫描测试 |
| 待办布局 | 改进／0.13.15 承接 | 魔法笔记待办拖动／键盘调宽并保存宽度，来源分组独立折叠 | 窄布局不调宽；折叠状态仅组件内；保留选中详情 | `f68584b`；`MagicNotesWorkspace.tsx`、`MagicTodoDirectory.tsx`；115 项含原生输入验证 |
| 笔记控件与索引 | 改进及修复／0.13.12–0.13.15 | 索引开关移至返回按钮旁，索引及 AI 评论显示文字；缩略图贴齐边缘、焦点可见 | 不改笔记正文、画布能力或缩略图生成 | `0265cfb`、`344008a`；笔记工作区、样式与 Electron 布局测试 |
| Mermaid 导出及查看 | 新增及修复／0.13.12 | 完整 PNG 导出；放大后边缘可达，弹层覆盖窗口，窄屏控件换行 | 当前主题，最长边 4096；不等于故事图导出 | `785b1ee`；`MermaidDiagram.tsx`、`markdown-mermaid.css`；58 项含 9 Electron 场景、10 次 PNG 下载 |
| Git／项目菜单 | 修复／0.13.12–0.13.15 | 分支菜单悬浮不挤内容，保留搜索与焦点；项目菜单通常 380px、窄屏收窄 | 受视口约束，不是新增 Git 或项目类型 | `fb4b9bd`、`0ed1be1`；`WorkspaceGitTools.tsx`、`ProjectSwitcher.tsx`；组件与 overlay 验证 |
| 工作栏与监督布局 | 修复／0.13.13–0.13.16 | 恢复分隔条 9px 命中区域；反馈名称、按钮、排序修正；回顾和活动铺满宽度，阶段、批次突出 | 布局变化不等于新增监督目标或执行权限 | `cebd513`、`b16fc90`、`c71c0ad`、`d4bc10c`、`325b702`；组件、CSS、隔离 Electron 视觉证据 |
| 队列附件与浏览器错误 | 修复／0.13.12–0.13.15 | 依据保存输入判断附件；纯文本隐藏按钮；关闭页签重试成功清除错误 | 首次关闭失败保留页签，不保证底层失败自动恢复 | `d5f6dc6`、`bf8ece0`；`ConversationInputQueue.tsx`、`RightAssistantSidebar.tsx`、数据库与组件测试 |
| 通知和删除确认 | 改进／0.13.10–0.13.12 | 紧凑通知，成功／提示 2 秒消失，错误手动关闭；删除确认去重复文案 | 永久删除语义不变，非系统通知策略变化 | `a0b35d1`、`be84534`；`App.tsx`、`styles.css`；假时钟回归 |
| 远程空闲进程及旧 Agent | 修复／Agent 0.13.3 起 | 最后任务完成后释放 Runtime，下轮恢复历史；退役 Agent 排空已有工作后退出 | 当前 Agent 常驻；保留活动任务及待答问题；旧进程不热更新 | `83a48a4`；`runtime-acp-backend.ts`、`daemon.ts`、`cli.ts`；213 项生命周期及 Linux 实机记录 |
| 远程完成确认与续聊 | 修复／Agent 0.13.4 配套 | 交付确认后完成，清理失败不改已完成结果；未知后显式新消息新绑定带历史 | 自动恢复仅 attach，不重放未知任务；不抢占仍活动请求 | `7adae97`；`model-bridge-broker.ts`、`agent-owned-acp-prompt.ts`、`acp-remote-runtime.ts`；Linux 双轮 Ask 探针及回归 |
| 旧安装清理与远程名称 | 修复及调整／0.13.12–0.13.15 | 清理确认停用 payload 与所属孤儿；移除“技术预览”标识 | 保留未知归属、活动安装、共享 Runtime 和历史；远程项目默认仍关闭 | `83a48a4`、`7adae97`；`installation-cleanup.ts`、`remote-environment-preparer.ts`；Linux 隔离清理验证 |
| 直连原生搜索 | 修复／0.13.15 承接 | workspace_rg 原生 args/cwd、输出／退出码，大输出由 output_read 续读 | 本机直连路径；Ask 工作区只读，Execute 当前账号；句柄随会话释放 | `ff746bd`；`direct-model-ripgrep.ts`、`model-tool-provider.ts`；169 通过、1 跳过及真实 Ask/Execute |
| 正常重启重复迁移 | 修复／0.13.8–0.13.9 | 不因聊天／文件化笔记写入形成的空闲页再触发迁移 | 保留真正旧数据转换与失败重试 | `8dce1d7`、`38d0923`；`assistant-storage-upgrade.ts`、`assistant-storage-startup.ts`；SQLite、启动回归 |
| 结构升级与空间回收 | 修复／0.13.16 | 结构、内容转换、空间回收分开，普通结构更新不全库 VACUUM，启动文案准确 | 必要转换仍执行；仅同次启动保留重试意图；schema 仍为 47 | `4c7193e`；数据库／升级服务、`StorageUpgrade.tsx`；47 项定向 |
| 回顾取消与避免重叠 | 修复及扩展／未发布 | 控件运行期间可用；继续后可暂停／取消；手动与自动共享单次执行限制 | 取消保留已存批次，不能继续，不发布未完成结果；清理期间仍占执行位置；自动等待、手动提示忙；范围选择不改当前运行 | `5116613`；`supervisor-service.ts`、`SupervisorActivity.tsx`、`SupervisorWorkspace.tsx`；38 UI、27 后端、1 Preload 定向记录 |

### 内部维护及不入正文条目

| 条目 | 来源 | 处理 |
| --- | --- | --- |
| OSS 上传加速 | `e6a25b7`，随 0.13.11 | 发布上传改动，无独立客户端功能，不写下载提速 |
| 测试 worker 调度、OpenCode 隔离路径、异步 UI 与大桥接载荷超时 | `984f16f`、`163e245`、`bb8c04a`、`2ca19eb`、`cd27163` | 测试维护，不把用例超时调整写成生产模型超时变化 |
| 发布元数据、功能矩阵、保留分支历史与恢复版 | `598c68f`、`bf8ece0`、`7756231`、`d23af99`、`107dc97`、`e8d93b5`、`0759d5d` 等 | 用于范围和升级依据，不重复计功能 |
| 社群二维码更新 | `4366bdc`、`24bde0c` 及合并提交 | 项目资料更新，不作为应用功能 |
| 迁移夹具与架构规范 | 相关发布／迁移提交 | 只作验证与维护证据 |
| 逐事件状态回放、事件触发监督、Experiment、自动纠偏接管、完整知识正文双向编辑、费用预算、私有应用市场 | 设计文档或后续规划 | 未作为当前功能宣传；图谱能力以生产组件为准 |

## 事实与验证边界

主要交叉核查资料：

- [监督实施记录](../../features/conversation-supervision/progress.md)、[监督设计](../../features/conversation-supervision/technical-design.md)、[故事图 PRD](../../features/story-graph/prd.md)。设计目标不等于已实现事实。
- [0.13.12 准备](../../development/release-preparation-0.13.12.md)、[0.13.14 联合准备](../../development/release-preparation-0.13.14.md)、[0.13.15 恢复版](../../development/release-preparation-0.13.15.md)、[0.13.16 准备](../../development/release-preparation-0.13.16.md)。
- [版本更新说明](../../../resources/release-notes.json)、[Agent 0.13.4 说明](../../../resources/agent-release-notes/0.13.4.md)、[笔记备份说明](../../features/magic-notes/technical-design.md#backup-and-restore)。

本次为只读代码／提交核查与文档编辑，未重跑产品测试、未构建或打包、未调用真实模型。下列均为历史验证记录，不能写成本次实测：

| 对象 | 已有证据 | 限制 |
| --- | --- | --- |
| 回顾覆盖与恢复 | 隔离 SQLite 22×23 共 506 个来源，长文本重建、跨重开、合并／发布失败与来源变化测试 | 不证明所有模型都正确提取全部事实 |
| 回顾真实模型 | 27 条消息、9677 码点，2 次提取、1 次合并，保存 53 条结构化记录；自动增量首次 2 次、重复 0 次、修改后 1 次的记录 | 更大 129 条消息样本第二次 JSON 无效，首批保留，不能写大样本全程已跑通 |
| 持续回顾 | e6ac073 的 13 项定向测试超过旧预算仍完成，主动暂停保留批次 | 非真实模型长时间压力验证 |
| 布局 | 325b702 记录 33 项组件、40 个 Electron fixture 场景通过 | 不是正式安装包完整端到端验收 |
| 远程 | Linux x64 真实 Host 生命周期、两轮 Ask 完成与历史恢复、隔离清理探针 | 不扩大到所有架构，未覆盖所有异常注入和正式更新 UI |
| 原生搜索 | 成功一轮真实 Ask／Execute 分页验证精确 6 次请求；定向 169 通过、1 跳过 | 早期失败轮无完整计数；非所有平台完整 UI |
| 历史 I/O | 1 万条历史受控回归，连续保存减少 WAL 增量和全量读取 | 不宣传整机“百倍提速”或真实磁盘吞吐收益 |
| 0.13.16 候选整体 | 5128 通过、84 跳过、1 失败；失败 Mermaid Electron 随后独立复跑通过；类型、lint、说明校验通过 | 不能改写成全量零失败，准备文档的 CI／打包待核验状态保持原义 |
| 5116613 | Renderer 38 通过；后端／IPC 筛选 27 通过、144 跳过；Preload 1 通过；定向 ESLint、diff 检查 | 无该轮 Electron 端到端、全量、类型检查或真实模型验证；记录中的“未提交”为提交前遗留措辞 |

## 截图准备与缺口

已读取 [Electron UI 自动化规范](../../quality/electron-ui-automation.md) 并检查已有产物。当前平台 Windows；拟用中文、浅色主题、1280×800 内容区，实际运行尺寸尚未取得。

- `dist/GoodBuddy-windows-x64/` 的便携标记及 `resources/app.asar` 版本均为 0.13.13，不能作 0.13.16／5116613 的产品截图。
- `out/` 有 Main、Preload、Renderer，也含新取消逻辑，但未找到可绑定目标 SHA 的构建身份。含某段新逻辑不证明三部分产物一致。
- 两个 portable staging 目录缺少完整 `resources/app.asar`，不能认定为目标包。
- 因无可确认匹配的生产产物，本次未启动应用／fixture，未做本地生产构建，未拍图；不能将视觉测试假数据或旧版图伪装成新版本实机结果。没有创建空 assets 目录或不存在的图片链接。

| 编号 | 优先级 | 场景与计划文件 | 当前状态 |
| --- | --- | --- | --- |
| 01 | 必补 | 真实工作回顾结果；`assets/01-work-review.png` | blocked：目标生产构建身份未确认 |
| 02 | 必补 | 同一结果图谱与来源；`assets/02-story-sources.png` | blocked：同上，需真实生成结果 |
| 03 | 建议 | Mermaid 正常 UI 导出并打开核对；`assets/03-mermaid-export.png` | blocked：同上 |
| 04 | 必补 | 同一回顾的阶段与保存批次；`assets/04-review-progress.png` | blocked：同上，区分 0.13.16 与后续取消控件 |
| 05 | 建议 | 虚构笔记待办调宽与折叠；`assets/05-note-todos.png` | blocked：同上 |
| R01 | 必填 | 最终版本、下载、日期、完整更新说明 | 尚未在线核验，不编造 |
| R02 | 必处理 | 5116613 的最终归属 | 已提交但未归入目标 tag；发布前核验对应版本并处理小节中的编辑提示 |
| C01 | 必核对 | 续跑期间暂停与取消控件版本 | 保留具体差异，待匹配最终安装包 |

取得可核验产物后的步骤：在本轮独立临时目录建立 Node supervisor 与 Electron bootstrap，ready 前隔离 userData/sessionData，通过生产 Main/Preload/Renderer 启动；正常 UI 创建虚构项目、消息、任务和笔记。回顾演示仅发送所需最小模型请求并从实际请求边界计数。检查保存与重新打开、对象来源、暂停续跑后，逐张 capturePage 并打开审阅，确认无私人资料、裁切、错误状态；只归档实际采用图片，停止本次进程并清理演示 profile。

## 文案审校与交付检查

采用 deai-writing 1.3.0，读者为 GoodBuddy 日常用户；标题和正文以操作与结果为主，保留必要的数据、费用、版本与功能边界。不引入虚构效率数字、用户评价或发布状态。

交付检查结果：

- Python 3.13.13 执行 `deai_scan.py article.md --json`：阻断项 0、复核项 13、读取错误 0。逐条审阅：12 项是编辑状态、升级兼容、发送限制、回放能力或取消语义等必要否定表述；另 1 项命中“模型准确理解”，用于说明处理覆盖不保证语义正确，保留原义。未机械删除功能边界。
- 独立只读复核按固定提交检查正文与清单，未发现重大过度宣称、明确功能遗漏或版本混淆。11 个相对 Markdown 链接目标及备份锚点存在；图 01–05、R01、R02、C01 与核查表对应。
- `git diff --check -- docs/pr-articles` 通过；仅提示既有 Git 行尾策略可能将 LF 转 CRLF。新增文件另作 no-index 空白检查。
- 已通读结构与篇幅，主要能力展开，控件调整合并，未把同一能力在三类中重复当作新增；性能无虚构量化承诺。
- 本次产品测试、构建、截图与真实模型请求均为 0。草稿所用验证数字来自已提交历史记录，不是本次执行结果。

本次只改文章、核查记录和索引，不提交、不打 tag、不对外发布。交付仍为带编辑提示的草稿；待补图片和发布信息见上表。