use-pnpm

Overview

本技能用于处理 pnpm 相关的安装、更新、工作区命令替换、Windows/PowerShell 故障和全局包恢复。重点覆盖 ERR_PNPM_UNEXPECTED_VIRTUAL_STORE、PNPM_HOME 与全局依赖树错位、Corepack 管理 pnpm、NVM Desktop 切换 Node 后的 pnpm 运行时混乱。

目标不是复述事故过程，而是给 future-agent 一套可执行判断路径：先识别 pnpm 由谁管理、全局区在哪里、store 在哪里、虚拟 store 指向哪里，再决定是重建依赖树、修配置，还是切回正确的 Node/pnpm 管理链路。

When to Use

• 用户要求安装、更新、删除、重建 pnpm 依赖或全局包。
• 用户想把 npm、npx、yarn 命令替换为 pnpm 写法。
• pnpm 报错包含 ERR_PNPM_UNEXPECTED_VIRTUAL_STORE、virtual-store-dir、store-dir、PNPM_HOME、global root、global bin 等关键词。
• Windows 或 PowerShell 下 pnpm 命令异常、全局命令找不到、全局包升级失败。
• Corepack 管理 pnpm，或 NVM Desktop 切换 Node 后 pnpm 版本、路径、全局区不一致。
• pnpm workspace 中需要判断命令应该在根目录、子包目录，还是通过 --filter 执行。

When Not to Use