pnpm 依赖安装与缓存 Action

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

✨ 特性

参数名	描述	必需	默认值
`cache-mode`	缓存模式：`node_modules` / `store`	否	`node_modules`
`cache-prefix`	缓存 key 前缀	否	`modules`
`node-modules-path`	`node_modules` 目录路径（仅 `cache-mode=node_modules` 时生效）	否	`node_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') }}

适用场景：希望二次执行直接复用产物、编译型依赖较多。
行为：缓存 node_modules 指定目录。命中缓存后跳过安装步骤。
额外设定：Action 会自动将 pnpm node-linker 设置为 hoisted，避免使用 symlink，生成更接近 npm 的目录结构。

with:
  cache-mode: store
  cache-hash: ${{ hashFiles('pnpm-lock.yaml') }}

适用场景：项目对 node_modules 目录结构有额外处理，或需要保持 node_modules 在工作目录内新生成。
行为：缓存 ${{ runner.temp }}/.pnpm-store。命中缓存后执行 pnpm install --offline --frozen-lockfile，仅进行符号链接操作。

with:
  force-install: "true"

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

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

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

with:
  clean-project-store: "true"

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

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