自维护
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