Harness 一键插入支持索引
架构变更（2026-10-21）： 见
../ARCHITECTURE.mdTop Rules。宿主适配仍属 MemHub 管理面；导入进 MemHub Evidence 权威改为写入 SDK（含 raw）。各 harness 专页未改处冲突时以架构为准。
更新日期：2026-10-14
“一键插入应用”控制的是 MemHub → Harness 的 Recall 接入；“同步开关”控制的是 Harness → MemHub 的会话读取与处理。两者不是同一个功能。
打开一键插入通常会执行：
后台 Preview 并计算 fingerprint
→ 创建 install-only Installation 和私有 Credential
→ 写 Harness 配置、Skill、Hook 或 Plugin
→ 写安装 Journal
→ 授予 Recall Tools 和 Scopes
→ 执行连接 Probe
默认详情页授权：
Tools: om_recall, om_conversations, om_diagnostic_trace
Scopes: all-apps, source:<当前来源>
Preview 不会弹出给用户；开关点击本身被视为确认。关闭时通常先撤销 Credential，再恢复或删除受管文件。用户修改过的文件不会被强删。
支持矩阵
| Harness | 一键插入产品状态 | Harness 如何查询 MemHub | Harness 如何把新会话送入 MemHub | 同步开关的数据来源 |
|---|---|---|---|---|
| Hermes | 开放 | MCP + Skill | 无自动 Hook；Core 扫描 | .hermes SQLite/文件扫描 |
| Cursor | 开放 | MCP + Skill | Capture Hooks | Cursor Adapter 扫描 + Hook 实时入口 |
| Claude Code | 开放 | MCP + Skill | Capture Hooks | .claude/projects 扫描 + Hook 实时入口 |
| Codex | 开放 | MCP + Skill | Capture Hooks | .codex/sessions 扫描 + Hook 实时入口 |
| WorkBuddy | 开放 | .codebuddy-plugin 内 MCP + Skill |
Plugin Hooks | WorkBuddy Adapter 扫描 + Plugin Hook |
| OpenCode | 开放 | MCP，无 Skill | JS Capture Plugin | OpenCode DB 扫描 + Plugin 实时入口 |
| Qwen Code | 开放 | MCP + Skill | 无自动 Hook | $QWEN_HOME/projects 扫描 |
| Pi | 开放 | CLI Skill，不使用 MCP | JS Capture Extension | Pi session 扫描 + Extension 实时入口 |
| OpenClaw | 正式产品冻结 | 当前没有；仅有未开放的底层 MCP 写入器 | 没有 Hook、Plugin 或 Prefetch | Adapter 也被冻结，开关不可用 |
| DeepSeek Harness | 详情页排除，来源管理页按 Profile 接入 | Profile 级 MCP Patch | 无自动 Hook | $DSH_HOME/sessions 扫描 |
同步开关的统一精确语义
打开同步开关
Core 会：
- 检查来源目录已经授权且 Root identity 有效；
- 建立实时读取基线，避免把打开前的文件尾部误判成实时新增；
- 如果没有现存 history Job，创建一个 history Job；
- 把
<data_dir>/config.json中该来源的sync_enabled写为true； - 调度 pending Job，并恢复 paused、interrupted、failed Job；
- 把该来源加入轮询/文件 Watcher；
- 补扫历史尚未处理的 Session，并继续处理未来的新 Session；
- 如果启用了自动记忆处理，恢复对应的 Memory Task。
关闭同步开关
Core 会：
- 把来源从实时 Watcher/轮询的可执行集合中移除；
- 把
config.json中该来源的sync_enabled写为false； - 停止 claim Job 表中尚未开始的 Job；这些 Job 保持原状态，等待下次打开；
- 不再通过 Adapter 扫描新 Session；
- 已经 running 的少量 Job允许执行完，不强杀；
- Harness Hook/Plugin 后续即使继续调用 Capture，Core 也会因为同步关闭而拒绝入库；
- 已经生成的 Memory 不删除，仍可被 Search 和 Recall 使用。
关闭同步开关不会卸载 MCP、Skill、Hook 或 Plugin，也不会撤销 Harness 查询记忆的 Credential。那些属于“一键插入应用”开关。
共同语义
- 已安装且权限为
approved时再次打开，一般不重装，只修复 Runtime 路径并 Probe。 install-only、revoked或relink-required状态通常会重新安装、签发新 Credential 并授权。- 关闭时先撤权，再卸载；若文件有用户修改，只撤权并要求人工核对。
- Probe 是 MemHub 自己启动落盘命令做检查，不证明正在运行的 Harness 已热加载。
- 最稳妥的生效方式是完全退出目标 Harness、重新打开并开始新会话。
统一生产入口：