Skip to content

code-association 0.10.0

Latest

Choose a tag to compare

@geek-xin geek-xin released this 30 Oct 05:55

code-association 0.10.0

跨程序变更影响扫描工具(Java / Maven 多模块仓库):分析一次提交改动了哪些类、方法、
SQL、MQ 消息结构,并推导出对其他模块 / 服务的连带影响与风险等级。

这一版有两件新东西:设置页可以把设置项 + 全部代码源导出成一个文件,搬到另一台机器上导入回来;
证据面板不再只贴引用行上下 3 行,而是把引用行所在的整个方法 / 类型 / XML 元素 / SQL 语句展开。
同时修好两处「读不到、读不全」的问题:大变更上影响清单过多会让整次分析在最后一步失败,
历史报告的证据链则整段显示「源码不可用」。

新增:配置导入导出

换机器以前要分两步:先用「代码源导入导出」搬代码源,再手工重配 AI 接口与 GitLab 令牌——
只带走代码源的话,另一半配置没人记得,新机器上第一件事就是「AI 审核怎么不生效」。
现在设置页的「配置导入导出」卡片把 AI 审核设置、GitLab 令牌与全部代码源装进同一个文件
(kind=code-association.config、version=1),导出与导入各一个接口。

  • 密钥默认不进文件。 「包含密钥」默认不勾,此时文件里没有 ai.apiKey 与 gitlab.token;
    只有显式勾选或 ?secrets=1 才写入,导出响应带 Cache-Control: no-store。
  • 导入不会清空本机密钥。 文件里没写的字段保持本机现值——一份不含密钥的备份被导回来,
    不该顺手把令牌清空。
  • 部分成功是常态,仍是 HTTP 200。 设置项按 ai / gitlab 分组独立校验、独立应用,
    失败的一组记入 settings.errors(带 section 与中文 reason),其余分组与代码源照常生效;
    只有 kind 不认识、version 比 1 新才回 400。
  • 也接受 5.9 的代码源导出文件(kind=code-association.sources),此时只处理代码源。

新增:证据链展开引用行所在的整段代码

证据行与路径跳点下方原来固定贴引用行上下各 3 行:够看清一个条件,却常常把方法签名和结尾切在
窗口外,读者仍然要回仓库确认「这是哪个方法」。现在 GET /api/analyses/{id}/code 支持
mode=block(界面固定传),片段按代码块边界取整块:

  • Java / JS / TS 等花括号语言取最近的方法体 / 类型体 / 初始化块;if / for / try 这类
    控制块继续向外扩,lambda 与匿名类也继续向外;字符串、注释、文本块里的花括号不参与配对。
  • MyBatis mapper / XML 取包含引用行的元素(通常是一整条 <select>),根元素不选。
  • .sql 按分号切语句,字符串与注释里的分号不算。
  • 没有块边界的 .properties / .yml 退化为上下各 10 行。
  • 超过 160 行的块只展示引用行附近,并注明「共 N 行,展示第 a–b 行」。

片段上方新增一行小字说明范围(「方法 · 第 27–30 行」「元素 select · 第 5–20 行」);
原来的 note 继续只承担「分析版本不在本地仓库」「文件只到第 N 行」这类异常说明。

修复:跨程序影响过多时,分析不再在最后一步失败

一次 2880 个文件、20052 项变更的分析产出 67 万条跨程序影响,report_json 序列化成单个字符串时
撞上 Jackson 的 2 GiB 文本缓冲上限,整次分析在跑完 107 秒后被标记失败、报告全丢。现在影响清单
按风险保留前 N 条(code-association.max-report-impacts,默认 5000,名额按对比程序公平分配),
计数仍按全量;报告新增 impactsTotal / impactsShown / impactsTruncated / impactsNote,
审核页明确写出「共多少处、列表保留多少处」。同一批影响不再序列化两遍(peers[].impacts 不再进
JSON),契约地图的模块关系边也按程序去重。

修复:历史报告的证据链不再整段显示「源码不可用」

报告里的 peerSourceId 是 long,本程序内部影响落库后是 0 而不是 null;前端把 0 当成
对比程序 id 传给源码接口,服务端按「这次分析里没有该对比程序」拒绝。现在 0 与空值同义
(读本程序源码),历史报告里也能直接展开方法。

下载

文件 说明
code-association-0.10.0.jar 可执行 jar 单文件,应用内「自动更新」用的就是它
code-association-0.10.0.zip Windows 推荐(自带解压即可,保留 CRLF)
code-association-0.10.0.tar.gz Linux / macOS 推荐

两个压缩包内容完全一致,均包含:可执行 jar、start.sh / stop.sh、
start.bat / stop.bat / start.ps1 / stop.ps1、application.yml 示例配置、
README.md、docs/ 与 INSTALL.md。

运行

Linux / macOS

tar -xzf code-association-0.10.0.tar.gz   # 或 unzip code-association-0.10.0.zip
cd code-association-0.10.0
chmod +x start.sh stop.sh
./start.sh                          # 默认 http://127.0.0.1:9996
./stop.sh

Windows

:: 解压 zip,进入解压目录
start.bat                           :: 默认 http://127.0.0.1:9996
stop.bat

需要 JDK 21+。详见包内 INSTALL.md。

升级说明

从 0.3.0 起可以直接用应用内更新:设置 → 版本与更新 → 应用更新 → 按提示重启。
0.6.0 起换完 jar 会自己重启(auto-restart 默认开),失败自动回滚到备份 jar;
更早的版本换完只会提示你自己执行 stop.sh / start.sh。

本版新增一个配置项 code-association.max-report-impacts(默认 5000,0 或负数表示不截断),
其余配置与历史报告不受影响;被旧缺陷挡住的分析重新发起一次即可。