前言¶
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 密钥或外部服务。
