DeepSeek Harness Lifelong Agent

English README · 安全策略 · 贡献指南

项目仓库：

面向 AI Agent 的受治理长期记忆。 这是一个 TypeScript 治理核心，用于对 Agent 的记忆执行可审计的准入、检索、过期、替代与撤回决策。

DSH 技术预览兼容性声明

独立治理核心可运行且已完成单元测试。随附的 DSH adapter 只定义集成契约，尚未针对某个固定 DSH/Cordis 版本完成注册和端到端验证。因此，本项目不能被表述为可直接加载到任意 DSH 版本的插件。

项目背景

长任务 Agent 需要连续性：项目约束、经过验证的决策、历史失败、用户确认的偏好，以及已完成任务中的经验。如果只是“把一切保存起来，之后再检索”，长期记忆会带来新的错误面：

• 模型总结、单次工具输出或未经确认的反馈被固化成长期但错误的规则；
• 仓库、策略或运行环境改变后，陈旧决策仍然悄然影响新任务；
• 项目、用户或敏感信息跨越授权边界进入不应访问的上下文；
• 相互冲突的记忆被同时注入，迫使模型任意选择；
• 记忆检索挤占上下文窗口，造成 token 和成本不可预测地增长；
• 被检索的内容无法追溯来源，或在纠错/撤回后仍被继续引用。

DSH Governed Memory 不把长期记忆视为对话转录的归档，而是将其视为一个受控生命周期：每一次记忆进入或离开模型上下文都有显式策略、原因码和审计事件。

解决思路

核心实现以下生命周期：

capture → quarantine → verify → promoted → retrieve
                              ↘ decay / superseded / revoked

1. 候选隔离（Capture into quarantine）：模型总结、单次工具结果和未确认反馈先以 quarantine 状态保存，默认不可检索。
2. 验证后显式提升（Verify and promote）：条目必须同时具有已验证的 A/B 级证据和显式批准，才能成为 promoted。
3. 检索前过滤（Filter before retrieval）：拒绝未提升、跨 scope、隐私不允许、过期、陈旧、被替代、已撤回或 canonical key 冲突的条目。
4. 最小充分检索（Token-bounded retrieval）：ContextLedger 记录哪些条目被纳入或排除、预计 token 用量及原因码。
5. 请求预算预检（Budget preflight）：模型调用前返回 ALLOW、MITIGATE 或 BLOCK；预估成本不会被伪装为供应商实际账单。
6. 全程可审计（Auditability）：捕获、提升、检索、衰减与撤回都会发出事件，便于宿主系统重建“为什么某条记忆可见或被拒绝”。

Beta 已实现能力

能力