JianFeeeee 217e32b494 ci: 补 staticcheck + 覆盖率采集 —— 把"看不见"变成可见 ...

## 背景

本轮判据治理的起点是「覆盖率／判据形状两者都看不清」。前几个提交补了
gofmt 门和 SDK 判据步骤；这个补最后两项。

## staticcheck

### 为什么选它

`go vet` 只跑标准检查器。实测今天撞到的那类缺陷它抓不到：

    pluginHealthTracker 标记 Unhealthy=true 后，isHealthy 立刻用
    LastReload（**从未被赋值**，恒为零值）判"冷却已过"而自愈

那是 SA4xxx 家族（无用赋值 / 永真条件）的领域。它不替代判据，
但能在"写完了但逻辑自相矛盾"处提前报警。

只查四族，不查风格：

    SA4xxx 无用赋值 / 永真条件
    SA5xxx 可疑代码
    SA6xxx 低效写法
    SA9xxx 必错分支

### 踩到的坑：版本不匹配会造出一道永远绿的门

第一版钉 staticcheck@2025.1.1，在 Go 1.27.1 上实测：

    internal error in importing "image/color"
    (cannot decode "image/color", export data version 4 is
     greater than maximum supported version 2)

然后**静默返回退出码 0** —— 一道永远绿的门，比没有门更危险。
改用 2026.2.2 后正常解析。步骤里加了两道判：

  · 退出码非 0 但输出里没有任何 `file.go:line` ⇒ 判定"未能运行"，直接红
  · 版本变化导致的静默退化由上面这条兜住

### 存量基线：24 条 / 13 个文件（2026-11-04 实测）

按分布：

    SA9003  empty branch          10
    SA4006  value never used       4
    SA4000  identical expressions  3
    SA4010  value never checked    2
    SA4008  1    SA4023 1    SA6001 1    SA6003 1

处理方式是**基线 + 只许减不许增**：新增告警让这一步红，存量可见但
暂不阻塞（否则合并即长红，所有人学会忽略这道门 —— 正是本仓
ci.yml 里那段"长红 ⇒ 整道门失效"的教训）。低于基线时会提示把
BASE 调低，否则门会越来越松。

抽样确认这些是真问题，不是误报。例如：

    internal/agent/api/codec_chunkfast_golden_test.go:68:9:
        this value of fastOK is never used (SA4006)
    internal/agent/api/codec_chunkfast_golden_test.go:69:2:
        empty branch (SA9003)

`fastOK` 赋值后从未使用，且紧跟一个空分支 —— 那里本意要区分
「回退」与「快速路径给出失败」，实际什么都没做。

## 覆盖率采集

仓里 521 个测试文件、11.2 万行测试代码，但**没有任何覆盖率数据** ——
无法回答"哪些模块其实没被测到"。

补的步骤只报数，不设阈值：

  · 打总覆盖率
  · 打覆盖率最低的 15 个包

**为什么不设阈值**：阈值会促成"为凑数写空判据"，那比没覆盖率更糟
（本仓 engineering-lessons §1.1 记的就是这个）。这里只把数字
摆出来，让人做模块级决策时有参照。

顺带：这一步同时兜住了 `go test` 的失败（`|| { ... exit 1; }`），
所以它不只是统计，也是一道执行力门。

## 验证

    YAML 语法             OK
    CI 门禁自检           通过（动态枚举 / 排除表 / 启动图 / 交叉枚举 / run 步骤语法）
    本地复跑 staticcheck  rc=1、24 条 = 基线 ⇒ 通过
    go build ./...        PASS
    go test（core/webui） 全绿

## 后续

staticcheck 存量 24 条已登记方向（future-plan.md「staticcheck 存量」）。
它不是判据问题，是代码问题，单独收敛。

2026-11-04 18:20:04 +08:00

..

scripts

fix(ci): 修复 c20e7c6 带进来的 && false 死条件 + 自测调用计数契约

2026-10-25 08:06:46 +08:00

workflows

ci: 补 staticcheck + 覆盖率采集 —— 把"看不见"变成可见

2026-11-04 18:20:04 +08:00