前言¶
在 DeepSeek Harness（DSH）智能体开发中，跨会话继续任务时容易缺少项目上下文。dsh-project-memory 是一个 DSH 插件，用于把文档、代码符号、经验记录和任务状态保存为项目记忆，供后续会话召回。
下面介绍它的定位、核心能力、典型用法和注意事项。
这是什么¶
dsh-project-memory 由 00080000 维护，分类为 memory，许可证为 MIT。它为 dsh agents 提供持久项目记忆。
该插件按项目保存数据在磁盘上，不使用向量数据库。运行时为纯 JavaScript，唯一 runtime dependency 是 pdfjs-dist，用于 PDF 文本提取。
核心能力¶
文档与代码符号记忆¶
插件支持 PDF、Markdown、plain text 文件记忆，条目带 path:line citations，便于回源核对。
它也记录代码符号，保留完整类型签名。L1 regex 提取覆盖 generics、parameter/return types、overloads、interfaces、type aliases。
如果用户项目中安装了 typescript，可以启用可选的 TypeScript semantic enhancement（L2/L3）。启用前可在项目内安装 TypeScript：
npm i -D typescript
如果不需要该增强，可以关闭配置项：
enableTypeScript: false
自动刷新与读取时记忆¶
插件通过 watch_repo 做内容哈希变化检测，自动刷新新增或变更文件。
文件被模型 observed/read 时也会进行 read-time memorization，也就是说记忆随正常开发读取产生，而不是必须提前全量扫描。
文档与代码符号之间会建立 doc ↔ code cross-linking。
召回与经验记录¶
使用 query_memory 可搜索 documents、symbols、experience notes。召回基于 BM25，并带有 CJK optimization。
召回结果带 path:line citations，用于验证来源。当命中 blind spot 时，query_memory 会给出 blindSpots-aware recall warnings，提示需要读源文件。
经验记录使用 problem → solution superseding，避免相似问题重复堆积。经验库容量有界，project-size capacity 被限制在 100–2000。
跨会话任务¶
TaskBridge 用于跨会话开发任务。新会话继续时，先 list_tasks，再 select_task 执行 bind、rename、unarchive。
query_memory 可以带任务类型：
type: 'task'
如果使用 all 类型：
type: 'all'
结果会附加 task-count hint。
用户侧可以使用 /tasks 命令查看 task stack、step progress、involved files、current session binding。
典型用法¶
1、在当前会话中读取项目文件。插件会在文件被模型 observed 时进行 read-time memorization。
2、需要查询时调用 query_memory，查 documents、symbols 或 experience notes。
3、确认返回条目的 path:line citations，再回源文件核对。
4、如果继续上一轮开发任务，先调用 list_tasks，再调用 select_task 进行 bind、rename 或 unarchive。
5、用户侧用 /tasks 查看当前任务栈、步骤进度、涉及文件和当前会话绑定。
安装与启用¶
当前资料没有提供可核实的官方安装命令，因此这里不给出拼接命令。可以访问插件目录页和 GitHub 仓库查看插件信息：
https://dsh-plugin.org/plugins/00080000/dsh-project-memory
https://github.com/00080000/dsh-project-memory
运行环境要求 Node >=18。如果启用 TypeScript semantic enhancement，需要在用户项目安装 typescript；如果不需要，可以设置 enableTypeScript: false。
适用场景与注意¶
适合在 DSH 智能体开发中使用，需要持久项目记忆、文档/代码符号召回、经验记录和跨会话任务的项目。
需要注意：
- 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
- 所有数据保存在项目磁盘上，使用前应确认目录权限和清理策略。
- TaskBridge auto-sync 需要 dsh build with session events +
todo_write；已核实资料提到 verified on0.1.2-alpha.x。在 older hosts 上，task tools 仍可作为 plain record list 使用。 - 召回警告提示 blind spot 时，应回到源文件确认，不要只依赖部分摘要。
相关链接¶
插件目录页：
https://dsh-plugin.org/plugins/00080000/dsh-project-memory
GitHub 仓库：
https://github.com/00080000/dsh-project-memory
