haoku123/dsh-blast-radius

README 摘要

dsh-blast-radius DeepSeek Harness 插件： agent 改了代码，这次改动会波及什么？ diff 告诉你改了 5 行。它不会告诉你这 5 行在一个被另外 3 个文件调用的函数里， 而那些调用点 一个测试都没有 。前者是文本视角，后者是风险视角。 用真实的 TypeScript 语义分析（ tsserver ）回答后者：改动落在哪个符号上、谁依赖这个 符号、那些依赖里有多少受测试保护。 两条不会妥协的原则 这两条决定了插件的所有行为，也决定了默认配置： 1. 分析失败永不阻断 agent。 TypeScript 没装、tsserver 崩了、查询超时 —— 全部放行。 即使 enforce: true 也一样。一个会因为子进程死掉就卡住 agent 的质量工具，比没有这个 工具更糟。 2. 「不知道」永不伪装成「安全」。 分析不出结论时明确说出来，而不是渲染成一条干净 的结果。这也是 enforce 默认关闭的原因：一个第一天就开始拦你写入的插件，会在赢得 信任之前先被卸载。 功能 - 语义影响面 ： tsserver 的 references + navtree ，按符号（不是行号）归因 - 测试覆盖缺口 ：区分生产调用点与测试引用 —— 这是最值钱的信号 - 风险分级 ： 低 / 中 / 高 ，规则确定可复现（不用模型判断） - 写入前拦截 ： tools/pre-execute waterfall，超阈值走 ask - 仪表盘 ： shell.overlay 角落面板，4s 轮询 - 零额外安装 ： typescript 包自带 tsserver.js ，优先用被分析项目自己的版本 安装 默认 report-only ：只记录、只显示，不拒绝任何写入。 配置 见 cordis.patch.yml 。关键项： 键 默认 含义 : enforce false 超阈值时是否要求确认。默认只报告 enforceAtRisk high 触发确认的风险等级： medium \ high timeoutMs 3000 单次语义查询预算，超时降级为「未分析」并放行 highProductionRefs 12 调用点超过此数即为高风险（即使有测试） testPatterns [] 追加的测试路径正则（内置已覆盖 .test. / test/ / tests / ） maxProjectFiles 2000 无 tsconfig 时扫描上限，触顶会明确报告 verbose false 每次分析打一行日志，调阈值时有用 风险分级规则 条件 等级 无人引用 / 仅被测试引用 / 仅被导入未调用 低 有生产调用点，无测试引用，且 跨文件 高 有生产调用点，无测试引用，但都在本文件内 中 有生产调用点且有测试引用，调用面 ≥ highProducti…

分类