本期主旨
30 天 · 189 commits · 3 条主线收口,下一程指向知识图谱 API
灵阙知识图谱(CogNebula)在 2026-03-21 至 04-14 的周期内完成 189 次提交,单人贡献,前 11 日占 77%。三条主线——图谱扩建、混合检索+数据质量、前端架构收敛——已按既定节奏合上。下一个里程碑:2026 年 5 月 · 端午节后第一周正式启动知识图谱 API 研发。本期报告先交代数据,再列三件当下应处理的信号与下一程的路线图。
图表一 · 活动热力图
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
| 类别 | 次数 | 占比 | |
| feat | 65 | 34.4% | |
| fix | 55 | 29.1% | |
| docs | 33 | 17.5% | |
| other | 32 | 16.9% | |
| polish | 2 | 1.0% | |
| refactor | 2 | 1.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
前段冲刺(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 月中 / 端午后
图例: 已完成 /
持续进行 /
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
未来两周的三件必办事
-
PDCA 四文档同步补丁 2-3 h · 不阻塞 KG API 准备
把本期 189 次提交的架构含义(前端收敛、混合检索新增、KG schema 演进)同步回 PRD / SYSTEM_ARCHITECTURE / USER_EXPERIENCE_MAP / PLATFORM_OPTIMIZATION_PLAN。目标:任何新读者能从四份文档直接理解现状。
-
技术债清扫(kg + quality 域)半日 · KG API 启动前完成
扫描 55 次 fix 中的重复模式,识别 2-3 个可合并重构的主题。refactor 占比从 1.1% → 5% 即达标。不清扫 = KG API 建在老问题之上。
-
KG API 研发启动准备 2026-05 · 端午后第一周
建议在启动前落地:API 设计文档(REST + MCP 双协议选型)、性能基线(向量检索 p99 目标)、质量门禁(延用 6D 审计扩展至 API 层)。此为下一个周期的主线里程碑,本报告余下观察都服务于它的起跑质量。