Repository navigation
Augit 1.0.0-rc.4
Pre-release
Pre-release
·
43 commits
to main
since this release
Augit 1.0.0-rc.4 发布说明
- 发布日期:2026-10-26
- 状态:公开预发布候选(GitHub Pre-release),不是正式 1.0
- 构建源提交:
5b03ccb303683a427e67f607dfc4a7dab384a961(GitHub Actions 从 tag 构建;Augit.exeProductVersion 内含该提交号) - 发布记录 / tag:
v1.0.0-rc.4 - 平台:Windows 10 22H2 x64、Windows 11 x64
1. 这是什么
Augit 是面向「代码由外部 AI、脚本或人工修改」这一协作方式的轻量 Windows 只读项目查看器与 Git 图形工具。界面使用 C#/.NET 10 原生 Win32 外壳 + WebView2,不接入 AI,不提供内置文本编辑和保存。
rc.4 是 Windows 10 22H2 启动/选择目录退出的加固版,建立在 rc.3 的 self-contained 便携包之上。它不改变产品功能或 Git 行为,新增启动兼容性、异常边界、诊断日志和 git init 超时。
2. 下载
| 文件 | 大小 | SHA-256 |
|---|---|---|
| Augit-1.0.0-rc.4-win-x64-setup.exe | 5,016,402 B | dc79380768b40c2592fb372f4e6cf2b6414c2d29b7637194eb26cd89d38d16a4 |
| Augit-1.0.0-rc.4-win-x64-portable.zip | 39,134,517 B | 9168826c43a145405186894bf3bee652d5ac952881887791e6bfa49e4ba5dc29 |
| SHA256SUMS.txt | 205 B | 7212a1c2cdbd347f13ed1e02ce076d3ffef9c2c4913c26f09bbe177356a4ca97 |
发布页:https://github.com/Paranoid49/Augit/releases/tag/v1.0.0-rc.4
- 上表与 Release 正文、附件
SHA256SUMS.txt一致;发布后已匿名下载复核。 - 便携版:自带 .NET 10.0.11 Runtime,不需要预装 .NET;只要求系统已有 Microsoft Edge WebView2 Runtime。不写系统 PATH,不添加资源管理器菜单,不安装或修改共享运行时。
- 安装版:按需联网的小型安装器,需要管理员权限;缺少 .NET 10/WebView2 时先说明,经确认后从项目锁定的微软官方地址下载并校验哈希与 Microsoft 签名。
- 两种包共用
%LOCALAPPDATA%\Augit中的个人设置、最近目录和会话状态。
3. rc.4 的变化
3.1 Windows 10 兼容性
- 发布 apphost 显式设置
<CETCompat>false</CETCompat>。Windows 10 部分机器/补丁级别对 CET(影子栈)支持不完整;默认开启 CET 的 .NET apphost 可能在启动或首次进入新代码路径时以0x80131506退出。此开关只影响 apphost 的 CET 兼容标记,不改变 .NET 运行时、技术栈或产品功能。 - 这是对 Windows 10 22H2 支持范围的兼容性修复,不是降低 Windows 安全更新要求。
3.2 首次启动不再把程序目录当工作区
- 双击便携包或开始菜单快捷方式时,Windows 会把当前目录设为程序目录。rc.3 会直接把
D:\Augit之类的发布目录当工作区,展示Augit.exe、coreclr.dll等二进制,并进入“创建 Git 仓库”状态。 - rc.4 在没有有效最近目录、且当前目录等于程序目录时,改用
%LOCALAPPDATA%\Augit\Welcome空目录,并在首屏直接显示「Open Workspace」启动页,而不是因为空目录不是 Git 仓库就自动弹出「Create Git Repository」。 - 用户通过「打开目录」选择真实项目;显式
--workspace(包括augit .)不受影响。
3.3 退出保护与本地诊断
OnWebMessageReceived/OnNavigationCompleted等 async void 事件处理器增加最外层异常边界:处理器内部异常只写本地日志,不再把异常抛回消息循环导致进程终止。- 新增
%LOCALAPPDATA%\Augit\logs\augit.log:记录启动版本、系统、参数、工作区、桥接异常、工作区/Git watcher 初始化异常和 WebView2 进程失败。日志只在本机,不上传,不包含文件内容或 Git 输出/凭据;超过 4 MB 轮换为augit.log.1。 - 如果 rc.4 仍异常退出,请把
%LOCALAPPDATA%\Augit\logs\augit.log的最后一段附到 Issue;若进程直接消失且日志为空,请同时提供 Windows 事件查看器「Windows 日志 > 应用程序」中Application Error/.NET Runtime的事件。
3.4 git init 边界
git/init现在先校验目标必须是本机固定磁盘上可访问的本地目录,拒绝网络/远程/无效路径。git init增加 30 秒显式超时;超时后结束进程并返回可读失败,不再无限停在“Initializing…”。InspectAsync仍使用 30 秒查询超时。
4. 与前序版本的关系
- rc.3 修复了“新电脑便携版缺 .NET”的问题:便携包 self-contained。
- rc.4 修复/加固 Windows 10 22H2 上“首次启动选择目录后卡住并退出”的问题;便携版仍是 self-contained,安装版仍是联网安装器。
- 运行代码在 rc.4 中新增的是启动/异常边界和
git init超时,不改变文件浏览、Git、终端或 Settings 的产品行为。 - rc.2、rc.3 的公开 Release 保留,不覆盖、不改写。
5. 验证摘要
- Release 构建:0 警告、0 错误。
- 测试:Core 72/72、Shell 270/270、Infrastructure 207/207(新增首次启动回退与显式写超时测试;托管 CI 排除 4 个需要交互式控制台的 ConPTY 用例)。
- UI 资产字节一致性、PowerShell 编码、文档数字自洽、coverage generator 检查通过。
- 发布后匿名下载实际 Release 便携包并启动 PASS(隐藏
DOTNET_ROOT):窗口类Augit.Shell.Window、窗口出现 469.5ms、关闭 96ms、退出码 0、无残留子进程;ProductVersion1.0.0-rc.4+5b03ccb…,includedFrameworks为Microsoft.NETCore.App 10.0.11。 - 首次启动(无有效最近目录、当前目录为发布目录)显示「Open Workspace」,
augit.log记录startup-workspace=welcome;不再自动弹出「Create Git Repository」。 - Windows 10 22H2 实机复验:rc.4 的 CET/首次启动/退出保护需要在用户出问题的机器上复验;rc.3 的 Windows 10 22H2 双屏/DPI/安装证据仅覆盖运行代码相同的部分,不覆盖本版的启动路径修复。
- 仍未验证:干净虚拟机、真实缺少 WebView2 的安装流程、三块及以上显示器、物理拔插显示器。
6. 系统要求
- Windows 10 22H2 x64 或 Windows 11 x64(不支持 32 位、ARM64、Windows Server、Windows 预览版、网络共享目录和远程文件系统)。
- 便携版:自带 .NET 10.0.11 Runtime,无需预装 .NET。
- 安装版:需要 .NET 10 Runtime;缺少时安装器先说明,经确认后下载锁定的微软运行时并校验哈希与 Microsoft 签名。
- Microsoft Edge WebView2 Runtime(Evergreen),两种包都需要。
- Git for Windows 2.40 或更高版本(仅 Git 功能需要);Augit 不捆绑 Git。
7. 已知限制
完整清单见已知限制。重点:
- 未代码签名,SmartScreen 可能提示未知发布者。
- 本次 Windows 10 22H2 修复需要在用户机器上复验;干净虚拟机、真实缺 WebView2、三屏/物理拔线未验证。
- 整窗像素历史结果仍为 0 张合格 / 50 组页面级配对;只登记持续改进。
- 500ms 历史慢样本未归因;Settings 冷开 567ms;80,000 行软换行全量 DOM;离屏全文连续朗读受限。
- Diff 有 10MB/20MB 与 2000 行实现上限;搜索超时仅受控慢条件验证;Push 认证覆盖按专项记录限定。
- 不提供 Force Push、子模块、平台接口、Git Console、自动更新或遥测。
8. 反馈
通过 GitHub Issues 反馈。请附版本、复现步骤、期望/实际结果;若异常退出,附 %LOCALAPPDATA%\Augit\logs\augit.log 末段或 Windows 应用程序日志中的崩溃事件。Augit 不做遥测/崩溃上报,不会自动上传代码、日志或使用数据。