# 知识图谱写时演化 + 贡献分软降权

| 字段 | 内容 |
|---|---|
| 版本 | 0.1.16 |
| 日期 | 2026-07-27 |
| commit | 1548718 |
| MR | （直推 main；无单独 MR） |

## 问题

1. 进化闭环只反哺流程包（Issue → evolve → MR），不反哺业务仓 `knowledge/` 节点效用。
2. archive/sync 会合并正文，但缺少写时建链/邻接回写/取代（A-MEM / Graphiti）机器口径。
3. `/kb-query` 仅两级 index 导航，无贡献分排序，易反复读到低价值或已取代笔记。

## 改动

| 项 | 落点 |
|---|---|
| 时效字段 | schema + kb-graph §3.1：`status` / `supersedes` / `keywords`；okf-check 校验 |
| 写时三步 | `kb-knowledge-evolve.md`；archive/sync/librarian/SKILL 原则 21 |
| 贡献分 | `.kb/knowledge-utility.json` + `scripts/kb-knowledge-utility.mjs`（bump/penalize/rank/summary） |
| 检索/巡检 | query rank+bump；health summary；bootstrap 空模板 |
| 工种 | librarian/inspector 可经 shell 写 utility |

## 验证

```bash
# 效用分
TMP=$(mktemp -d)
mkdir -p "$TMP/.kb" "$TMP/knowledge"
cp bootstrap/kb.project.json "$TMP/" 2>/dev/null || echo '{"knowledgeRoot":"knowledge","codeRoots":[]}' > "$TMP/kb.project.json"
cp bootstrap/knowledge-utility.json "$TMP/.kb/"
node scripts/kb-knowledge-utility.mjs bump --target "$TMP" --paths knowledge/a.md,knowledge/b.md --delta 1
node scripts/kb-knowledge-utility.mjs penalize --target "$TMP" --paths knowledge/b.md --delta 0.5
node scripts/kb-knowledge-utility.mjs rank --target "$TMP" --query-files knowledge/a.md,knowledge/b.md --json
node scripts/kb-knowledge-utility.mjs summary --target "$TMP" --json
rm -rf "$TMP"

# OKF（可选：对已 bootstrap 业务仓）
# node scripts/kb-okf-check.mjs --target <业务仓>
```

## 后续

- 已 bump 包版本 **0.1.16**（含本篇与 stage-next）；publish 由维护者执行
- 可选：本地 FTS / 向量混合检索（本轮不做）
- 可选：query 自动从回答路径解析 bump 清单的机器辅助