Skip to content

code-association 0.5.0

Choose a tag to compare

@geek-xin geek-xin released this 27 Oct 02:10
· 21 commits to main since this release

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.sh

Windows

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

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

升级说明

从 0.3.0 起可以直接用应用内更新:设置 → 版本与更新 → 应用更新 → 按提示重启。
0.3.0 及更早的版本没有这个功能,请手动下载替换 jar(旧 jar 会被备份为 .bak-<版本>,可回滚)。