dsh-project-brain：DSH 持久化项目智能与记忆插件

前言¶

DeepSeek Harness（DSH）的会话通常是短周期的，而真实的软件开发项目是长期演进的过程。上下文信息往往散落在多次对话中：架构决策的缘由、生产环境的修复方案、当前的开发进度和关键文件路径。dsh-project-brain 插件旨在解决这一问题，将分散的上下文转化为项目本地化、结构化的知识层。

插件概览¶

这是一个为 DSH 提供持久化项目智能与记忆的插件。它分析当前工作区，生成架构报告，保存决策和开发历史，并在未来的会话中恢复正确的上下文。与每次对话都需要重新扫描仓库不同，该插件将结构化知识存储在项目内部，随着项目的演进而不断丰富。

核心功能¶

项目感知与分析：自动检测语言、框架、工具、入口点、清单、README 元数据、符号和导入。生成覆盖项目目的、架构风格、概念层、组件职责、关系、运行时流、关键文件、阅读顺序和风险的架构报告。
跨会话记忆：持久化决策、需求、架构笔记、bug、教训、变更、TODO 和时间线事件。在新会话中，通过 DSH 系统提示自动恢复高价值记忆和活跃 TODO。
本地检索与后备：本地 BM25 检索是零配置默认值。架构生成和记忆检索具备本地后备路径，即使在 AI 不可用的情况下也能工作。
备份与恢复：支持 project_export、project_import 和 project_rollback_backup 工具，允许将项目脑导出为 zip 文件并在不同机器间还原或回滚到历史版本。

安装与配置¶

环境要求：插件依赖 Node.js 环境，要求版本 >= 22.19.0。
配置注意：在设置页面的配置项修改后，如果未保存，更改不会立即生效。

典型用法¶

初始化分析：在首次打开项目目录的会话中，插件会自动扫描并激活项目脑，生成架构报告。
恢复上下文：在新的 DSH 会话中，系统会自动注入高价值记忆和待办事项，避免重复解释项目背景。
备份与迁移：使用 project_export 将当前项目脑打包；在另一台机器上使用 project_import 恢复，支持自动预览影响清单和版本回滚。

工作原理¶

插件通过以下流程运作：

Active DSH Session
       │ trusted live Session cwd
       ▼
Workspace scanner ───────► project facts and source evidence
       │
       ├──► current DSH LLM ───► semantic architecture report
       │          │ unavailable / timeout / invalid output
       │          └────────────► local architecture fallback
       │
       ├──► .project-brain/ ───► memory, TODOs, timeline, architecture
       │
       ├──► context injector ──► next Session system prompt
       │
       └──► Connection RPC ────► Dashboard and TodoStri

结语¶

该插件通过本地化和持久化机制，解决了 AI 编程助手会话碎片化的问题。其默认的本地 BM25 检索机制降低了使用门槛，而架构生成与记忆检索的双重后备路径保证了在特定网络环境下的可用性。更多细节可参考其 GitHub 仓库。