DSH 情感陪伴记忆插件
人也记不住每次闲聊。重要的是，理解什么对这个人值得记住。
面向 DeepSeek Harness 的选择性记忆插件。模型主动维护用户画像，思考用户在意什么、哪些片段会被用户自己记住、哪些经历承载情感联系，再决定记忆的保留、提炼、合并与修正。
同样是一碗面，普通外卖可能只是当天的细节，家人特意留的面却可能承载被惦记的感受。重要性来自这个人与这段经历的意义，不按内容类型、关键词、情绪分数或固定遗忘天数筛选。
Companion Memory for DeepSeek Harness: model-guided selective memory, an evolving user profile, three-layer progressive disclosure, and native conversation-prefix reuse for emotional companionship.
设计
| 机制 | 做什么 |
|---|
| 主动维护用户画像 | 新经历补充或修正对用户的理解；完整画像始终参与后台取舍，不靠本轮检索碰运气。 |
| 原始记忆 → 提炼记忆 → 简短总结 | 保留原话与来源，提炼意义和情境，用短总结作为检索入口。 |
| 相关才入选 | 只比较简短总结的语义相似度，达标才进入候选，最多24条，可以是0条，不硬凑。 |
| 渐进披露 | 模型自己决定看提炼内容，还是进一步核对原始来源。 |
| 缓存与总结复用 | 尽早复用刚完成的原生会话前缀，沿用已有总结，阶段成功结果可恢复，减少重复整理。 |
| 理解可以改变 | 今天想听建议，就按今天的需要回应；画像帮助理解，不把用户定型。 |
缓存是否实际命中由模型提供商决定，插件不承诺固定命中率。相似度只用于本轮相关性，不用来判断长期情感价值。
安装
已验证环境：Node.js 24+、DeepSeek Harness 0.2.1-rc.2、Cordis 4.0.5。先在宿主中配置好模型与凭据，插件复用宿主，不需要再填写模型 API Key。
在常用的 web profile 中安装发布包：
dsh plugin --profile web add https://github.com/123zxs345/dsh-plugin-companion-memory/releases/download/v0.3.2/dsh-plugin-companion-memory-0.3.2.tgz
也可以从固定版本的 Git 仓库安装：
dsh plugin --profile web add "git+https://github.com/123zxs345/dsh-plugin-companion-memory.git#v0.3.2"
重启 dsh web。组合包会在当前 profile 下加载 companion-memory，数据保存在该 profile 的 companion-memory/ 目录。Git 仓库包含可安装的编译结果，使用者无需先构建源码。
使用 DSH 的「自定义插件索引」时，可以在「发现 → 添加索引源」填入：
https://raw.githubusercontent.com/123zxs345/dsh-plugin-companion-memory/main/market/index.json
语义召回使用宿主已有的 Hindsight chunks 服务。在当前 profile 的 cordis.patch.yml 配置它的地址：
- id: companion-memory
config:
dataDir: !!js "ctx.get('profileContext').dir + '/companion-memory'"
companionId: default
idleReviewSeconds: 15
reviewMaxDelaySeconds: 60
candidateBudget: 24
minimumSimilarity: 0.55
contextTokens: 800
hindsightUrl: http://127.0.0.1:8888
将地址替换为你的实际服务。profile 补丁会替换整个 config，请保留数据目录及已有自定义配置。未配置检索服务时，本地SQLite与后台画像维护仍然保留，额外经历候选为空，不用无关内容补位。插件不会自动下载嵌入模型或另起数据库；外部服务由宿主管理。
默认用于一个主人的 profile。多用户部署请使用隔离的作用域、独立 companionId 和数据目录。
使用示例
以下为虚构示意：
用户：以后我说累了，先听我吐槽两句，别急着给建议。
模型可以将它提炼成：疲惫时希望先被倾听，并保留适用情境与原话依据。另一天出现“今天我想听听你的办法”时，当前表达优先，也可以修正已有理解。
默认安静15秒后尝试整理；持续聊天时，从首个完整待整理交互起最多等待60秒，生成回复期间会等待其结束。普通闲聊可以不形成长期记忆。上述时间是本地调度目标，不是提供商缓存TTL。
插件给宿主模型提供 recall_memory 与 read_memory，聊天先看到摘要；需要时再展开意义或原话。后台模型决定记忆变化，执行层只检查来源、容量、依赖和事务一致性。
程序化接入
在创建或恢复宿主 Agent 之前加载：
import { resolve } from 'node:path';
import CompanionMemory from 'dsh-plugin-companion-memory';
await root.plugin(CompanionMemory, {
dataDir: resolve('.dsh-companion-memory'),
companionId: 'my-companion',
hindsightUrl: 'http://127.0.0.1:8888',
candidateBudget: 24,
minimumSimilarity: 0.55,
});
root 是已有的Cordis Context，需提供 agents、systemPrompt、tools、llm 服务。插件不替换宿主人设。使用 createCompanionMemoryPlugin({ runModel, isBudgetError }) 可接入宿主的人民币预算与结算。
加载后通过 root.companionMemory.reviewNow('preview') 预览整理计划，通过 applyPreview() 应用；userProfile() 读取当前画像。设置 idleReviewSeconds: 0 可关闭自动调度，保留手动整理。
完整架构、三层披露、画像修正、遗忘与详情释放、预算适配、作用域及控制器接口见技术说明。
数据与卸载
记忆存入本地SQLite。模型整理会使用宿主的模型服务；启用Hindsight时，短总结也会送到你配置的检索服务。插件不额外保存宿主API密钥。删除插件记忆不等于删除宿主原始聊天或微信、QQ平台记录。
dsh plugin --profile web remove dsh-plugin-companion-memory
卸载后重启宿主。数据目录保留，是否删除由你决定。
从源码构建
在这个独立仓库的根目录执行：
npm ci
npm run check
npm run build
npm pack
测试使用虚构资料和宿主模型桩，不调用付费模型API。源码、类型声明与编译结果均开放。问题和改进建议请提交到Issues。
许可
MIT。依赖及用途见第三方声明。
