灵阙知识图谱 工程进度报告
CogNebula · Engineering Review
第 1 期
2026-04 · 内部参阅
主笔:Maurice
本期主旨

30 天 · 189 commits · 3 条主线收口,下一程指向知识图谱 API

灵阙知识图谱(CogNebula)在 2026-03-21 至 04-14 的周期内完成 189 次提交,单人贡献,前 11 日占 77%。三条主线——图谱扩建、混合检索+数据质量、前端架构收敛——已按既定节奏合上。下一个里程碑:2026 年 5 月 · 端午节后第一周正式启动知识图谱 API 研发。本期报告先交代数据,再列三件当下应处理的信号与下一程的路线图。

189
Commits
25
Active Days
7.6
Avg / Day
43
Peak · 03-30
34.4%
Feat Share
1.1%
Refactor
图表一 · 活动热力图

25 个活跃日分布:前段集中,后段稀疏

Daily Commit Heatmap · 03-21 → 04-14(空白日 = 0 次提交)
日期
5
12
11
2
19
28
9
43
19
9
11
1
日期
2
11
5
2
峰值 03-30(43 次);04-03→04-12 十天共 14 次(空窗待诊断);收官日 04-14 收束于质量审计 PASS。
图表二 · 提交结构

功能 / 修复 比例健康,重构仍被推迟

Commit Category Breakdown
189 COMMITS
类别次数占比
feat6534.4%
fix5529.1%
docs3317.5%
other3216.9%
polish21.0%
refactor21.1%

读法:feat 65 次中含 kg(11)、m3(21)、rules(3)、nav(3) 子域;fix 55 次中 kg(8) 与 quality(3) 集中在数据质量侧。refactor 仅 2 次——是本期唯一主动提示的反常信号。

图表三 · 日速度曲线

前段冲刺 146 次,后段稳定 43 次

Daily Velocity · Line + Area
45 30 15 0 43 · 峰值 04-03 → 04-12 低速窗口 03-21 03-28 03-30 04-05 04-08 04-14
前段冲刺(03-21 → 03-31)占 77%;中段 04-03 → 04-12 低速窗口仅 14 次;收官段 04-13 → 04-14 含混合检索 + 6D 审计 PASS。
三条主线 · 收口状态

三条交付线已按节奏合上

知识图谱扩建 进行中 · 节奏稳

kg-api-server.py ×24 · expert/kg/page.tsx ×23 · feat(kg) ×11 · fix(kg) ×8

数据层与 UI 同步扩建,新增与返工比约 11:8 ——结构稳定,属正常维护区间。

混合检索 · MCP · 数据质量 已交付

hybrid_search + RRF fusion + MCP API key · 6D 审计 16/16 PASS · 04-13 单日 +1600 行

本期最完整的一次工程交付。若未来出现检索体验退化,回归点应锁定 2026-04-13 这一 commit 簇。

前端架构收敛 已完成

9 pages removed (audit / compliance / tax / ops/*, ai-team/*) · 职能迁入 /expert/* 与 /ops/ 新布局

三月底至四月初的系统性清理,旧页面下线,导航逻辑与 KG 专家视图合流。此为后续 API 开发的前置条件之一。

路线图 · 未来六周

从已完成到 KG API 正式启动的时间线

03 月下
04 月初
04 月中
04 月底
05 月初
05 月中 / 端午后
① KG 扩建
进行中 · 持续
② 混合检索+质量
已交付 04-13
③ 前端收敛
已完成 04 月初
④ PDCA 四文档同步
本周
⑤ 技术债清扫
下周
⑥ 节奏诊断
10 分钟
KG API 研发
★ 05 月 · 端午后

图例: 已完成 / 持续进行 / 2 周内 / 6 周后里程碑 ★

信号 · 三件当下应处理的事

不是危机,但会在下一周期复利

● 中 · 文档

PDCA 四文档漂移

HANDOFF.md 49 次更新 vs PRD/SYSTEM_ARCHITECTURE/UX_MAP/OPT_PLAN 近静止。单人会话接力压所有上下文到一份文档。

代价:下次会话冷启成本叠加至 ~49 份 HANDOFF 版本。
● 高 · 技术债

重构比例 1.1%

189 次提交中仅 2 次 refactor。fix(kg) ×8 与 fix(quality) ×3 含重复模式,未提取为结构化重构。KG API 开发前若不清扫,新接口会叠加在旧代码路径上。

代价:KG API 上线后 fix 比例将超过 feat。
● 低 · 节奏

04-03 → 04-12 低速窗口

十天 14 次提交。原因需在 task_plan.md 标注:主动休整 / 家庭 / 外部阻塞。不标注则无法识别同样曲线是否健康。

代价:无当下损失,仅识别成本。
下一程 · 优先级 1-2-3

未来两周的三件必办事

  1. PDCA 四文档同步补丁 2-3 h · 不阻塞 KG API 准备
    把本期 189 次提交的架构含义(前端收敛、混合检索新增、KG schema 演进)同步回 PRD / SYSTEM_ARCHITECTURE / USER_EXPERIENCE_MAP / PLATFORM_OPTIMIZATION_PLAN。目标:任何新读者能从四份文档直接理解现状。
  2. 技术债清扫(kg + quality 域)半日 · KG API 启动前完成
    扫描 55 次 fix 中的重复模式,识别 2-3 个可合并重构的主题。refactor 占比从 1.1% → 5% 即达标。不清扫 = KG API 建在老问题之上。
  3. KG API 研发启动准备 2026-05 · 端午后第一周
    建议在启动前落地:API 设计文档(REST + MCP 双协议选型)、性能基线(向量检索 p99 目标)、质量门禁(延用 6D 审计扩展至 API 层)。此为下一个周期的主线里程碑,本报告余下观察都服务于它的起跑质量。