后端适配层

系统概览

后端适配层。提供统一的后端接口，支持浏览器（IndexedDB）和桌面（Go）两种后端。 idb.ts 封装 IndexedDB 操作，browser-adapter.ts 和 go-adapter.ts 分别为两种后端实现。

核心职责

• backend/index.ts — 后端适配层入口。
• backend/types.ts — 后端接口定义。
• backend/browser-adapter.ts — 浏览器后端实现（IndexedDB）。
• backend/go-adapter.ts — 桌面后端实现（Go/Wails）。
• backend/idb.ts — IndexedDB 操作封装。
• backend/backend-mocks.ts — 后端测试共享 Mock 工厂（ADR-206 Phase 4 拆自 backend.test.ts）。
• backend/browser-adapter-mocks.ts — 浏览器适配器测试共享 Mock 工厂（ADR-206 Phase 4 拆自 browser-adapter.test.ts）。

测试基础设施（ADR-206 Phase 4）

go-adapter 依赖 @bindings 运行时（Wails），idb 在 Node/happy-dom 下无 IndexedDB 实现，故两个 mock 工厂提供内存桩将单测与真实浏览器/桌面存储隔离：

• backend-mocks.ts — idbStore（内存 Map）/ setWindow / clearWebFlag / resetIdb 环境控制 + goAdapterMock（Go 后端能力桩）。
• browser-adapter-mocks.ts — mem（双层 Map store）/ setStore / resetMem 控制 + eqBytes 二进制相等断言。
• 坑：mem 必须普通 const 导出（Vite 禁止把 vi.hoisted 结果跨文件 export）；vi.mock('./idb') 因 hoist 约束在各测试文件内联，但共享同一 mem 实例；跨用例复用共享桩须 resetIdb() / resetMem() 防状态泄漏。

对外 API（节选）

• BackendAdapter — 后端适配器接口。
• BrowserAdapter — 浏览器后端实现。
• GoAdapter — Go 后端实现。
• idbSet(store, key, value) — 写入 IndexedDB。
• idbGet(store, key) — 读取 IndexedDB。
• idbDelete(store, key) — 删除 IndexedDB 记录。

与其他子系统关系

• IndexedDB：@/core/backend/idb。
• Wails 绑定：@/core/wails-bindings。
• 文件导入：@/core/drop-import。

不变量

• 适配器接口统一：浏览器和桌面后端通过相同接口调用。
• IndexedDB 操作异步：所有操作返回 Promise，不阻塞 UI。
• 数据隔离：浏览器和桌面后端数据独立存储。