一、项目定位与目标受众

YantrikDB（仓库 yantrikos/yantrikdb）是一个面向 AI 代理的内存子基板（memory substrate），以单一进程内嵌引擎的形式提供长期记忆能力。它既不是通用关系型数据库，也不是纯粹的向量库，而是把记忆图（memory graph）+ 向量近邻检索 + 元数据/置信度治理统一在同一个引擎里，目标消费方是长时运行的智能体（agent）循环，特别是 yantrikdb-agi 等上层系统所提出的"既要记住原文，也要知道不知道什么"的场景 资料来源：README.md:1-40。

子基板暴露的核心动词（remember / recall / think / correct / forget / relate）直接对应代理的写入、回溯、自检、修订、淘汰与关联动作，避免把同一份"记忆事实"在多个存储后端之间来回拼接 资料来源：CHANGELOG.md:1-30。

二、技术栈与仓库布局

引擎本体用 Rust 实现，向量索引与排序逻辑位于 src/hnsw.rs 与 src/recall.rs，图操作（实体 upsert、relate）位于 src/graph_ops.rs，并通过 PyO3 在 crates/yantrikdb-python 子 crate 中向 Python 暴露 YantrikDB、set_embedder_named、ConnectionProxy 等接口 资料来源：Cargo.toml:1-40 资料来源：crates/yantrikdb-python/pyproject.toml:1-30。

graph LR
    Py[Python Agent / yantrikdb-agi] -->|PyO3| Core[Rust Engine]
    Core --> HNSW[hnsw.rs<br/>cosine_distance + ANN]
    Core --> Recall[recall.rs<br/>scoring + sort]
    Core --> Graph[graph_ops.rs<br/>entities / claims / links]
    Core --> Pool[Worker Pool<br/>后台重构任务]
    HNSW -. cold tier .-> Z[zstd 压缩 embedding]

写入路径在 Rust 内落地为统一的中心化数值合约（InvalidEmbedding { path, index, reason } / InvalidScalar { path, field, value }），任何"非有限"或越界值都会在入口被拦截 资料来源：CHANGELOG.md:60-90。

三、核心能力

写入与检索：remember() 持久化条目（含向量与元数据），recall() 执行 HNSW 候选召回后用排序器给出分数与顶层 confidence 字段 资料来源：src/recall.rs:1-60。

冷热分层：v0.9.0 引入 access_count 驱动的 tiering——热层常驻内存，冷层落盘并对 embedding 做 zstd 压缩以节省空间 资料来源：CHANGELOG.md:10-40。recall() 在读取冷层时必须重新解压才参与距离计算，否则会拿到错误向量（见 issue #62） 资料来源：src/hnsw.rs:1-50。

链接模型（link model）：通过 relate(src, dst, ...) 把"记忆 ↔ 实体"的关系落到 memory_entities 表，而非直接污染 entities，用于清除"幻影实体" 资料来源：src/graph_ops.rs:1-60。RFC #48 进一步提议把链接作为 remember() 写入路径的一等公民 资料来源：CHANGELOG.md:100-130。

自检与修订：think() 返回包含冗余触发的摘要（issue #45 提议把重复 rid 列出来），correct() 在保留 rid 与时间戳的前提下要求调用方给出修订原因，并维持链接完整性 资料来源：CHANGELOG.md:130-170。

置信度：issue #46 提议把 confidence 提升为 remember 与 recall 的一等字段，而非仅作为元数据键 资料来源：CHANGELOG.md:170-190。

四、近期版本与已知风险

资料来源：CHANGELOG.md:1-200。

仍需关注的开放问题：

• #62：冷层读取路径未对 zstd embedding 解压，召回分数可能静默返回 NaN，并污染顶层 confidence，目前尚未合入 资料来源：CHANGELOG.md:200-220。
• #56：relate 的内存→实体边仍可能写入 entities 而非 memory_entities，导致幻影实体 资料来源：src/graph_ops.rs:40-80`。
• #45 / #46 / #47：think() 冗余触发缺少数值化、confidence 未一等化、correct() 语义未与 forget+remember 明确区分，等待 RFC 落地 资料来源：CHANGELOG.md:130-190。

五、面向贡献者的入口

新接入者通常从 Python 侧开始：先在 YantrikDB.with_default(path) 之上拿到一个连接，再调 set_embedder_named(...) 选择嵌入模型，最后进入 remember / recall 主循环 资料来源：pyproject.toml:1-30。Rust 侧的贡献入口集中在 src/hnsw.rs（距离/守卫）、src/recall.rs（评分/排序）与 src/graph_ops.rs（图边方向），新增功能前建议先核对 CHANGELOG.md` 与未关闭的 RFC/issue，避免与正在进行的中心化数值合约（v0.9.3 引入）冲突 资料来源：CHANGELOG.md:60-90。

模块定位与职责

crates/yantrikdb-python/src 是 yantrikdb 面向 Python 使用者的 pyo3 绑定层，负责把 Rust 内核（记忆、图、认知、整合）的能力以 YantrikDB / ConnectionProxy 等 Python 类与方法的形式暴露出来。lib.rs 是绑定 crate 的入口，承担 pyo3 模块注册、#[pymodule] 声明以及子模块挂载的职责；所有面向 Python 的方法都通过 #[pyclass] / #[pymethods] 在这里聚合，使 import yantrikdb 之后即可调用底层的 remember / recall / think / relate 等高阶 API。

该模块层并不重新实现核心逻辑，而是作为薄薄的胶水层，把请求参数序列化为 Rust 类型，转交给底层的 yantrikdb-engine，再把结果序列化回 Python 对象（dict、list、numpy array 等）。因此 src 模块的稳定性、错误码形态以及并发约束直接决定了 Python 端的可用性 — 例如 v0.9.0 引入后台 worker 池后，set_embedder_named 在 Python 端一度因为“需要独占访问”而失败，修复点就位于这一层（见下文）。

目录结构与子模块分工

src 目录在 pyo3 端被划分为三个主要单元：根入口、整合管线、引擎子模块。

mod.rs 是 py_engine 命名空间的拼装点，它把三个子模块的 #[pymethods] 在同一个 Python 路径下分发，使 ydb.engine.memory.remember(...) 这类深层调用与扁平调用都可用。

关键执行流与并发约束

Python 端的最常见路径是 remember → recall → think，其在绑定层的执行顺序如下（基于文件命名与社区上下文还原）：

sequenceDiagram
    participant Py as Python 调用方
    participant Lib as lib.rs (pyo3 类)
    participant Sub as py_engine/*.rs
    participant Eng as yantrikdb-engine
    Py->>Lib: YantrikDB(...).remember(text, ...)
    Lib->>Sub: dispatch to memory.rs
    Sub->>Eng: record + tier 路由
    Eng-->>Sub: rid, tier, confidence
    Sub-->>Py: Python dict
    Py->>Lib: recall(query)
    Lib->>Sub: memory.rs::recall
    Sub->>Eng: 候选打分 + 排序
    Eng-->>Sub: 命中列表
    Sub-->>Py: list[dict]

并发方面，set_embedder_named 在 v0.9.0 因为 pyo3 构造函数启动了后台 worker 池而要求“独占访问”，v0.9.1 在该层放宽了锁语义，使 worker 池在运行状态下仍可切换 embedder。社区 issue #58 与对应 release notes（v0.9.1）记录了这一修复路径，定位点即位于 lib.rs 的构造器与 set_embedder_named 的 #[pymethod] 实现处。资料来源：crates/yantrikdb-python/src/lib.rs:1-

数值契约上，v0.9.3 引入的 “central numeric/vector contract gate” 通过 InvalidEmbedding { path, index, reason } 与 InvalidScalar { path, field, value } 在所有写入路径（包括 memory.rs 的 remember 与 py_consolidate.rs 的 consolidate）做前置校验。这一道闸门确保 NaN / 零范数不会进入下游 hnsw.rs 的余弦距离计算 — 即 #60 与 #62 描述的两条 NaN 通道。资料来源：crates/yantrikdb-python/src/py_engine/memory.rs:1-

与未决社区问题的对应关系

• recall 中 NaN 分数静默传播（#62）：绑定层在冷 tier 读路径上需要确保 zstd 压缩向量被解压后再喂给打分器；目前修复点应在 py_engine/memory.rs 的冷 tier 解码分支。
• 幻影实体清理（#56）：relate 在 py_engine/graph.rs 中无条件 upsert 双端实体，期望的修复方向是让 memory→entity 边经过 memory_entities 中间表。
• 第一类链接模型（#48）：remember 写路径未来需要接收 links=[...]，扩展点位于 py_engine/memory.rs 的 remember 方法签名。
• correct() 语义收紧（#47）：py_engine/memory.rs 中 correct 需要新增 reason 必填参数，并在内部保留 rid + timestamp + 修订历史。
• confidence 作为一等字段（#46）：remember / recall 在 py_engine/memory.rs 需要把 confidence 从 metadata 提升为顶层级参数与过滤条件。
• think() 冗余 trigger 命名重复 rid（#45）：py_engine/cognition.rs 的 think 返回结构需要在 trigger 字段里附上重复 rid 列表，而不仅仅是一个布尔。

整体而言，src 模块是 yantrikdb Python 端契约的“事实发布处”，其稳定演进直接对应社区 RFC 与 patch release 的节奏。

Pitfall Log / 踩坑日志

项目：yantrikos/yantrikdb

摘要：发现 31 个潜在踩坑项，其中 0 个为 high/blocking；最高优先级：安装坑 - 失败模式：installation: v0.9.0 — close the memory gaps。

1. 安装坑 · 失败模式：installation: v0.9.0 — close the memory gaps

• 严重度：medium
• 证据强度：source_linked
• 发现：Developers should check this installation risk before relying on the project: v0.9.0 — close the memory gaps
• 对用户的影响：Upgrade or migration may change expected behavior: v0.9.0 — close the memory gaps
• 证据：failure_mode_cluster:github_release | https://github.com/yantrikos/yantrikdb/releases/tag/v0.9.0 | v0.9.0 — close the memory gaps

2. 安装坑 · 失败模式：installation: v0.9.1 — set_embedder_named works with the worker pool running

• 严重度：medium
• 证据强度：source_linked
• 发现：Developers should check this installation risk before relying on the project: v0.9.1 — set_embedder_named works with the worker pool running
• 对用户的影响：Upgrade or migration may change expected behavior: v0.9.1 — set_embedder_named works with the worker pool running
• 证据：failure_mode_cluster:github_release | https://github.com/yantrikos/yantrikdb/releases/tag/v0.9.1 | v0.9.1 — set_embedder_named works with the worker pool running

3. 安装坑 · 失败模式：installation: v0.9.2 — NaN-safe recall

• 严重度：medium
• 证据强度：source_linked
• 发现：Developers should check this installation risk before relying on the project: v0.9.2 — NaN-safe recall
• 对用户的影响：Upgrade or migration may change expected behavior: v0.9.2 — NaN-safe recall
• 证据：failure_mode_cluster:github_release | https://github.com/yantrikos/yantrikdb/releases/tag/v0.9.2 | v0.9.2 — NaN-safe recall

4. 安装坑 · 失败模式：installation: v0.9.3 — contract gate, isolation repair, 7.4× distance path

• 严重度：medium
• 证据强度：source_linked
• 发现：Developers should check this installation risk before relying on the project: v0.9.3 — contract gate, isolation repair, 7.4× distance path
• 对用户的影响：Upgrade or migration may change expected behavior: v0.9.3 — contract gate, isolation repair, 7.4× distance path
• 证据：failure_mode_cluster:github_release | https://github.com/yantrikos/yantrikdb/releases/tag/v0.9.3 | v0.9.3 — contract gate, isolation repair, 7.4× distance path

5. 安装坑 · 来源证据：Cold-tier recall scores can be NaN — read path never decompresses zstd embeddings (follow-on from #60)

• 严重度：medium
• 证据强度：source_linked
• 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Cold-tier recall scores can be NaN — read path never decompresses zstd embeddings (follow-on from #60)
• 对用户的影响：可能阻塞安装或首次运行。
• 证据：community_evidence:github | https://github.com/yantrikos/yantrikdb/issues/62 | 来源类型 github_issue 暴露的待验证使用条件。

6. 安装坑 · 来源证据：RFC: first-class link model on the remember write path (Proposal 2)

• 严重度：medium
• 证据强度：source_linked
• 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：RFC: first-class link model on the remember write path (Proposal 2)
• 对用户的影响：可能影响升级、迁移或版本选择。
• 证据：community_evidence:github | https://github.com/yantrikos/yantrikdb/issues/48 | 来源类型 github_issue 暴露的待验证使用条件。

7. 安装坑 · 来源证据：Unguarded division can produce NaN embeddings; NaN bypasses hnsw.rs zero-guard and breaks recall.rs sort total-order, p…

• 严重度：medium
• 证据强度：source_linked
• 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Unguarded division can produce NaN embeddings; NaN bypasses hnsw.rs zero-guard and breaks recall.rs sort total-order, panicking the process
• 对用户的影响：可能增加新用户试用和生产接入成本。
• 证据：community_evidence:github | https://github.com/yantrikos/yantrikdb/issues/60 | 来源讨论提到 python 相关条件，需在安装/试用前复核。

8. 安装坑 · 来源证据：correct(): tighten semantics — preserve rid+timestamp, revision history, require reason, preserve link integrity

• 严重度：medium
• 证据强度：source_linked
• 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：correct(): tighten semantics — preserve rid+timestamp, revision history, require reason, preserve link integrity
• 对用户的影响：可能影响升级、迁移或版本选择。
• 证据：community_evidence:github | https://github.com/yantrikos/yantrikdb/issues/47 | 来源类型 github_issue 暴露的待验证使用条件。

9. 安装坑 · 来源证据：links: route memory→entity edges through memory_entities, not claims (phantom entity cleanup)

• 严重度：medium
• 证据强度：source_linked
• 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：links: route memory→entity edges through memory_entities, not claims (phantom entity cleanup)
• 对用户的影响：可能影响升级、迁移或版本选择。
• 证据：community_evidence:github | https://github.com/yantrikos/yantrikdb/issues/56 | 来源讨论提到 node 相关条件，需在安装/试用前复核。

10. 配置坑 · 可能修改宿主 AI 配置

• 严重度：medium
• 证据强度：source_linked
• 发现：项目面向 Claude/Cursor/Codex/Gemini/OpenCode 等宿主，或安装命令涉及用户配置目录。
• 对用户的影响：安装可能改变本机 AI 工具行为，用户需要知道写入位置和回滚方法。
• 证据：capability.host_targets | https://github.com/yantrikos/yantrikdb | host_targets=mcp_host, claude_code, claude, cursor

11. 配置坑 · 失败模式：configuration: Cold-tier recall scores can be NaN — read path never decompresses zstd embeddings (follow-on...

• 严重度：medium
• 证据强度：source_linked
• 发现：Developers should check this configuration risk before relying on the project: Cold-tier recall scores can be NaN — read path never decompresses zstd embeddings (follow-on from #60)
• 对用户的影响：Developers may misconfigure credentials, environment, or host setup: Cold-tier recall scores can be NaN — read path never decompresses zstd embeddings (follow-on from #60)
• 证据：failure_mode_cluster:github_issue | https://github.com/yantrikos/yantrikdb/issues/62 | Cold-tier recall scores can be NaN — read path never decompresses zstd embeddings (follow-on from #60)

12. 配置坑 · 来源证据：think(): redundancy trigger should name the duplicate rids

• 严重度：medium
• 证据强度：source_linked
• 发现：GitHub 社区证据显示该项目存在一个配置相关的待验证问题：think(): redundancy trigger should name the duplicate rids
• 对用户的影响：可能影响升级、迁移或版本选择。
• 证据：community_evidence:github | https://github.com/yantrikos/yantrikdb/issues/45 | 来源类型 github_issue 暴露的待验证使用条件。

13. 能力坑 · 能力判断依赖假设

• 严重度：medium
• 证据强度：source_linked
• 发现：README/documentation is current enough for a first validation pass.
• 对用户的影响：假设不成立时，用户拿不到承诺的能力。
• 证据：capability.assumptions | https://github.com/yantrikos/yantrikdb | README/documentation is current enough for a first validation pass.

14. 运行坑 · 失败模式：runtime: Unguarded division can produce NaN embeddings; NaN bypasses hnsw.rs zero-guard and breaks rec...

• 严重度：medium
• 证据强度：source_linked
• 发现：Developers should check this runtime risk before relying on the project: Unguarded division can produce NaN embeddings; NaN bypasses hnsw.rs zero-guard and breaks recall.rs sort total-order, panicking the process
• 对用户的影响：Developers may hit a documented source-backed failure mode: Unguarded division can produce NaN embeddings; NaN bypasses hnsw.rs zero-guard and breaks recall.rs sort total-order, panicking the process
• 证据：failure_mode_cluster:github_issue | https://github.com/yantrikos/yantrikdb/issues/60 | Unguarded division can produce NaN embeddings; NaN bypasses hnsw.rs zero-guard and breaks recall.rs sort total-order, panicking the process

15. 运行坑 · 失败模式：runtime: v0.9.0 regression: set_embedder_named always fails with 'exclusive access' after pyo3 constru...

• 严重度：medium
• 证据强度：source_linked
• 发现：Developers should check this runtime risk before relying on the project: v0.9.0 regression: set_embedder_named always fails with 'exclusive access' after pyo3 constructor changes
• 对用户的影响：Developers may hit a documented source-backed failure mode: v0.9.0 regression: set_embedder_named always fails with 'exclusive access' after pyo3 constructor changes
• 证据：failure_mode_cluster:github_issue | https://github.com/yantrikos/yantrikdb/issues/58 | v0.9.0 regression: set_embedder_named always fails with 'exclusive access' after pyo3 constructor changes

16. 运行坑 · 来源证据：v0.9.0 regression: set_embedder_named always fails with 'exclusive access' after pyo3 constructor changes

• 严重度：medium
• 证据强度：source_linked
• 发现：GitHub 社区证据显示该项目存在一个运行相关的待验证问题：v0.9.0 regression: set_embedder_named always fails with 'exclusive access' after pyo3 constructor changes
• 对用户的影响：可能增加新用户试用和生产接入成本。
• 证据：community_evidence:github | https://github.com/yantrikos/yantrikdb/issues/58 | 来源讨论提到 python 相关条件，需在安装/试用前复核。

17. 维护坑 · 失败模式：migration: RFC: first-class link model on the remember write path (Proposal 2)

• 严重度：medium
• 证据强度：source_linked
• 发现：Developers should check this migration risk before relying on the project: RFC: first-class link model on the remember write path (Proposal 2)
• 对用户的影响：Developers may hit a documented source-backed failure mode: RFC: first-class link model on the remember write path (Proposal 2)
• 证据：failure_mode_cluster:github_issue | https://github.com/yantrikos/yantrikdb/issues/48 | RFC: first-class link model on the remember write path (Proposal 2)

18. 维护坑 · 失败模式：migration: confidence: first-class field on remember + recall filter

• 严重度：medium
• 证据强度：source_linked
• 发现：Developers should check this migration risk before relying on the project: confidence: first-class field on remember + recall filter
• 对用户的影响：Developers may hit a documented source-backed failure mode: confidence: first-class field on remember + recall filter
• 证据：failure_mode_cluster:github_issue | https://github.com/yantrikos/yantrikdb/issues/46 | confidence: first-class field on remember + recall filter

19. 维护坑 · 失败模式：migration: correct(): tighten semantics — preserve rid+timestamp, revision history, require reason, pres...

• 严重度：medium
• 证据强度：source_linked
• 发现：Developers should check this migration risk before relying on the project: correct(): tighten semantics — preserve rid+timestamp, revision history, require reason, preserve link integrity
• 对用户的影响：Developers may hit a documented source-backed failure mode: correct(): tighten semantics — preserve rid+timestamp, revision history, require reason, preserve link integrity
• 证据：failure_mode_cluster:github_issue | https://github.com/yantrikos/yantrikdb/issues/47 | correct(): tighten semantics — preserve rid+timestamp, revision history, require reason, preserve link integrity

20. 维护坑 · 失败模式：migration: links: route memory→entity edges through memory_entities, not claims (phantom entity cleanup)

• 严重度：medium
• 证据强度：source_linked
• 发现：Developers should check this migration risk before relying on the project: links: route memory→entity edges through memory_entities, not claims (phantom entity cleanup)
• 对用户的影响：Developers may hit a documented source-backed failure mode: links: route memory→entity edges through memory_entities, not claims (phantom entity cleanup)
• 证据：failure_mode_cluster:github_issue | https://github.com/yantrikos/yantrikdb/issues/56 | links: route memory→entity edges through memory_entities, not claims (phantom entity cleanup)

21. 维护坑 · 失败模式：migration: think(): redundancy trigger should name the duplicate rids

• 严重度：medium
• 证据强度：source_linked
• 发现：Developers should check this migration risk before relying on the project: think(): redundancy trigger should name the duplicate rids
• 对用户的影响：Developers may hit a documented source-backed failure mode: think(): redundancy trigger should name the duplicate rids
• 证据：failure_mode_cluster:github_issue | https://github.com/yantrikos/yantrikdb/issues/45 | think(): redundancy trigger should name the duplicate rids

22. 维护坑 · 失败模式：migration: v0.7.20 — algo gap analysis Tier 1.5 + Tier 2

• 严重度：medium
• 证据强度：source_linked
• 发现：Developers should check this migration risk before relying on the project: v0.7.20 — algo gap analysis Tier 1.5 + Tier 2
• 对用户的影响：Upgrade or migration may change expected behavior: v0.7.20 — algo gap analysis Tier 1.5 + Tier 2
• 证据：failure_mode_cluster:github_release | https://github.com/yantrikos/yantrikdb/releases/tag/v0.7.20 | v0.7.20 — algo gap analysis Tier 1.5 + Tier 2

23. 维护坑 · 失败模式：migration: v0.7.21 — first-class record-to-record link model

• 严重度：medium
• 证据强度：source_linked
• 发现：Developers should check this migration risk before relying on the project: v0.7.21 — first-class record-to-record link model
• 对用户的影响：Upgrade or migration may change expected behavior: v0.7.21 — first-class record-to-record link model
• 证据：failure_mode_cluster:github_release | https://github.com/yantrikos/yantrikdb/releases/tag/v0.7.21 | v0.7.21 — first-class record-to-record link model

24. 维护坑 · 失败模式：migration: v0.7.22 — partial-link writes + windowed leak audit

• 严重度：medium
• 证据强度：source_linked
• 发现：Developers should check this migration risk before relying on the project: v0.7.22 — partial-link writes + windowed leak audit
• 对用户的影响：Upgrade or migration may change expected behavior: v0.7.22 — partial-link writes + windowed leak audit
• 证据：failure_mode_cluster:github_release | https://github.com/yantrikos/yantrikdb/releases/tag/v0.7.22 | v0.7.22 — partial-link writes + windowed leak audit

25. 维护坑 · 失败模式：migration: v0.8.0 — World's Best Memory System program

• 严重度：medium
• 证据强度：source_linked
• 发现：Developers should check this migration risk before relying on the project: v0.8.0 — World's Best Memory System program
• 对用户的影响：Upgrade or migration may change expected behavior: v0.8.0 — World's Best Memory System program
• 证据：failure_mode_cluster:github_release | https://github.com/yantrikos/yantrikdb/releases/tag/v0.8.0 | v0.8.0 — World's Best Memory System program

26. 维护坑 · 来源证据：confidence: first-class field on remember + recall filter

• 严重度：medium
• 证据强度：source_linked
• 发现：GitHub 社区证据显示该项目存在一个维护/版本相关的待验证问题：confidence: first-class field on remember + recall filter
• 对用户的影响：可能影响升级、迁移或版本选择。
• 证据：community_evidence:github | https://github.com/yantrikos/yantrikdb/issues/46 | 来源类型 github_issue 暴露的待验证使用条件。

27. 维护坑 · 维护活跃度未知

• 严重度：medium
• 证据强度：source_linked
• 发现：未记录 last_activity_observed。
• 对用户的影响：新项目、停更项目和活跃项目会被混在一起，推荐信任度下降。
• 证据：evidence.maintainer_signals | https://github.com/yantrikos/yantrikdb | last_activity_observed missing

• 严重度：medium
• 证据强度：source_linked
• 发现：no_demo
• 证据：downstream_validation.risk_items | https://github.com/yantrikos/yantrikdb | no_demo; severity=medium

29. 安全/权限坑 · 存在评分风险

• 严重度：medium
• 证据强度：source_linked
• 发现：no_demo
• 对用户的影响：风险会影响是否适合普通用户安装。
• 证据：risks.scoring_risks | https://github.com/yantrikos/yantrikdb | no_demo; severity=medium

30. 维护坑 · issue/PR 响应质量未知

• 严重度：low
• 证据强度：source_linked
• 发现：issue_or_pr_quality=unknown。
• 对用户的影响：用户无法判断遇到问题后是否有人维护。
• 证据：evidence.maintainer_signals | https://github.com/yantrikos/yantrikdb | issue_or_pr_quality=unknown

31. 维护坑 · 发布节奏不明确

• 严重度：low
• 证据强度：source_linked
• 发现：release_recency=unknown。
• 对用户的影响：安装命令和文档可能落后于代码，用户踩坑概率升高。
• 证据：evidence.maintainer_signals | https://github.com/yantrikos/yantrikdb | release_recency=unknown