前言¶
DeepSeek Harness (DSH) 的設計理念是「一切皆插件」，通過擴展能力來覆蓋智能體開發中的不同需求。在開發編碼智能體時，一個常見的問題是上下文丟失：智能體在會話之間無法記住之前的決策、教訓或項目結構，導致重複造輪子或重複犯錯。
Veyra 旨在解決這一問題。它爲 DSH 提供了「持久工程記憶」與「可選的 AST 代碼智能」的 Dual-Brain（雙腦）架構。插件不依賴外部 API 密鑰，通過純 ESM 模塊運行，讓智能體具備跨會話的記憶能力。
Veyra 是什麼¶
Veyra 是由 LoveDoLove 維護的一個 DSH 插件，核心功能是提供持久化、證據自洽的工程記憶，並支持可選的結構化代碼分析。它將「工程決策記憶」（如根本原因、修復方案）與「代碼結構真理」（如調用圖、符號表）分離，幫助智能體在執行任務時既能調用過往經驗，又能精準定位代碼結構。
安裝與啓用¶
安裝過程依賴 DSH 的插件管理工具。安裝後需要重啓或重載配置文件以激活插件。
- 運行安裝命令：
dsh plugin --profile web add @lovedolove/veyra
- 重啓 DeepSeek Harness 或重載當前配置文件，Veyra 將自動激活。
前置條件：系統需安裝 Node.js，版本範圍在 >=22.5.0 且 <25.0.0 之間。
Dual-Brain 架構¶
Veyra 通過兩層互補的架構來回答不同類型的問題：
- Veyra Memory（記憶腦）：存儲工程層面的經驗教訓，包括根本原因、決策約束、因果鏈（症狀 → 根本原因 → 修復方案 → 驗證結果）以及驗證狀態。這是跨會話累積的「知識狀態」。
- Code Intelligence（代碼腦）：提供 AST 級別的結構化事實，包括符號、文件、調用圖、類層級關係。這些數據始終直接來源於當前倉庫，而非記憶。
這兩者互不衝突。當代碼結構發生變化時，代碼智能層會標記相關記憶爲「可能陳舊」，但絕不會靜默覆蓋記憶腦中的內容。
核心功能¶
- 持久工程記憶：每條記憶都攜帶證據錨點、驗證狀態（未驗證 → 已審閱 → 已驗證）和權威等級。Veyra 不會修改倉庫文件，倉庫文件始終是權威來源。
- 混合搜索：支持 FTS5 BM25 全文搜索、符號/路徑加權、語義重疊以及意圖親和度（爲何/如何/發生了什麼）的綜合評分，並透明展示分數拆解。
- 變更感知：智能體會自動感知倉庫變更。變更摘要會引導記憶檢索，Veyra 會檢查記憶的證據錨點是否指向被修改或刪除的代碼，並對陳舊記錄應用檢索懲罰。
- 健康檢查與維護：提供
veyra_health命令和 Web 界面查看記憶健康度。內置的memory-maintenance技能提供生命週期管理動作（保留、覆蓋、失效、遺忘、墓碑、重新驗證），需顯式請求執行。 - Web 界面：在 DSH Web 中訪問
/veyra，可查看只讀的「知識觀測站」和交互式的「網絡圖」。
Code Intelligence（可選）¶
AST 級別的代碼智能是可選的。它依賴外部工具 codebase-memory-mcp 提供結構化數據。
- 安裝原生引擎（如需啓用 Code Intelligence）：
curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash
- 降級模式：若未安裝該二進制文件，Veyra 仍可正常運行記憶功能，所有 Code Intelligence 工具將返回包含安裝指引的結構化錯誤，不會中斷記憶功能。
典型用法¶
Veyra 提供了一系列 Slash Command 供智能體和用戶交互。
- 查看最近記錄：
/veyra recent
- 檢索記憶：
/veyra recall sqlite wal
- 深度檢查與驗證：
/veyra inspect vey_...
- 記憶管理：
/veyra forget vey_... # 軟遺忘，保留可檢查性
/veyra promote vey_... canonical # 顯式提升爲權威記憶
在 Web 界面中，訪問 /veyra 可以查看知識圖譜和本地網絡圖，訪問 /veyra?id=<record> 可聚焦查看單條記錄的 1 跳局部圖。
注意事項¶
- 包體積：該插件爲純 ESM 包，打包後約 180 kB。
- 權限：Veyra 以當前 DSH 進程權限運行，讀取倉庫內容。
- 安全：在使用前應檢查源碼與許可證（MIT）。
- 倉庫保護：Veyra 僅讀取倉庫，絕不寫入文件。記憶的權威性來源於倉庫文件本身。
- 無外部依賴：基礎記憶功能無需 API 密鑰或外部服務。
