记忆管理插件（dsh-memory-manager）

为 DSH（DeepSeek Harness）打造的记忆管理插件：跨会话记忆库、上下文计划注入、Agent 记忆工具与完整的对话侧栏面板。 Memory Manager for DSH — cross-session memory library, context planning & Agent memory tools.

---

功能特性

• 文件夹记忆库：以「文件夹 + Markdown」形式存放记忆（memories/*.md），front-matter 元数据，Obsidian 兼容，可直接用任意编辑器或图谱工具打开。
• 记忆 = 不可变快照 + 可编辑标注层：快照保存历史事实，`` 标注层可随时补充说明，互不污染。
• 印象（impressions）：每记忆可带少量简短标签，作为检索主键与图谱节点；支持 LLM 生成印象建议。
• 组合（composedOf）与双向链接（backlink）：可把多条记忆非破坏性聚合成一条组合记忆；links 自动建立反向引用索引。
• 上下文计划注入（systemPrompt section）：按会话维护一份注入计划（固定消息 + 勾选记忆），记忆模式开启后每次发送自动注入到模型的系统提示中，带单条 / 总量 / 固定消息三级字符上限。
• 4 个 Agent 记忆工具：memory_search / memory_recall / memory_save / memory_pin，可整体开关，模型可直接读写记忆库。
• 对话侧栏面板：四个标签页 —— 计划 / 记忆库 / 消息 / 图谱；从浏览器输入栏的「记忆」按钮或消息动作条直接操作。
• 跨会话共享：宿主级插件，记忆库数据跨会话共享，不受进程重启影响（存于磁盘）。
• 设置页自由开关：宿主启用后可在 DSH 设置页独立控制启用、注入模式、注入视图、工具开关、记忆库路径与字符上限。
• 非破坏性轮次排除 / 恢复：可把某轮对话排除出注入（不删除），随时恢复参与。

架构一句话

插件是宿主级（Host）插件：lib/index.js 为 Host 半区（ESM，注册 settings / 工具 / 注入段 / HTTP API / 事件），lib/client.js 为浏览器 Client 半区 bundle（window.__ModuleLoader__.load 包裹的 CJS），两者通过 HTTP 端点 /_dsh/memory-manager/api，以 {op, sessionId, args} JSON 信封通信。

安装与挂载

请参阅 docs/INSTALL.md —— 简要而言，把本包放入 DSH profile 的 node_modules，在 profile 的 package.json 的 dsh.profile.bundles 中登记 bundle（通过包内 cordis.patch.yml 以 insert 方式挂载进 profile 层栈），重启 DSH 即可。

快速开始

1. 按 docs/INSTALL.md 完成安装并重启 DSH。
2. 在浏览器打开对话，输入栏左侧出现「记忆 · 已关闭」按钮；DSH 设置页出现「记忆管理」区块。
3. 点击「记忆 · 已关闭」按钮打开侧栏面板；如记忆库为空，可先用示例库或「消息」页把某条消息保存为记忆。
4. 在「记忆库」页把记忆「加入计划」，或在「计划」页打开「临时记忆模式」（或将某条消息「固定」）。
5. 下一次发送消息时，模型系统提示即包含「=== 记忆库上下文 ===」注入段。