前言¶
在智能体开发中，对话记录通常不被视为真正的记忆。为了让 Agent 在多轮交互中具备连续性，需要一种机制将信息沉淀下来。DSH-KRouter（dsh-krouter）旨在为编码 Agent 提供一个“第二大脑”。它将“昨天”的思考过程密封并提炼至 Obsidian，使“明天”的 Agent 能够直接命中该页面，而不是依赖上一次对话的向量转储。
插件定位¶
dsh-krouter 是一个基于 MIT 许可证的 Memory（记忆）类插件，由开发者 398894496-arch 维护。它充当 Agent 的知识操作系统（OS），核心目标是解决 Agent 记忆的持久化与检索问题。
核心功能¶
该插件通过以下机制实现记忆功能：
-
自进化（默认开启计时器）
插件默认开启计时器，负责每日的自我进化。它将每日的交互内容进行提炼，自动写入 Obsidian vault。 -
Obsidian 沉淀
每日的思考会被蒸馏并写入 Obsidian vault，作为后续检索的依据。 -
检索锁定机制
检索基于“锁定”而非向量相似度。系统将一个短名词映射到特定的页面，并使用双 SHA-256 校验。这种机制避免了向量数据库的复杂性，同时保证了检索的准确性。 -
五道门与自动方法
当“五道门”检查通过后，系统会自动生成临时的（provisional）方法写入 vault，无需人工干预。在后续遇到相似任务时，系统会询问用户是否采纳。 -
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
注意事项¶
-
资源要求
插件不依赖 GPU、Docker 或嵌入守护进程。它使用 Python3 和 ripgrep (rg) 进行本地检索，对硬件要求较低。 -
检索机制
插件不使用向量数据库。检索完全基于名词到页面的锁定映射，这要求在canonical_sources.psv等文件中维护准确的映射关系。 -
默认行为
计时器默认是开启的。这意味着插件会定期执行自进化流程。
总结¶
dsh-krouter 是一个为 Coding Agent 设计的记忆系统，它通过将每日思考提炼至 Obsidian 并采用“锁定”检索策略，实现了记忆的持久化和可复现性。对于需要长期记忆和多轮推理的开发场景，该插件提供了一个轻量级、无向量数据库依赖的解决方案。
- GitHub 仓库: https://github.com/398894496-arch/DSH-KRouter
- 插件目录: https://www.skillhub.cn/plugins/398894496-arch/DSH-KRouter
