CLI 参考

ash CLI 是机器接口：成功输出和错误诊断都使用稳定的 ASON，不提供人类帮助页、颜色、进度条或交互式 REPL。

命令	输入	输出
`ash --version`	无	稳定版本字符串
`ash --build-info`	无	版本、目标、协议、ASON、提交与信任指纹
`ash ason`	stdin 裸 ASON	唯一规范 ASON
`ash run`	stdin 单个类型化请求	单个最终响应
`ash rpc`	stdin/stdout 长度帧	握手与有序响应帧
`ash self status [--prefix PATH]`	安装前缀	当前/前一版本与安装状态
`ash self check --candidate FILE`	候选二进制	健康、版本与目标
`ash self update [--prefix PATH] [--from DIR]`	签名元数据或离线目录	激活结果
`ash self rollback [--prefix PATH]`	安装状态	回滚或计划结果
`ash self recover [--prefix PATH]`	安装日志	恢复结果

ash self replace 是更新流程使用的内部 Windows 辅助入口，不是普通 Harness API。

错误契约

示例：

s:1
e{c}:
4

退出码按错误类别稳定映射。调用方应根据 ASON 诊断字段和退出码分支，不应匹配本地化文本；无参数或未知命令返回 Usage 类错误，而不是打印帮助。

文件操作受启动时工作区约束。路径必须使用规范逻辑形式，拒绝词法逃逸、符号链接或 Windows reparse point 绕过。exec 也不会自动切换到隐式系统 Shell。