文档/命令

命令参考

Pinset 2.1 的 63 个公开 CLI 命令。每页包含语法、状态修改、JSON 支持、退出码和关键错误。

项目与选择命令

7

pinset init在当前目录创建最小项目配置。→pinset detect读取传统项目版本文件，报告版本选择、范围约束、忽略的工具、不支持值和冲突。→pinset import重新扫描，并把所有可安全映射的传统选择导入 schema 4 pinset.toml 与 schema 3 pinset.lock。→pinset global查看全局选择，或批量设置任意组合的全局默认运行时。→pinset use为最近项目解析并锁定一个或多个运行时，或写入全局作用域。→pinset unset删除一个项目或全局选择，但不卸载对应运行时。→pinset install安装一个显式精确运行时，或安装项目/全局锁中的全部目标。→

查询与生命周期命令

12

pinset which输出 Pinset 将为某命令使用的精确可执行文件。→pinset current显示当前生效的项目、全局或系统运行时选择和可执行文件。→pinset list列出已安装版本，或查询一个 Provider 的官方可用版本。→pinset outdated将每个精确锁定版本同时与“请求选择器允许的最新版本”和“最新稳定版本”比较。→pinset update重新解析请求选择器并刷新精确锁记录，不改变选择器，也不安装运行时。→pinset migrate验证并把 schema 1–3 项目配置重写为 schema 4，同时保持运行时锁为 schema 3，不重新解析版本。→pinset lock audit审计一组项目或全局配置/锁、当前平台制品、相关内容寻址缓存、安装收据与由收据证明的所有权。项目选择 Python 时还会审计 .venv 所有权标记。→pinset uninstall删除一个由 Pinset 所有的精确版本运行时安装。→pinset prune删除未被全局或所提供项目选择保护的已安装版本。→pinset exec使用 Pinset 所选运行时与环境启动子命令，不依赖 Shell 直接路由。→pinset x解析、验证、安装并运行一次 Provider 命令，同时不改变项目/全局选择状态。→pinset doctor诊断项目边界与严格策略、锁、安装、命令路由、环境变量、PATH 状态和只用于迁移的传统来源。→

下载缓存命令

7

pinset cache组合下载缓存检查、验证、修复、清理和离线导入操作。→pinset cache list列出完整的内容寻址运行时归档。→pinset cache info汇总完整与未完成下载的缓存用量。→pinset cache verify计算每个完整归档的摘要，并与内容标识比较。→pinset cache repair删除损坏的完整归档，使后续安装可以重新下载。→pinset cache clean删除下载缓存中的完整内容寻址归档。→pinset cache import把经过审查的归档导入已验证离线缓存。→

Python 环境命令

4

pinset venv组合项目所有的 Python 环境操作。→pinset venv create必要时安装所选 CPython，然后创建或验证项目 .venv。→pinset venv status显示所选 CPython 发行版与受管项目环境路径。→pinset venv recreate在证明 Pinset 所有权后删除并重建项目 .venv。→

命令路由命令

6

pinset shim组合 Provider 命令路由的检查与修复操作。→pinset shim path输出保存 Pinset 命令 shim 的用户所有目录。→pinset shim install修复命令 shim，但不覆盖不归 Pinset 所有的文件。→pinset shim migrate在当前路由目录注册已配置 Provider 命令，同时保留已有条目。→pinset activate输出把 Pinset 命令路由目录放到 PATH 前面的 Shell 代码。→pinset completions为受支持 Shell 生成 Pinset 补全代码。→

下载源命令

7

pinset source组合本机 Provider 下载源检查、选择、策略与验证操作。→pinset source list列出内置与自定义源，可限制为一个 Provider。→pinset source add添加具名自定义制品源，并可选择授予可信元数据权限。→pinset source use为一个受支持 Provider 选择活动源。→pinset source fallback替换一个 Provider 的有序回退源列表。→pinset source remove删除一个非活动的自定义源。→pinset source test对一个源执行只读连接与 Provider 元数据验证。→

Provider Registry 命令

2

pinset provider list验证并列出内嵌声明式 Provider Registry。→pinset provider verify验证内嵌 Registry 或一个本地 clear-signed Registry 文件，但不激活它。→

加密项目环境命令

18

pinset env init创建一个空的加密 profile、一个设备 age X25519 identity，通常还会创建独立恢复 identity。→pinset env set在 profile 中新增或替换一个加密变量。→pinset env unset不区分大小写地匹配并删除一个变量。→pinset env list列出一个 profile 的变量名，不向输出写入变量值。→pinset env reveal有意进行人工检查时，打印一个解密值。→pinset env import把显式指定的明文 dotenv 文件导入一个加密 profile。→pinset env export当目标系统无法使用 Pinset 注入时，有意把一个 profile 导出为明文 dotenv 文件。→pinset env recipient add允许另一个 age X25519 identity 解密某个 profile。→pinset env recipient remove在证明当前解密权限后，从 profile 删除一个 recipient。→pinset env recipient list打印某个 profile 配置的公开 recipients。→pinset env identity create生成一个额外 age X25519 identity，并打印其 ID 和公开 recipient。→pinset env identity import把口令保护的恢复/备份 identity 还原到当前电脑的系统密钥库。→pinset env identity list列出已注册 identity 的 ID、公开 recipient 和存储后端，不包含私钥。→pinset env identity backup把一个密钥库 identity 备份为新的口令保护 age 文件。→pinset env identity export把密钥库 identity 导出为明文，主要用于受明确保护的 CI Secret。→pinset trust add批准当前规范化项目及其精确环境策略进行自动注入。→pinset trust status检查当前项目和环境策略是否匹配本地信任记录。→pinset trust revoke删除当前电脑对某项目的自动注入批准。→