LoveDoLove/Veyra

Veyra

面向 DeepSeek Harness 的持久化工程记忆与知识观测台。

安装它，重启 DSH，然后继续工作。Veyra 会观察有用的上下文，记住持久的经验教训，为 RAG 文档建立索引，并通过统一的混合搜索将它们召回。它不会写入你的代码仓库。

安装

dsh plugin --profile web add @lovedolove/veyra

重启 dsh web。一次正常的启动看起来像这样：

[veyra] plugin loaded (home=...)
[veyra] registered /veyra
[veyra] registered skill: veyra
[veyra] registered tools: veyra_remember, veyra_recall, veyra_inspect, veyra_forget, veyra_promote

需要 Node 22.5+ 和 DSH >=0.1.2-rc.1。记忆存储在 $DSH_HOME/veyra/ 中。

日常使用

对于普通工作，你无需管理记忆。

1. 像往常一样在 DSH 中进行工程工作。
2. Veyra 会将该轮次提炼为一个候选（文件、符号、测试结果、断言信号，以及结构化的因果维度：symptom → rootCause → remedy → verifiedOutcome）。持久且有依据的经验教训会成为派生记忆，并与相邻记忆建立关联——被扩展、更新或产生矛盾。近似重复项不会被克隆；相反，重复的观察和已验证的测试结果会强化现有知识（unverified → reviewed → verified）并累积证据锚点。任何内容都不会被静默合并。
3. 之后在同一项目的会话中，相关的记忆和 RAG 知识会通过混合搜索自动召回（结合词法 FTS5 BM25 + 精确符号、token 级语义 Jaccard 重叠、意图亲和度以及关系图信号）。矛盾会保留在双方可见。被取代、与仓库漂移以及长期闲置未验证的记忆会退出环境召回。Canonical 永远不会被自动分配。

让智能体记住重要的事情，或者直接继续——自动召回已经开启。

混合搜索与统一 RAG

Veyra 统一了工程记忆（kind: 'memory'）和知识库 / RAG 文档（kind: 'knowledge'）：
- 词法：SQLite FTS5 BM25 排序，外加精确符号和文件路径加权。
- 语义：Token Jaccard 重叠和查询概念覆盖度。
- 记忆与因果：意图亲和度，对为什么优先考虑根因，对如何做优先考虑补救措施，对这修复了吗优先考虑已验证结果。
- 关系：图内聚性为相互关联的知识加权。
- 多维排序：复合评分，并提供完全透明的分解（relevance、semantic、evidence_strength、validation_tier、scope_proximity、freshness_tier、confidence、intent_affinity、relationship）。

命令与知识观测台

| 命令 | 作用 |
| --- | --- |
| /veyra | 此工作区的状态和记忆计数 |
| /veyra observatory | 打开人类知识观测台仪表盘 |
| /veyra observatory search  | 检查混合搜索信号和评分分解 |
| /veyra observatory record  | 深度检查，回答 6 个问题（What、Why、Where、When、Evidence、Validation） |
| /veyra observatory causality | 因果知识图谱（symptom → rootCause → remedy → verifiedOutcome） |
| /veyra observatory relationships [id] | 知识链接的有向图投影 |
| /veyra observatory local  | 某条记录周围的 1 跳局部图（默认图视图） |
| /veyra observatory graph [id] | 给定 id 时为局部图；否则为项目边列表 |
| Network Graph WebUI | 托管页面位于 /veyra?id=（局部图，默认 1 跳）。搜索 → 记录 → 图 |
| /veyra observatory contradictions | 并排显示活跃的冲突声明 |
| /veyra recall  | 混合搜索项目（+ 可复用）记忆 |
| /veyra recent | 最近 8 条记录，包括候选记录 |
| /veyra inspect  | 读取一条记录，包含深度溯源和因果切面 |
| /veyra forget  | 软遗忘（从召回中移除，仍可检查） |
| /veyra promote  canonical | 标记为项目真相——只有此状态才是 canonical |

同名工具（veyra_remember、veyra_recall、veyra_inspect、veyra_forget、veyra_promote）可供 agent 使用。当你需要完整指导时，加载捆绑的 veyra 技能。

记忆规则

| 内容 | 权威级别 | 自动召回？ |
| --- | --- | --- |
| 自动捕获的观察 | candidate | 否 |
| 记住 / 学到的经验 | derived | 是 |
| 显式提升的真相 | canonical | 是 |

Canonical 永远不会自动分配。仓库文件保持权威。相似不等于同一：重叠的记忆会被链接，而不是合并。机密会被脱敏。项目相互隔离；可复用记忆需主动选择启用。

配置（可选）

DSH Settings 暴露 Recall limit 和 Include reusable。recallLimit: 0 仅禁用自动召回记忆上下文——工具、/veyra、Observatory 和已存储记忆仍然可用。

在 profile cordis.patch.yml 中：

- id: veyra
name: '@lovedolove/veyra'
config:
recallLimit: 5   # 0 = no automatic recall context
includeReusable: true
observe: true
learn: true

VEYRA_HOME 覆盖存储根目录。observe / learn 仅保留在 yaml 中。

许可证

MIT