highland0971/dsh-native-memory

为 DeepSeek Harness（dsh）打造的原生、按工作区隔离的长期记忆：事实与档案存放在 harness 自带的 storage-domain 上，跨会话回忆走 session-query 全文检索，写入必须经人工审批，且每条记忆都带来源引用——不需要外部服务器，不引入额外运行时依赖。

⚠️ 安装插件即在本机以你的权限运行第三方代码。安装前请审阅源码（src/）与安全模型。

与其他方案的对比

	dsh-hermes-memory	dsh-native-memory
存储	~/.dsh/settings.yaml 命名空间	独立 storage-domain 单元（~/.dsh/storages/dsh_memory.json）
作用域	用户全局、跨项目混用	按工作区隔离（精确 cwd 授权）
写入安全	模型静默写入	人工审批门 + 会话日志审计
回忆方式	全部常驻注入（硬上限）	有界常驻档案 加 按需召回 + 历史会话全文检索
依赖	需把文件塞进 harness checkout 用相对导入	仅 zod + harness 本身

完整架构与竞品分析见 docs/design.md。

安装

dsh plugin --profile web add dsh-native-memory   # 发布后从 npm 安装
dsh plugin --profile web add /path/to/this/repo  # 从本地检出安装

重启 dsh web。插件会开启 session-query 全文检索，并为所有会话注册记忆工具。配置方法见 docs/install.md。

工具

工具	类型	审批
memory_remember	在本工作区新增/更新一条事实（默认拒存密钥形态文本）	需要
memory_edit	替换一条事实	需要
memory_forget	归档一条事实（软删除）	需要
memory_recall	确定性三档关键词扫描（标签 > 文本 > 模糊；档内按新鲜度/访问频次决胜）	不需要
memory_search	全文检索本工作区的历史会话（排除当前会话）	不需要
memory_expand	把事实引用展开回原始日志摘录	不需要
memory_consolidate	近重复合并建议 + 容量预算	不需要
memory_import	从历史会话日志导入候选事实	需要（逐条）
memory_profile	读取常驻注入的工作区档案	不需要
memory_export	写出 git 友好的 Markdown 镜像（.dsh-memory/memory.md，已打码、幂等）	不需要

每条事实都记录来源 (sessionId, seq)——记忆始终可从无损会话日志还原。

写入默认拒绝密钥形态文本（token / 密钥 / 密码）；bundle patch 里 secretPolicy: "mask" | "off" 可放宽。凭据赋值检测可能误伤 ≥16 字符的良性 token: … 值。注入与工具输出恒打码。

浏览器只读页面（设置 → 记忆）列出所有工作区的事实（密钥已打码）；删除会复制为一条 memory_forget 指令，在对话中经审批门执行。

可选会话末提议（proposeOnSessionEnd: true）：一次廉价 LLM 调用把结束的会话蒸馏为候选事实， 在后续会话中展示；只有经审批门 memory_remember 才会成为事实。

压缩漂移护栏（compactionGuard: true，默认开启）：压缩摘要丢掉的字面锚点会在后续会话中 作为待核实数据浮现——确定性、零 LLM。

开发

pnpm install
pnpm build && pnpm typecheck && pnpm test

新贡献者从 docs/handoff.md 与 docs/contributing.md 开始。

许可证

MIT