VarAlign – 捕获AI编程助手在会话间散落的重复变量

VarAlign 是一款专为 VS Code 设计的扩展，旨在解决 AI 编程助手在跨会话编程时产生的变量混乱问题。AI 助手经常忘记之前的操作，在不同的会话中重新引入已存在的变量（但使用了不同的名称），或者让变量值偏离之前定义的内容，甚至在文件移动后留下未定义的变量。VarAlign 可以跟踪 AI 助手编写的每一个赋值操作，对重复和漂移进行评分，并提供可直接粘贴到 AI 助手中的修复提示。

该扩展完全在本地运行，不需要任何云服务或遥测，代码永远不会离开用户的机器。因此，它可以在严格限制或断网的环境下正常工作。VarAlign 的核心是一个零依赖的 Python 引擎，它随扩展一起发布，无需额外安装。用户界面则是轻量级的只读客户端。

VarAlign 提供了几个原生树形视图："重复项"（按高/中/低分组）、"变量"（按文件分组并标记重复级别）和"会话"（显示每个 AI 会话引入或更改的变量）。在重复项视图中，用户可以展开配对查看双方，并通过右键菜单进行确认、忽略或添加注释。状态栏会显示高优先级重复项的数量。

使用 VarAlign 非常简单：安装扩展后，确保 Python 3.11 或更高版本在 PATH 中，然后打开一个仓库并点击活动栏中的 VarAlign 图标即可开始跟踪。扩展会在仓库根目录创建 .varmem/ 文件夹来存储跟踪数据，并自动将其添加到 .gitignore 中。

VarAlign 提供 Pro 版本，解锁变量合并功能：用户可以直接在编辑器中将重复的变量合并为规范名称，并自动重写所有引用和删除重复定义。Pro 许可证通过 Ed25519 签名密钥在本地验证，即使在离线环境也能工作。

VarAlign 还支持自托管 API，适合团队集中运行引擎。用户只需在设置中配置 API 地址、令牌和项目 ID，即可让视图通过 API 读取报告。

该扩展的 VS Code 部分采用 BSL 1.1 许可证（源代码可用），2023年7月15日后转为 Apache-2.0；底层引擎单独使用 Apache-2.0 许可证。开发人员可以通过 npm 和 esbuild 进行构建和打包。