Skip to content

Releases

v0.1.2 - wheel-only packaging

Pre-release

Choose a tag to compare

@GALAXYLLIYI GALAXYLLIYI released this 08 Nov 02:45

v0.1.2 发布准备单 · 2026-11-08

状态:wheel 已构建并验证;本 Release 只发 wheel;zip 待 legacy 对齐后补。
发布态:GitHub Pre-release;releases/latest 仍指向带 zip 的 v0.1.1,
install.ps1 可正常安装,不会落到没有 zip 的 v0.1.2。
原因:zip 打包被 legacy 一致性闸门拦住;仓库工作区还有未提交的 build/deploy 改动。

1. 产物

F:\ZhuanZ\Documents\agent-ctl\dist\v0.1.2\computer_use_gate-0.1.2-py3-none-any.whl
size:   616,726 bytes
sha256: C2EF3F4849EFEB5B1D4575B22845622D1D5364D092B6D4A575C43978670FE470

zip(agentctl.zip)未生成:tools/pack_dist.py 因 live 与仓内产物不一致而中止。

2. 本版改了什么

打包 / 安装

  • 修复 PEP 639 License classifier 冲突:pip install -e . 不再失败。
  • 新增 console script:agentctl = "agentctl.cli:main"。
  • 新增 src/agentctl/__main__.py:python -m agentctl 可用。
  • 包名统一为 computer-use-gate;CLI 保持 agentctl;import 包保持 agentctl。
  • requires-python 收紧为 >=3.12,<3.13,与 install.ps1 的 cp312 vendor wheel 一致。
  • 契约随包:src/agentctl/contract/tools.json + tools/sync_contract.py;
    core.tool_list() 在仓库根缺失时回退到包内副本。

文档

  • README 第一屏改为“30 秒看懂 + 30 秒试一下”,增加英文入口和 demo 占位。
  • 新增 docs/demo-60s-script.md:60 秒 demo 分镜。
  • 新增 docs/benchmark-50-20261108.md:20 应用 / 50 任务 benchmark 规格。
  • 新增 docs/launch-status-20261108.md:发布状态单与问题清单。

3. 已验证

路径 结果
临时 venv + wheel + --no-deps 成功
agentctl status JSON,ok: true,退出码 0
python -m agentctl status JSON,ok: true,退出码 0
agentctl --list 29 行,无 _error
pipx install <wheel>(临时 PIPX_HOME) 成功
pipx 的 agentctl status JSON,退出码 0
wheel 内契约 agentctl/contract/tools.json,91,618 bytes

4. 未完成 / 阻塞

4.1 zip 被 legacy 一致性闸门拦住

tools/pack_dist.py 报:

[X] live 与仓内产物不一致 —— 中止发包

涉及:

  • act.py
  • auth_popup.py
  • gate.py
  • guardian_policy.json
  • perceive.py
  • post_compat.json
  • 验动作.py

需要先把 live 改动同步回真源(legacy_tools/_src/)并重生/重同步 live,再打 zip。
没有绕过闸门。

4.2 仓库工作区未提交

当前还有用户侧未提交改动:

  • build/AgentCtl.spec
  • contract/tools.json
  • src/agentctl_main.py

以及未跟踪的 build_retina/、deploy/、dist_retina/ 等。发布 commit 需要确认是否纳入这些改动。

4.3 未做

  • PyPI 上传(需要账号/token)
  • 干净 Windows VM 安装(当前是临时 venv + pipx,不是完整 VM)
  • demo 视频录制(脚本已出)
  • install.ps1 的 zip 路径(等 legacy 对齐)

5. 下一步

  1. 决定 v0.1.2 是 wheel-only,还是等 legacy 对齐后同时发 zip。
  2. 确认 release commit 是否包含 contract/tools.json、src/agentctl_main.py、build/AgentCtl.spec。
  3. 在干净 Windows VM 上跑 wheel + pipx + agentctl status + --list。
  4. 上传 PyPI(需要账号/token)。
  5. 录 demo,替换 README 占位。

v0.1.1 — 修复陌生人首跑断链

Choose a tag to compare

@GALAXYLLIYI GALAXYLLIYI released this 24 Oct 09:40

AgentCtl v0.1.1 — 修复陌生人首跑断链

如果你在 v0.1.0 上碰过这些,这版就是给你的:

  • 修 Gitee 取包链:install.ps1 原来用 GitHub 风格的 releases/latest/download,在 Gitee 上 404;
    现在先向 Gitee API 取最新 tag,再走 releases/download/<tag>/agentctl.zip;删掉了会返回 HTML 的 archive/main.zip 回退。
  • 修 干净克隆打包:probe.py 已在仓内(以前被 .gitignore 忽略,导致 pack_dist 在干净克隆上直接失败)。
  • 修 gate.py 的 invalid escape(docstring 改 raw),消除 SyntaxWarning 导致的冒烟失败。
  • 门面清理:作者署名占位符 → GALAXYLLIYI;删掉 security@<你的域名> 坏链;
    删掉 README 里两处过时警告(第三方许可已齐全、AGENT接口.md 路径已脱敏)。

验证方式(我们自己的闸):tools/smoke_clean_clone.py 在干净克隆上 6/6 步 PASS(含装后 bench 与 selftest)。

安装(先看脚本再跑):

irm https://gitee.com/GALAXYLIYI/agent-ctl/raw/main/install.ps1 -OutFile install.ps1
notepad install.ps1
.\install.ps1

或从本页下载 agentctl.zip + agentctl.zip.sha256,先核哈希:

Get-FileHash .\agentctl.zip -Algorithm SHA256   # 与 .sha256 第一列逐字符比对

注意:Windows 10/11 + Python 3.12 + git;装完默认全拒(设计如此);适用范围很有限,详见 README。

v0.1.0 — 开源首版

Choose a tag to compare

@GALAXYLLIYI GALAXYLLIYI released this 24 Oct 08:58

⚠ 已被 v0.1.1 取代:这一版的 install.ps1 在 Gitee 上取包 404、干净克隆打包失败。新装请用 v0.1.1。