前言¶
在 DSH 生态中，Agent 的长期记忆管理是一个常见痛点。开发者经常面临 Agent 忘记早期指令、将不可靠信息误认为用户偏好，以及难以追溯和修正错误记忆的情况。dsh-adaptive-context 插件（AdaptiveContextPlane, ACP）旨在解决这些问题。它是一个带治理的长期记忆系统，由 Icstick 维护，类别属于“记忆”。
ACP 的核心价值在于将记忆管理从“黑盒”转变为“可审计的账本”。它通过显式的证据记录、写入闸门和用户权限控制，确保注入 Agent 的上下文信息权威、准确且可追溯。
核心功能¶
- 证据账本：基于 SQLite 的只追加式账本。每条证据都记录来源、权威等级（7级）和领域（6类）。同一事件重放只会落一条。
- 治理：包含写入闸门（拦截密钥、隐私、提示注入）、读取闸门（按作用域/状态/资格过滤）以及用户权利（查看、导出、纠正、删除等）。
- 上下文编排：在每轮对话的 pre-step 阶段执行。通过双通道排序（文本+语义）和内容去重，控制注入预算，避免冗余信息。
- 用户模型：显式建模用户事实、偏好、工作状态、表达风格等，拒绝模糊推断。
- 后台沉淀：每轮结束后在后台运行。证据积压到一定量或时间间隔后触发 LLM 提炼。失败不推水位，下轮重试同批，仅 LLM 完全不可用时走规则兜底。
- 时间真相：证据带有生效起止时间，可查询历史视图。被取代的证据在旧时点依然可见，保留完整的演化链。
- 表达风格晋升：风格候选需过人工审批门或满足策略护栏才生效，支持回滚。
- 多源路由：支持多个记忆源并行召回，各自超时互不拖累，主路挂了自动走备路。
- 审计与导出：所有关键操作留痕（谁、何时、为什么），支持 JSONL 格式的证据与审计数据全量导入导出。
- 离线巩固：通过慢环将证据与观察整理成稳定的候选结论，物理分离，晋升必须过人工门。
安装与配置¶
安装该插件需要执行 CLI 命令并手动补全配置。
- 安装插件：
dsh plugin --profile <profile> add github:Icstick/dsh-adaptive-context
*注意：该命令只会安装依赖并 reconcile bundles，不会自动写入配置条目。*
- 配置数据目录：
插件运行依赖于显式配置的数据目录。编辑 profile 根目录的cordis.patch.yml，添加以下内容：
- id: adaptive-context
name: dsh-adaptive-context
config:
ledgerDir: C:\path\to\acp-data # 必填：账本目录的绝对路径
*注意：`DSH_HOME` 环境变量不可靠，必须显式指定 `ledgerDir`。*
- 安装并重启：
进入 profile 目录执行pnpm install，然后重启 dsh。
典型用法¶
ACP 的设计理念是“证据即真相”。以下是基于事实的典型使用场景：
- 第一天：告诉 Agent “记得我喜欢把配置和代码分开”。这句话被 ACP 记录为一条用户事实证据，来源权威，随后在新会话中自动注入。
- 第二周：发现 Agent 生成的代码缩进错误，纠正说：“都说了，用 4 空格。”这句话作为“用户纠正”写入，同时将之前错误的旧证据标记为“已取代”。从此，注入的只会是新偏好。
- 一个月后：需要迁移环境，导出 JSONL 格式的全部证据带走，在新环境导入。此时可以完整查看到从“用户偏好”到“纠正”再到“最终偏好”的演变过程。
注意事项¶
- 配置覆盖规则：在
cordis.patch.yml中，同一个 id（如adaptive-context）的多个条目，后者会整体覆盖前者，不是合并。 - 配置项变更：
targetDomain已弃用。memosBaseUrl和memosEnabled已于 2026-10-01 退场，配置中保留这些键位仅作兼容展示，不再生效。 - 运行环境：插件以当前 dsh 进程权限运行，安装前建议检查源码与许可证（MIT）。
总结¶
ACP 为 DSH 提供了一套结构化的长期记忆解决方案。通过将记忆写入、检索和治理流程标准化，它解决了 Agent 记忆不可控、难维护的问题。对于需要长期运行、对上下文一致性要求高的 Agent 项目，这是一个必要的工具。
