docs(tools): add pyenv/poetry/* & pyenv/launcher

Author: Sun-ZhenXing

docs/tools/pyenv/launcher.md

@@ -0,0 +1,56 @@
+# Python Launcher
+
+[[TOC]]
+
+## 1. Python Launcher 使用
+
+此功能适用于 Windows。
+
+在 Windows 上安装 Python 时，默认会安装 Python Launcher，用于管理和执行不同的 Python 版本。
+
+安装后可以使用 `py` 命令查看和管理计算机中不同的 Python。`py` 命令默认可以代替 `python` 命令使用。
+
+直接启动 Python：
+
+```bash
+py
+```
+
+查看已安装的 Python：
+
+```bash
+py -0
+```
+
+查看帮助：
+
+```bash
+py --help
+```
+
+除了 Python 程序默认的命令行参数外，`py` 还包括下面的参数：
+
+| 参数                  | 说明                                              |
+| --------------------- | ------------------------------------------------- |
+| `-2`                  | 启动最新的 Python 2.x 版本                        |
+| `-3`                  | 启动最新的 Python 3.x 版本                        |
+| `-X.Y`                | 启动指定的 Python 版本如果存在匹配的 64 位 Python |
+| `-X.Y-32`             | 启动指定的 32 位 Python 版本                      |
+| `-X-32`               | 启动最新的 32 位 Python 版本 X                    |
+| `-X.Y-64`             | 启动指定的 64 位 Python 版本                      |
+| `-X-64`               | 启动最新的 64 位 Python 版本 X                    |
+| `-0`，`--list`        | 列出可用的 Python                                 |
+| `-0p`，`--list-paths` | 列出路径                                          |
+
+## 2. 配置
+
+默认 `py.exe` 被安装在 `C:\Windows\py.exe` 路径下。
+
+如果需要修改默认启动的 Python 版本，可以创建 `C:\Windows\py.ini` 文件，内容如下：
+
+```ini
+[defaults]
+python=3.10
+```
+
+这样，`py` 命令就会默认启动 Python 3.10。

docs/tools/pyenv/poetry/index.md

@@ -0,0 +1,3 @@
+# Poetry
+
+<AutoCatalog />

docs/tools/pyenv/poetry/poetry.md

@@ -0,0 +1,91 @@
+# Poetry
+
+[[TOC]]
+
+## 1. Poetry 简介
+
+Poetry 是一款用于 Python 依赖性管理和打包的工具。它允许你声明项目依赖的库，并为你管理（安装/更新）它们。Poetry 提供一个锁文件，以确保可重复安装，并可构建项目以供发布。
+
+Poetry 需要 Python 3.8 以上版本。它是多平台的，目标是让它在 Linux、MacOS 和 Windows 上同样运行良好。
+
+推荐使用 `pipx` 安装：
+
+```bash
+pipx install poetry
+```
+
+如果你没有安装 `pipx`，可以使用 `pip` 安装 `pipx`：
+
+```bash
+pip install pipx
+```
+
+对于 Linux 或 MacOS 系统，可以使用官方命令安装：
+
+```bash
+curl -sSL https://install.python-poetry.org | python -
+```
+
+对于 Windows 则可以使用 PowerShell 安装：
+
+```powershell
+(Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | python -
+```
+
+这种方法需要手动添加路径：
+
+- MacOS：`~/Library/Application Support/pypoetry`
+- Linux/Unix：`~/.local/share/pypoetry`
+- Windows：`%APPDATA%\pypoetry`
+
+## 2. Poetry 基本使用
+
+查看命令的使用方式：
+
+```bash
+poetry list
+```
+
+创建项目：
+
+```bash
+poetry new poetry-demo
+```
+
+这将生成如下目录：
+
+```console
+poetry-demo
+├── pyproject.toml
+├── README.md
+├── poetry_demo
+│   └── __init__.py
+└── tests
+    └── __init__.py
+```
+
+初始化项目：
+
+```bash
+cd pre-existing-project
+poetry init
+```
+
+这总是可以配合虚拟环境使用。
+
+Poetry 还可以配合 [`pre-commit`](https://pre-commit.com/) 使用，可以在项目中添加 `.pre-commit-config.yaml` 文件，然后运行 `pre-commit install` 安装钩子。
+
+```yml
+repos:
+-   repo: https://github.com/python-poetry/poetry
+    rev: ''  # add version here
+    hooks:
+    -   id: poetry-check
+        args: ["-C", "./subdirectory"]
+    -   id: poetry-lock
+        args: ["-C", "./subdirectory"]
+    -   id: poetry-export
+        args: ["-C", "./subdirectory", "-f", "requirements.txt", "-o", "./subdirectory/requirements.txt"]
+    -   id: poetry-install
+        args: ["-C", "./subdirectory"]
+```

package.json

@@ -21,17 +21,17 @@
     "update-package": "pnpm dlx vp-update"
   },
   "devDependencies": {
-    "@vuepress/client": "2.0.0-beta.68",
-    "@vuepress/plugin-shiki": "2.0.0-beta.68",
-    "@vuepress/utils": "2.0.0-beta.68",
+    "@vuepress/client": "2.0.0-rc.0",
+    "@vuepress/plugin-shiki": "2.0.0-rc.0",
+    "@vuepress/utils": "2.0.0-rc.0",
     "github-slugger": "^2.0.0",
     "katex": "^0.16.9",
     "mermaid": "^10.6.1",
     "vue": "^3.3.8",
-    "vuepress": "2.0.0-beta.68",
-    "vuepress-plugin-auto-catalog": "2.0.0-beta.250",
-    "vuepress-plugin-copy-code2": "2.0.0-beta.250",
-    "vuepress-plugin-md-enhance": "2.0.0-beta.250",
-    "vuepress-plugin-search-pro": "2.0.0-beta.250"
+    "vuepress": "2.0.0-rc.0",
+    "vuepress-plugin-auto-catalog": "2.0.0-rc.0",
+    "vuepress-plugin-copy-code2": "2.0.0-rc.0",
+    "vuepress-plugin-md-enhance": "2.0.0-rc.0",
+    "vuepress-plugin-search-pro": "2.0.0-rc.0"
   }
 }