用途:为代码库生成确定性的认知负荷指数(CLI,0-1000),输出分维度得分与可执行建议。适合大型重构前、接手陌生代码库、架构评审或跟踪复杂度趋势时使用。
主要能力:按 8 个维度评分并加权求和,权重合计 1.00:D1 结构复杂度 0.20、D2 嵌套深度 0.15、D3 体量/规模 0.12、D4 命名质量 0.15、D5 耦合 0.12、D6 内聚 0.10、D7 重复 0.08、D8 可导航性 0.08。评分采用 sigmoid 归一化与 P90 加权,0 与 1000 不可达,上限 999。评级区间:0-100 优秀、101-250 良好、251-400 中等、401-600 需关注、601-800 差、801-999 严重。
使用方式:先探测语言与规模,再逐维度采集原始指标,调用计算脚本归一化,最后聚合。脚本路径为 skills/cognitive-load-analyzer/lib/cli_calculator.py,命令示例:uv run --no-project python3 <skill_dir>/lib/cli_calculator.py normalize-d1 '<json>',聚合用 aggregate '{"D1": ..., "D8": ...}'。工具优先级:lizard(30+ 语言)> 语言专用工具(radon、gocyclo、eslint)> grep/awk/find 启发式。D4 可结合 LLM 评估,静态与 LLM 按 60/40 合成。
限制:超过 100K LOC 时启用确定性抽样(SHA-256 哈希模 100 小于 30,并纳入所有大于 200 LOC 的文件);多语言代码库按语言分别分析后按 LOC 加权聚合。输出为 {"ok": true, "result": {...}} 或 {"ok": false, "error": "..."}。具体安装方式、收费与平台支持暂未提供。