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 倉庫。