Repository navigation
Releases
Releases · GALAXYLLIYI/computer-use-gate
v0.1.2 - wheel-only packaging
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.pyauth_popup.pygate.pyguardian_policy.jsonperceive.pypost_compat.json验动作.py
需要先把 live 改动同步回真源(legacy_tools/_src/)并重生/重同步 live,再打 zip。
没有绕过闸门。
4.2 仓库工作区未提交
当前还有用户侧未提交改动:
build/AgentCtl.speccontract/tools.jsonsrc/agentctl_main.py
以及未跟踪的 build_retina/、deploy/、dist_retina/ 等。发布 commit 需要确认是否纳入这些改动。
4.3 未做
- PyPI 上传(需要账号/token)
- 干净 Windows VM 安装(当前是临时 venv + pipx,不是完整 VM)
- demo 视频录制(脚本已出)
install.ps1的 zip 路径(等 legacy 对齐)
5. 下一步
- 决定 v0.1.2 是 wheel-only,还是等 legacy 对齐后同时发 zip。
- 确认 release commit 是否包含
contract/tools.json、src/agentctl_main.py、build/AgentCtl.spec。 - 在干净 Windows VM 上跑 wheel + pipx +
agentctl status+--list。 - 上传 PyPI(需要账号/token)。
- 录 demo,替换 README 占位。
v0.1.1 — 修复陌生人首跑断链
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 — 开源首版
⚠ 已被 v0.1.1 取代:这一版的 install.ps1 在 Gitee 上取包 404、干净克隆打包失败。新装请用 v0.1.1。