Skip to content

AcpAgent Client 1.4.0

Choose a tag to compare

View all tags
@ClickPM ClickPM released this 20 Sep 10:02
· 173 commits to main since this release
v1.4.0
25a7074

R8 Windows 端。这是第一个带安装包的 release —— v1.0.0 到 v1.3.0 都只发源码，需要自己构建。

下载哪一个

文件 体积 说明
AcpAgentClient-1.4.0-setup.exe 79.0 MB 一般选这个。per-user 安装，装进 %LOCALAPPDATA%\Programs\AcpAgentClient，不要管理员权限。含 Zed Agent sidecar
AcpAgentClient-1.4.0-windows-x64.zip 110.3 MB 免安装，解压即用。含 Zed Agent sidecar
AcpAgentClient-1.4.0-windows-x64-nosidecar.zip 46.7 MB 免安装，不含 sidecar：不需要 Zed 内置 agent 时体积小一半多。其余五个 agent 照常

Windows 10 / 11 x64。其余 agent（Claude Agent、Codex、Cursor、pi、DeepSeek Harness）走 ACP registry 在应用内安装，npx 型的需要系统 Node ≥ 22（没有的话应用会下载一份受管 Node 到自己的数据目录）。

安装包没有代码签名，SmartScreen 首次会拦一下：「更多信息」→「仍要运行」。用户数据在 %APPDATA%\AcpAgentClient，卸载不会删它。

SHA-256：

b01072c2d55baaa04439693466a00e46e474d2f5fd452c5e25bce130b31bb698  AcpAgentClient-1.4.0-windows-x64.zip
3b149628491bf97b73bc8981ffab3fdd41a9870c3d980266c79904b9256e0ae7  AcpAgentClient-1.4.0-windows-x64-nosidecar.zip
6c4fa202242350a5b877e414050cd78ab890d1564818404cd17ab033e41e45ab  AcpAgentClient-1.4.0-setup.exe

变更

sidecar 的版本号与应用解耦

sidecar/zed-agent-acp（Zed 内置 agent 的 ACP 包装，176 MB 的可执行文件）此前版本号跟着应用一起抬，而 cargo 只要看见 Cargo.toml 里 version 变了就会重编这个 crate 并全量重链 —— 发一次版本白等一刻钟，而它的源码根本没动。

实测四个数（本机，release）：

改了什么 耗时
什么都不改 8.23 s（cargo 判 fresh）
改 Cargo.toml 的 version 14 m 16 s
只改 Cargo.toml 里的注释 9.53 s（fresh —— fingerprint 认的是 manifest 的解析结果，不认注释）
抬应用版本 1.3.0 → 1.4.0 1.51 s（fresh）

现在 sidecar 的版本跟上游 zed 钉版本走（1.21.0，事实来源是 pins/upstream.json 里 zed 那条新增的 version 字段），只在换 zed 钉版本时才动 —— 那一次本来就要重编整个依赖闭包。这条写成了 CLAUDE.md 的硬性规则 11，scripts/validate.ps1 新增「版本门」核对四个数（pubspec.yaml / rust/Cargo.toml 的应用版本两处一致；sidecar 版本 == pins 的 zed version == vendor 里 zed manifest 的 version）。zed-agent-acp --version 现在也带上钉的上游 commit：

zed-agent-acp 1.21.0 (zed @ d9e1c024f393832765a03f4de204d6c8cd9abcb2)

Windows 打包

  • scripts/package.ps1：一条命令出上面三件产物（dist/）。sidecar 不在这里构建，build/sidecar/ 里有就随包、没有就只出精简 zip。
  • packaging/windows/acp-agent-client.iss：Inno Setup 安装器脚本，per-user、不签名，LICENSE 进安装向导，卸载不碰 %APPDATA% 的用户数据。
  • scripts/verify-package.ps1：产物的自动化验收。每条都把 %APPDATA% 指到新建的空目录再起进程（本机能做到的「干净机首启」等价物）：zip 解压即用跑通无头往返、精简包确实没有 sidecar、随包 sidecar 的 --version 与 --selftest、安装器静默装 → 跑通 → 静默卸载后目录与卸载注册都清干净。

版本与构建信息进日志

起核心时往 %APPDATA%\AcpAgentClient\logs\acp-<日期>.log 写一行：

core   AcpAgentClient 1.4.0 (release, windows/x86_64) data=… sidecar=…

装机报障要问的「哪个版本、哪种构建、sidecar 随没随包」都在这一行。设计稿（画板 70）没有版本位，所以版本号只进日志、不进界面。

其他

NOTICE 与 Zed 派生文件的头注释改成双向核对（扫到的派生文件都要在 NOTICE 里；NOTICE 列的都要在盘上且带头注释），并进 validate.ps1。LICENSE 与 NOTICE 随安装包分发。

已知限制

  • 只有 Windows x64。macOS / Linux 构建（含原生窗口控制）留给后续一轮。
  • 安装包未签名。
  • 安装器界面只有英文（Inno Setup 6 自带的语言包里没有简体中文，入库第三方 .isl 等于再分发）。应用自己的界面照常是中文。
  • sidecar 的 --selftest 路上有两条 stderr 噪音（prompt_store 的 lmdb 环境重复打开、settings_store 往未建出的目录写 settings 失败），退出码为 0、不影响功能。

完整的轮次记录、实测数字与三轮独立审查的 findings 处理在 rounds/round-08/round-08.md。

Assets 5
Loading