dsh-plastic-memory

简体中文 | English

「愿你有一天，能与珍爱之人再次相逢。」——《可塑性记忆》

互动产生轨迹，轨迹沉淀为记忆。记忆是历经提炼的认知结晶，贯穿生命周期，持续塑形，直至最后一刻。

💡 灵感来源

插件取名灵感源自动画《可塑性记忆》（Plastic Memories）。在原作中，拥有独立心智的 Giftia 寿命被严格限制在 81,920 小时（约 9 年 4 个月）。若记忆容量超载且缺乏妥善管理与回收，Giftia 的人格便会发生不可逆的崩溃，异化为失去理智的**「徘徊者（Wanderer）」**。

在 LLM 时代，智能体（Agent）的长期记忆系统同样面临着类似的工程挑战：过期、矛盾、冗余与孤立的记忆不断堆积，导致 Agent 认知漂移、产生幻觉与决策冲突，造成 Token 浪费与输出质量退化。

为此，dsh-plastic-memory 作为一款基于 DeepSeek Harness 的 Agent 记忆插件，提供记忆的存储、分类、检索与治理，赋予 Agent 记忆可塑性（Plasticity）与生命周期（Lifecycle）：既能提炼沉淀、精准唤起，也能诊断健康、判定事实冲突、适时遗忘。让有价值的共识历久弥新，让失效的信息有序退场。

🎬 设定对照

✨ 核心特性

• 🗂️ 记忆分类与可扩展
  内置 profile / preference / knowledge / project / reference 五类，覆盖身份、习惯、知识、项目决策与资源指南，分类保存、按需召回。同时支持扩展自定义分类（测试功能）。
• 🛡️ 严格的工作区隔离与写入保护
  工作区（Workspace）记忆相互物理隔离，互不可见；全局（Global）记忆跨项目只读共享。模型无权直接写入全局域，任何项目记忆提升到全局必须由用户确认，避免全局规则无序扩张与污染。
• 🩺 内建多层治理体系（Governance）
  配备记忆体检机制，阻断高危信息写入（如 API 密钥），治理规则冲突，防止长期运行带来的认知退化。
• 🔍 精确的因果溯源（Traceability）
  每条记忆沉淀时均锚定原始会话轨迹切片。深入分析时，模型可调用 memory_source 回溯对话原始背景。

🏗️ 架构概览

工作流简述： 对话中模型触发 memory_save 提炼有效记忆节点，写入前通过安全管线去重并拦截密钥泄露。记忆保存为 Markdown 文件，在会话启动或上下文压缩时以只读快照形式精准注入。存储层之上叠加治理层，持续读取并处置记忆库，抑制上下文退化与规则漂移。

📦 安装

0.2.0 即将发布，含破坏性更新：要求最低 DeepSeek Harness v0.2.1-rc.2。建议等 0.2.0 发布后再正式使用；目前只能安装旧版本，旧版本提供记忆保存、检索、自动注入、健康体检等功能的基础体验。之后升级到 0.2.0 时，已有记忆原地沿用，待处理事项自动迁移。

旧版本 0.1.1-beta.5：

dsh plugin --profile web add [email protected]

把 web 换成你的目标 Profile 名即可（若该 Profile 不存在则自动创建）。安装后插件声明将自动写入该 Profile 的 cordis.patch.yml，重启该 Profile 后生效。插件以预构建产物发布到 npm，安装不需要构建授权。
桌面版：先打开一次 DeepSeek Harness 桌面版，让它建好自己的 Profile，然后完全退出，在终端运行下面这条，再重新打开桌面版。dsh 命令用 npm 装的或桌面版自带的都可以。

dsh plugin --profile desktop add [email protected]

运行环境要求：Node.js ^22.19.0 || >=24，DeepSeek Harness v0.1.7-rc.1 及以上（目前已验证到 v0.2.1-rc.2）；图形界面要 v0.2.1-rc.2 及以上。
中文分词：可选依赖 @node-rs/jieba（带各平台预编译二进制）随 npm 安装自动带上，中文检索按词匹配；当前平台装不上时插件照常安装，中文检索退回二字切分，其他功能不受影响。
（DeepSeek Harness 仍在预发布阶段，之后还可能出现破坏性更新；升级宿主前请留意本插件当前支持的版本范围，见顶部徽章和 CHANGELOG。）

当前为 beta 阶段，安装命令直接写明版本号；发布稳定版后可直接 dsh plugin --profile web add dsh-plastic-memory。

🚀 快速上手

1. 保存记忆：对话中告诉模型需要记住的内容，模型自动识别并写入；下次开启新会话时，已保存的记忆随上下文快照自动注入，无需手动操作。
2. 检索记忆：需要回顾时，让模型搜索相关记忆，支持按类型、作用域过滤。
3. 查看健康度：让模型检查记忆库整体健康评分，了解当前记忆质量状况。
4. 整理记忆：让模型扫描全库，自动检出冲突、冗余、过期等问题并给出处置建议，确认后一键优化。

🖥️ 界面

装好后不用碰 yaml，三处界面都在宿主的 web UI 里：

• 左栏「记忆」页：四个 tab。「待处理」列出等你拍板的事——体检发现的冲突、适合提升为全局的记忆、超出上限的提醒、密钥、读不出的文件，每一项就地处理（以哪条为准、撤销、提升或留在本项目、彻底删除密钥）；「全部记忆」按项目 / 全局浏览、打开文件或在访达中显示、删除；「健康」看每一层的分数和问题，右上「体检当前项目」随时体检；「最近删除」找回 14 天内删掉的记忆，被裁决删掉的会标明以哪条为准。页面不要求正在对话，它借用当前项目的一个空闲会话执行命令；一个会话都没有时只显示空态。
• 右侧栏「记忆」tab：这次对话带入了哪些记忆、占了多少上下文、模型新记了什么；带入的记忆之间有冲突可以就地裁决。
• 插件设置页（宿主插件管理里的本插件详情）：场景模板、自定义类型（弹层增删改）、带入上限与超出上限的模式、溯源记忆出处、中文分词的用户词典路径、体检开关与灵敏度、全局记忆的去向，外加一张状态卡。保存即写回 profile 的 cordis.patch.yml，不用重启。

对话里每次记住东西都有一张可删的卡；左栏图标上的圆点只在有事等你决定时亮（琥珀），发现密钥时变红。

界面要求 DeepSeek Harness v0.2.1-rc.2 及以上；更早的受支持宿主（v0.1.7-rc.1 起）工具与注入照常，只是没有界面。

🧠 记忆体系

系统内置 5 类基础记忆类型，适用于所有交互场景：

场景扩展模板

通过配置模板可在基础 5 类之上追加领域专用类型：

• coding（默认）：追加 procedure（可复用的标准操作流程）。
• office：追加 decision（会议决议）/ commitment（待办承诺）/ person（团队人员画像）。
• custom：仅保留 5 类核心内置类型，其余完全由用户在配置中自定义声明（测试中，后续会进一步优化）。

召回注入模式 (recall)

控制不同记忆类型在上下文中的呈现形式：

自定义类型定义

在配置项 customTypes 中声明（名称不能与内置 5 类冲突）：

customTypes:
  ritual:
    label: 团队仪式
    description: 定期执行的团队流程与规范
    whenToSave: 用户提到固定周期执行的流程或仪式时
    recall: search
    governancePriority: low
    decayDays: 90

🛠️ 工具集一览

1. 日常交互工具

2. 记忆健康治理工具（governance.enabled = true）

治理工具默认只处理全局和当前项目的记忆，要动其他项目的记忆需带 allowCrossWorkspace: true（用户明确要做全局整理时）。子 agent 会话（宿主派生的子任务）只能读：memory_search、memory_source、memory_health 可用，其余写工具（含 memory_scan）一律拒绝，记忆照常注入。

📂 存储结构与目录规范

记忆就是文件：磁盘上的 Markdown 是唯一真相，插件不在内存里另存一份。你用编辑器新建、修改、删除文件，下一次工具调用和新会话注入立即反映，不用重启。

<memoryRoot>/
  global/                    # 全局记忆（跨项目共享）
    <name 的 slug>.md         # 一条记忆一个文件（YAML Frontmatter + 正文）
    MEMORY.md                # 生成的索引：列出当前有效的记忆，手改会被覆盖
    .archive/                # 已遗忘、已取代的记忆；遗忘 14 天后自动清理
  <项目slug>-<hash>/         # 项目记忆（按工作区隔离）
    .workspace               # 一行：该项目的本地绝对路径
    <name 的 slug>.md
    MEMORY.md
    .archive/
  .state/                    # 插件自用：快照、待决冲突、扫描缓存、召回统计

索引行末尾带文件名，模型拿到就能直接读原文；.archive/ 是隐藏目录，宿主的 grep 搜不到里面已遗忘的内容。

手动编辑规范

• 新建：一个 .md 文件，Frontmatter 最少只要 name 和 type，正文就是记忆内容。id、时间戳、tags、summary、confidence 都可以省，插件在下一次写入或会话启动时补齐（id 按文件路径派生，之后跟着文件走）。
• 时间戳：接受 2026-09-01、2026-09-01T08:30:00Z、带时区偏移等常见写法；缺省取文件修改时间。
• 修改：改正文或字段后记忆带「已手编」标注，memory_source 会提示出处可能不再对应；用 memory_save 更新后标注清除。
• 过期：validTo 已过的记忆留在原位，不注入、不检索；memory_health 会提醒延长有效期或遗忘。
• 恢复：误删的记忆在 .archive/ 里，用 memory_snapshot 恢复，或把文件搬回上一层并把 status 改成 active。
• 格式错误：解析不了的文件单独隔离，不影响其他记忆；memory_health 和 memory_scan 会列出来，修好即生效。
• MEMORY.md 是生成物，不要手改。

⚙️ 核心配置参考

在 Profile 对应的 cordis.patch.yml 中调整 plastic-memory 配置：

🧪 开发与测试

pnpm install --frozen-lockfile
pnpm typecheck && pnpm test && pnpm build
pnpm host:smoke      # 把打包产物装进全新的 dsh 宿主，验证安装与加载（无需 API Key）
pnpm host:contract   # 在该宿主里驱动九个工具，验证宿主契约（无需 API Key；提供 Key 时额外运行语义层两项）

开发流程、测试说明与提交规范见 CONTRIBUTING.md；变更记录见 CHANGELOG.md。

📄 License

MIT License

如果这个项目对你有帮助，欢迎点个 ⭐ 支持一下，十分感谢。