Fix memory value metrics and strengthen active recall

README.md

@@ -189,6 +189,11 @@ python3 dna.py memory maintain weekly --json
 python3 dna.py memory maintain monthly --json
 ```
 
+`memory value` 将真正待审的 `backlog.reviewable_proposals` 与来源指针、
+生命周期事件分开统计。`backlog.pending` 只是 `total_pending` 的兼容别名，
+不能解释为待审记忆数量。`clients` 中的 `recall_hits` 和 `recall_share` 用于
+观察 Codex、Claude、Hermes 的主动召回采用情况；占比不代表召回质量。
+
 当新证据明确使旧结论失效时，调用 `memory_remember` 并显式传入旧 ID：
 
 ```json

README_EN.md

@@ -158,6 +158,12 @@ python3 dna.py memory maintain weekly --json
 python3 dna.py memory maintain monthly --json
 ```
 
+`memory value` separates reviewable `backlog.reviewable_proposals` from
+provenance and lifecycle events. `backlog.pending` is only a compatibility
+alias for `total_pending`; it is not the number of memories awaiting review.
+Per-client `recall_hits` and `recall_share` show active-recall adoption across
+Codex, Claude, and Hermes. Recall share is not a quality score.
+
 When a new verified fact invalidates an older one, pass exact old memory IDs in
 `supersedes`. Old Markdown remains available as history, while default recall
 returns active conclusions only. DNA Memory never infers replacement from type

docs/mcp-and-client-adapters.md

@@ -229,6 +229,24 @@ python3 dna.py memory maintain monthly --json
 - weekly：daily + SQLite 在线备份、有限轮换和 `VACUUM`。
 - monthly：weekly + `PRAGMA integrity_check` 和 Markdown 重建核对。
 
+`memory value` 的 backlog 字段按用途拆分：
+
+| 字段 | 含义 |
+|---|---|
+| `reviewable_proposals` | pending 的 `memory_proposal`，是真正待审认知候选 |
+| `provenance_events` | 会话、轮次和来源指针 |
+| `lifecycle_events` | 客户端启动、停止和关闭事件 |
+| `other_pending` | 尚未显式分类的新事件类型 |
+| `total_pending` | 所有 pending 事件之和 |
+| `pending` | `total_pending` 的兼容别名 |
+| `oldest_reviewable_at` | 最早待审候选时间 |
+
+客户端字段中的 `recall_attempts`、`recall_hits`、`useful`、`misleading` 和
+`recall_share` 用于观察各客户端是否实际进入召回闭环。`recall_share` 仅表示
+调用分布，不应作为质量评分。7 天和 30 天窗口兼容 SQLite 时间、ISO 8601
+`+0800`/`+08:00` 偏移和 Unix 秒；不可解析时间仍保留在全量统计中，但不进入
+时间窗口。
+
 自动化可使用 macOS LaunchAgent、cron 或其他调度器。建议使用通用 label：
 
 ```text

docs/skill-management.md

@@ -28,6 +28,15 @@ DNA Memory 将“长期记忆”和“行为 Skill”分开治理：
 4. 记忆服务故障不阻塞主任务。
 5. 不把完整 transcript、凭证或大型工具输出写入记忆。
 
+仓库中的 `dna-memory-loop` 是不含个人命名的公开模板。本机部署可以在
+`skill_registry` 中使用自定义的受管 Skill 名称，但 Codex、Claude Code 和
+Hermes 的目标目录必须链接到同一个 `skill_root` 真源。不要复制三份后分别
+修改，否则召回边界和隐私限制会随客户端漂移。
+
+对依赖历史的实质任务，Memory Loop 是强制前置步骤；“继续之前的工作”、
+“按上次方案”、已有项目路径、用户长期偏好、已知错误和开放事项都属于触发
+条件。翻译、当前时间、一步格式化等完全自包含任务仍然跳过召回。
+
 ## 命令
 
 ```bash