Repository navigation
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.shWindows
:: 解压 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 或负数表示不截断),
其余配置与历史报告不受影响;被旧缺陷挡住的分析重新发起一次即可。