pinset self update

什么时候用

升级 Pinset 本身时使用。项目工具升级用 use；降级需指定确切版本。

示例

pinset self update --plan
pinset self update 3.1.0

执行结果：第一条显示版本、平台包和摘要；第二条校验下载后成对更新 CLI/shim，报告是否需要重启。

行为细节

会联网。省略版本读取官方 /releases/latest 重定向，只接受稳定 Pinset 3；指定时可选受支持的预发布。两种方式都不访问 GitHub REST API、不需 token；确定版本后固定同一发布目录。

检查 SHA256SUMS 中唯一合法 SHA-256；优先 pinset-v<version>-<platform>.zip，兼容固定平台包名。校验 CLI 实际版本后成对替换，启动符号链接解析到真实安装。同版本不重复下载，自动更新拒绝较旧 latest。--plan 仅读取重定向和清单，不下载程序、不写盘。

元数据请求有超时和有限重试；较长或 HTTP 日期格式 Retry-After 会提示等待，不提前重试。下载仍受网络和 GitHub 流量限制。

参数、退出码与常见错误

成功（含已是当前版）返回 0，失败返回 1。拒绝访问、限流、资源或平台缺失、清单错误会分别说明，按消息处理。PINSET_UPDATE_REPAIR 可先运行 self repair --plan 检查恢复状态。