docs: add pnpm memo and update README (#670)

Add a new pnpm.md memo in the docs directory and update the README to
include pnpm in the quick reference section. Also, introduce a new
pnpm.svg asset in the assets directory.

README.md

@@ -134,6 +134,7 @@ Quick Reference
 [package.json](./docs/package.json.md)<!--rehype:style=background: rgb(132 132 132);-->  
 [Yarn](./docs/yarn.md)<!--rehype:style=background: rgb(33 136 182);-->  
 [nvm](./docs/nvm.md)<!--rehype:style=background: rgb(132 132 132);-->  
+[pnpm](./docs/pnpm.md)<!--rehype:style=background: rgb(33 136 182);-->  
 <!--rehype:class=home-card-->
 
 ## 工具

assets/pnpm.svg

@@ -0,0 +1,20 @@
+<svg
+  xmlns="http://www.w3.org/2000/svg"
+  width="24"
+  height="24"
+  viewBox="0 0 24 24"
+  fill="none"
+  stroke="currentColor"
+  stroke-width="2"
+  stroke-linecap="round"
+  stroke-linejoin="round"
+>
+  <path d="M3 17h4v4h-4z" />
+  <path d="M10 17h4v4h-4z" />
+  <path d="M17 17h4v4h-4z" />
+  <path d="M17 10h4v4h-4z" />
+  <path d="M17 3h4v4h-4z" />
+  <path d="M10 10h4v4h-4z" />
+  <path d="M10 3h4v4h-4z" />
+  <path d="M3 3h4v4h-4z" />
+</svg>

docs/pnpm.md

@@ -0,0 +1,260 @@
+pnpm 备忘清单
+===
+
+这是一份 [`pnpm`](https://pnpm.io/) 软件包管理器备忘单，其中列出了 `pnpm` 常用命令使用清单。
+
+入门
+---
+
+### pnpm 与 npm 命令比较
+
+npm | pnpm | 说明
+:- | :- | :-
+`npm install` | `pnpm install` | 安装依赖
+`npm init` | `pnpm init` | 创建 `package.json` 文件
+`npm install <package>` | `pnpm add <package>` | 安装包
+`npm install -g <package>` | `pnpm add -g <package>` | 全局安装包
+`npm update` | `pnpm update` | 更新包
+`npm cache clean` | `pnpm cache clean` | 清理缓存
+
+### pnpm install
+
+```shell
+--no-lockfile # 不生成 pnpm-lock.yaml 锁定文件
+--force # 强制覆盖现有的 node_modules
+--frozen-lockfile # 忽略 pnpm-lock.yaml 中的更改
+--offline # 离线模式，不尝试从远程仓库安装包
+--shamefully-hoist # 类似于 npm 的 hoist 行为
+--strict-peer-dependencies # 严格检查 peer dependencies
+```
+
+这些选项可用于 `pnpm install`。
+
+### pnpm add
+
+```shell
+--save # 将包添加到 dependencies
+--save-dev # 将包添加到 devDependencies
+--global # 全局安装包
+--exact # 安装精确版本号的包
+--shamefully-hoist # 类似于 npm 的 hoist 行为
+--strict-peer-dependencies # 严格检查 peer dependencies
+```
+
+这些选项可用于 `pnpm add`。
+
+### pnpm remove
+
+```shell
+# 从依赖中删除包
+pnpm remove <package>
+```
+
+### pnpm update
+
+```shell
+# 更新所有包
+pnpm update
+# 更新特定包
+pnpm update <package>
+# 更新到最新版本（包括 major 版本）
+pnpm update --latest
+```
+
+### pnpm list
+
+```shell
+# 列出所有已安装的包
+pnpm list
+# 列出全局安装的包
+pnpm list -g
+# 查找过时的包
+pnpm outdated
+```
+
+### pnpm cache
+
+```shell
+# 清理 pnpm 缓存
+pnpm cache clean
+# 查看缓存中所有的包
+pnpm cache list
+```
+
+### pnpm why
+
+```shell
+# 显示为什么安装了某个包
+pnpm why <package>
+```
+
+示例
+---
+
+### 安装包
+
+```bash
+# 将包添加到“dependencies”
+pnpm add <package>
+# 将包添加到“devDependencies”
+pnpm add -D <package>
+# 将包作为精确版本添加
+pnpm add --exact <package>
+# 在全局范围内安装包
+pnpm add -g <package>
+# 安装特定版本的包
+pnpm add <package>@<version>
+```
+
+### 移除包
+
+```bash
+pnpm remove <package>
+```
+
+### 查看包
+
+```bash
+# 列出已安装的包
+pnpm list
+# 列出顶级安装的包
+pnpm list --depth 0
+# 列出全局安装的包
+pnpm list -g
+# 根据模式和深度列出包
+pnpm list --pattern "lodash" --depth 1
+```
+
+### 清除
+
+```bash
+# 清理 node_modules 并删除不必要的文件
+pnpm prune
+# 检查过时的包
+pnpm outdated
+```
+
+### 信息
+
+```bash
+# 显示关于安装包的原因的信息
+pnpm why <package>
+```
+
+### 清理缓存
+
+```bash
+# 清除 pnpm 的全局缓存
+pnpm cache clean
+```
+
+此外，您可以指定一个或多个要清理的包。
+
+Monorepo
+---
+
+### 创建 Monorepo 工作区
+
+1. 创建一个新的 pnpm 工作区：
+
+```bash
+pnpm init -w
+```
+
+这将在项目的根目录中创建一个 `pnpm-workspace.yaml` 文件，内容如下：
+
+```yaml
+packages:
+  - 'packages/**'
+  - 'apps/**'
+```
+
+2. 在 `pnpm-workspace.yaml` 中定义您的工作区结构：
+
+```yaml
+packages:
+  - 'packages/*'
+  - 'apps/*'
+```
+
+### 添加包到 Monorepo 工作区
+
+```bash
+# 在工作区中添加包
+pnpm add <package> -w
+```
+
+### 运行脚本
+
+```bash
+# 在所有包中运行脚本
+pnpm -r run <script>
+# 仅在某个包中运行脚本
+pnpm --filter <package> run <script>
+# 在某个包及其依赖中运行脚本
+pnpm --filter <package>... run <script>
+```
+
+### 添加工作区范围的依赖
+
+```bash
+# 添加依赖到工作区根目录
+pnpm add <package> -w
+# 添加开发依赖到工作区根目录
+pnpm add -D <package> -w
+```
+
+### 创建新的包
+
+在 `packages` 目录中创建新的包，例如：
+
+```bash
+mkdir packages/new-package
+cd packages/new-package
+pnpm init
+```
+
+### 链接本地包
+
+```bash
+# 将本地包链接到当前工作区
+pnpm link <local-package-path>
+# 链接工作区中的包
+pnpm add <local-package-name> --workspace
+```
+
+高级用法
+---
+
+### 工作区
+
+```bash
+# 创建工作区
+pnpm init -w
+# 在工作区中添加包
+pnpm add <package> -w
+```
+
+### 链接
+
+```bash
+# 链接一个全局包到当前项目
+pnpm link <package>
+# 链接本地包到全局
+pnpm link --global <package>
+```
+
+### 运行脚本
+
+```bash
+# 运行 package.json 中的脚本
+pnpm run <script>
+# 运行根目录中的包的脚本
+pnpm run -w <script>
+```
+
+另见
+---
+
+- [pnpm 官方文档网站](https://pnpm.io/)
+- [pnpm 常见问题解答](https://pnpm.io/motivation)