dsh-memory-engine 0.5.2 → 0.5.4

package/README.md

@@ -2,7 +2,7 @@
 
 DSH 插件的本地记忆引擎，带神经网络可视化。它让 agent 保存、召回和管理跨会话记忆，也能把你已有的记忆文件导进来。
 
-当前版本：0.5.1。Node ≥22，零新增依赖；DSH 宿主提供 `@deepseek-ai/dsh-tools@0.2.1-rc.3`。本机安装已启用，无需重复安装。
+当前版本：0.5.2。Node ≥22，零新增依赖；DSH 宿主提供 `@deepseek-ai/dsh-tools@0.2.1-rc.3`。本机安装已启用，无需重复安装。
 
 ## 界面
 
@@ -22,6 +22,57 @@ memory_map(out="D:\\memory-map.html")
 
 默认输出 `{DSH_HOME}/memory-engine/starmap.html`；未设置 DSH_HOME 时为 `~/.dsh/memory-engine/starmap.html`。`open` 默认 false，显式 true 才启动系统默认浏览器。
 
+## 装完是空库（重要）
+
+插件**不会自动读取任何东西**。装完那一刻记忆库是空的，图谱里一个神经元都没有。
+
+它只会读写自己的目录：
+
+```text
+{DSH_HOME}/memory-engine/
+  memories.json     记忆库
+  config.json       配置（可选）
+  starmap.html      生成的图
+```
+
+不会扫描硬盘、不会猜路径、不会去读你的聊天记录或其他机器人的数据。`DEFAULT_BRIDGE_ROOT`、`DEFAULT_DIARY_DIR` 默认都是空字符串——不配置就完全不读。
+
+记忆只有三个来源：
+
+1. **机器人自己存**：agent 调用 `memory_save`。DSH 里聊几句就有了。
+2. **你手动导入**：`memory_import(source="json"|"markdown"|"text", path="...")`，见下一节。
+3. **QQ 桥接同步**：只有配置了 `bridgeRoot` 的私有适配器才走这条，普通用户用不到。
+
+所以新用户装完的方向是：
+
+```text
+装完 → 空图 → 机器人边聊边存 → 几天后点开，图里是它自己的记忆
+```
+
+旧的历史数据不会自己进来，需要按下一节导入。
+
+## 怎么让机器人自己记记忆
+
+插件只会存取，**不会自己判断什么值得记**。要不要调 `memory_save`，由 agent 决定；它得知道该记什么。
+
+想让记忆真的长起来，在 agent 的提示词/角色卡里加一段（可直接复制）：
+
+```text
+聊天时遇到这些，用 memory_save 记下来：
+  · 对方的称呼、偏好、忌讳、习惯（kind="印象"，who 填对方名字）
+  · 答应过的事、约定、承诺（kind="对话"）
+  · 情绪特别重的瞬间（kind="事件"，heat=1）
+  · 新学到的知识、名词、梗的解释（kind="知识"）
+  · 每天结束时，用一两句写当天小结（kind="日记"）
+
+不用每条都记。一天三五条就够，宁可少存也别灌水。
+存之前先 memory_recall 查一下，避免重复。
+```
+
+**为什么必须写这段**：工具描述只说明「能存」，不会告诉模型「该存什么」。不写提示词的结果是——装了一周，图还是空的。
+
+这个插件的作者给自家机器人的做法是：除了上面的提示词，还额外跑一个夜间任务，从当天聊天记录里自动提炼印象（那部分不在本插件里，属于她的私有机器人适配器）。
+
 ## 保存和召回
 
 让 agent 使用：

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-memory-engine",
-  "version": "0.5.2",
+  "version": "0.5.4",
   "description": "Local DSH memory engine with neuron network visualization and private file import",
   "keywords": [
     "dsh",