DeepSeek Harness（DSH）在构建具备长期记忆和稳定人格的智能体时，常面临对话上下文丢失、记忆管理混乱以及人格漂移的问题。现有的记忆方案往往缺乏分层结构，导致检索效率低下。
dsh-lan-memory（澜·记忆与人格系统）是一个 DSH 插件，旨在解决上述痛点。它通过三层记忆架构、人格注入机制以及 Mood 状态池管理，为智能体提供跨会话的持久化记忆与稳定的人格表现。
核心功能¶
- 三层记忆架构：将记忆分为常驻（始终注入）、检索（关键词检索）和经验库（沉淀教训与方法）三个层级。
- 人格系统：包含 SOUL 静态底稿与 MOOD 输出契约，为智能体提供稳定的人格基础。
- Mood 状态池：在每条回复前自动生成 Vibe、Sparks、Reflections、Will 四个维度的状态信息，辅助人格演变与调试。
- 一键整理：提供手动去重合并功能，并在写入前自动备份，确保数据安全。
- 人格可编辑：支持在 GUI 设置页面在线修改 SOUL 与 MOOD 契约，保存即生效。
- 零依赖存储：基于纯 JSONL 文件存储，无外部数据库或运行时依赖。
安装与启用¶
使用以下命令安装插件。请将 <插件目录绝对路径> 替换为实际路径。
dsh plugin --profile web add <插件目录绝对路径>
验证安装是否成功：
dsh --profile web --dump-config | grep lan
若需卸载，执行：
dsh plugin --profile web remove dsh-lan-memory
数据文件默认保存在 ~/.dsh/hanako/ 目录下，卸载操作不会删除这些文件。
典型用法¶
插件提供了 lan_ 前缀的工具函数，供模型在对话中主动调用。
- 常驻记忆：使用
lan_pin添加需始终注入的关键信息。
lan_pin("用户偏好", "喜欢美式咖啡")
- 检索记忆：使用
lan_remember记录信息并打标签，供后续检索。
lan_remember("用户是医学总监，关注肠内营养", ["用户偏好"])
模型在对话中可根据上下文主动调用 `lan_recall` 进行检索。
- 人格配置：人格配置文件
persona.json存储在~/.dsh/hanako/，插件启动时加载注入。默认人格为“鲸鱼娘”，支持 GUI 在线编辑。
适用场景与注意¶
本插件适用于需要长期记忆、人格一致性要求较高的智能体开发场景。它不依赖外部数据库，数据存储在本地文件中，适合对数据隐私有要求的场景。
使用时需注意：插件以当前 DSH 进程的权限运行。安装前建议检查源码与许可证（MIT）。
短结尾¶
dsh-lan-memory 通过分层记忆与人格注入机制，降低了智能体长期对话的开发门槛。其纯 JSONL 的存储方式也保证了轻量级与可移植性。
项目地址：https://github.com/kiefeng/dsh-lan-memory
