可塑记忆 KKL08/dsh-plastic-memory

dsh-plastic-memory

Plastic Memories

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

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

💡 灵感来源

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

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

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

🎬 设定对照

| 《可塑性记忆》世界观设定 | dsh-plastic-memory 功能对应 | 作用价值 |
| 艾拉的日记 | 对话中沉淀记忆（memory_save） | 从日常对话与任务中提炼记忆点，自动写入保存 |
| Giftia 的灵魂载体 Alma OS | 文件即记忆（Markdown） | 每条记忆为一个标准 Markdown 文件，透明、可编辑、便于维护管理 |
| Giftia 的心智寿命 | 记忆保质与衰退机制 (decayDays) | 引入基于时间维度的记忆新鲜度 |
| 徘徊者（Wanderer） | 记忆矛盾与事实冲突（Memory Rot） | 陈旧与相互矛盾的记忆会干扰上下文，支持针对性扫描并处置 |
| 第 1 终端服务（回收业务） | 记忆治理层（Governance） | 全库记忆体检、置信度刷新、清理问题记忆与孤立节点 |
| 人机搭档协作制 | 用户与智能体协同提权（memory_promote） | Global 全局记忆与跨作用域提升必须由用户显式确认 |
| 最初相遇的节点 | 记忆溯源（memory_source） | 每条记忆均锚定原始对话切片，出处可查可追溯 |

✨ 核心特性

- 🗂️ 记忆分类与可扩展 内置 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 dsh-plastic-memory@0.1.1-beta.5
把 web 换成你的目标配置档名即可（若该配置档不存在则自动创建）。安装后插件声明会自动写入该配置档的 cordis.patch.yml，重启该配置档后生效。插件以预构建产物发布到 npm，安装不需要构建授权。
桌面版：先打开一次 DeepSeek Harness 桌面版，让它建好自己的配置档，然后完全退出，在终端运行下面这条，再重新打开桌面版。dsh 命令用 npm 装的或桌面版自带的都可以。

dsh plugin --profile desktop add dsh-plastic-memory@0.1.1-beta.5

运行环境要求：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：这次对话带入了哪些记忆、占了多少上下文、模型新记了什么；带入的记忆之间有冲突可以就地裁决。
- 插件设置页（宿主插件管理里的本插件详情）：场景模板、自定义类型（弹层增删改）、带入上限与超出上限的模式、溯源记忆出处、中文分词的用户词典路径、体检开关与灵敏度、全局记忆的去向，外加一张状态卡。保存即写回配置档的 cordis.patch.yml，不用重启。

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

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

🧠 记忆体系

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

| 类型 (Type) | 说明 |
| profile | 用户的个人身份、专业角色与能力画像 |
| preference | 经过纠正与确认的准则、行为习惯 |
| knowledge | 跨越项目周期的通用事实、业务常识与规则 |
| project | 与当前项目生命周期强相关的临时状态与决策 |
| reference | 外部系统与资源的索引 |

场景扩展模板

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

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

召回注入模式 (recall)

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

| 模式 | 注入行为 | 适用场景 |
| core | 全文注入：常驻系统上下文 | 高频核心偏好与人设画像 |
| search | 索引注入：进入概览索引，模型按需调取 | 详细流程规范与业务知识 |
| passive | 静默索引：仅在索引中呈现名称，最大化节约 Token | 低频调用的参考信息 |

自定义类型定义

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

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

🛠️ 工具集一览

1. 日常交互工具

| 工具 | 用途与特性 |
| memory_save | 沉淀或更新记忆。内置重复性校验与密钥嗅探，遇到近似内容时主动引导 update 或 force |
| memory_search | 按相关性检索记忆，中英文查询都可用：同时含全部关键词的记忆排在只含部分关键词的之前，关键词作为整词出现的又排在只作为长词一部分出现的之前（如 scope 之于 readScope）；每个术语只写一种写法，用记忆里最可能出现的那种，同一术语的中文和英文写法不放进同一次查询；没有记忆含全部关键词时，结果开头会说明；排第一的也缺了某个关键词、或对上的查询实词不到 65% 时，还会提示命中弱、建议换词或换成另一种语言的写法再搜，有可列的词时还列出各关键词命中几条。每条命中带记忆文件的绝对路径，要看全文直接读。支持按类型（Type）及作用域（Scope）过滤，默认返回 10 条（上限 50） |
| memory_forget | 记忆批量移除：文件搬进 .archive/，删除前自动快照，14 天内可恢复。含密钥的记忆例外：立即物理删除、所有快照里的副本一并脱敏，不可恢复 |
| memory_snapshot | 快照管理：手动打标、差异比对（Diff）、历史版本回滚与误删恢复 |
| memory_source | 因果溯源：回溯记忆提炼时的原始会话轨迹切片，校验记忆产生的原始意图与上下文背景，防范幻觉 |

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

| 工具 | 用途与特性 |
| memory_health | 健康度评分（0–100）：评估全库记忆质量；同时列出解析不了被隔离的文件和目录问题（重复 id、缺 .workspace 标记等） |
| memory_scan | 全库深度体检：规则层（密钥泄露、超长、孤立引用、破损文件）；语义层（冲突、冗余）按需调用 LLM |
| memory_confirm | 保质期刷新与处置决策：确认陈旧记忆的置信度以延长生命周期，或对冲突扫描结果进行人工仲裁 |
| memory_promote | 记忆提权流转：将验证过的项目专属记忆提升至全局（Global）或同步至 AGENTS.md，必须由用户明确指令确认 |

治理工具默认只处理全局和当前项目的记忆，要动其他项目的记忆需带 allowCrossWorkspace: true（用户明确要做全局整理时）。子代理会话（宿主派生的子任务）只能读：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 配置：

| 配置项 | 默认值 | 说明 |
| writeMode | 'proactive' | 写入模式（目前唯一值，后续会扩展更多模式） |
| snapshotTokenBudget | 4000 | 每次对话自动带入记忆的 token 上限，对话中检索到的不计入 |
| snapshotOverflow | 'relax' | 超出上限时：relax 全部带入并按 25% 一档提醒 / strict 截断索引行并提示漏掉几条 |
| evidenceLookup | 'strict' | 证据溯源模式：off（关闭） / strict（仅强信号提示） / active（主动引导） |
| template | 'coding' | 预设场景模板：coding / office / custom |
| customTypes | {} | 自定义记忆类型定义字典 |
| governance.enabled | true | 是否启用主动治理层（体检、健康分、提权） |
| governance.health.sensitivity | 'normal' | 健康警报灵敏度：conservative / normal / proactive |
| governance.globalPromoteTarget | 'plugin-global' | 提权目标：plugin-global（插件全局域）或 agents-md（~/.dsh/AGENTS.md） |
| memoryRoot | '' | 存储根路径，缺省为 ${DSH_HOME:-~/.dsh}/memories |
| search.userDictionaryPath | 不设 | 用户词典路径（设置页同名字段）：追加在内置词典之上，改了下一次搜索生效。要填绝对路径；每行「词 词频 词性」，词频必填，不带词频的词条不生效，例如 插件记忆 10 n。没装 @node-rs/jieba 时不生效 |

🧪 开发与测试

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

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