dsh-workspace-recollection 🧠

给 DeepSeek Harness 的跨会话长期记忆：按工作区隔离、跨会话共享。

DSH 的会话一关，上下文就散了。这个插件把「做过什么、当时怎么决定的、那个坑是什么」沉淀下来， 需要时再分层、按需地取回 —— 会话开始时只注入一行提示（告诉模型「你有记忆、去查」），用哪层取哪层。

核心是分层检索：想先看「大概有什么」就调 memory_index 拿目录（浅层要点，置顶在最前）；条目很长时，中间还有一层 段级引索 —— 先定位到「哪一段」，只把那一段取回来；深层原文（当时的思考、命令、结论） 留在本地向量库里，真要细节时才取。实测一条 1.5 万字的记忆取回一段约 1200 字，省 92%~97%。

---

快速开始（安装插件）

以下命令都在你的命令行终端（PowerShell / CMD / bash 等）中运行。

# ① 前置要求：确认 Node.js 已安装
node -v

# ② 安装 DSH 启动器与 pnpm（已装可跳过；装完请重新打开终端）
npm install -g @deepseek-ai/dsh pnpm
dsh --version   # 验证 dsh 命令可用

# ③ 安装本插件：--profile 填你实际在用的那个
#    桌面应用（Electron 版）→ desktop；dsh web → web
dsh plugin --profile desktop add dsh-workspace-recollection

装完重开桌面应用（dsh web 用户则重启 dsh web）才生效 —— 运行中的进程持有内存里的旧插件。 之后点会话头部的「🧠 记忆」（或设置页里的「记忆」）就能打开记忆面板。

兼容性：本插件在 dsh 0.2.0-rc.2 下开发并测试（dsh --version 可查看你的版本）。 建议使用相同版本；其他版本如遇问题欢迎反馈。

从源码安装（clone 本仓库后）

本插件是纯 JavaScript、无构建步骤 —— clone 下来就能直接挂载：

git clone https://github.com/reaxlll/dsh-workspace-recollection.git
dsh plugin --profile desktop add file:/path/to/dsh-workspace-recollection

改源码后重开应用即可（宿主半侧改动必须重启；浏览器半侧刷新页面即可）。

首次启动会自动装好嵌入模型

语义检索需要一个本地嵌入模型（Xenova/bge-small-zh-v1.5，512 维，ONNX 量化版约 23MB）。 不用你动手：插件启动时会检查它是否在位，缺了就自己从镜像（hf-mirror.com，失败自动回退 huggingface.co）逐个文件拉下来，下完自动加载 —— 实测 24MB 约 18 秒。 之后运行时零联网，也不调任何云端 API。

网络不通或下载失败也不会影响使用：memory_recall 自动退回关键词检索，其他功能照常； 面板状态条上的「加载模型」可随时重试。

💬 反馈与发版节奏

欢迎提 issue 与 PR —— bug、体验问题、优化想法都行。 可以随意对插件进行修改因为作者很可能没空维护，也对应了dsh那句，想要啥自己做(^_^) 但动手前请先翻一眼 提交记录， 确认不是已经修掉的同款问题。

• 小修不单独发版：不影响使用的小 bug 与优化会累计到下一个版本一起发。 所以「main 上已经修了」不等于「你装的这版已经包含」—— latest 没更新时，以 main 的提交记录为准。
• 报 bug 时请带上：插件版本、dsh 版本、操作系统、复现步骤（有日志或截图更好）—— 直接用 issue 模板 会把这些列好。
• 想改代码？先看 CONTRIBUTING.md：代码地图、三条硬规矩（纯函数要配单测 / 阈值必须用真实回放来定 / 约束行为要用代码而不是提示词）、常见改动配方，以及一份提 PR 前的检查清单。

插件功能

…