pinset
EN
自维护

pinset self repair

恢复中断的 Pinset 操作,并修复 Pinset 管理的命令入口。

在 GitHub 查看源文档 ↗

什么时候用

切换版本、自更新或受管 Python 重建意外中断后使用。单个工具损坏用 install --repair,此命令处理事务和入口。

示例

pinset self repair --plan
pinset self repair

执行结果:预览后恢复当前项目、全局和 CLI/shim 中断状态,不撤销已经完成的版本切换。

行为细节

不联网。未完成事务恢复原配置、锁、加密档案和本地绑定;已完成事务只清残留标记。也恢复受管 venv 重建、入口发布和 CLI/shim 更新。符号链接启动时处理真实安装。

venv 创建进程仍运行时不删除目录。Windows 无法原子替换运行中入口时保留原文件并报错;外部或无所有权证明的入口也保留。

参数、退出码与常见错误

参数含义
--plan只读预览。

成功返回 0,不能安全恢复返回 1。PINSET_VENV_BUSY 需等创建进程退出;PINSET_BROKER_VERSION 需匹配的 CLI/shim。外部文件冲突先检查所有权,不强行覆盖。

/docs/commands/self-repair适用版本 · Pinset 3.1.0