前言¶
DeepSeek Harness (DSH) 依靠插件体系构建扩展能力。对于依赖上下文的智能体而言，长期记忆是维持连贯性和提升准确性的关键，但单纯存储容易导致信息冗余、冲突甚至污染。dsh-plastic-memory 是一款为 DSH 提供记忆存储、分类、检索与治理能力的插件，旨在为 Agent 赋予可塑的记忆能力与生命周期管理。
核心功能¶
该插件主要提供以下能力：
- 记忆分类与可扩展：内置
profile（身份）、preference（偏好）、knowledge（知识）、project（项目）、reference（参考）五类记忆。支持在基础类型上通过配置模板扩展自定义类型。 - 工作区隔离与写入保护：项目记忆在物理层面相互隔离，互不可见；全局记忆仅允许只读访问。模型无法直接写入全局域，任何将项目记忆提升至全局的操作必须由用户显式确认，防止全局规则污染。
- 内建多层治理体系：提供记忆体检机制，能够拦截高危信息（如 API 密钥），治理规则冲突，防止长期运行带来的认知退化。
- 因果溯源：每条记忆均锚定原始对话轨迹切片，模型可调用工具回溯记忆产生的原始背景，防范幻觉。
- Markdown 文件存储：记忆以标准 Markdown 文件形式持久化，支持透明查看与编辑。
安装与启用¶
该插件当前处于 Beta 阶段（v0.1.1-beta.3）。
运行环境要求：
* Node.js ^22.19.0 || >=24
* DeepSeek Harness v0.1.7-rc.2 或更新
安装命令：
dsh plugin --profile web add dsh-plastic-memory@0.1.1-beta.3
安装后插件声明将自动写入对应 Profile 的配置文件，重启 Profile 后生效。
工具集¶
插件提供以下工具，可用于日常交互与记忆治理：
日常交互工具¶
memory_save：沉淀或更新记忆。内置重复性校验与密钥嗅探，遇到近似内容时会主动引导更新或强制覆盖。memory_search：多维全文检索，支持按类型及作用域过滤。memory_forget：批量移除记忆。删除前自动归档快照，14 天内可恢复。memory_snapshot：快照管理。支持手动打标、差异比对、历史版本回滚与误删恢复。memory_source：因果溯源。回溯记忆提炼时的原始会话轨迹切片。
记忆健康治理工具¶
memory_health：评估全库记忆质量，返回健康度评分（0-100）。memory_scan：全库深度体检。检查规则层（密钥、孤立引用、破损文件）和语义层（冲突、冗余），并给出处置建议。memory_confirm：保质期刷新与处置决策。确认陈旧记忆的置信度以延长生命周期，或对冲突扫描结果进行人工仲裁。memory_promote：记忆提权流转。将验证过的项目专属记忆提升至全局，该操作必须由用户明确指令确认。
配置与存储¶
配置项¶
在 Profile 的 cordis.patch.yml 中可调整 plastic-memory 配置。关键配置包括：
writeMode：写入模式（当前为proactive）。snapshotTokenBudget：注入上下文的最大 Token 预算上限。evidenceLookup：证据溯源模式（off/strict/active）。template：预设场景模板（coding/office/custom）。customTypes：自定义记忆类型定义字典。governance.enabled：是否启用主动治理层。memoryRoot：存储根路径，默认为${DSH_HOME:-~/.dsh}/memories。
存储结构¶
记忆存储在本地文件系统中，目录结构如下：
<memoryRoot>/
global/ # 全局记忆（跨项目共享）
<id>.md # 独立记忆词条
MEMORY.md # 全局聚合索引
<项目slug>-<hash>/ # 项目记忆（工作区隔离）
.workspace # 关联的本地绝对路径标记
<id>.md
MEMORY.md
手动编辑注意事项¶
插件具备外部变更感知机制，调用工具前会自动重载。
手动编辑 Markdown 文件时，时间戳必须保持 2026-09-01T08:30:00.000Z 这种 UTC 毫秒格式。格式错误的文件会被隔离，不影响其他记忆加载，但在健康检查中可见。
适用场景¶
该插件适合需要构建具备长期记忆能力的 DSH Profile 或智能体场景。它通过分类、隔离和治理机制，帮助开发者解决 Agent 长期运行中记忆混乱的问题。
