前言¶

在智能體開發中，對話記錄通常不被視爲真正的記憶。爲了讓 Agent 在多輪交互中具備連續性，需要一種機制將信息沉澱下來。DSH-KRouter（dsh-krouter）旨在爲編碼 Agent 提供一個“第二大腦”。它將“昨天”的思考過程密封並提煉至 Obsidian，使“明天”的 Agent 能夠直接命中該頁面，而不是依賴上一次對話的向量轉儲。

插件定位¶

dsh-krouter 是一個基於 MIT 許可證的 Memory（記憶）類插件，由開發者 398894496-arch 維護。它充當 Agent 的知識操作系統（OS），核心目標是解決 Agent 記憶的持久化與檢索問題。

核心功能¶

該插件通過以下機制實現記憶功能：

1. 自進化（默認開啓計時器）
   插件默認開啓計時器，負責每日的自我進化。它將每日的交互內容進行提煉，自動寫入 Obsidian vault。

2. Obsidian 沉澱
   每日的思考會被蒸餾並寫入 Obsidian vault，作爲後續檢索的依據。

3. 檢索鎖定機制
   檢索基於“鎖定”而非向量相似度。系統將一個短名詞映射到特定的頁面，並使用雙 SHA-256 校驗。這種機制避免了向量數據庫的複雜性，同時保證了檢索的準確性。

4. 五道門與自動方法
   當“五道門”檢查通過後，系統會自動生成臨時的（provisional）方法寫入 vault，無需人工干預。在後續遇到相似任務時，系統會詢問用戶是否採納。

5. Agent 知識 OS
   插件提供完整的路由（router）和寫入器，管理 Agent 的知識庫結構。

安裝與配置¶

安裝過程需要完成代碼克隆、虛擬環境創建及依賴安裝。請確保 Python 環境可用。

git clone https://github.com/398894496-arch/DSH-KRouter.git
cd DSH-KRouter
python3 -m venv .venv
. .venv/bin/activate
python3 -m pip install -r requirements.txt
./scripts/first_run.sh

配置 API Key：
API Key 必須配置。你可以將其粘貼在 template/ 目錄下的模板文件中，或者通過 ~/.dsh-krouter-keys.env 文件注入。系統會同時讀取這兩處配置。

典型用法¶

安裝完成後，可以通過腳本命令與插件交互。

1. 獲取建議與檢索
使用 krouter suggest 命令，系統會根據名詞返回建議。如果命中，返回收據；如果未命中，返回提示。

export OBSIDIAN_VAULT=/path/to/YourVault
./scripts/krouter suggest homz

2. 命中時的返回格式
當檢索成功時，命令會返回一個包含校驗信息的收據：

retrieval_status: canonical-match
canonical_source: /YourVault/Agent第二大腦.md
canonical_id: Q01
source_verified_at: 2026-01-01
source_sha256: d8c1d5af…
canonical_map_sha256: c55b8715…
canonical_match: true

注意事項¶

1. 資源要求
   插件不依賴 GPU、Docker 或嵌入守護進程。它使用 Python3 和 ripgrep (rg) 進行本地檢索，對硬件要求較低。

2. 檢索機制
   插件不使用向量數據庫。檢索完全基於名詞到頁面的鎖定映射，這要求在 canonical_sources.psv 等文件中維護準確的映射關係。

3. 默認行爲
   計時器默認是開啓的。這意味着插件會定期執行自進化流程。

總結¶

dsh-krouter 是一個爲 Coding Agent 設計的記憶系統，它通過將每日思考提煉至 Obsidian 並採用“鎖定”檢索策略，實現了記憶的持久化和可復現性。對於需要長期記憶和多輪推理的開發場景，該插件提供了一個輕量級、無向量數據庫依賴的解決方案。

• GitHub 倉庫: https://github.com/398894496-arch/DSH-KRouter
• 插件目錄: https://www.skillhub.cn/plugins/398894496-arch/DSH-KRouter