@carloswon/cairn-memory 0.0.0-stage → 0.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +81 -0
- package/LICENSE +21 -0
- package/README.md +158 -2
- package/dist/src/agents/adapters.d.ts +82 -0
- package/dist/src/agents/adapters.js +209 -0
- package/dist/src/agents/adapters.js.map +1 -0
- package/dist/src/agents/config.d.ts +82 -0
- package/dist/src/agents/config.js +603 -0
- package/dist/src/agents/config.js.map +1 -0
- package/dist/src/agents/cordisPatch.d.ts +89 -0
- package/dist/src/agents/cordisPatch.js +201 -0
- package/dist/src/agents/cordisPatch.js.map +1 -0
- package/dist/src/agents/index.d.ts +2 -0
- package/dist/src/agents/index.js +3 -0
- package/dist/src/agents/index.js.map +1 -0
- package/dist/src/core/errors.d.ts +36 -0
- package/dist/src/core/errors.js +74 -0
- package/dist/src/core/errors.js.map +1 -0
- package/dist/src/core/hash.d.ts +14 -0
- package/dist/src/core/hash.js +48 -0
- package/dist/src/core/hash.js.map +1 -0
- package/dist/src/core/ids.d.ts +10 -0
- package/dist/src/core/ids.js +41 -0
- package/dist/src/core/ids.js.map +1 -0
- package/dist/src/core/index.d.ts +6 -0
- package/dist/src/core/index.js +7 -0
- package/dist/src/core/index.js.map +1 -0
- package/dist/src/core/scope.d.ts +78 -0
- package/dist/src/core/scope.js +181 -0
- package/dist/src/core/scope.js.map +1 -0
- package/dist/src/core/secrets.d.ts +13 -0
- package/dist/src/core/secrets.js +122 -0
- package/dist/src/core/secrets.js.map +1 -0
- package/dist/src/core/time.d.ts +7 -0
- package/dist/src/core/time.js +18 -0
- package/dist/src/core/time.js.map +1 -0
- package/dist/src/core/types.d.ts +139 -0
- package/dist/src/core/types.js +30 -0
- package/dist/src/core/types.js.map +1 -0
- package/dist/src/governance/apply.d.ts +64 -0
- package/dist/src/governance/apply.js +160 -0
- package/dist/src/governance/apply.js.map +1 -0
- package/dist/src/governance/archive.d.ts +29 -0
- package/dist/src/governance/archive.js +52 -0
- package/dist/src/governance/archive.js.map +1 -0
- package/dist/src/governance/dedup.d.ts +21 -0
- package/dist/src/governance/dedup.js +23 -0
- package/dist/src/governance/dedup.js.map +1 -0
- package/dist/src/governance/index.d.ts +16 -0
- package/dist/src/governance/index.js +17 -0
- package/dist/src/governance/index.js.map +1 -0
- package/dist/src/governance/propose.d.ts +78 -0
- package/dist/src/governance/propose.js +150 -0
- package/dist/src/governance/propose.js.map +1 -0
- package/dist/src/index.d.ts +15 -0
- package/dist/src/index.js +24 -0
- package/dist/src/index.js.map +1 -0
- package/dist/src/interfaces/app-service.d.ts +292 -0
- package/dist/src/interfaces/app-service.js +743 -0
- package/dist/src/interfaces/app-service.js.map +1 -0
- package/dist/src/interfaces/cli/main.d.ts +2 -0
- package/dist/src/interfaces/cli/main.js +854 -0
- package/dist/src/interfaces/cli/main.js.map +1 -0
- package/dist/src/interfaces/console/assets/page.d.ts +18 -0
- package/dist/src/interfaces/console/assets/page.js +39 -0
- package/dist/src/interfaces/console/assets/page.js.map +1 -0
- package/dist/src/interfaces/console/assets/ui-css.d.ts +11 -0
- package/dist/src/interfaces/console/assets/ui-css.js +119 -0
- package/dist/src/interfaces/console/assets/ui-css.js.map +1 -0
- package/dist/src/interfaces/console/assets/ui-js.d.ts +14 -0
- package/dist/src/interfaces/console/assets/ui-js.js +1098 -0
- package/dist/src/interfaces/console/assets/ui-js.js.map +1 -0
- package/dist/src/interfaces/console/assets/url-state.d.ts +9 -0
- package/dist/src/interfaces/console/assets/url-state.js +45 -0
- package/dist/src/interfaces/console/assets/url-state.js.map +1 -0
- package/dist/src/interfaces/console/export.d.ts +46 -0
- package/dist/src/interfaces/console/export.js +84 -0
- package/dist/src/interfaces/console/export.js.map +1 -0
- package/dist/src/interfaces/console/model.d.ts +372 -0
- package/dist/src/interfaces/console/model.js +731 -0
- package/dist/src/interfaces/console/model.js.map +1 -0
- package/dist/src/interfaces/console/review-store.d.ts +142 -0
- package/dist/src/interfaces/console/review-store.js +342 -0
- package/dist/src/interfaces/console/review-store.js.map +1 -0
- package/dist/src/interfaces/console/security.d.ts +76 -0
- package/dist/src/interfaces/console/security.js +105 -0
- package/dist/src/interfaces/console/security.js.map +1 -0
- package/dist/src/interfaces/console/server.d.ts +45 -0
- package/dist/src/interfaces/console/server.js +476 -0
- package/dist/src/interfaces/console/server.js.map +1 -0
- package/dist/src/interfaces/console/suggestions.d.ts +112 -0
- package/dist/src/interfaces/console/suggestions.js +511 -0
- package/dist/src/interfaces/console/suggestions.js.map +1 -0
- package/dist/src/interfaces/console/text.d.ts +4 -0
- package/dist/src/interfaces/console/text.js +18 -0
- package/dist/src/interfaces/console/text.js.map +1 -0
- package/dist/src/interfaces/mcp/server.d.ts +4 -0
- package/dist/src/interfaces/mcp/server.js +480 -0
- package/dist/src/interfaces/mcp/server.js.map +1 -0
- package/dist/src/jobs/index.d.ts +6 -0
- package/dist/src/jobs/index.js +7 -0
- package/dist/src/jobs/index.js.map +1 -0
- package/dist/src/jobs/remote.d.ts +42 -0
- package/dist/src/jobs/remote.js +34 -0
- package/dist/src/jobs/remote.js.map +1 -0
- package/dist/src/jobs/worker.d.ts +67 -0
- package/dist/src/jobs/worker.js +169 -0
- package/dist/src/jobs/worker.js.map +1 -0
- package/dist/src/onboarding/auto.d.ts +88 -0
- package/dist/src/onboarding/auto.js +399 -0
- package/dist/src/onboarding/auto.js.map +1 -0
- package/dist/src/onboarding/batches.d.ts +103 -0
- package/dist/src/onboarding/batches.js +219 -0
- package/dist/src/onboarding/batches.js.map +1 -0
- package/dist/src/onboarding/discover.d.ts +54 -0
- package/dist/src/onboarding/discover.js +369 -0
- package/dist/src/onboarding/discover.js.map +1 -0
- package/dist/src/onboarding/import.d.ts +69 -0
- package/dist/src/onboarding/import.js +279 -0
- package/dist/src/onboarding/import.js.map +1 -0
- package/dist/src/onboarding/index.d.ts +24 -0
- package/dist/src/onboarding/index.js +22 -0
- package/dist/src/onboarding/index.js.map +1 -0
- package/dist/src/onboarding/judgement.d.ts +50 -0
- package/dist/src/onboarding/judgement.js +121 -0
- package/dist/src/onboarding/judgement.js.map +1 -0
- package/dist/src/onboarding/policy.d.ts +86 -0
- package/dist/src/onboarding/policy.js +249 -0
- package/dist/src/onboarding/policy.js.map +1 -0
- package/dist/src/projection/brief.d.ts +112 -0
- package/dist/src/projection/brief.js +200 -0
- package/dist/src/projection/brief.js.map +1 -0
- package/dist/src/projection/index.d.ts +1 -0
- package/dist/src/projection/index.js +2 -0
- package/dist/src/projection/index.js.map +1 -0
- package/dist/src/projection/markdown.d.ts +82 -0
- package/dist/src/projection/markdown.js +313 -0
- package/dist/src/projection/markdown.js.map +1 -0
- package/dist/src/retrieval/export.d.ts +80 -0
- package/dist/src/retrieval/export.js +215 -0
- package/dist/src/retrieval/export.js.map +1 -0
- package/dist/src/retrieval/index.d.ts +5 -0
- package/dist/src/retrieval/index.js +6 -0
- package/dist/src/retrieval/index.js.map +1 -0
- package/dist/src/retrieval/search.d.ts +37 -0
- package/dist/src/retrieval/search.js +294 -0
- package/dist/src/retrieval/search.js.map +1 -0
- package/dist/src/store/archives.d.ts +94 -0
- package/dist/src/store/archives.js +135 -0
- package/dist/src/store/archives.js.map +1 -0
- package/dist/src/store/audit.d.ts +57 -0
- package/dist/src/store/audit.js +131 -0
- package/dist/src/store/audit.js.map +1 -0
- package/dist/src/store/backup.d.ts +36 -0
- package/dist/src/store/backup.js +90 -0
- package/dist/src/store/backup.js.map +1 -0
- package/dist/src/store/blocks.d.ts +64 -0
- package/dist/src/store/blocks.js +104 -0
- package/dist/src/store/blocks.js.map +1 -0
- package/dist/src/store/conflicts.d.ts +52 -0
- package/dist/src/store/conflicts.js +112 -0
- package/dist/src/store/conflicts.js.map +1 -0
- package/dist/src/store/db.d.ts +44 -0
- package/dist/src/store/db.js +162 -0
- package/dist/src/store/db.js.map +1 -0
- package/dist/src/store/device.d.ts +46 -0
- package/dist/src/store/device.js +111 -0
- package/dist/src/store/device.js.map +1 -0
- package/dist/src/store/index.d.ts +14 -0
- package/dist/src/store/index.js +15 -0
- package/dist/src/store/index.js.map +1 -0
- package/dist/src/store/memories.d.ts +133 -0
- package/dist/src/store/memories.js +442 -0
- package/dist/src/store/memories.js.map +1 -0
- package/dist/src/store/migrate.d.ts +32 -0
- package/dist/src/store/migrate.js +87 -0
- package/dist/src/store/migrate.js.map +1 -0
- package/dist/src/store/open.d.ts +53 -0
- package/dist/src/store/open.js +203 -0
- package/dist/src/store/open.js.map +1 -0
- package/dist/src/store/outbox.d.ts +65 -0
- package/dist/src/store/outbox.js +137 -0
- package/dist/src/store/outbox.js.map +1 -0
- package/dist/src/store/plans.d.ts +137 -0
- package/dist/src/store/plans.js +243 -0
- package/dist/src/store/plans.js.map +1 -0
- package/dist/src/store/schema.d.ts +46 -0
- package/dist/src/store/schema.js +544 -0
- package/dist/src/store/schema.js.map +1 -0
- package/dist/src/store/scopes.d.ts +44 -0
- package/dist/src/store/scopes.js +220 -0
- package/dist/src/store/scopes.js.map +1 -0
- package/dist/src/store/write-guard.d.ts +10 -0
- package/dist/src/store/write-guard.js +10 -0
- package/dist/src/store/write-guard.js.map +1 -0
- package/dist/src/sync/apply.d.ts +24 -0
- package/dist/src/sync/apply.js +130 -0
- package/dist/src/sync/apply.js.map +1 -0
- package/dist/src/sync/cryptoutil.d.ts +86 -0
- package/dist/src/sync/cryptoutil.js +339 -0
- package/dist/src/sync/cryptoutil.js.map +1 -0
- package/dist/src/sync/events.d.ts +69 -0
- package/dist/src/sync/events.js +78 -0
- package/dist/src/sync/events.js.map +1 -0
- package/dist/src/sync/obs-store.d.ts +41 -0
- package/dist/src/sync/obs-store.js +325 -0
- package/dist/src/sync/obs-store.js.map +1 -0
- package/dist/src/sync/orchestrate.d.ts +37 -0
- package/dist/src/sync/orchestrate.js +84 -0
- package/dist/src/sync/orchestrate.js.map +1 -0
- package/dist/src/sync/pull.d.ts +24 -0
- package/dist/src/sync/pull.js +150 -0
- package/dist/src/sync/pull.js.map +1 -0
- package/dist/src/sync/push.d.ts +19 -0
- package/dist/src/sync/push.js +227 -0
- package/dist/src/sync/push.js.map +1 -0
- package/dist/src/sync/syncd-store.d.ts +31 -0
- package/dist/src/sync/syncd-store.js +92 -0
- package/dist/src/sync/syncd-store.js.map +1 -0
- package/dist/src/sync/vault.d.ts +37 -0
- package/dist/src/sync/vault.js +53 -0
- package/dist/src/sync/vault.js.map +1 -0
- package/docs/cairn-security.md +267 -0
- package/docs/cairn-usage.md +919 -0
- package/package.json +71 -4
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
本文件记录 `@carloswon/cairn-memory` 的显著变更。格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)。
|
|
4
|
+
|
|
5
|
+
## [0.3.0] - 2026-11-04
|
|
6
|
+
|
|
7
|
+
候选的批准/拒绝出口,以及治理投影「谁进得去」的重要度与使用信号。两个 OpenSpec 变更归档,主规格 10/10 严格通过。
|
|
8
|
+
|
|
9
|
+
### Added
|
|
10
|
+
|
|
11
|
+
- **候选晋升与拒绝**(`add-candidate-promote-command`):候选(`status=candidate`)此前**没有任何合法晋升入口**——唯一路径是用逐字节相同的正文再写一次,撞查重后被动晋升,且无法表达作用域意图。现在:
|
|
12
|
+
- `cairn promote <id> [--scope-preset <preset>]`、`cairn reject <id> "<理由>"`,以及 MCP 工具 `memory_promote` / `memory_reject`。
|
|
13
|
+
- 晋升后权威记为 `user_confirmed`(用户**审阅并批准**),不沿用候选的 `agent_inferred`,也不伪装成 `user_explicit`(用户亲口陈述)。
|
|
14
|
+
- 批准凭据是本地 CLI 进程本身,通道记入审计;**不可被远端或 Agent 代签**。
|
|
15
|
+
- **晋升可同时迁移作用域**,与状态更新同事务,并按新作用域**重建 outbox**(旧作用域任务若照发会把记忆同步到错误的云端空间)。
|
|
16
|
+
- 拒绝转墓碑而非物理删除,可审计、可恢复。
|
|
17
|
+
- **记忆重要度 `importance`**(1–5,`add-memory-importance-and-usage-signal`):与 `confidence`(可信度)正交。`memory_add` / `memory_propose` 可指定;缺省 3(未判断);`agent_inferred` / `imported_unverified` 来源**上限 3**(不得自封高星挤占预算);越界报错不静默截断。
|
|
18
|
+
- **使用信号双轨**:`last_used_at`(被看到)与 `usage_count`(被主动请求)。自动注入**只写前者**——插件每轮都注入(实测 97% 重复),计入次数会让注入频率取代真实需求,形成正反馈死锁。
|
|
19
|
+
- **投影排序与三条地板**:`有效重要度 × 艾宾浩斯衰减`,带 ①`importance≥4` 豁免 ②本轮高度相关豁免 ③绝对地板 0.5。没有地板的话,被注入过的更容易被注入,一年后只剩少数明星记忆可见。
|
|
20
|
+
- **过期归档**:`cairn doctor --archive-stale [--apply]`,`importance=1` 且 180 天未用 → `archived`(不删除,留审计)。默认演练;**不挂在写入/检索路径上**。
|
|
21
|
+
|
|
22
|
+
### Changed
|
|
23
|
+
|
|
24
|
+
- MCP `memory_search` 新增 `increment_usage` 参数(缺省 `true`)。**宿主插件自动召回必须传 `false`**。
|
|
25
|
+
- 检索结果 `summarize` 带出 `importance` 与 `usage_count`,供面板显示「这条为什么被选中」。
|
|
26
|
+
- 迁移 005 只做 `ALTER TABLE ADD COLUMN` + 建索引,**不重建表**——与 004 不同,这两列没有硬编码 CHECK 约束,没有理由再付一次「关外键 + DROP 旧表 + 重建 6 索引 3 触发器」的风险。
|
|
27
|
+
|
|
28
|
+
### Fixed
|
|
29
|
+
|
|
30
|
+
- `markUsed()` 自 0.1.x 起**从未被任何代码调用**(`last_used_at` 全库 0/45),现在接上检索路径,并区分注入/检索两种增量语义。
|
|
31
|
+
|
|
32
|
+
## [0.2.0] - 2026-11-02
|
|
33
|
+
|
|
34
|
+
DSH 实时记忆插件、`lesson` 类型、投影简报、跳过账本与宿主适配器。九个 OpenSpec 能力规格全部通过严格校验。
|
|
35
|
+
|
|
36
|
+
### Added
|
|
37
|
+
|
|
38
|
+
- **`lesson` 记忆类型**:表达「曾经判断错了」的纠正性认知,区别于 `fact`(事实)与 `procedure`(做法)。迁移 004 重建 `memory.kind` CHECK 约束并重建全部索引与 FTS 触发器。
|
|
39
|
+
- **受管投影简报**:把作用域过滤后的记忆摘要写入宿主的 `AGENTS.md` 受管块。按宿主分级预算——DSH / Claude Code / Cursor / Copilot 各 2 KB,WorkBuddy 8 KB,OpenClaw 不支持。超预算时按 confidence、updated_at、id 裁剪,并在块内写明未显示条数。
|
|
40
|
+
- **跳过账本**:`onboarding` 跳过的条目变成持久、可查询的事实(`markItemSkipped` / `listSkippedItems`),不再从待办队列里消失得无影无踪。
|
|
41
|
+
- **DSH 宿主适配器**:`cairn agent apply --host dsh` 走 Cordis patch,不写 `mcp.json`。
|
|
42
|
+
- **DSH 实时召回插件**:会话每步前按短查询召回、按预算注入、同会话去重。附会话内面板:按会话切片的注入记录、活动日志(所有经 Cairn 的操作留痕)、三态指示(已注入 / 已过滤 / 未命中),栏宽可拖拽并持久化。
|
|
43
|
+
|
|
44
|
+
### Changed
|
|
45
|
+
|
|
46
|
+
- 需求「记忆调用对用户可见」收紧到 500 字符以内,场景集合与约束强度不变。
|
|
47
|
+
- 投影摘要统一走同一份 `firstLine`(此前注入文本与面板各写一份,导致 frontmatter 记忆显示成 `---`)。
|
|
48
|
+
|
|
49
|
+
### Fixed
|
|
50
|
+
|
|
51
|
+
- 插件导出形状:Cordis 把函数导出当作 `apply` 调用并把 ctx 传成第一个参数,导致连续三轮 `cannot get property ... without inject`。改为模块级 `{ name, inject, apply }`。
|
|
52
|
+
- 工具调用入口:`ctx.tools.call` 不存在。真实入口是 `tools.get(name, scope)` → `definition.execute(args, exec)`。
|
|
53
|
+
- 去重早退覆盖真实状态:`pre-step` 每步都跑召回,去重后早退分支仍写 `lastUsage`,把上一步结果清空,面板因此恒显示「未命中」。
|
|
54
|
+
- 注入判定不再靠文本反推:`renderInjection` 直接返回 `includedIds`,避免截断长度不一致导致的假阴性。
|
|
55
|
+
- 召回被虚词带偏:`deriveQueries` 取词频最高的二字词,中文里几乎总是「是否 / 一个 / 这个」,会命中互不相干的记忆。新增虚词黑名单与相关性计分。
|
|
56
|
+
- 活动记录无独立滚动条:宿主在会话进行中把视图区设为 `min-height: auto`,面板 `overflow: auto` 不触发。
|
|
57
|
+
|
|
58
|
+
### Tests
|
|
59
|
+
|
|
60
|
+
- 根套件 668 项 / 667 通过 / 0 失败 / 1 显式 skip。
|
|
61
|
+
- DSH 插件 79 项全通过。
|
|
62
|
+
- `npm pack` 后安装到临时目录,`cairn doctor` 返回 `ok: true`。
|
|
63
|
+
## [0.1.0] - 2026-10-25
|
|
64
|
+
|
|
65
|
+
首个本地 MVP(OpenSpec 变更 `add-local-first-memory-mvp`)。
|
|
66
|
+
|
|
67
|
+
### Added
|
|
68
|
+
|
|
69
|
+
- 本地 SQLite 权威库:作用域(个人/设备/项目/Agent 私有/受约束自定义)、不可变修订链、证据与关系、冲突队列、可审计 tombstone、版本化迁移(并发安全)、一致性备份恢复、设备身份与克隆防护。
|
|
70
|
+
- 中文检索:FTS5 trigram + 两字中文有界 LIKE 回退;索引损坏自动降级,绝不返回全库。
|
|
71
|
+
- 治理:规范化计划(plan_hash 绑定)、本地一次性审批、幂等应用与续跑、并发冲突保留、秘密与提示注入三层阻断。
|
|
72
|
+
- 首次初始化:元数据发现(零正文读取)、不可变快照导入(imported_unverified + local_only)、分批整理与晋升游标。
|
|
73
|
+
- 接口:CLI(`cairn`)与 MCP stdio(`cairn-mcp`,8 个 memory 工具 + 4 个按需 onboarding 工具);stdout 只含协议消息。
|
|
74
|
+
- 宿主配置:Claude Code / Cursor / Copilot / OpenClaw / WorkBuddy 的 plan→apply→doctor→uninstall,诚实分级 fixture-only/blocked。
|
|
75
|
+
- 后台任务:本地 outbox + `cairn worker run-once`;local_only/设备限定内容在任务生成前物理排除;默认不安装任何 hook。
|
|
76
|
+
|
|
77
|
+
### 边界(未实现,另立变更)
|
|
78
|
+
|
|
79
|
+
- 真实 ECS/OBS 云同步(outbox 仅为本地任务边界,`remote=not_configured`)。
|
|
80
|
+
- macOS/Linux 平台验证(当前仅 Windows x64 + Node 22/24)。
|
|
81
|
+
- 真实宿主 CLI 认证与本地模型抽取。
|
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Carlos (CarlosWonMore)
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,159 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Cairn
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
> 内部代号,未完成商标核查。Cairn(石堆路标)——徒步者沿路堆石给后来者指路;对应「跨设备、跨 Agent 留下可解释、可删除、可迁移的记忆标记」,而不是「又一个会记住你一切的云服务」。
|
|
4
|
+
|
|
5
|
+
**个人、多设备、多 Agent 的本地优先记忆主权层。**
|
|
6
|
+
|
|
7
|
+
**Local-first memory sovereignty for individuals across devices and agents.**
|
|
8
|
+
|
|
9
|
+
Your memory lives in a local SQLite file you own. Every device holds the authoritative copy, so search, add, correct, forget and export all work offline. The cloud is an optional encrypted relay, never a precondition. Models only ever propose candidates — scope, approval, provenance, revision, conflict and deletion are executed by deterministic code.
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## 为什么需要它
|
|
14
|
+
|
|
15
|
+
每个 Agent 都在自己攒记忆:WorkBuddy 有一份、ZCode 有一份、DSH 又有一份。你换一台机器、换一个 Agent,记忆就断了;你无法解释某条记忆从哪来,也无法确认它真的被删掉。
|
|
16
|
+
|
|
17
|
+
Cairn 把记忆从「Agent 的私有财产」变成「你名下的资产」:
|
|
18
|
+
|
|
19
|
+
- **本地权威**:SQLite 是每台设备的权威副本;断网时新增、检索、更正、遗忘、导出全部可用。
|
|
20
|
+
- **云端可选**:仅作加密中继与备份,不参与日常读写,不是使用记忆的前提。
|
|
21
|
+
- **确定性治理**:模型只提出候选;作用域、审批、来源、修订、冲突与删除由代码执行并可审计。
|
|
22
|
+
- **不入侵**:标准记忆走 MCP,管理走 CLI,低能力 Agent 走受管 Markdown 投影;不逆向任何 Agent 的私有数据库。
|
|
23
|
+
- **诚实分级**:每个宿主接入都标注 `fixture-only` / `blocked`,不把「写了配置」当成「验证过」。
|
|
24
|
+
|
|
25
|
+
---
|
|
26
|
+
|
|
27
|
+
## 能力
|
|
28
|
+
|
|
29
|
+
### 记忆存储与检索
|
|
30
|
+
|
|
31
|
+
| 能力 | 说明 |
|
|
32
|
+
|---|---|
|
|
33
|
+
| 作用域 | 个人全局 / 设备限定 / 项目 / Agent 私有 / 受约束自定义 |
|
|
34
|
+
| 不可变修订链 | 每次修改追加修订,历史上任何一版都可查 |
|
|
35
|
+
| 中文检索 | FTS5 trigram + 两字中文有界 LIKE 回退;索引损坏自动降级,绝不返回全库 |
|
|
36
|
+
| 冲突队列 | 并发写入保留冲突而非覆盖,交由人决定 |
|
|
37
|
+
| 可审计删除 | tombstone 而非物理抹除,删除可追溯 |
|
|
38
|
+
| 备份恢复 | 一致性备份、版本化迁移(并发安全)、设备身份与克隆防护 |
|
|
39
|
+
|
|
40
|
+
### 治理
|
|
41
|
+
|
|
42
|
+
- **规范化计划**:`plan_hash` 绑定内容,审批绑定哈希,改一字即失效。
|
|
43
|
+
- **本地一次性审批**:`approval_id` 一次性有效,模型无法自行签发。
|
|
44
|
+
- **秘密与注入三层阻断**:敏感内容、提示注入、越权外泄在写入与检索两侧拦截。
|
|
45
|
+
- **幂等应用**:中断可续跑,并发冲突保留。
|
|
46
|
+
|
|
47
|
+
### 自动整理(首次初始化)
|
|
48
|
+
|
|
49
|
+
`cairn onboarding` 把历史快照整理成可用记忆:元数据发现(零正文读取)→ 不可变快照导入 → 分批判定 → 晋升或跳过。判定只影响「值不值得记」,不能改敏感度、不能扩作用域、不能当审批。
|
|
50
|
+
|
|
51
|
+
### 接口
|
|
52
|
+
|
|
53
|
+
| 入口 | 形态 |
|
|
54
|
+
|---|---|
|
|
55
|
+
| MCP server | stdio,14 个工具(10 记忆 + 4 整理),stdout 只含 JSON-RPC |
|
|
56
|
+
| CLI | 27 个入口:`add` / `search` / `show` / `update` / `forget` / `export` / `import` / `plan` / `approve` / `policy` / `onboarding` / `doctor` / `backup` / `restore` / `sync` / `device` / `worker` / `agent` / `discover` / `archive` / `review` / `vault` / `status` / `init` / `uninstall` / `apply` |
|
|
57
|
+
| 本地控制台 | `cairn ui`:回环 + 一次性令牌,工作台 / 双层建议 / AI 复核 / 静态导出 |
|
|
58
|
+
| 受管投影 | 写入宿主的 `AGENTS.md` 受管块,供不支持 MCP 的 Agent 读取 |
|
|
59
|
+
|
|
60
|
+
### 已接入宿主
|
|
61
|
+
|
|
62
|
+
| 宿主 | 配置写入 | MCP 分级 | 投影 |
|
|
63
|
+
|---|---|---|---|
|
|
64
|
+
| Claude Code | `mcp.json` | fixture-only | brief |
|
|
65
|
+
| Cursor | `mcp.json` | fixture-only | brief |
|
|
66
|
+
| Copilot | `mcp.json` | fixture-only | brief |
|
|
67
|
+
| WorkBuddy | 手工 `mcp.json` | blocked(Cairn 不代写) | brief |
|
|
68
|
+
| DSH | Cordis `cordis.patch.yml` | fixture-only | brief |
|
|
69
|
+
| OpenClaw | 无 | blocked | none |
|
|
70
|
+
|
|
71
|
+
DSH 额外提供**实时召回插件**:会话每步前按短查询召回,按预算注入,并在会话顶部显示三态面板(已注入 / 已过滤 / 未命中)与活动记录。
|
|
72
|
+
|
|
73
|
+
---
|
|
74
|
+
|
|
75
|
+
## 快速开始
|
|
76
|
+
|
|
77
|
+
```bash
|
|
78
|
+
npm install
|
|
79
|
+
npm run build # Node.js 22.5+(已验证 Node 22.22.2 / 24.21.0,Windows x64 与 Linux/Ubuntu 22.04)
|
|
80
|
+
npm run cli -- doctor # 健康检查(无模型、无云端即可用)
|
|
81
|
+
|
|
82
|
+
npm run cli -- add "项目的构建约定是 pnpm"
|
|
83
|
+
npm run cli -- search "构建约定"
|
|
84
|
+
npm run cli -- ui # 本地控制台:回环 + 一次性令牌
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
### MCP 接入
|
|
88
|
+
|
|
89
|
+
```json
|
|
90
|
+
{
|
|
91
|
+
"mcpServers": {
|
|
92
|
+
"cairn": {
|
|
93
|
+
"command": "node",
|
|
94
|
+
"args": ["<path-to>/dist/src/interfaces/mcp/server.js"]
|
|
95
|
+
}
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
DSH 走 Cordis,不用 `mcp.json`:在 `cordis.patch.yml` 里用 `- insert:` 嵌套一条 `@deepseek-ai/dsh-mcp-client` 的 stdio 条目(见 `docs/M0-session-handoff.md` §9)。
|
|
101
|
+
|
|
102
|
+
### 自检与验收
|
|
103
|
+
|
|
104
|
+
```bash
|
|
105
|
+
npm run mcp:smoke # MCP 接入自检:默认只读真实库
|
|
106
|
+
npm run test:e2e # 合成 HOME 端到端:533 条同构 fixture,不碰真实库
|
|
107
|
+
npm run test:ui # 浏览器点击级验收(需一次性 npm i --no-save playwright)
|
|
108
|
+
npm run test:real # 真实 OBS 云同步往返(需五个 OBS_* 变量齐全,缺任一即 exit 2)
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
**Windows 提醒:不要直接运行或双击 `.ts` / `.js` 文件**(会弹出「选择打开方式」)。始终使用 `npm run cli --`、`cairn.cmd` 或 `npm link` 后的全局 `cairn`。
|
|
112
|
+
|
|
113
|
+
---
|
|
114
|
+
|
|
115
|
+
## 状态
|
|
116
|
+
|
|
117
|
+
仓库当前**没有活动变更**。九个 OpenSpec 能力规格全部通过严格校验(9/9)。
|
|
118
|
+
|
|
119
|
+
| 能力 | 说明 |
|
|
120
|
+
|---|---|
|
|
121
|
+
| `memory-store` | 存储、修订链、迁移、备份 |
|
|
122
|
+
| `scoped-retrieval` | 作用域与检索 |
|
|
123
|
+
| `memory-governance` | 计划、审批、幂等应用 |
|
|
124
|
+
| `memory-review` | 冲突与复核 |
|
|
125
|
+
| `agent-interfaces` | 宿主接入、投影、会话内面板 |
|
|
126
|
+
| `agent-onboarding` | 首次初始化 |
|
|
127
|
+
| `auto-onboarding` | 策略预授权的自动整理 |
|
|
128
|
+
| `cloud-sync` | OBS/ECS 加密同步 |
|
|
129
|
+
| `local-console` | 本地控制台 |
|
|
130
|
+
|
|
131
|
+
测试基线:`npm test` **不联网**,恒 668 项 / 667 通过 / 0 失败 / 1 显式 skip。真实云端往返单独用 `npm run test:real`。
|
|
132
|
+
|
|
133
|
+
### 已知边界
|
|
134
|
+
|
|
135
|
+
- 仅验证 Windows x64 与 Linux/Ubuntu 22.04;macOS 未验证。
|
|
136
|
+
- Claude Code / Cursor / Copilot 的宿主接入为 `fixture-only`,未在真实 CLI 认证下跑过。
|
|
137
|
+
- 云端需要自备 OBS + ECS;默认不安装任何同步 hook。
|
|
138
|
+
- 无本地模型依赖;不做抽取推理。
|
|
139
|
+
|
|
140
|
+
---
|
|
141
|
+
|
|
142
|
+
## 文档
|
|
143
|
+
|
|
144
|
+
| 文档 | 内容 |
|
|
145
|
+
|---|---|
|
|
146
|
+
| `docs/cairn-usage.md` | 十分钟上手 / 三层独立授权初始化 / MCP 接入 / 宿主配置 |
|
|
147
|
+
| `docs/cairn-security.md` | 信任模型 / 秘密与注入防线 / 备份恢复 / 卸载 / 故障排查 |
|
|
148
|
+
| `docs/cairn-sync.md` | OBS/ECS 双后端 / E2EE / 双设备验证 |
|
|
149
|
+
| `docs/cairn-console.md` | `cairn ui` 预览页与工作台 / 双层建议 / 导出明文风险 |
|
|
150
|
+
| `docs/cairn-auto-onboarding.md` | 策略字段 / 条件顺序 / 撤销路径 / `judgement` 权力边界 |
|
|
151
|
+
| `openspec/` | 流程事实源:proposal / specs / design / tasks 及验证记录 |
|
|
152
|
+
|
|
153
|
+
模块划分:`core / store / retrieval / governance / onboarding / interfaces / projection / agents / jobs`。CLI 与 MCP 共用同一应用服务,不各自实现记忆规则。
|
|
154
|
+
|
|
155
|
+
---
|
|
156
|
+
|
|
157
|
+
## 许可证
|
|
158
|
+
|
|
159
|
+
MIT。见 [LICENSE](./LICENSE)。
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 宿主适配器元数据(tasks 8.1)。
|
|
3
|
+
*
|
|
4
|
+
* 全部路径与能力边界来自 M0 能力矩阵
|
|
5
|
+
* artifacts/m0/delegated/work/agent-adapters/out/adapter-matrix.json
|
|
6
|
+
* (仅依据官方公开文档,未公开路径一律 blocked,不做逆向猜测)。
|
|
7
|
+
*
|
|
8
|
+
* 能力分级(诚实原则):
|
|
9
|
+
* - 本实现未对任何真实宿主 CLI 复跑验证,因此一律不标 real-cli-tested;
|
|
10
|
+
* - 'fixture-only':契约只对官方形态的 fixture 文件验证过;
|
|
11
|
+
* - 'blocked':无公开文档路径或需要用户手动 UI 步骤,原型拒绝写入推测路径。
|
|
12
|
+
*/
|
|
13
|
+
export type AgentKind = 'claude-code' | 'cursor' | 'copilot' | 'openclaw' | 'workbuddy' | 'dsh';
|
|
14
|
+
/**
|
|
15
|
+
* MCP 配置的**形态**,而不是路径。
|
|
16
|
+
*
|
|
17
|
+
* - 'json':宿主把 MCP 服务器放在一个 JSON 文件的 named entry 里(mcpServers / servers);
|
|
18
|
+
* - 'cordis-patch':宿主用插件树的 YAML 补丁行登记插件,MCP 服务器是一条 insert 行;
|
|
19
|
+
* - 'none':无公开配置路径。
|
|
20
|
+
*
|
|
21
|
+
* DSH(DeepSeek Harness)是唯一已知的 'cordis-patch' 宿主:它**不读 mcp.json**,
|
|
22
|
+
* 接入点是 <dshHome>/profiles/<profile>/cordis.patch.yml 的 `- insert:` 行。
|
|
23
|
+
*/
|
|
24
|
+
export type McpConfigKind = 'json' | 'cordis-patch' | 'none';
|
|
25
|
+
export type CapabilityLevel = 'fixture-only' | 'blocked';
|
|
26
|
+
/**
|
|
27
|
+
* 宿主能吃什么样的投影内容。
|
|
28
|
+
*
|
|
29
|
+
* - 'brief':可承载记忆摘要正文(DSH / Claude Code / Cursor / Copilot / WorkBuddy)
|
|
30
|
+
* - 'index':约定是索引文件,只放指针,**不得放正文**(ZCode 内置文档明写
|
|
31
|
+
* "never put memory content there")
|
|
32
|
+
* - 'none':无公开落点,不投影
|
|
33
|
+
*/
|
|
34
|
+
export type ProjectionMode = 'brief' | 'index' | 'none';
|
|
35
|
+
/** MCP 配置里服务器映射的顶层键名(copilot 的 VS Code 路径为 "servers",矩阵明确与 CLI 不同)。 */
|
|
36
|
+
export type McpServerMapKey = 'mcpServers' | 'servers';
|
|
37
|
+
export interface HostAdapter {
|
|
38
|
+
kind: AgentKind;
|
|
39
|
+
label: string;
|
|
40
|
+
/** MCP 配置文件路径;null = 官方未公开路径,拒绝写入。 */
|
|
41
|
+
mcpConfigPath(homeRoot: string, projectRoot: string | null): string | null;
|
|
42
|
+
/** MCP 配置形态;决定 plan/apply/doctor/uninstall 走 JSON 合并还是插件树块编辑。 */
|
|
43
|
+
mcpConfigKind: McpConfigKind;
|
|
44
|
+
mcpConfigCapability: CapabilityLevel;
|
|
45
|
+
/** 受管区块目标文件;null = 无公开块文件,只提供可复制文案。 */
|
|
46
|
+
blockTargetPath(homeRoot: string, projectRoot: string | null): string | null;
|
|
47
|
+
blockCapability: CapabilityLevel;
|
|
48
|
+
/** 投影形态:决定写摘要正文、只写索引行,还是完全不写。 */
|
|
49
|
+
projectionMode: ProjectionMode;
|
|
50
|
+
/** 投影字节预算;'none' 时为 0。超预算按确定性规则裁剪并明示。 */
|
|
51
|
+
projectionBudgetBytes: number;
|
|
52
|
+
/** mcp-primary 的原生记忆关闭方式:documented-manual = 有文档化手动步骤;none = 无公开关闭接口。 */
|
|
53
|
+
nativeDisable: 'documented-manual' | 'none';
|
|
54
|
+
/**
|
|
55
|
+
* MCP 服务器映射顶层键。claude-code/cursor/openclaw 生态为 mcpServers;
|
|
56
|
+
* copilot 的 VS Code 工作区文件 .vscode/mcp.json 顶层键为 "servers"(M0 矩阵明确)。
|
|
57
|
+
*/
|
|
58
|
+
mcpServerMapKey(homeRoot: string, projectRoot: string | null): McpServerMapKey;
|
|
59
|
+
notes: string[];
|
|
60
|
+
}
|
|
61
|
+
/**
|
|
62
|
+
* DSH profile 名(决定 patch 文件所在目录)。
|
|
63
|
+
* 默认 'desktop':DSH 桌面端把配置树放在 <dshHome>/profiles/desktop/。
|
|
64
|
+
*/
|
|
65
|
+
export declare const DEFAULT_DSH_PROFILE = "desktop";
|
|
66
|
+
/** 覆盖 DSH profile 名(CLI --dsh-profile 用);传 null 复位。 */
|
|
67
|
+
export declare function setDshProfile(profile: string | null): void;
|
|
68
|
+
export declare function dshProfileFor(_homeRoot: string): string;
|
|
69
|
+
/** <dshHome>/profiles/<profile> */
|
|
70
|
+
export declare function resolveDshProfileRoot(dshHome: string): string;
|
|
71
|
+
/**
|
|
72
|
+
* 解析 DSH 数据根。
|
|
73
|
+
*
|
|
74
|
+
* 顺序:显式传入 → DSH_HOME 环境变量 → E_VALIDATION。
|
|
75
|
+
* **不回退 ~/.dsh**:该目录在部分机器上是旧安装留下的空壳,猜它比报错更危险(design D4)。
|
|
76
|
+
*/
|
|
77
|
+
export declare function resolveDshHome(explicit: string | null | undefined): string;
|
|
78
|
+
export declare const AGENT_KINDS: readonly AgentKind[];
|
|
79
|
+
export declare function isAgentKind(value: unknown): value is AgentKind;
|
|
80
|
+
export declare const HOST_ADAPTERS: Record<AgentKind, HostAdapter>;
|
|
81
|
+
/** 按字符串取适配器;未知宿主一律 E_VALIDATION,绝不猜路径。 */
|
|
82
|
+
export declare function getAdapter(kind: string): HostAdapter;
|
|
@@ -0,0 +1,209 @@
|
|
|
1
|
+
import { join } from 'node:path';
|
|
2
|
+
import { err } from '../core/errors.js';
|
|
3
|
+
/**
|
|
4
|
+
* DSH profile 名(决定 patch 文件所在目录)。
|
|
5
|
+
* 默认 'desktop':DSH 桌面端把配置树放在 <dshHome>/profiles/desktop/。
|
|
6
|
+
*/
|
|
7
|
+
export const DEFAULT_DSH_PROFILE = 'desktop';
|
|
8
|
+
let dshProfileOverride = null;
|
|
9
|
+
/** 覆盖 DSH profile 名(CLI --dsh-profile 用);传 null 复位。 */
|
|
10
|
+
export function setDshProfile(profile) {
|
|
11
|
+
if (profile !== null && !/^[A-Za-z0-9._-]+$/.test(profile)) {
|
|
12
|
+
throw err('E_VALIDATION', `非法的 DSH profile 名: ${JSON.stringify(profile)}`);
|
|
13
|
+
}
|
|
14
|
+
dshProfileOverride = profile;
|
|
15
|
+
}
|
|
16
|
+
export function dshProfileFor(_homeRoot) {
|
|
17
|
+
return dshProfileOverride ?? DEFAULT_DSH_PROFILE;
|
|
18
|
+
}
|
|
19
|
+
/** <dshHome>/profiles/<profile> */
|
|
20
|
+
export function resolveDshProfileRoot(dshHome) {
|
|
21
|
+
return join(dshHome, 'profiles', dshProfileFor(dshHome));
|
|
22
|
+
}
|
|
23
|
+
/**
|
|
24
|
+
* 解析 DSH 数据根。
|
|
25
|
+
*
|
|
26
|
+
* 顺序:显式传入 → DSH_HOME 环境变量 → E_VALIDATION。
|
|
27
|
+
* **不回退 ~/.dsh**:该目录在部分机器上是旧安装留下的空壳,猜它比报错更危险(design D4)。
|
|
28
|
+
*/
|
|
29
|
+
export function resolveDshHome(explicit) {
|
|
30
|
+
if (typeof explicit === 'string' && explicit.length > 0)
|
|
31
|
+
return explicit;
|
|
32
|
+
const fromEnv = process.env['DSH_HOME'];
|
|
33
|
+
if (typeof fromEnv === 'string' && fromEnv.length > 0)
|
|
34
|
+
return fromEnv;
|
|
35
|
+
throw err('E_VALIDATION', 'DSH 数据根未指定:请用 --home-root <dir> 显式给出,或设置 DSH_HOME 环境变量(不猜测 ~/.dsh)');
|
|
36
|
+
}
|
|
37
|
+
export const AGENT_KINDS = ['claude-code', 'cursor', 'copilot', 'openclaw', 'workbuddy', 'dsh'];
|
|
38
|
+
export function isAgentKind(value) {
|
|
39
|
+
return typeof value === 'string' && AGENT_KINDS.includes(value);
|
|
40
|
+
}
|
|
41
|
+
export const HOST_ADAPTERS = {
|
|
42
|
+
'claude-code': {
|
|
43
|
+
kind: 'claude-code',
|
|
44
|
+
label: 'Claude Code',
|
|
45
|
+
mcpConfigPath: (homeRoot, projectRoot) => {
|
|
46
|
+
// 矩阵:仅 project 作用域(项目根 .mcp.json);local/user 聚合在 ~/.claude.json,
|
|
47
|
+
// 原型不写聚合状态文件(blocked),请用官方 CLI 指定作用域。
|
|
48
|
+
void homeRoot;
|
|
49
|
+
return projectRoot ? join(projectRoot, '.mcp.json') : null;
|
|
50
|
+
},
|
|
51
|
+
mcpConfigCapability: 'fixture-only',
|
|
52
|
+
mcpConfigKind: 'json',
|
|
53
|
+
blockTargetPath: (homeRoot, projectRoot) =>
|
|
54
|
+
// 矩阵 rules_memory:CLAUDE.md(项目)与 .claude/CLAUDE.md(用户)均为公开文件。
|
|
55
|
+
projectRoot ? join(projectRoot, 'CLAUDE.md') : join(homeRoot, '.claude', 'CLAUDE.md'),
|
|
56
|
+
blockCapability: 'fixture-only',
|
|
57
|
+
projectionMode: 'brief',
|
|
58
|
+
projectionBudgetBytes: 2048,
|
|
59
|
+
nativeDisable: 'documented-manual',
|
|
60
|
+
mcpServerMapKey: () => 'mcpServers',
|
|
61
|
+
notes: [
|
|
62
|
+
'MCP 仅支持 project 作用域(项目根 .mcp.json);local/user 作用域聚合在 ~/.claude.json,本原型不写该文件,请用官方 CLI。',
|
|
63
|
+
'只写 CLAUDE.md 受管区块;不接管 auto memory 目录(~/.claude/projects/<project>/memory/),也不把自动记忆回读成指令。',
|
|
64
|
+
'mcp-primary 模式:官方只提供 /memory 开关或 CLAUDE_CODE_DISABLE_AUTO_MEMORY 环境变量,需用户手动完成,本原型不写 settings.json。',
|
|
65
|
+
],
|
|
66
|
+
},
|
|
67
|
+
cursor: {
|
|
68
|
+
kind: 'cursor',
|
|
69
|
+
label: 'Cursor',
|
|
70
|
+
mcpConfigPath: (homeRoot, projectRoot) =>
|
|
71
|
+
// 矩阵:.cursor/mcp.json(project)或 ~/.cursor/mcp.json(global),两者均为公开路径。
|
|
72
|
+
projectRoot ? join(projectRoot, '.cursor', 'mcp.json') : join(homeRoot, '.cursor', 'mcp.json'),
|
|
73
|
+
mcpConfigCapability: 'fixture-only',
|
|
74
|
+
mcpConfigKind: 'json',
|
|
75
|
+
blockTargetPath: (homeRoot, projectRoot) => {
|
|
76
|
+
// 矩阵 rules_memory:项目级 AGENTS.md 为公开规则文件;全局规则只有 User Rules (UI),
|
|
77
|
+
// 无文件路径,故 projectRoot 为 null 时不提供块目标。
|
|
78
|
+
void homeRoot;
|
|
79
|
+
return projectRoot ? join(projectRoot, 'AGENTS.md') : null;
|
|
80
|
+
},
|
|
81
|
+
blockCapability: 'fixture-only',
|
|
82
|
+
projectionMode: 'brief',
|
|
83
|
+
projectionBudgetBytes: 2048,
|
|
84
|
+
nativeDisable: 'none',
|
|
85
|
+
mcpServerMapKey: () => 'mcpServers',
|
|
86
|
+
notes: [
|
|
87
|
+
'官方 Rules 文档明确模型补全之间不保留记忆:无原生自动记忆,无需也无法关闭。',
|
|
88
|
+
'默认写项目根 AGENTS.md 受管区块;.cursor/rules/*.mdc 需要 frontmatter,本原型不覆盖既有 .mdc 文件。',
|
|
89
|
+
'全局规则只有 User Rules (UI) / Team Rules (dashboard),无公开文件路径。',
|
|
90
|
+
],
|
|
91
|
+
},
|
|
92
|
+
copilot: {
|
|
93
|
+
kind: 'copilot',
|
|
94
|
+
label: 'GitHub Copilot',
|
|
95
|
+
mcpConfigPath: (homeRoot, projectRoot) =>
|
|
96
|
+
// 矩阵:VS Code 工作区 .vscode/mcp.json(project);CLI 用户级 ~/.copilot/mcp-config.json(user)。
|
|
97
|
+
projectRoot ? join(projectRoot, '.vscode', 'mcp.json') : join(homeRoot, '.copilot', 'mcp-config.json'),
|
|
98
|
+
mcpConfigCapability: 'fixture-only',
|
|
99
|
+
mcpConfigKind: 'json',
|
|
100
|
+
blockTargetPath: (homeRoot, projectRoot) => {
|
|
101
|
+
// 矩阵 rules_memory:.github/copilot-instructions.md 为仓库级公开文件;无 home 级块文件。
|
|
102
|
+
void homeRoot;
|
|
103
|
+
return projectRoot ? join(projectRoot, '.github', 'copilot-instructions.md') : null;
|
|
104
|
+
},
|
|
105
|
+
blockCapability: 'fixture-only',
|
|
106
|
+
projectionMode: 'brief',
|
|
107
|
+
projectionBudgetBytes: 2048,
|
|
108
|
+
nativeDisable: 'documented-manual',
|
|
109
|
+
mcpServerMapKey: (_homeRoot, projectRoot) => (projectRoot ? 'servers' : 'mcpServers'),
|
|
110
|
+
notes: [
|
|
111
|
+
'VS Code 工作区配置 .vscode/mcp.json 顶层键为 "servers",与 CLI 的 mcpServers 不同(矩阵明确);合并时保留未知顶层字段。',
|
|
112
|
+
'M0 曾对 CLI 用户级路径做过 real-cli-tested(Copilot CLI 1.0.86、synthetic HOME);本实现未复跑真实 CLI,能力按 fixture-only 如实标注。',
|
|
113
|
+
'Copilot Memory 为服务端账号级能力(public preview),个人仅可查看/删除,无公开写入或批量导出 API,本原型不访问云端。',
|
|
114
|
+
'mcp-primary 模式:原生 Memory 只能由用户在 GitHub 设置中手动关闭。',
|
|
115
|
+
'注意:GitHub Copilot 自带服务端 Copilot Memory(Repository-level facts + User-level preferences)。本产品写入 .github/copilot-instructions.md 的投影与它并存,两者可能给出不同说法,doctor 会提示这一点。',
|
|
116
|
+
],
|
|
117
|
+
},
|
|
118
|
+
openclaw: {
|
|
119
|
+
kind: 'openclaw',
|
|
120
|
+
label: 'OpenClaw',
|
|
121
|
+
mcpConfigPath: () => {
|
|
122
|
+
// 矩阵:官方说明 mcp.servers 存于 OpenClaw config,但未给出配置文件路径;CLI 不在本机。
|
|
123
|
+
// 拒绝写入推测路径(blocked)。
|
|
124
|
+
return null;
|
|
125
|
+
},
|
|
126
|
+
mcpConfigCapability: 'blocked',
|
|
127
|
+
mcpConfigKind: 'none',
|
|
128
|
+
blockTargetPath: (homeRoot) =>
|
|
129
|
+
// 矩阵:~/.openclaw/workspace/AGENTS.md 为官方默认工作区模板,公开路径;openclaw 无项目作用域。
|
|
130
|
+
join(homeRoot, '.openclaw', 'workspace', 'AGENTS.md'),
|
|
131
|
+
blockCapability: 'fixture-only',
|
|
132
|
+
projectionMode: 'none',
|
|
133
|
+
projectionBudgetBytes: 0,
|
|
134
|
+
nativeDisable: 'none',
|
|
135
|
+
mcpServerMapKey: () => 'mcpServers',
|
|
136
|
+
notes: [
|
|
137
|
+
'MCP 配置文件路径官方未公开(openclaw mcp add CLI 不在本机):本原型拒绝写入推测路径,MCP 条目需用户手动添加。',
|
|
138
|
+
'只在 ~/.openclaw/workspace/AGENTS.md 写受管区块;USER.md / MEMORY.md / memory/YYYY-MM-DD.md / DREAMS.md 不整文件改写。',
|
|
139
|
+
'原生记忆(dreaming 等)开关存在但配置路径未公开:不能宣称已接管或关闭原生记忆,只能给出手动步骤。',
|
|
140
|
+
'原生记忆导入官方走 Control UI(复制到 memory/imports/ 且源文件不变);本原型只做有界发现与显式快照。',
|
|
141
|
+
],
|
|
142
|
+
},
|
|
143
|
+
workbuddy: {
|
|
144
|
+
kind: 'workbuddy',
|
|
145
|
+
label: 'WorkBuddy',
|
|
146
|
+
mcpConfigPath: () => {
|
|
147
|
+
// 矩阵:官方仅描述"自定义连接器"UI 安装 MCP,未公开本地 mcp.json 路径(blocked)。
|
|
148
|
+
return null;
|
|
149
|
+
},
|
|
150
|
+
mcpConfigCapability: 'blocked',
|
|
151
|
+
mcpConfigKind: 'none',
|
|
152
|
+
blockTargetPath: (homeRoot, projectRoot) => {
|
|
153
|
+
// 2026-11-01 核对应用代码:MemoryCollector.getWorkingMemoryContent() 读取
|
|
154
|
+
// <cwd>/.workbuddy/memory/MEMORY.md,包成 <working_memory_content> 注入,上限 10000 字符(Hs=1e4)。
|
|
155
|
+
// 这是项目级落点;用户级 ~/.workbuddy/MEMORY.md 另有 4000 字符上限(本次不处理)。
|
|
156
|
+
const root = projectRoot ?? homeRoot;
|
|
157
|
+
return join(root, '.workbuddy', 'memory', 'MEMORY.md');
|
|
158
|
+
},
|
|
159
|
+
blockCapability: 'fixture-only',
|
|
160
|
+
projectionMode: 'brief',
|
|
161
|
+
projectionBudgetBytes: 8192,
|
|
162
|
+
nativeDisable: 'none',
|
|
163
|
+
mcpServerMapKey: () => 'mcpServers',
|
|
164
|
+
notes: [
|
|
165
|
+
'MCP 配置文件路径未公开:拒绝写入 ~/.workbuddy/mcp.json 等未记录路径,只能由用户在连接器 UI 中信任并启用。',
|
|
166
|
+
'记忆落点:<cwd>/.workbuddy/memory/MEMORY.md(项目级,注入标签 <working_memory_content>,上限 10000 字符)。证据来自应用代码 MemoryCollector,非官方文档;真实注入生效未独立验证,故为 fixture-only。',
|
|
167
|
+
'注入受 localMemoryEnabled / generateMemoryEnabled 开关控制,被用户关闭时文件写了也不会进上下文——doctor 无法代查该开关状态。',
|
|
168
|
+
'原生记忆为账号级服务端能力,无公开文件或写入 API:不能宣称已接管或关闭原生记忆,只能由用户在设置中手动关闭。',
|
|
169
|
+
'本原型不爬取云端与缓存;记忆导入仅走官方粘贴通道。',
|
|
170
|
+
],
|
|
171
|
+
},
|
|
172
|
+
dsh: {
|
|
173
|
+
kind: 'dsh',
|
|
174
|
+
label: 'DeepSeek Harness (DSH)',
|
|
175
|
+
mcpConfigPath: (dshHome) => {
|
|
176
|
+
// DSH 不读 mcp.json:MCP 服务器是 Cordis 插件树里的一条 `- insert:` 补丁行。
|
|
177
|
+
// 目标固定为 <dshHome>/profiles/<profile>/cordis.patch.yml(profile 见 dshProfileFor)。
|
|
178
|
+
return join(resolveDshProfileRoot(dshHome), 'cordis.patch.yml');
|
|
179
|
+
},
|
|
180
|
+
mcpConfigCapability: 'fixture-only',
|
|
181
|
+
mcpConfigKind: 'cordis-patch',
|
|
182
|
+
blockTargetPath: (dshHome) => {
|
|
183
|
+
// DSH 的 @deepseek-ai/dsh-agent-instructions 在**每个会话首个请求**加载 user-global 层:
|
|
184
|
+
// $DSH_HOME/AGENTS.md,然后才是项目级 AGENTS.md(叠加,后者更具体优先)。
|
|
185
|
+
// 要覆盖"所有工作区",落点必须是这个用户级文件,而不是逐项目的 AGENTS.md。
|
|
186
|
+
return join(dshHome, 'AGENTS.md');
|
|
187
|
+
},
|
|
188
|
+
blockCapability: 'fixture-only',
|
|
189
|
+
projectionMode: 'brief',
|
|
190
|
+
projectionBudgetBytes: 2048,
|
|
191
|
+
nativeDisable: 'none',
|
|
192
|
+
mcpServerMapKey: () => 'mcpServers',
|
|
193
|
+
notes: [
|
|
194
|
+
'DSH 不使用 mcp.json:MCP 接入点是 Cordis 插件树的 <dshHome>/profiles/<profile>/cordis.patch.yml,条目必须写成 "insert:" 块。不带 insert 的裸 id 行是"覆盖既有条目",找不到目标会被静默丢弃(日志只有一行 patch: entry not found)。',
|
|
195
|
+
'规则入口是用户级 <dshHome>/AGENTS.md(对所有工作区生效);项目级 AGENTS.md 追加在其后,两者叠加而非替代。',
|
|
196
|
+
'证据边界:fixture 抄自一份真实 DSH 安装(2026-11-01,profile=desktop)的文件形态;真实加载验证仅在该单机单版本上进行,不表述为兼容所有 DSH 版本,故分级为 fixture-only。',
|
|
197
|
+
'DSH 无公开的原生记忆关闭接口:mcp-primary 只能给手动步骤,不能宣称已接管。',
|
|
198
|
+
'数据根与用户主目录是两个概念:本适配器只认显式 homeRoot 或 DSH_HOME 环境变量,不猜测 ~/.dsh。',
|
|
199
|
+
],
|
|
200
|
+
},
|
|
201
|
+
};
|
|
202
|
+
/** 按字符串取适配器;未知宿主一律 E_VALIDATION,绝不猜路径。 */
|
|
203
|
+
export function getAdapter(kind) {
|
|
204
|
+
if (!isAgentKind(kind)) {
|
|
205
|
+
throw err('E_VALIDATION', `未知宿主类型: ${JSON.stringify(kind)}(支持:${AGENT_KINDS.join(', ')})`);
|
|
206
|
+
}
|
|
207
|
+
return HOST_ADAPTERS[kind];
|
|
208
|
+
}
|
|
209
|
+
//# sourceMappingURL=adapters.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"adapters.js","sourceRoot":"","sources":["../../../src/agents/adapters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAqExC;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,SAAS,CAAC;AAE7C,IAAI,kBAAkB,GAAkB,IAAI,CAAC;AAE7C,uDAAuD;AACvD,MAAM,UAAU,aAAa,CAAC,OAAsB;IAClD,IAAI,OAAO,KAAK,IAAI,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3D,MAAM,GAAG,CAAC,cAAc,EAAE,sBAAsB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,kBAAkB,GAAG,OAAO,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,SAAiB;IAC7C,OAAO,kBAAkB,IAAI,mBAAmB,CAAC;AACnD,CAAC;AAED,mCAAmC;AACnC,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACnD,OAAO,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,QAAmC;IAChE,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAC;IACzE,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACxC,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,OAAO,CAAC;IACtE,MAAM,GAAG,CACP,cAAc,EACd,oEAAoE,CACrE,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAyB,CAAC,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;AAEtH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,WAAiC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACzF,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAmC;IAC3D,aAAa,EAAE;QACb,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,aAAa;QACpB,aAAa,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE;YACvC,iEAAiE;YACjE,sCAAsC;YACtC,KAAK,QAAQ,CAAC;YACd,OAAO,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7D,CAAC;QACD,mBAAmB,EAAE,cAAc;QACnC,aAAa,EAAE,MAAM;QACrB,eAAe,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE;QACzC,8DAA8D;QAC9D,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,WAAW,CAAC;QACvF,eAAe,EAAE,cAAc;QAC/B,cAAc,EAAE,OAAO;QACvB,qBAAqB,EAAE,IAAI;QAC3B,aAAa,EAAE,mBAAmB;QAClC,eAAe,EAAE,GAAG,EAAE,CAAC,YAAY;QACnC,KAAK,EAAE;YACL,wFAAwF;YACxF,0FAA0F;YAC1F,oGAAoG;SACrG;KACF;IACD,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,QAAQ;QACf,aAAa,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE;QACvC,qEAAqE;QACrE,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAC;QAChG,mBAAmB,EAAE,cAAc;QACnC,aAAa,EAAE,MAAM;QACrB,eAAe,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE;YACzC,gEAAgE;YAChE,sCAAsC;YACtC,KAAK,QAAQ,CAAC;YACd,OAAO,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7D,CAAC;QACD,eAAe,EAAE,cAAc;QAC/B,cAAc,EAAE,OAAO;QACvB,qBAAqB,EAAE,IAAI;QAC3B,aAAa,EAAE,MAAM;QACrB,eAAe,EAAE,GAAG,EAAE,CAAC,YAAY;QACnC,KAAK,EAAE;YACL,2CAA2C;YAC3C,4EAA4E;YAC5E,0DAA0D;SAC3D;KACF;IACD,OAAO,EAAE;QACP,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,gBAAgB;QACvB,aAAa,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE;QACvC,qFAAqF;QACrF,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,iBAAiB,CAAC;QACxG,mBAAmB,EAAE,cAAc;QACnC,aAAa,EAAE,MAAM;QACrB,eAAe,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE;YACzC,wEAAwE;YACxE,KAAK,QAAQ,CAAC;YACd,OAAO,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,yBAAyB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACtF,CAAC;QACD,eAAe,EAAE,cAAc;QAC/B,cAAc,EAAE,OAAO;QACvB,qBAAqB,EAAE,IAAI;QAC3B,aAAa,EAAE,mBAAmB;QAClC,eAAe,EAAE,CAAC,SAAS,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC;QACrF,KAAK,EAAE;YACL,wFAAwF;YACxF,0GAA0G;YAC1G,6EAA6E;YAC7E,iDAAiD;YACjD,iKAAiK;SAClK;KACF;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,UAAU;QACjB,aAAa,EAAE,GAAG,EAAE;YAClB,8DAA8D;YAC9D,qBAAqB;YACrB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,mBAAmB,EAAE,SAAS;QAC9B,aAAa,EAAE,MAAM;QACrB,eAAe,EAAE,CAAC,QAAQ,EAAE,EAAE;QAC5B,sEAAsE;QACtE,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,CAAC;QACvD,eAAe,EAAE,cAAc;QAC/B,cAAc,EAAE,MAAM;QACtB,qBAAqB,EAAE,CAAC;QACxB,aAAa,EAAE,MAAM;QACrB,eAAe,EAAE,GAAG,EAAE,CAAC,YAAY;QACnC,KAAK,EAAE;YACL,uEAAuE;YACvE,yGAAyG;YACzG,uDAAuD;YACvD,kEAAkE;SACnE;KACF;IACD,SAAS,EAAE;QACT,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,WAAW;QAClB,aAAa,EAAE,GAAG,EAAE;YAClB,wDAAwD;YACxD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,mBAAmB,EAAE,SAAS;QAC9B,aAAa,EAAE,MAAM;QACrB,eAAe,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE;YACzC,iEAAiE;YACjE,wFAAwF;YACxF,0DAA0D;YAC1D,MAAM,IAAI,GAAG,WAAW,IAAI,QAAQ,CAAC;YACrC,OAAO,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;QACzD,CAAC;QACD,eAAe,EAAE,cAAc;QAC/B,cAAc,EAAE,OAAO;QACvB,qBAAqB,EAAE,IAAI;QAC3B,aAAa,EAAE,MAAM;QACrB,eAAe,EAAE,GAAG,EAAE,CAAC,YAAY;QACnC,KAAK,EAAE;YACL,sEAAsE;YACtE,mJAAmJ;YACnJ,0FAA0F;YAC1F,0DAA0D;YAC1D,2BAA2B;SAC5B;KACF;IACD,GAAG,EAAE;QACH,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,wBAAwB;QAC/B,aAAa,EAAE,CAAC,OAAO,EAAE,EAAE;YACzB,2DAA2D;YAC3D,gFAAgF;YAChF,OAAO,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,EAAE,kBAAkB,CAAC,CAAC;QAClE,CAAC;QACD,mBAAmB,EAAE,cAAc;QACnC,aAAa,EAAE,cAAc;QAC7B,eAAe,EAAE,CAAC,OAAO,EAAE,EAAE;YAC3B,2EAA2E;YAC3E,qDAAqD;YACrD,6CAA6C;YAC7C,OAAO,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QACpC,CAAC;QACD,eAAe,EAAE,cAAc;QAC/B,cAAc,EAAE,OAAO;QACvB,qBAAqB,EAAE,IAAI;QAC3B,aAAa,EAAE,MAAM;QACrB,eAAe,EAAE,GAAG,EAAE,CAAC,YAAY;QACnC,KAAK,EAAE;YACL,+KAA+K;YAC/K,sEAAsE;YACtE,kHAAkH;YAClH,+CAA+C;YAC/C,8DAA8D;SAC/D;KACF;CACF,CAAC;AAEF,0CAA0C;AAC1C,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;QACvB,MAAM,GAAG,CAAC,cAAc,EAAE,WAAW,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7F,CAAC;IACD,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC"}
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
import type { CairnStore } from '../store/open.js';
|
|
2
|
+
import type { AgentKind, CapabilityLevel } from './adapters.js';
|
|
3
|
+
export type ConfigMode = 'observe' | 'router' | 'mcp-primary';
|
|
4
|
+
export interface ConfigPlanAction {
|
|
5
|
+
type: 'write_mcp_config' | 'write_managed_block' | 'manual_step';
|
|
6
|
+
path: string | null;
|
|
7
|
+
before: string | null;
|
|
8
|
+
after: string | null;
|
|
9
|
+
/** plan 时目标整文件 sha256;null = 文件不存在。 */
|
|
10
|
+
beforeHash: string | null;
|
|
11
|
+
}
|
|
12
|
+
export interface AgentConfigPlan {
|
|
13
|
+
agentKind: AgentKind;
|
|
14
|
+
homeRoot: string;
|
|
15
|
+
projectRoot: string | null;
|
|
16
|
+
mode: ConfigMode;
|
|
17
|
+
actions: ConfigPlanAction[];
|
|
18
|
+
conflicts: {
|
|
19
|
+
path: string;
|
|
20
|
+
reason: string;
|
|
21
|
+
}[];
|
|
22
|
+
capability: CapabilityLevel;
|
|
23
|
+
notes: string[];
|
|
24
|
+
}
|
|
25
|
+
/** router 受管区块正文(跨设备记忆路由约定,5 行)。 */
|
|
26
|
+
export declare const ROUTER_BLOCK_CONTENT: string;
|
|
27
|
+
/** 计划哈希:规范化 JSON 的 sha256(字段顺序与空白不敏感)。 */
|
|
28
|
+
export declare function planHash(p: AgentConfigPlan): string;
|
|
29
|
+
/** planHash 别名:apply 用签名校验计划未被篡改/过期。 */
|
|
30
|
+
export declare function planSignature(p: AgentConfigPlan): string;
|
|
31
|
+
/**
|
|
32
|
+
* 生成配置计划(零写入):observe 只出说明;router 出受管区块(与可选 MCP 条目);
|
|
33
|
+
* mcp-primary 额外出原生记忆手动关闭步骤。
|
|
34
|
+
*/
|
|
35
|
+
export declare function planAgentConfig(store: CairnStore, input: {
|
|
36
|
+
agentKind: AgentKind;
|
|
37
|
+
homeRoot: string;
|
|
38
|
+
projectRoot?: string | null;
|
|
39
|
+
mode: ConfigMode;
|
|
40
|
+
mcpCommand?: {
|
|
41
|
+
command: string;
|
|
42
|
+
args: string[];
|
|
43
|
+
};
|
|
44
|
+
}): Promise<AgentConfigPlan>;
|
|
45
|
+
export interface ApplyAgentConfigResult {
|
|
46
|
+
applied: ConfigPlanAction[];
|
|
47
|
+
skipped: string[];
|
|
48
|
+
}
|
|
49
|
+
/** 应用配置计划:校验签名与冲突,逐动作核对目标哈希后写入。 */
|
|
50
|
+
export declare function applyAgentConfig(store: CairnStore, input: {
|
|
51
|
+
plan: AgentConfigPlan;
|
|
52
|
+
signature: string;
|
|
53
|
+
}): Promise<ApplyAgentConfigResult>;
|
|
54
|
+
export interface DoctorResult {
|
|
55
|
+
agentKind: string;
|
|
56
|
+
configPath: string | null;
|
|
57
|
+
configExists: boolean;
|
|
58
|
+
cairnEntryPresent: boolean;
|
|
59
|
+
blockPath: string | null;
|
|
60
|
+
blockPresent: boolean;
|
|
61
|
+
capability: CapabilityLevel;
|
|
62
|
+
notes: string[];
|
|
63
|
+
}
|
|
64
|
+
/** 只读健康检查:如实报告 fixture-only/blocked,不宣称真实宿主认证。 */
|
|
65
|
+
export declare function doctorAgentConfig(store: CairnStore, input: {
|
|
66
|
+
agentKind: AgentKind;
|
|
67
|
+
homeRoot: string;
|
|
68
|
+
projectRoot?: string | null;
|
|
69
|
+
}): Promise<DoctorResult>;
|
|
70
|
+
export interface UninstallResult {
|
|
71
|
+
removed: {
|
|
72
|
+
path: string;
|
|
73
|
+
restoredOriginal: boolean;
|
|
74
|
+
}[];
|
|
75
|
+
notes: string[];
|
|
76
|
+
}
|
|
77
|
+
/** 卸载:只处理本产品安装记录覆盖的路径;能恢复原字节就整文件恢复。 */
|
|
78
|
+
export declare function uninstallAgentConfig(store: CairnStore, input: {
|
|
79
|
+
agentKind: AgentKind;
|
|
80
|
+
homeRoot: string;
|
|
81
|
+
projectRoot?: string | null;
|
|
82
|
+
}): Promise<UninstallResult>;
|