feat: connect conversations with Magic Notes

Let users retain useful assistant replies or complete conversations without leaving their chat workflow. Preview and edit captured text, choose an existing note or atomically create a note with its first entry, and return to the source conversation or message from saved records. Add an application-scoped Notes workbar tab with title/body search and quick text appends. Preserve drafts across conversation switches and guard closing, replacement and disabling. Schema 48 stores optional source metadata without rewriting file-backed bodies; source deletion retains the saved note. Older clients cannot reopen an upgraded database without a pre-upgrade backup. Release note: 可将助手回答或完整会话预览、编辑后加入魔法笔记，并从笔记返回原会话或消息。右侧快速笔记支持搜索和追加文字，切换会话保留草稿；采集本身不调用模型，保存后自动评论仍遵循已有设置。 Validation: isolated HEAD-based candidate passed 22 files / 930 focused tests, plus 20 gateway tests after including its create-result fixture adjustment. Real Electron App/preload/IPC/SQLite acceptance passed for all 502 historical messages, exact-entry/source navigation, native keyboard input in a 214px panel, reopen and source-deletion retention, with zero capture model calls. Repository lint and web TypeScript passed. Cached whitespace and secret-pattern checks passed; native-client changes and unrelated IPC extraction are excluded. Validation limits: the isolated source tree reuses installed node_modules, where a parallel task upgraded DSH from the committed 0.1.2-rc.1 to 0.1.7-rc.2. Full typecheck reports 14 DSH errors in three unchanged files; the full-suite attempt with --bail=1 also fails in deepseek-harness-host.test.ts. These are not all-green repository or release-package results. Earlier execution-time full suite failures and fixture repairs remain recorded in the feature progress doc.
2026-09-27 08:17:54 +08:00
parent 55efca3ee1
commit 1094433a7d
51 changed files with 1949 additions and 56 deletions
@@ -1,6 +1,11 @@
 # 助手工作栏

-助手工作栏统一承载本机与远程执行空间、Task、成果、文件、浏览器和终端等持续工作界面。
+助手工作栏统一承载本机与远程执行空间、Task、成果、文件、浏览器、终端和笔记等持续工作界面。
+
+“笔记”为应用级、可关闭的单实例 Tab，新布局默认不打开。它提供搜索、浏览和快速追加文字，
+与主页面魔法笔记共用存储；会话采集、来源跳转与草稿规则由
+[魔法笔记文档](../magic-notes/README.md)维护。该应用已接入并通过真实 Electron 验收；
+全仓验证未全绿，聚焦复跑与执行时失败见[笔记验证进度](../magic-notes/progress.md)。

 ## 文档导航

@@ -86,6 +86,7 @@ Runtime
 资源监控
 成果
 文档
+笔记
 ```

 - 应用不得根据当前项目、会话、Runtime、主机或探测结果无提示地增删能力目录项。
@@ -96,6 +97,7 @@ Runtime
  Conversation、Job、Run 或心跳事项。
 - 当前能力、连接、数据和空状态可以动态变化。
 - 能力不可用时，目录项或已打开面板显示原因、影响和可执行的配置或切换入口，不能只通过隐藏表示。
+- 笔记遵循魔法笔记的业务启用设置，启用时提供应用级单实例 Tab，禁用前处理草稿，禁用后移除入口和实例；取消主侧栏常驻不影响工作栏可用性。采集与来源规则见[魔法笔记逻辑设计](../magic-notes/logic-design.md)。
 - 用户可以在设置中调整目录顺序；恢复默认布局恢复标准目录与默认打开面板，不强制打开全部能力。
 - 浏览器、终端及其他声明为多实例的能力可以创建多个实例，每个实例拥有独立身份和范围绑定。

@@ -44,7 +44,7 @@ SSH 连接池，但尚不存在工作栏应用实例模型、终端 IPC、终端
 ### 3.1 工作栏应用

 工作栏应用是可以在助手工作栏中打开的一个能力，例如任务中心、工作区、浏览器、成果或
-终端。每项应用通过统一注册表声明：
+终端、笔记。每项应用通过统一注册表声明：

 - 稳定应用 ID。
 - 用户可见名称、图标和说明。
@@ -54,7 +54,8 @@ SSH 连接池，但尚不存在工作栏应用实例模型、终端 IPC、终端
 - 当前不可用时的原因和修复入口。

 目录中的应用可发现性与实例是否已经打开相互独立。应用不可用时保留入口并说明原因，不以
-隐藏代替状态。
+隐藏代替状态。笔记遵循其业务启用设置：关闭魔法笔记时隐藏目录入口并移除对应 Tab，
+关闭前处理草稿，规则见[会话联动逻辑](../magic-notes/logic-design.md)。

 注册表字段如下：

@@ -76,14 +77,15 @@ SSH 连接池，但尚不存在工作栏应用实例模型、终端 IPC、终端
 `defaultOpen`、`required` 和 `closable` 不互相推导。例如浏览器默认打开但不是必需实例；任务
 中心和工作区既默认打开又必须存在。`required` 不表示锁定顺序，顺序只由 `reorderable` 控制。

-当前五个应用的 `visibleAcrossContextSwitches` 均为 `true`。该属性记录应用目录的显示策略，
+当前六个应用的 `visibleAcrossContextSwitches` 均为 `true`。该属性记录应用目录的显示策略，
 不改变内容归属，也不授予其他会话的 MCP 访问权限；当前没有使用 `false` 的应用，尚未实现
 按上下文隐藏 Tab 的策略。

 浏览器在创建时绑定当前 Conversation；切换会话后仍保留原 Tab、选中状态和页面，导航操作
 继续使用原 `targetRef.conversationId`。此时新建浏览器才绑定新会话。默认或旧布局中尚未绑定
 的浏览器在首次使用时绑定活动会话，此后不再随会话切换改绑。终端同样保留创建时执行目标；
-任务中心、工作区和成果的内容继续跟随当前项目。
+任务中心、工作区和成果的内容继续跟随当前项目。笔记使用应用级范围，选择与草稿不随项目或
+会话切换，不接受 `targetRef`；重启仅恢复工作栏 Tab 描述，不恢复笔记选择和草稿。

 ### 3.2 工作栏 Tab 实例

@@ -218,6 +220,7 @@ stdio fallback。首期远程终端随 SSH Channel 结束，不提供跨 SSH 或
 | 浏览器 | `multiple` | 当前 Conversation | 是，一个实例 | 否 | 是 | 是 | 每次创建新 Tab |
 | 成果 | `single` | 当前项目 | 是 | 否 | 是 | 是 | 聚焦已有 Tab |
 | 终端 | `multiple` | 当前项目 | 否 | 否 | 是 | 是 | 每次创建新 Tab |
+| 笔记 | `single` | 应用级 | 否 | 否 | 是 | 是 | 聚焦已有 Tab |

 实例策略、默认状态和可关闭策略都是应用注册数据，不能分散硬编码在多个点击处理器中。