Repository navigation
code-association 0.5.0
code-association 0.5.0
跨程序变更影响扫描工具(Java / Maven 多模块仓库):分析一次提交改动了哪些类、方法、
SQL、MQ 消息结构,并推导出对其他模块 / 服务的连带影响与风险等级。
本次重点:分析过程进度实时可见
分析详情页在运行期间实时显示阶段、百分比、「第 N / 8 步」,以及当前处理的文件与计数
(如 C215.java (1531/2400)),步骤条随阶段点亮。此前大型仓库上进度会长时间停在
同一个数字,看起来像卡死——修掉了三个原因:
Progress.file收下了to上界却从未使用,索引阶段始终上报from(20%)。
INDEX_HEAD在大型仓库上占用绝大部分墙钟时间,界面于是一整段时间显示同一个数字。
现在按已处理文件数在[from, to)内插值,阶段结束时仍精确落在边界上。- 真正的大头是
CallGraphBuilder.build()的第二次全量遍历,它此前完全不报进度。
两趟遍历现在共用一套计数单位(每文件两个单位),百分比单调上升,不会走到 100% 再回退。 - 从历史记录打开正在运行的分析时只把快照塞进面板、没有订阅它,于是一次渲染后再也不动。
现在打开运行中的分析会重新开始轮询。
本次重点:代码源标签与导入导出
- 代码源标签分类:一个代码源可以打多个标签,左侧菜单按标签分组、每组可折叠,
列表每行显示标签 pill,点一下即按该标签过滤。标签不参与分析,只影响检索与展示。 - 代码源导入导出:设置页新增卡片,用于换机器迁移、团队共享与备份。
按 type + location 判定同一代码源,已存在则合并标签(并集),不存在则新建;
单条非法只记入errors并继续处理其余条目。 - 编辑代码源:列表每行新增编辑按钮,走
PUT /api/sources/{id}。
本次重点:版本检查与自动更新
设置页新增「版本与更新」卡片:当前版本、最新版本、历史版本列表一目了然。
服务会定时向 GitHub 查询 release,不用再手动去发布页翻。
| 入口 | 作用 |
|---|---|
GET /api/update |
当前 / 最新 / 历史版本(带缓存,命中不耗 GitHub 额度) |
POST /api/update/check |
强制重新检查 |
POST /api/update/download |
下载指定版本的 jar 到 {data-dir}/updates/,边下边算 SHA-256 |
POST /api/update/apply |
先备份当前 jar 为 <jar>.bak-<版本>,再替换 |
POST /api/update/rollback |
从最近的备份回滚 |
检查是自动的,替换 jar 需要你点确认。 让程序重启自己会让前端拿不到响应,
也把「什么时候中断服务」的决定权从运维手里拿走了。替换后界面会提示执行
./stop.sh && ./start.sh(Windows 用 stop.bat 再 start.bat)。
三种情况会明确拒绝替换并说明原因:在 IDE 里跑(没有可替换的 jar)、Windows
(运行中的 jar 被系统锁定)、还没下载(无暂存文件)。
关于 GitHub 限流
未认证调用 api.github.com 每小时只有 60 次。默认 6 小时检查一次,够用;
频繁点「立即检查」会撞 403,此时界面会明确说明是限流并给出额度重置时间。
配置 GITHUB_TOKEN(只读 classic token,无需任何 scope)可提到 5000 次/小时。
左侧菜单栏可收起
文字菜单可以折起来只留图标栏,把宽度让给工作区:
- 侧栏右上角的折叠按钮,或图标栏底部收起后出现的展开按钮;
- 快捷键
Ctrl + B/⌘ + B(在输入框里自动让位); - 选择记在浏览器本地,刷新后保持,首帧就按记下的状态渲染。
窄屏(≤860px)默认收起,但仍然可以手动展开——此前该断点把菜单藏死、没有展开入口。
修复
- 重启提示会误判:
apply后要提示「已替换 jar,请重启服务生效」,原判据是
「当前版本 == 已应用版本」。但 JVM 一直报告它启动时的版本,所以「重新应用正在跑的
版本」会被当成「已经重启过」,提示当场消失。改用进程启动时间判断,
status返回startedAt、apply/rollback返回swappedAt,只有前者晚于后者才算重启完成。 release.sh的 jar 校验被 SIGPIPE 误判:unzip -Z1 ... | grep -q在pipefail下
是错的——grep -q命中后立即退出,unzip收到 SIGPIPE 被杀,整条管道返回 141,
于是「校验通过」被当成失败。改为先把清单读进变量再 grep。- 分析失败后看不到任何详情:失败的分析没有报告,而详情页在没有报告时会隐藏
#an-body,进度卡片原先正嵌在这个容器里,于是失败原因被写进一个display:none
的区域——点开一条失败记录,页面显示「暂无数据」和「这个代码源还没有分析记录」。
现在进度/失败卡片移出该容器,失败时单独渲染「失败原因」区块;页面状态改由
选中的分析记录推导,历史列表与总览时间线也直接显示失败原因。 - 仓库里有一个超大文件,就导致该程序的每一次分析全部失败:
GitTreeSource.read把 20MB 写死在loader.getBytes(20 * 1024 * 1024)里,
而 JGit 超限时抛的是LargeObjectException(RuntimeException),原有的
catch (IOException)拦不住,异常一路冒到AnalysisService.run,整次分析被标记为 FAILED。
现在先比loader.getSize()再读,超限即跳过并在报告「跨程序分析边界」里列出文件名与大小。
新增配置max-file-mb(默认 20MB,设为0关闭限制)。
下载
| 文件 | 说明 |
|---|---|
code-association-0.5.0.jar |
可执行 jar 单文件,应用内「自动更新」用的就是它 |
code-association-0.5.0.zip |
Windows 推荐(自带解压即可,保留 CRLF) |
code-association-0.5.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.5.0.tar.gz # 或 unzip code-association-0.5.0.zip
cd code-association-0.5.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.3.0 及更早的版本没有这个功能,请手动下载替换 jar(旧 jar 会被备份为 .bak-<版本>,可回滚)。