近期多 PR 合入后积累了一批未接入主流程的模块与重复实现,建议清理以降低维护成本。
明确未接入主流程(建议删除或接线)
src/wiki-engine/manifest-compiler.ts:注释称由 teamai codebase --compile 调用,但该子命令不存在(src/codebase-cmd.ts 无 --compile 分支),全库无 import。
src/wiki-engine/doc-graph-extractor.ts:仅被单测引用,未接入 extract/import 任何流程。
src/utils/source-conflict.ts 的 recordSourceUpdate:生产路径只读 source-marks.jsonl、从不写入(codebase-lint 侧),多源冲突检测实际拿不到数据。
- 死导出函数:
buildCodeGraphIndex / writeCodeGraph(src/wiki-engine/code-knowledge/code-graph.ts)、scanInterfacesFromFacts(interface-scanner.ts)、fromLegacyConfidence(reconciler-v2-types.ts:18)——均无生产调用。
save-session 命令链(src/session-collector.ts + index.ts:482-488):无 push --sessions 落地路径,与 contribute-check 职责重叠,仅测试调用。
重复实现 / 兼容垫片(可删,需改测试 import)
src/utils/gf-cli.ts、src/utils/repo-url.ts:只是 re-export src/providers/tgit/*,仅测试还在引用。
- 双轨产物并存:
docs/team-codebase/(旧扁平 MD)vs teamwiki/(新图谱);import-mr 仍调旧的 applyCodebaseSuggestions,而 CI 已切换到 teamwiki(src/ci/extract-mr.ts:16 注释 vs src/import-mr.ts:389),行为不一致。
- 9 个 legacy hidden hook 子命令(
track/mr-hint/auto-recall 等)在 hook-dispatch 统一后仅为旧 settings 兼容(src/hooks.ts:24、src/index.ts:445-724),迁移期结束后可移除注册。
@deprecated CodeGraphIndex 别名仍被 codebase-wiki-lint.ts import(src/wiki-engine/code-knowledge/code-graph.ts:17),可渐进 rename 为 GraphIndex。
建议
分批清理:先删纯死代码(manifest-compiler / doc-graph-extractor / 死导出函数),再收敛重复(utils 垫片、codebase 双轨),最后在 hook 迁移完成后移除 legacy 子命令注册。
严重程度:低(技术债,不影响功能)。
近期多 PR 合入后积累了一批未接入主流程的模块与重复实现,建议清理以降低维护成本。
明确未接入主流程(建议删除或接线)
src/wiki-engine/manifest-compiler.ts:注释称由teamai codebase --compile调用,但该子命令不存在(src/codebase-cmd.ts无--compile分支),全库无 import。src/wiki-engine/doc-graph-extractor.ts:仅被单测引用,未接入 extract/import 任何流程。src/utils/source-conflict.ts的recordSourceUpdate:生产路径只读source-marks.jsonl、从不写入(codebase-lint侧),多源冲突检测实际拿不到数据。buildCodeGraphIndex/writeCodeGraph(src/wiki-engine/code-knowledge/code-graph.ts)、scanInterfacesFromFacts(interface-scanner.ts)、fromLegacyConfidence(reconciler-v2-types.ts:18)——均无生产调用。save-session命令链(src/session-collector.ts+index.ts:482-488):无push --sessions落地路径,与contribute-check职责重叠,仅测试调用。重复实现 / 兼容垫片(可删,需改测试 import)
src/utils/gf-cli.ts、src/utils/repo-url.ts:只是 re-exportsrc/providers/tgit/*,仅测试还在引用。docs/team-codebase/(旧扁平 MD)vsteamwiki/(新图谱);import-mr仍调旧的applyCodebaseSuggestions,而 CI 已切换到 teamwiki(src/ci/extract-mr.ts:16注释 vssrc/import-mr.ts:389),行为不一致。track/mr-hint/auto-recall等)在hook-dispatch统一后仅为旧 settings 兼容(src/hooks.ts:24、src/index.ts:445-724),迁移期结束后可移除注册。@deprecated CodeGraphIndex别名仍被codebase-wiki-lint.tsimport(src/wiki-engine/code-knowledge/code-graph.ts:17),可渐进 rename 为GraphIndex。建议
分批清理:先删纯死代码(manifest-compiler / doc-graph-extractor / 死导出函数),再收敛重复(utils 垫片、codebase 双轨),最后在 hook 迁移完成后移除 legacy 子命令注册。
严重程度:低(技术债,不影响功能)。