dsh-refactor-insight
DSH 技能插件：把代码库的坏味道转成带定位、优先级和依赖顺序的可执行重构计划——结构健康体检，而非 diff 审查。
Turn codebase smells into an executable, priority-ordered refactoring plan.
能力（v0）
六条确定性坏味道规则（阈值均可参数覆盖，零依赖启发式）：
- 超长文件（默认 > 400 行）
- 深嵌套（默认最大缩进 / 花括号深度 > 5）
- TODO/FIXME 密度（噪音指标，输出每千行计数）
- 长函数（Python 缩进块 / JS-TS 花括号配对 / Go 函数声明，函数体 > 80 行）
- 上帝对象（类方法数 > 10 或类体行数 > 300 / Go 接收者方法数）
- 高耦合模块（复用
arch-profile --deps 输出，按入度/出度识别 hub 模块 + Tarjan 环检测）
- 只输出计划、不自动改代码；高风险重构项由 LLM 标注、须人工确认。
脚本只给硬事实（确定性扫描），严重度 / 成本 / 建议动作由 LLM 精修真误报后标注推断。
快速开始
在 DSH 中使用
- 安装插件：
dsh plugin --profile web add github:duyanta123/dsh-refactor-insight
- 发布 v0.1.0 tag 后，可改为
github:duyanta123/dsh-refactor-insight#v0.1.0 锁定版本。
- 使用：对 Agent 说「用 refactor-insight 体检 /path/to/repo」
- 输出：按
docs/refactor-plan-template.md 生成 REFACTOR-PLAN.md。
只跑诊断 CLI（零依赖，不经过 DSH 也能跑）
独立 refactor-smell.mjs 与 arch-profile.mjs 继续支持 Node.js >= 18；作为 DSH 0.1.5-rc.2 bundle 运行时要求 Node.js >= 22.19。兼容门禁可用 npm run test:compat。
# 六条规则诊断
node scripts/refactor-smell.mjs <repo_path>
# 复用 arch-profile 的依赖输出做高耦合/环检测
node scripts/arch-profile.mjs <repo_path> --deps > deps.json
node scripts/refactor-smell.mjs <repo_path> --deps-json deps.json
主要参数：--max-lines、--max-func-lines、--max-nesting、--max-methods、--max-class-lines、--max-coupling、--max-depth、--include-dirs、--exclude-dirs。
示例输出（节选）：
{
"language": "javascript/typescript",
"smells": [
{
"rule": "god-object",
"type": "god_object",
"path": "src/lib/GodService.js",
"name": "GodService",
"methods": 12,
"threshold": 10,
"severity": 2,
"cost": "M"
}
]
}
目录结构
dsh-refactor-insight/
├── package.json # npm 包 + dsh.bundle.patch
├── cordis.patch.yml # DSH bundle patch
├── plugin/index.js # ESM 入口，注册 skills/ 为技能根
├── skills/refactor-runbook/SKILL.md # 技能 frontmatter + 阶段执行 runbook
├── docs/refactor-plan-template.md # 输出报告骨架
├── scripts/arch-profile.mjs # 复用：probe/scan/deps/entry（零依赖）
├── scripts/refactor-smell.mjs # 坏味道诊断器（六条规则，--deps-json 复用 arch-profile deps）
└── test/ # node --test 测试 + fixtures
本地开发
- profile 的 package.json 加
"dsh-refactor-insight": "file:<本地路径>/dsh-refactor-insight"，bundles 加 "dsh-refactor-insight"。
- 测试：
npm test
- 打包检查：
npm pack --dry-run
输出
REFACTOR-PLAN.md：结构化重构计划（按 docs/refactor-plan-template.md 骨架）
