工具管理

`pinset check`

检查工具配置、安装和命令绑定是否一致，并按需验证安装内容与实际版本。

什么时候用

安装后确认工具链、排查版本或生成 CI 报告时使用。默认只读，--deep 复核内容，--probe 才运行工具并记录证据。

示例

pinset check
pinset check --deep --probe --format json > pinset-check.json

普通检查的英文终端输出形式示例：

Tool  Configured  Installed  Bound  Observed
node  yes  yes  yes  no
Check passed: yes

Observed 为 no 表示没有运行探针，不等于工具失败。第二条生成包含整体和逐工具 passed 的报告。

行为细节

默认不解密、不运行工具、不联网、不写盘。--deep 计算安装内容指纹与收据比较；--probe 执行有超时的版本探针，并在 Pinset home 写入实际路径、版本、宿主和时间证据。Java/Android 额外观测不代表项目构建通过。

JSON schema_version 为 1；字段名称、类型和含义稳定，只增加字段。每项含 tool、expected_version、actual_version、artifact_digest、passed。无探针观测时 actual_version 为 null；无内容检查时 payload_verified 为 null。收据与锁摘要匹配、安装内容与收据匹配是两种检查，不声称重算原始下载包摘要。详见 JSON 检查契约。

参数、退出码与常见错误

参数	含义
`--global`	检查全局选择。
`--deep`	复核安装内容。
`--probe`	运行版本探针并记录证据。
`--format text\|json`	默认 `text`；全局 `--json` 也输出同一 JSON。
`--target android\|ios\|windows\|macos\|linux\|web`	增加目标环境检查，要求项目上下文，不能与 `--global` 并用。

所有已选工具通过本次要求的检查返回 0。失败仍输出完整报告并返回 1；操作错误也返回 1，JSON 含 passed: false 和 error；参数错误返回 2。按 detail 区分缺失安装、内容变化或实际版本不匹配后修复。

/docs/commands/check适用版本 · Pinset 3.1.0