pnpm 依赖安装与缓存 Action

专为 pnpm 项目设计的 GitHub Action，通过缓存 pnpm store，在 CI/CD 中实现快速复用，二次执行可在 10 秒内完成安装。

✨ 特性

参数名	描述	必需	默认值
`cache-prefix`	缓存 key 前缀	否	`modules`
`force-install`	是否强制安装（追加 `--force`）	否	`false`
`install-command`	自定义安装命令，覆盖默认的 `pnpm install`	否	`''`
`install-args`	附加参数（仅默认命令时生效）	否	`''`
`cache-hash`	缓存 hash 值（建议：`hashFiles('pnpm-lock.yaml')`）	否	`''`
`clean-project-store`	安装后是否清理项目根的 `.pnpm-store`	否	`false`

- name: 安装依赖
  uses: actions/xgj/pnpm-install@v1
  with:
    cache-hash: ${{ hashFiles('pnpm-lock.yaml') }}

默认缓存 pnpm store，命中后执行 pnpm install --offline --frozen-lockfile，通常在 10 秒内完成链接。
首次执行或 lock 文件变更时执行 pnpm install --prefer-offline --frozen-lockfile，完成后写入缓存。
当未显式提供 cache-hash 时，会依次使用 pnpm-lock.yaml、package.json 计算 hash 作为兜底，确保缓存具备基本失效条件。

Action 会根据以下优先级自动识别 pnpm store：

解析完成后会打印 pnpm store path: ...，并将路径写入环境变量 PNPM_STORE_DIR 供后续步骤使用。

with:
  force-install: "true"

当缓存未命中且怀疑存在依赖冲突时，可追加 --force。

with:
  install-command: "pnpm install --prod"

完全覆盖默认安装逻辑，适合部署类任务。

with:
  clean-project-store: "true"

在部分仓库中 .npmrc 会指定相对 store 路径，该选项可避免 CI 工作目录残留。

参见 examples/basic-usage.yml，展示在 CI 中的集成方式。