root/goodbuddy
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
goodbuddy/docs/features/obsidian/progress.md
T
mesalogo f81f342cde feat: open local runtime clients from the composer 
Add composer shortcuts for local Continue and OpenCode terminals and the official DeepSeek Harness Web client, using the current project and model bridge. Manage browser service reuse, stop actions and terminal cleanup. Upgrade DeepSeek Harness to 0.1.7-rc.2 and Cordis to 4.0.4.

Include the coordinated IPC handler extraction and related tests and documentation. Remote native-client coordinator wiring, managed Node consolidation, Ask MCP mappings and full desktop/package acceptance remain unfinished; this commit records the implemented local workflow and supporting SSH groundwork.

Validation: typecheck and lint passed; 267 focused tests passed and 5 skipped. No new real-provider calls were made for this commit. Prior real-model evidence and remaining acceptance work are documented in the feature progress files.

Release note: 本地项目选择 Continue 或 OpenCode 后，可从输入框下方打开原生终端；选择 DS 后，可打开使用当前项目和模型的官方 Web 客户端。客户端使用独立会话，DS 网页关闭后服务继续运行，可在 GoodBuddy 中停止；远程入口尚未完成。
2026-09-27 08:38:00 +08:00

110 lines
13 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 实施进度
## 当前状态
2026-09-27：主服务、设置 UI、Main IPC、HTTP 网关和直连工具提供器已实现，共享目录共 19 个工具。Windows 真实 Electron 设置操作与 OpenCode / Continue 聊天输入框读写已通过；Windows x64 解包应用通过受限网络下的设置连接和保存验证。物理断网、安装器及其他系统验收仍待完成，全量检查存在下述无关失败；当前状态不表示已发布。
| 阶段 | 已核对事实 | 剩余工作 |
| --- | --- | --- |
| TS-1 配置与服务 | 默认关闭、范围独立保存、注册发现及 ID 路由已实现；复制后的真实 MCPVault 已用于文件操作和错误传播测试 | 跨平台安装包验证归入 TS-4 |
| TS-2 设置 UI | 真实 Electron 窗口中验证草稿测试不保存、不启用，保存和错误保留输入，Windows 原生目录对话框取消、键盘开关、19 工具展开及浅深主题窄窗口；修复表单横向撑宽 | 其他系统原生窗口验收 |
| TS-3 网关与 IPC | 19 工具、Ask/Execute、撤销、取消及清理自动化通过；OpenCode / Continue 真实会话及聊天输入框读写通过 | 安装后的聊天读写与其他系统验收 |
| TS-4 打包与交付 | 当前源码 `build:bundle` 和 Windows x64 `--dir` 打包通过；实际 `app.asar` UI 连接随包 MCPVault 并保存，子进程加载网络 API 限制，PATH 仅含 System32 | 物理断网或 OS 级隔离、安装器、macOS/Linux/其他架构原生资源验收 |
DeepSeek Harness 和远程执行保持既有不可用边界。本轮产品代码仅修改 Obsidian 表单布局，没有改变 Agent 或远程 Runtime 路径。
## 提交快照验证
提交前从 HEAD 与 Obsidian 暂存内容生成独立目录，排除并行开发的原生终端、DSH 升级、IPC 拆分与 Magic Notes 改动。锁文件从 HEAD 重新生成，仅添加固定版本 MCPVault 及其依赖，没有升级或删除既有依赖项；独立目录安装该锁文件后验证。
`npm run typecheck`、`npm run lint` 和 `npm run build` 均通过。聚焦服务、Electron、网关、直连工具、配置、Continue 适配器及共享 UI 的 11 个文件共 237 项通过；完整 IPC、设置面板与构建测试的 3 个文件共 303 项通过。合计 14 个文件、540 项测试通过。本次没有重跑全量套件、安装包或真实模型调用，新增模型调用为 0。下文全仓失败记录来自此前混合工作区，不代表此提交快照的类型检查或构建结果。
## 2026-09-27 验收补充
以下结果来自独立临时应用配置、项目和 vault。模型凭据通过临时复制的 `runtime-settings.json` 与配套 `Local State` 在 Electron Main 中解密；源配置和用户 vault 均未修改。测试结束删除临时配置、凭据副本和笔记；Windows 解包构建与检查日志保留在系统临时目录的 `opencode` 下。没有提交、发布、安装器或 portable 构建。
| 验证项 | 实际结果与边界 |
| --- | --- |
| 聚焦测试 | 8 文件、133 项通过，含 `obsidian-electron.test.ts` 和 Continue 适配器；IPC 定向 5 项通过、152 项跳过。布局修正后 MCP 设置、共享 UI 与 Electron 服务共 43 项通过 |
| `npm run build` / `npm run typecheck` | `build` 停在类型检查；末次类型检查仍为 SSH pool、SSH directory browser 和 SSH terminal 测试替身缺少 `forwardLoopback`。本轮脚本类型错误已修复；未修改并行开发的 SSH 测试 |
| `npm run build:bundle` | 当前源码通过，布局修改后再次通过；不能据此将 `npm run build` 记为通过 |
| `npm run lint` | 当前工作区通过 |
| 分项类型检查 | `npx tsc --noEmit -p tsconfig.web.json` 与 `npx tsc --noEmit -p tsconfig.agent.json` 均通过 |
| `npm test` | 首次 200 秒超时；随后后台运行完整结束，691.25 秒，444 文件通过、3 失败、11 跳过；5,274 测试通过、3 失败、83 跳过 |
| 全量失败定位 | `activity-history-io.test.ts`：迁移重复添加 `source_json`；`magic-notes-capture.electron.test.ts`：宽度 0、溢出 82 的布局断言；`build-release.test.ts`：fixture 缺少 `@deepseek-ai/dsh/package.json`。均属于并行改动范围，本轮保留原状 |
| 真实设置 UI | [Electron runner](../../../build/run-obsidian-electron-acceptance.cjs) 导入生产 Main、使用生产 Preload/Renderer 和原生鼠标键盘，覆盖测试 18 个上游工具、保存、错误、目录对话框取消、Space 启用和展开 19 个工具。未替换 IPC 或 ObsidianService |
| 布局缺陷与修复 | 原表单复用了横向 `.capability-diagnostic`；759 像素内容视口中卡片右边界达到 1116 像素。改为 Obsidian 纵向表单、按钮及路径换行后，普通状态右边界 691，含测试结果和工具展开时 732；浅深主题均无卡片内部横向溢出 |
| 真实 Runtime 会话 | [Runtime runner](../../../tests/obsidian-runtime-acceptance.ts) 使用真实 OpenCode / Continue、生产 HTTP 网关和 MCPVault，断言工具事件、模型返回和实际文件。两轮各 Runtime 各 3 次模型 HTTP 请求，共 12 次；第二轮使用 UI 保存并启用的能力快照 |
| 完整聊天输入框 | `--chat` 中 OpenCode 实际发送、读写及回复验证通过，计 4 次模型 HTTP 请求；该次随后在 Continue 菜单定位处失败。修正选择器后 `--chat --continue-only` 通过，同样 4 次请求。合计本轮 20 次真实模型 HTTP 请求，其他启动、菜单和凭据准备失败均为 0 次。聊天证据来自开发生产 bundle；没有将独立 Runtime harness 冒充聊天 UI |
| Windows x64 解包应用 | 正常 electron-builder 配置以 `--dir --publish never` 生成 `GoodBuddy.exe` 和 `app.asar`，含解包 MCPVault 及 `windows-trash.exe`。[打包 runner](../../../build/run-obsidian-packaged-acceptance.cjs) 通过 CDP 驱动真实页面控件，设置连接返回 18 工具，保存快照匹配临时 vault；托管 node shim 指向该打包 EXE |
| 网络限制 | 打包 EXE 的 PATH 仅含 System32，Chromium 指向不可用代理；Electron 启动会移除 `NODE_OPTIONS`，首次尝试未加载 guard。随后仅在测试 Main 的本机 inspector 中恢复该变量，审计确认真实 MCPVault 子进程加载 guard，入口为 `app.asar.unpacked/.../server.js`。Node guard 拒绝非 loopback socket 和 fetch；不覆盖 OS 全部联网方式，不算物理断网或防火墙隔离 |
复现命令如下。打包命令须使用真正的 Node 可执行文件；本机 PATH 中的 Electron Node shim 会使 electron-builder CLI 误读 argv。`--live` 和 `--chat` 会调用真实文本模型；默认读取当前用户 GoodBuddy 模型配置，也可用 `GOODBUDDY_ACCEPTANCE_SETTINGS` 指向含配套 `Local State` 的测试配置目录中的设置文件。
```powershell
npx vitest run src/shared/obsidian-tools.test.ts src/main/obsidian/obsidian-service.test.ts src/main/obsidian/obsidian-electron.test.ts src/main/agent/knowledge-mcp-gateway.obsidian.test.ts src/main/agent/model-tool-provider.obsidian.test.ts src/main/capabilities/capability-service.test.ts src/renderer/src/McpSettingsSection.test.tsx src/main/agent/continue-host-adapter.test.ts
npx vitest run src/main/ipc.test.ts -t Obsidian
npx vitest run src/renderer/src/McpSettingsSection.test.tsx src/renderer/src/WorkspacePrimitives.test.tsx src/main/obsidian/obsidian-electron.test.ts
npm run build:bundle
node build/run-obsidian-electron-acceptance.cjs
node build/run-obsidian-electron-acceptance.cjs --live
node build/run-obsidian-electron-acceptance.cjs --chat
node build/run-obsidian-electron-acceptance.cjs --chat --continue-only
# 以下占位路径替换为本机 Node、临时构建目录及打包 EXE。
& "<node.exe>" build/run-electron-builder.cjs --win --x64 --dir --publish never --config.directories.output="<temporary-output>"
node build/run-obsidian-packaged-acceptance.cjs "<temporary-output>/win-unpacked/GoodBuddy.exe"
```
本机打包输出为 `%TEMP%/opencode/obsidian-package-acceptance/win-unpacked`；全量日志为 `%TEMP%/opencode/obsidian-full-tests.log` 与 `.err`。以下保留 2026-09-26 的历史记录，不能用其中旧阻塞覆盖本节最新结果。
本轮文档 deai-writing 扫描 6 文件，0 个阻断项、12 个复核项；复核项均为测试条件、状态或能力范围限定，通读后保留。`git diff --check` 通过。
## 源码与测试证据
2026-09-26 核对以下源码与测试。本轮重新执行的结果见验证记录；此前构建结果保留原来源，不作为当前工作区构建通过的证明。
| 证据 | 可支持的结论 |
| --- | --- |
| [obsidian-service.ts](../../../src/main/obsidian/obsidian-service.ts) 与[服务测试](../../../src/main/obsidian/obsidian-service.test.ts) | 注册发现、真实复制包后的读写、许可证与资源、工具集合、多仓库 ID 以及取消后进程清理 |
| [capability-service.test.ts](../../../src/main/capabilities/capability-service.test.ts) | 范围持久化、旧字段缺省和拒绝 `readOnly` 参数 |
| [ipc.test.ts](../../../src/main/ipc.test.ts) | 设置组件调用正式注册的 IPC 处理器、真实配置服务及 MCPVault；Electron 传输和目录对话框由测试替代，不是安装后完整界面验证 |
| [共享工具测试](../../../src/shared/obsidian-tools.test.ts) | 19 工具集合和 18 个上游工具的字段、默认值、必填项与约束对应 |
| [HTTP 网关测试](../../../src/main/agent/knowledge-mcp-gateway.obsidian.test.ts) | 实际 HTTP MCP 发现 19 工具，真实多仓库读写、删除及错误返回；另覆盖撤销、取消和等待 transport 关闭 |
| [直连提供器测试](../../../src/main/agent/model-tool-provider.obsidian.test.ts) | 通过实际服务执行全部 19 个工具并核验文件，包含笔记移动、二进制附件移动和删除；覆盖 Ask、失效令牌、原生错误及关闭清理 |
| [index.ts](../../../src/main/index.ts)、[ipc.ts](../../../src/main/ipc.ts) 与[capability-ipc.ts](../../../src/main/capabilities/capability-ipc.ts) | 正式启动实例化、依赖注入和 IPC 注册；能力处理器位于 `capability-ipc.ts`，范围保存、开关及分配提交在持久化前撤销旧 Obsidian 请求授权 |
| [package-mcpvault.ts](../../../src/main/obsidian/package-mcpvault.ts) 与[构建配置](../../../electron.vite.config.ts) | 构建期递归复制运行依赖，并固定上游版本 |
## 验证记录
| 验证项 | 2026-09-26 结果及范围 |
| --- | --- |
| 聚焦生产组件自动化 | 本轮 7 个文件、132 项测试通过，包含 Continue 适配器；另运行 IPC 的 Obsidian 用例，5 项通过、151 项跳过 |
| `npm run build` | 此前主实施方反馈通过；本轮未重跑 |
| `npm run typecheck` | 首次运行报原生终端依赖未列入项目的 TS6307；并行改动后复跑，该错误已消失，当前阻塞为 `native-terminal-client.test.ts:33` 的 TS2352 类型转换错误。未修改这部分并行开发代码 |
| `npm run lint` | 本轮通过；最终测试文件改动另行定向检查 |
| `npm test` | 本轮在 200 秒超时；结束前出现数据库迁移、Magic Notes 等失败。全量套件没有通过结论；Continue 适配器定向复跑通过 |
| Electron 托管 Node 冒烟 | 将服务测试改为真实 Electron 可执行文件，以 `ELECTRON_RUN_AS_NODE=1` 启动复制后的包，10 项通过。Windows 子进程 PATH 仅保留测试 shim 与 System32；覆盖发现、读写、局部修改、属性、回收站和取消清理。没有隔离网络，物理断网安装包验收仍待完成 |
| 安装后完整 Electron UI 与跨平台验收 | 待完成；组件自动化使用替代 Electron 传输，不能覆盖原生窗口及安装环境 |
2026-09-26 本次文档修订新增 FR-10、LR-8、US-12，保留原有 ID。交付检查结果：
| 文档检查 | 结果 |
| --- | --- |
| 相对链接及锚点 | 6 份功能文档的 53 个链接、4 份跨功能文档新增的 5 个引用通过 |
| 稳定 ID 与工具清单 | FR-1～FR-10、US-1～US-12、LR-1～LR-8、TS-1～TS-4 唯一声明通过；18 个上游工具和 19 个共享工具映射一致 |
| deai-writing 审校 | 功能文档 0 个阻断项、11 个复核项，逐项核对后保留状态和能力边界限定；跨功能新增段落单独扫描，0 个阻断项、0 个复核项 |
| 差异与空白 | `git diff --check` 通过；临时脚本另检查未跟踪的功能文档，无行尾空白或旧网关接入状态 |
本轮修改服务测试和验证记录；测试使用独立临时仓库，未修改用户笔记或应用设置。
最终定向 ESLint 和 `git diff --check` 通过。README 与本进度文档经 deai-writing 扫描，0 个阻断项、3 个复核项；复核项均描述验收范围或草稿状态，保留事实限定。
聚焦测试复现入口如下；这些命令用于定位相关用例，不是全量通过证明：
```powershell
npx vitest run src/shared/obsidian-tools.test.ts src/main/obsidian/obsidian-service.test.ts src/main/agent/knowledge-mcp-gateway.obsidian.test.ts src/main/agent/model-tool-provider.obsidian.test.ts src/main/capabilities/capability-service.test.ts src/renderer/src/McpSettingsSection.test.tsx
npx vitest run src/main/ipc.test.ts -t Obsidian
```
剩余验收以本文顶部阶段表为准，按[验证矩阵](./technical-design.md#验证与实施顺序)补充物理断网、安装后及其他目标系统证据。配置变更触发取消与销毁等待的具体语义以[功能逻辑](./logic-design.md#授权撤销与清理)为准。
Reference in New Issue View Git Blame Copy Permalink