前言¶
在 DeepSeek Harness(DSH)里做带「角色感」的对话,常见做法是往系统提示里堆一段固定人设,或自己维护一份上下文文件。人设一旦写死,很难按对话开关;所谓「长期记忆」若只靠全量历史,成本高,也没有「久不提起就淡掉、重要条目可置顶」这类机制。社区维护者 ifenc 的 dsh-persona-memory(人格记忆 · Persona Memory)把人物卡、会衰减的记忆、日记、资料库和表情包做成同一套本地插件,按对话、按人物卡隔离,数据落在本机。下面介绍它是什么、能做什么,以及如何安装与使用。
这是什么¶
dsh-persona-memory 是面向 DSH 的本地优先插件:在系统提示中注入可配置人物卡,随时间维护会自然变淡并可复习的长期记忆,并支持按人物卡绑定的日记、资料库与表情包。仓库:https://github.com/ifenc/dsh-persona-memory;社区目录页:https://www.skillhub.cn/plugins/ifenc/dsh-persona-memory。当前 package.json 版本为 0.9.1,许可证 MIT,维护者 ifenc。插件为非官方项目,与 DeepSeek 无隶属关系。
核心功能¶
人设与人物卡¶
- 按对话独立:每个对话可单独开/关人设;打开后当前人物卡与记忆进入该对话的系统提示,换对话不会连带切换。新对话默认关闭。
- 自由条目 + 权重:人物卡由有序条目组成(标题、内容可自定义);权重可改默认项(拟人度、玩梗、情绪等)或新增自定义权重(0–100),提示词按数值生成约束。
- 与记忆/日记/资料/表情包绑定:每张人物卡各自一套数据;切换卡片时提示词与附属数据一并切换。可单独清空、导入/导出当前卡;删卡会连带删除其记忆、日记、资料与表情包。
- 关闭后的语气提醒:在曾开过人设的对话里关闭后,会注入短句提醒,要求用普通助手语气,减轻历史对话的惯性。
长期记忆¶
记忆清晰度随时间衰减;注入提示或主动复习可延长保留。重要记忆可置顶、永不遗忘;低于阈值进入「已遗忘」,可恢复。
日记、资料库、表情包¶
- 日记:可让模型在对话自然收束时写日记;或开「自动摘要」,每轮在本地汇总当天要点(不额外调用模型)。
- 资料库:收录梗、笔记、带来源链接的资料;模型通过
persona_library搜索/查阅,学到新内容时可自动补充;设置页可手动增删改或导入导出。 - 表情包:可按卡开关;上传 PNG / JPEG / GIF / WebP(单张 ≤2MB),填名称与标签;模型通过
persona_sticker的send在合适时机发 Markdown 图链,图片仅存本机并由本地接口提供。
工具与界面¶
注册工具:persona、persona_memory、persona_diary、persona_library、persona_sticker,均作用于当前人物卡;也可用自然语言让人设调整、记/忘事、写日记、查资料、发表情包。
设置 → 人格记忆 中可编辑卡片、记忆(含清晰度条)、资料库、表情包、日记与参数。输入框下方开关只作用于当前对话:左键开/关,右键关闭或切换人物卡;设置页可查看「已开启 N 个对话」并「全部关闭」。人设只注入主对话,子 Agent 不受影响。
导入导出与更新¶
人物卡、记忆、日记、资料库、表情包可分别导出 JSON,也可一键备份/恢复;导入支持合并(去重)或覆盖。设置 → 参数 中「检查更新」会读取 GitHub main 上 package.json 的 version 与本地比较,仅提示,不自动安装。
安装与启用¶
需要 DSH 0.2.1+(README 注明在 0.2.1-rc.2 桌面版上开发与测试)。Node >=22(见 package.json engines)。
1、将仓库克隆或下载到本地任意目录:
git clone https://github.com/ifenc/dsh-persona-memory.git
2、在 DSH 插件管理里安装该本地 bundle(选择 dsh-persona-memory 目录),或使用 CLI(--profile 按实际 profile 替换,桌面版通常为 desktop,Web 版为 web):
dsh plugin --profile desktop add "/absolute/path/to/dsh-persona-memory"
3、安装后刷新页面;若插件未出现,重启 dsh web。
从本地目录安装时 DSH 以 link 方式挂载,改源码后重新加载插件或重启即可生效。资料中未提供 dsh plugin add github:owner/repo 一类远程一键命令,请勿凭名称自行拼接。
典型用法¶
1、打开 设置 → 人格记忆,编辑人物卡条目与权重,查看记忆、日记、资料库与表情包,按需导入导出或调整参数。
2、在需要角色感的对话里,点输入框下方开关 左键 开启人设;右键 可关闭或切换到另一张人物卡(记忆与日记随卡切换)。
3、对话中可直接说「记住这件事」「把这条忘掉」「写篇日记」「换成另一张人物卡」等,由对应工具执行。
4、需要资料检索时,让模型使用 persona_library;发表情包时由模型在合适时机调用 persona_sticker。
数据、隐私与适用注意¶
- 默认存储路径:
DSH_HOME/persona-memory/store.json;可用环境变量DSH_PERSONA_MEMORY_DIR覆盖目录。 - 数据在本机;除「检查更新」请求 GitHub 上的
package.json(仅 User-Agent,不上传本地数据)外,插件不发起其他网络请求。 - 人物卡、记忆、日记、资料与表情包的名称/标签会进入发给模型的提示词;勿写入不希望发给模型的内容。表情包以 data URL 写入
store.json,单张 ≤2MB,会增大数据文件体积。
适用对象:希望在 DSH 里做可开关、可换卡、带衰减记忆与本地日记/资料/表情包,且接受数据本地自管的开发者或高级用户。
安全与信任:插件以当前 DSH 进程权限运行,可读写上述本地存储并注册工具与 HTTP 接口。安装前请自行审阅 仓库源码 与 MIT 许可证。插件依赖 DSH 的 tools、systemPrompt、webServer、agents、sessions 等服务;DSH 快速迭代时接口变更可能需要插件同步适配。
结尾¶
dsh-persona-memory 把 DSH 对话扩展成「按对话、按人物卡」的人设与长期记忆体系,并把日记、资料库、表情包绑在同一套本地数据里,适合需要本地优先、可导入导出、可自然语言调工具的场景。