Skip to content

Releases: jiwangyihao/trail-cli

v0.1.2

13 May 11:44
@github-actions github-actions
v0.1.2
aac3ff4
This commit was signed with the committer’s verified signature.
jiwangyihao jiwangyihao
GPG key ID: 9875AAC8A3A1FBD0
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
v0.1.2 Pre-release
Pre-release

阶段性公开测试说明

v0.1.2 是一次面向「安装可用性、README 用户入口、daemon 异步续查模型」的阶段性预发布。重点不在新增一个单点玩法命令，而是把 Agent 长任务执行、失败恢复、安装入口和用户文档继续收口。本版本仍标记为 pre-release，建议先在可回滚环境中试用。

安装与升级

普通 Windows 用户建议下载：

  • trail-cli-windows-x64-v0.1.2.zip

解压后运行压缩包内的安装入口即可。普通安装不要求本机已有 Python、uv 或 Node。安装器会同步 CLI、daemon 和完整 Trail skills bundle。

Agent / 自动安装场景可使用：

$script = Join-Path $env:TEMP 'trail-agent-install.ps1'
iwr 'https://github.com/jiwangyihao/trail-cli/releases/download/v0.1.2/agent-install.ps1' -UseB -OutFile $script
powershell -NoProfile -ExecutionPolicy Bypass -File $script -Agent openclaw -Scope user -CliVersion 0.1.2 -RepoSlug 'jiwangyihao/trail-cli' -Yes

如果已经安装过旧版，建议仍使用上面的安装器覆盖安装；安装器会同步 CLI、daemon 和 skills。需要校验下载文件时，请使用 SHA256SUMS.txt。

主要变化

1. README 改为普通用户入口

本版本重写了 README，让它只回答普通用户需要先知道的问题：这个项目是什么、从哪里下载、如何安装、Agent 如何接管、当前能力边界是什么。

具体变化：

  • README 顶部改为 badges + 当前重点提示块，突出 Windows 预发布和「货币战争」当前重点。
  • 安装说明拆成普通用户、让 Agent 帮你安装、面向 Agent 的安装说明三块。
  • 首页不再承载命令协议、输出字段、恢复链路、renderer 契约、skill 拓扑或玩法细节。
  • 详细协议继续留在 active skills、命令参考、契约测试和专项设计文档中，避免普通用户首页被内部实现细节淹没。

这次 README 调整的目标是：新用户先能安装和启动，而不是先读完一份内部协议说明书。

2. Windows 安装脚本改为 ASCII 英文输出

修复 Windows 用户设备上的安装脚本文字编码问题。

此前部分环境会按非 UTF-8 代码页读取 PowerShell 脚本，中文字符串可能导致脚本解析异常，典型表现是安装前就出现 ParserError。本版本将以下入口的用户可见输出、提示和错误前缀改为纯 ASCII 英文：

  • scripts/agent-install.ps1
  • scripts/install-trail.cmd

错误码本身保持稳定，例如 CHECKSUM_MISMATCH、PROJECT_PATH_REQUIRED 等，便于 Agent 和用户继续定位问题。

3. daemon 异步命令模型落地

本版本引入并启用了 daemon 端异步请求执行模型，用于支撑耗时业务命令、UI mutation、恢复查询和 Agent 重发附着。

主要能力包括：

  • daemon 端新增 async job / call 记录。
  • 业务命令可在 wait budget 内返回 running job，而不是长期阻塞 CLI。
  • 支持 request status、request result、request cancel 等控制面查询。
  • request journal 与 session mutation lock 区分已执行、已持久化、结果未知、已取消和可恢复失败。
  • CW、input、window、image、ocr 等游戏相关操作接入取消与 side-effect 状态传播。

这条链路的目标是：Agent 可以安全处理长时间运行的命令，不因为一次 CLI 调用超时就失去现场状态。

4. 单例异步续查模型

在 v0.1.2 中，daemon 异步模型继续收紧为「单例异步续查」：

  • 常规续查应原样重发同一业务命令。
  • 相同 workspace / session / method / payload 会附着到当前运行中的 singleton job。
  • request=<job_id> 不再作为普通轮询入口，而是保留给恢复、排障和控制面。
  • 终态结果回放、显式 job id mismatch、call id 误用等路径都补了保护。

对应的 trail-hsr skill 和简单命令参考也已更新，避免 Agent 把 --request-id 当作常规轮询习惯使用。

5. 货币战争首页提示处理修复

修复货币战争首页积分提示相关路径：

  • 首页支持识别并关闭「积分线已更新」提示。
  • 首页支持识别并关闭积分奖励类提示。
  • cw.start 在 clean home、unfinished progress、after-start 出现进度等分支里更稳定地标记 side effect 与失败状态。
  • 已发生 UI side effect 但结果未知时，不再伪装成普通失败，而是保留 tainted / request status 供恢复。

这些调整主要服务于真实无人值守流程：遇到首页弹窗或未完成进度时，Agent 能知道该停、该问还是该恢复。

6. start / HSR 入口文档收口

trail-hsr 入口 skill 明确了 start 相关收口语义：

  • start 的定位更清楚：启动或接管到大世界入口，而不是直接替代所有玩法阶段。
  • daemon-backed 业务命令的 running / busy / result / cancel 使用方式同步到 skill 文档。
  • 简单命令参考强调常规续查重发业务命令，恢复和排障再使用控制面。

这能减少 Agent 在长任务、启动失败或窗口恢复时选择错误命令面的概率。

7. Release 与安装器回归增强

本版本补充了 release / installer 相关回归：

  • 新增 Windows 安装入口 ASCII-only 检查，防止再次引入非 ASCII 用户可见输出。
  • 回归 OpenClaw user scope dry-run、project scope 参数校验、冲突模式、CLI-only、skills-only 和完整 bundle 安装。
  • release metadata 测试继续校验 Windows zip、agent-install.ps1、wheel、sdist 和 SHA256SUMS.txt 等资产。
  • 预发布 CI 回归断言已对齐 daemon async 请求模型、首页提示 OCR 调用和 socket server 测试。

8. AGENTS.md 后续准则调整

发布后又将 AGENTS.md 从实现细节罗列改为项目级设计准则，并明确：发布完成后必须手动重写 release note，不能把 workflow 自动生成的占位说明作为交付结果。

这项文档准则变更已推送到 master，但不包含在 v0.1.2 tag 内；它会影响后续发布流程。

已知限制

  • 仍是 pre-release：货币战争无人值守流程仍在持续收敛，未知事件、特殊弹窗、BOSS 前备战等场景仍可能需要人工介入。
  • daemon 异步模型已经启用，但真实长任务、UI side effect 和恢复路径仍需要更多实机样本验证。
  • Windows zip 体积仍较大，因为包含 PyInstaller runtime、OCR/ONNX 依赖和内置静态资源。
  • README 现在刻意不写内部协议；需要命令细节时应让 Agent 读取已安装 skills 或项目内 active 文档。

发布资产

  • trail-cli-windows-x64-v0.1.2.zip：Windows x64 打包版 CLI / daemon / skills。
  • agent-install.ps1：Agent 安装器。
  • trail_cli-0.1.2-py3-none-any.whl：Python wheel。
  • trail_cli-0.1.2.tar.gz：源码包。
  • SHA256SUMS.txt：发布资产校验和。

验证记录

本地验证：

  • 安装器与 release metadata 回归：11 passed in 284.03s
  • 版本与 release 关键路径回归：5 passed in 88.96s
  • 预发布 CI 失败项定向回归：7 passed in 5.14s
  • AGENTS / release note 后续文档准则回归：19 passed in 2.80s

远端验证：

Full Changelog: v0.1.1...v0.1.2

Loading

Trail CLI v0.1.1 prerelease

10 May 13:41
@jiwangyihao jiwangyihao
v0.1.1
f240293
This commit was signed with the committer’s verified signature.
jiwangyihao jiwangyihao
GPG key ID: 9875AAC8A3A1FBD0
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
Trail CLI v0.1.1 prerelease Pre-release
Pre-release

阶段性公开测试说明

v0.1.1 是一次面向 Agent 无人值守流程的阶段性预发布。重点不在新增一个单点命令，而是把货币战争从「能读状态」推进到「能在更多真实分支里稳定接手、恢复和验证」。本版本仍标记为 pre-release，建议先在可回滚环境中试用。

安装与升级

$script = Join-Path $env:TEMP 'trail-agent-install.ps1'
iwr 'https://github.com/jiwangyihao/trail-cli/releases/download/v0.1.1/agent-install.ps1' -UseB -OutFile $script
powershell -NoProfile -ExecutionPolicy Bypass -File $script -Agent openclaw -Scope user -CliVersion 0.1.1 -RepoSlug 'jiwangyihao/trail-cli' -Yes

如果已经安装过旧版，建议仍使用上面的安装器覆盖安装；安装器会同步 CLI、daemon 和 skills。

主要变化

1. 货币战争静态资源包内置

本版本内置了货币战争资源 bundle，包括 4.2 版本的装备图标、角色图标、角色特征、装备特征和空槽模板。cw.equipment.read、槽位识别、角色识别和 release smoke check 不再依赖临时下载资源作为默认热路径。

这带来两个直接收益：

  • 首次运行更稳定，减少「资源未准备好」导致的识别失败。
  • Release 资产会校验 equipment/features.json、roles/features.json、roles/manifest.json 等 bundle 文件，避免发布缺资源包的二进制。

2. 装备识别与合成闭环增强

装备流程补齐了两个关键能力：读取装备背包和执行装备合成/装备动作。

  • cw.equipment.read 使用 bundle recognizer 识别装备格，并输出装备优先级与角色装备需求。
  • cw.equipment.compose 支持真实 UI mutation：优先复用已有高置信目标装备；没有现成装备时才执行合成，并在装备到目标角色后验证结果。
  • 装备识别会忽略特权版本装备候选，避免把特权图标误当成可合成/可装备目标。
  • 装备需求默认只推荐攻略中的 first_equipments / 「优选装备」，暂不把次选装备作为自动合成目标。

3. 战斗流程与下一轮备战 handoff

cw.battle.run 的阶段边界更明确：

  • 战斗仍在进行时输出 status=in_progress 和 next_action=cw.battle.run，让 Agent 明确继续跑同一命令。
  • 进入下一轮普通备战时，cw.battle.run(status=completed, stage=preparation) 会自动收集 stage、slots、equipment、shop、crystals、skill_info 等事实，并通过 handoff 交给 trail-cw-prep。
  • 整局失败时会收口为 result=lose stage=game_over，点击返回货币战争主页，并输出 game_over=1、restart_candidate=1、returned_home=1 等事实，避免 Agent 误把失败结算当作可继续战斗。

4. 未知事件恢复路径

新增未知事件处理链路：

  • cw.event.handle 遇到无法识别的新事件时，不再盲点；它会返回 event_type=unknown、next_action=manual，并标记需要恢复的 stale facts。
  • 新增内部 skill trail-cw-event-unknown，用于手工处理未知事件后的恢复流程。
  • cw.event.reconcile 用于未知事件手工处理后重新收敛 stage、slots、shop、equipment 等事实。
  • workflow handoff 已注册 cw.event.handle(event_type=unknown) -> trail-cw-event-unknown。

这条路径的目标是：未知事件可以暂停自动化并安全恢复，而不是把不确定状态伪装成成功。

5. 银狼 LV.999 / 可变费用角色支持

本版本补齐了 银狼LV.999 这类可变费用角色的身份模型：

  • 普通 银狼 与 银狼LV.999 分离，不再混用角色名、星级或费用。
  • shop、slots、guide progress、sell plan 和事件选择会保留 cost / star / role_id 等内部事实。
  • cw.shop.buy_slot 对普通角色继续使用星级等价数量差分验证；对 银狼LV.999 使用同 canonical name + 同 cost 的差分验证，不套用普通 1/3/9 星级折算。
  • CLI 支持透传 --variable-cost-choice cost_up|equipment，用于处理相关事件选择。

6. 输出协议与 Agent 可读事实更稳定

本版本继续收紧默认文本协议：

  • 购买角色后补充购买后的羁绊摘要。
  • cw.shop.buy_slot、cw.battle.run、cw.portal.select、cw.equipment.read 等命令的标题、事实行顺序和 must-keep 字段更稳定。
  • 可恢复失败会保留 request id、tainted 和恢复提示；unknown result 不再被默默吞掉。
  • cw.battle.clear_in_progress 只清 battle.run 内部续跑提示，不清历史截图或阶段事实。

7. 性能与测试稳定性

本版本压缩了多组慢测试和重复资源加载：

  • 缓存静态资源测试 JSON / PNG payload。
  • 减少静态资源、release、CLI 帮助、运行时后端等测试中的重复构建和重复图像处理。
  • pytest 默认临时目录继续固定到 .pytest-tmp，并扩展忽略规则，减少 Windows 环境下测试残留污染工作区。

已知限制

  • 仍是 pre-release：货币战争无人值守流程还在持续收敛，未知事件、BOSS 前备战和特殊事件仍可能需要手工介入。
  • cw.equipment.read 当前只把攻略「优选装备」作为自动需求目标；次选装备不会进入自动合成建议。
  • cw.event.handle 对未知事件会故意停止自动化并要求人工处理；这是安全边界，不是失败。
  • Windows zip 体积较大，因为包含 PyInstaller runtime、OCR/ONNX 依赖和内置 CW 静态资源。

发布资产

  • trail-cli-windows-x64-v0.1.1.zip：Windows x64 打包版 CLI / daemon / skills。
  • agent-install.ps1：Agent 安装器。
  • trail_cli-0.1.1-py3-none-any.whl：Python wheel。
  • trail_cli-0.1.1.tar.gz：源码包。
  • SHA256SUMS.txt：发布资产校验和。

验证记录

本地验证：

  • 版本相关测试：6 passed, 2 skipped in 6.58s
  • 资源 bundle artifact 校验：wheel、sdist、Windows zip、PyInstaller tree 均通过 ok cw_resource_bundle_artifacts count=1
  • Windows zip smoke test：
    • trail 0.1.1
    • ok release selfcheck assets=1 handoff=1

远端验证：

Full Changelog: v0.1.0...v0.1.1

Loading

Trail CLI v0.1.0 prerelease

30 Apr 14:31
@jiwangyihao jiwangyihao
v0.1.0
9f87d5a
This commit was signed with the committer’s verified signature.
jiwangyihao jiwangyihao
GPG key ID: 9875AAC8A3A1FBD0
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
Trail CLI v0.1.0 prerelease Pre-release
Pre-release

Trail CLI v0.1.0 prerelease.

This is an early Windows prerelease for Agent-assisted Honkai: Star Rail automation.

Install options:

  • Normal Windows user: download trail-cli-windows-x64-v0.1.0.zip, extract it, then double-click 安装 Trail.cmd.
  • Agent/local bundle install: download the zip, extract it, then run scripts\agent-install.ps1 -PackageRoot . from the extracted folder.
  • Remote Agent install for this prerelease tag:
irm https://github.com/jiwangyihao/trail-cli/releases/download/v0.1.0/agent-install.ps1 | iex
Install-TrailForAgent -CliVersion v0.1.0

Verification evidence before publishing:

  • Clean clone from tag v0.1.0 at 9f87d5a2146344528dd448c26e655b02f53180a1.
  • uv run pytest -q --basetemp .trail/pytest-tmp/prerelease -p no:cacheprovider: 1724 passed, 28 skipped.
  • Bundled executable selfcheck: ok release selfcheck assets=1 handoff=1.

Notes:

  • This is marked as a prerelease and may change before a stable release.
  • Use the v0.1.0 tag URLs for prerelease installs; do not rely on latest for this prerelease.
Loading