dsh-auto-memory v0.1.30
DEEPSEEK HARNESS联想记忆插件

让 AI
真正记得你

记忆不靠调用，自己被唤回。

市面记忆方案都要求模型"记得去查"——忘了调，记忆就等于不存在。本插件是 Host 侧主动联想中间件：持续观察对话情境，NLP 关键词 + 向量化双轨检索，该想起的记忆在模型开口之前，经固定边界注入下一环节。

GitHub npm
BSD-3-Clause 零运行时依赖 前缀缓存友好 记忆在你自己的机器上
0次
需要模型主动调用记忆
3级
检索算力：词法 / 内置向量 / BGE-M3
R@5 0.925
BGE-M3 int8 档实测召回（与 fp32 差 0.000）
100%
激活决策带证据链，可逐次复核打分
01核心管线

从对话到记忆注入，四站直达

观察 → 检索决策 → 投递闭环。NLP 关键词与向量化双轨并行，唤起必要性由统一策略管线回答——每一步都有 JS 权威层做最终仲裁，AI 只在边界内干活。

A · 观察

监听对话与工具事件

持续观察每轮对话、工具回包、用户/助手事件，定位有"长期价值"的内容。

  • 用户消息 + 工具结果实时锚定
  • 子代理静默评估（不打断主流程）
  • 闲聊 / 失败进重试队列（5 分钟心跳）
B · 检索与决策

双轨检索 + 两车道决策

先按相关性排序（词法 BM25 保底 / 内置向量 / BGE-M3），再按"该不该打断你"两车道分流。

  • 词法 0GB 保底 → 内置语义 ~130MB → Python BGE-M3 进阶
  • canary 显式唤起 / shadow 仅记录不注入
  • 决策全程可打分复核（A/P/S/H/E）
C · 投递闭环

固定边界注入 + 证据反馈

提示词字节级稳定，前缀缓存持续命中；每次投递留下 delivered/seen 证据喂回决策。

  • 固定边界注入（前缀缓存友好）
  • delivered / seen 证据回流
  • 「唤起回顾」页可逐次打分 + 政策提示
权限分立 决策全程可复核，记忆治理永远在 JS 权威层。 AI 子代理只产出"建议"；是否写入、是否注入、是否唤起——最终决策都跑在 Node 端的 JS 权威层里；任何一次决策都能在「唤起回顾」页追溯原始证据与上下文。
SYSTEM LAYERING · 运行时分层 完整交互架构图 →
JS 记忆核心 · lib/*_pre.js · 零运行时依赖
Python sidecar · 可选 · lazy spawn
可观测 / 待发布
live verified 已实现并实机验证 tested 已测试 queued 排队 · 语义层决定"想起什么"，权威层决定"是否/何时/如何注入"——Python 不创建证据，也不直接注入。点击模块查看实现摘要。
dsh-auto-memory 主视觉：不用吩咐，她自己记得 欢迎向导：每个功能、当场看懂、当场开关 唤起与固化：对话凝成技能，每一步有迹可循 无人值守模式：整夜安静跑，零寒暄，零打扰 外部记忆继承：你的其他 AI，也在喂她记忆 定时暖心问候：让每一天都被记得
GALLERY · 六幕
DESIGN PAPERS · 设计文献（全部结论冻结为工程决策）
01 多语言嵌入式检索选型研究3 模型 × 5 分块 × 6 通道 ≈ 90 评测单元，BGE-M3 全面领先；冻结为 D1–D11 工程决策 → 02 从语义相关到唤起必要：回声陷阱的发现、度量与修正激活策略 v2 技术报告 + 双轨部署架构（§7）；67 条人工金标 held-out 验收 actPrecision 0.917 → 03 嵌入基准报告模型/分块/融合冻结依据：bge-m3 + para-512-noov + 加权融合 → 04 算法冻结决策 D1–D11全部研究结论到生产实现的决策台账 → 05 Held-out 人工金标验收67 条标注打分：actPrecision 0.917 / harmfulEmit 0 / echo 层 7/7 → 06 Python Sidecar 完整契约协议/生命周期/权威边界/各里程碑回归证据（§19.x） →
02功能全景

十二个能力，互相咬合

逐项展开，不省略——你想知道它"到底能干什么"，往下读就对了。

3.1 · 三层记忆体系

三处文件，三种语义

用户级 → 项目笔记 → 每日日志/反思，越往下越新鲜、越往上越稳定。注入策略按这个分层严格区分：静态纪律进 system prompt 保缓存，动态记忆只取最近 1 天，其余按需 recall。

层
位置
内容
用户级记忆
~/.dsh/memory/MEMORY.md
跨项目规则与偏好
项目笔记
workspaces/{ws}/MEMORY.md
项目约定与决策
每日日志
workspaces/{ws}/YYYY-MM-DD.md
追加式工作日志
每日反思
…/reflections/YYYY-MM-DD.md
结构化复盘（成果/教训/下一步）
MEMORY HUB
memory hub
  • 静态纪律进 system prompt：字节级稳定 → 前缀缓存持续命中
  • 动态记忆走运行时快照：只注入最近 1 天日志+反思摘要
  • 凭证/密钥段永远被过滤在提示词之外
3.2 · 自动沉淀

记忆自己写自己

每轮对话结束，一个小型子代理静默评估本轮内容——长期有价值的主题分组写入今日日志（## 主题（HH:MM） + 要点），长期决策晋升项目笔记，跨项目规则晋升用户级，闲聊跳过。

  • 主题分组：## 主题（HH:MM） + 要点列表
  • 长期决策 → 项目笔记；跨项目规则 → 用户级
  • 失败入队，每 5 分钟重试；15 秒心跳文件证明循环存活
  • 每日写入有预算 + AI 自动压缩——超限不拒写
AUTO-CONSOLIDATION
overview
3.3 · 欢迎向导（v0.1.30 大更新）

不是弹窗广告，是功能总开关

升级或首装后自动播放的分步向导——Office/Fluent 式液态玻璃应用图标族，每项功能当场开关立即生效；中途关闭会先落到"完成提醒"步，告诉你每个功能在设置的哪个分区重新打开。

  • 每步一枚专属动效图标（注入青蓝 / 问候暖金 / 日历青绿 / 引擎紫蓝 / 雷达天青 / 完成珊瑚金）
  • 三级检索引擎在向导内自动检测 + 一键安装（SHA256 校验 + 推理自检）
  • 外部记忆实时扫描：WorkBuddy / Claude Code / Codex 等来源直接列出，逐源勾选
  • 升级用户一次性触达：v0.1.30 起所有用户升级后自动播放一次
  • 设置 → 外观 → 欢迎向导 → ▶ 重看引导 随时重新打开
WELCOME TOUR
tour welcome
3.4 · 唤起与技能固化

该出手时才出手

联想式记忆唤起在对话链中检测回忆需求，命中即注入下一环节（不破坏前缀缓存）；高频流程固化为技能 checklist 自动附上，跨会话验证后晋升——每一次"要不要打断你"的决策都能在「唤起回顾」页复核打分。

  • 决策打分：A 该激活 / P 只预取 / S 应抑制 / H 有害 / E 改目标
  • 技能晋升四态：observed → candidate → validated → active
  • 90 天未用自动归档，可手动置顶
  • 判定队列会汇总成政策提示，反哺自动决策
RECALL REVIEW
refine
3.5 · 无人值守模式

面向长跑批处理任务

设置 → 自动化提供手动开关与夜间自动托管（22:00-08:00 可调）；托管期间不注入欢迎语/寒暄/行为指令、日历提醒静默、上下文保持稳定——模型专注干活，token 花在正事上。

  • 零寒暄 / 零行为指令 / 日历静默 / 上下文冻结
  • 时间窗可调（默认 22:00-08:00）
  • 来源：社区 Issue #10 反馈驱动的加固场景
0
托管期间注入的寒暄
10h
夜间默认托管窗口
100%
上下文稳定（不增删）
UNATTENDED
tour toggles
3.6 · AI 问候与每日反思

时段感知 + 暂离回归 + 每日复盘

按时段（晨/午/晚）生成提及你当日最重要工作的问候；暂离超过 1 小时回来，记忆面板自动打开并送上"欢迎回来"+近期工作摘要；每天第一次会话主动呈现前一日结构化反思。

  • 时段问候：晨/午/晚，提及当日工作要点
  • 暂离 >1h 回归自动开面板 + "欢迎回来"
  • 每日第一次会话：前一日结构化反思
OVERVIEW
overview
3.8 · 日历 — AI 替你维护

截止日期从对话里"长出来"

AI 从对话中识别截止日期/约定自动入日历（calendar_add），未完成事项注入后续会话直到完成；日视图 07:00-22:00 时间轴、地点/提醒字段、紧急度语义色。

  • 自动从对话识别 deadline / 约定 → 入日历
  • 未完成项注入后续会话直到完成
  • 07:00-22:00 时间轴 + 地点/提醒字段 + 紧急度语义色
CALENDAR
calendar
3.9 · 外部记忆继承

别让别处的经验白攒

WorkBuddy / CodeBuddy / Claude Code / Codex 的历史会话与记忆可扫描发现、按源导入（只存路径指针，不复制内容）、按源删除；导入侧 + 注入侧双重卫生闸门防外部脏数据混入。

  • 扫描发现：WorkBuddy / CodeBuddy / Claude Code / Codex
  • 按源导入：只存路径指针（不复制内容）
  • 按源删除 + 双重卫生闸门
EXTERNAL SCAN
external scan
3.10 · 记忆卫生（生产级）

写入门禁 + 脏 token 扫描

三个写入工具全部过 sanitizeForWrite：GBK 乱码（34 特征全表）、复读退化、连续重复行、外部 AI 画像 JSON 特征、base64 残留——全部拒写并给出中文回执。设置 → 调试中心「扫描脏 token」一键按行区间报告问题（只报位置不含正文）。

  • 34 个 GBK 乱码特征全表识别
  • 复读退化 / 连续重复行 / 外部画像 JSON / base64 残留
  • 追加 8000 字/条；全量改写 20 万字上限
  • 追加前与文件尾部近 60 行做去重
HYGIENE
tour core
3.11 · 记忆生命周期

30 天蒸馏：把过程流水换成可复用结论

memory_maintain_pre 把 30 天前的每日日志交给 AI 蒸馏：只提炼有跨会话长期价值的要点（技术决策/架构约定/偏好/踩坑规则），写入项目笔记；原文保底归档到 archive/（AI 不可用时降级为原样归档，绝不丢信息）。

  • 30 天蒸馏窗口：旧日志 → 长期要点 → 项目笔记
  • 蒸馏明确边界：procedure skills（技能固化）与两级笔记不在蒸馏范围
  • 归档原文不在常规检索扫描内（检索=项目笔记+活跃日志+反思+用户级）
  • 蒸馏要点随笔记常驻注入
  • memory_consolidate：AI 发散固化（阶段性回头升格）
LIFECYCLE
hub
3.12 · 工程内核（信任背书）

保持克制的设计

这些不是"特性"，是"在你能用它之前先让你放心"的工程承诺——少一点跑得快的东西，多一点能跑得久的东西。

  • 零运行时依赖（仅 Node 内建模块）
  • 前缀缓存友好：提示词字节级稳定
  • 限额 AI：自动沉淀每日 ≤8 次带冷却
  • 集中式存储：~/.dsh/memory/workspaces/
  • 可选 Python sidecar（BGE-M3 int8，失败自动回退词法）
ENGINEERING
engineering
04快速开始

三步安装，一条命令

前置：安装 DeepSeek Harness 并至少启动过一次 dsh web。

01安装包

在 profile 目录（~/.dsh/profiles/web）执行：

bash
cd ~/.dsh/profiles/web
pnpm add @a9i5k4/dsh-auto-memory

没有 pnpm？npm install @a9i5k4/dsh-auto-memory 同样可用。

02注册到 profile

编辑同目录 package.json，在 dsh.profile.bundles 数组追加：

json
"dsh.profile.bundles": [
  "...",
  "@a9i5k4/dsh-auto-memory"
]

03重启生效

重启 dsh web——侧边栏出现「记忆」入口，进入即触发欢迎向导。

bash
dsh web

↻更新

设置 → 自动记忆页「检查更新」按钮可一键比对 npm 最新版；或直接：

bash
cd ~/.dsh/profiles/web
pnpm up @a9i5k4/dsh-auto-memory

AI 时代 让 AI 帮你装

复制下面这段发给你正在用的 AI 助手即可：

prompt
在 DeepSeek Harness web profile 目录 ~/.dsh/profiles/web 安装 npm 包
@a9i5k4/dsh-auto-memory（pnpm add 或 npm install），
把 "@a9i5k4/dsh-auto-memory" 追加到 package.json 的 dsh.profile.bundles 数组，
然后重启 dsh web 激活插件。

系统要求：dsh web 跑起来即可，Node 内建依赖足够；Python 档可选（用于 BGE-M3 进阶语义档，失败自动回退词法检索）。

05社区与链接

感谢这两位

dsh-auto-memory 不是一个"我一个人写的项目"——下面这两位是塑造产品形态的真正合作者。

ProperSAMA
github.com/ProperSAMA · PR #12
DSH Desktop 增强模式（透明 / Mica 材质）面板可读性修复 + 入口按钮防遮挡与外点/Esc 关闭。
nkh0472
github.com/nkh0472 · Issue #10
无人值守/批处理场景加固反馈——直接推动了欢迎向导与功能开关化。
GitHub npm License: BSD-3-Clause

欢迎 issue / PR——即使只是改一个标点或一句文案，也算参与。