dsh-project-memory：DeepSeek Harness 的持久项目记忆插件

它是做什么的？

dsh-project-memory 是 DeepSeek Harness（DSH）的持久项目记忆插件，为 DSH 智能体提供按工作区存储的项目索引。它解决智能体反复重读整个项目才能定位信息的问题，通过索引文档（PDF/Markdown/txt）和代码符号，并自动刷新，让智能体快速重定向。核心能力包括文档索引、代码符号表、自动刷新、文档与代码交叉链接、BM25 检索和经验笔记，且开销极小。

核心功能

• 文档索引：将 PDF、Markdown 和纯文本文件分块并由 LLM 总结，每条记录带有 path:line 引用。
• 代码符号表：无依赖的源码扫描器提取函数、类和方法名，不消耗 LLM token。
• 自动刷新：后台轮询（watch_repo）通过内容哈希检测新文件或变更文件，仅重新索引变更部分。
• 读时索引：文件在模型实际读取时（fs/observed）被索引，索引是正常工作的副产品，未读文件不会被索引。
• 文档↔代码交叉链接：文档提及符号时记录为引用，查询符号时也返回描述该符号的文档。
• BM25 检索：对文档、符号和经验笔记进行排序搜索，支持 LLM 查询扩展，并针对中日韩（CJK）优化，包括短语加权、同义词表和 CJK 感知的词边界。
• 经验笔记：记录问题→解决方案，相似问题会取代而非重复，笔记存储有界（100–2000 条），超出时修剪最旧笔记。

怎么使用这个插件？

在 DSH 中启用后，智能体自动调用工具，用户只需自然提问，例如“索引这个项目”或“auth 模块是做什么的？”，或继续正常工作，智能体会自动调用匹配工具。默认（lazyIndexing）下，文件在模型读取时被索引；watch_repo 保持显式监视的根目录后台刷新；index_repo 强制完整回填项目（跳过未变更文件）。可用工具包括 index_doc（索引单个文档）、index_repo（索引整个项目）、watch_repo（启用自动刷新）、memory_stats（显示存储统计）和 query_memory（BM25 搜索）。