diff --git a/%E4%BB%A5%E5%BC%80%E5%8F%91%E6%A8%A1%E5%BC%8F%E8%BF%90%E8%A1%8C.md b/%E4%BB%A5%E5%BC%80%E5%8F%91%E6%A8%A1%E5%BC%8F%E8%BF%90%E8%A1%8C.md
new file mode 100644
index 0000000..a66893f
--- /dev/null
+++ b/%E4%BB%A5%E5%BC%80%E5%8F%91%E6%A8%A1%E5%BC%8F%E8%BF%90%E8%A1%8C.md
@@ -0,0 +1,27 @@
+## 初次运行
+
+1. 安装 [Node.JS](https://nodejs.org/en)，建议下载最新的 LTS 版本。
+2. 安装 [pnpm](https://pnpm.io/zh/installation)。推荐[使用 corepack 安装](https://pnpm.io/zh/installation#%E4%BD%BF%E7%94%A8-corepack-%E5%AE%89%E8%A3%85)。
+3. 安装 Git。Windows 用户可以安装 [Git for Windows](https://git-scm.com/download/win)。
+4. 克隆仓库。
+   1. 打开终端/命令行（Windows 用户可以右键开始菜单，选择 `Windows Terminal` 或 `PowerShell`；你**不需要**管理员权限）。
+   2. 键入 `git clone https://git.unlock-music.dev/um/um-react.git` 并回车来下载源码到 `um-react` 目录。
+   3. 键入 `cd um-react` 并回车切换到对应的代码目录。
+5. 安装依赖
+   - 键入 `pnpm i --frozen-lockfile` 并回车来安装需要的依赖
+6. 运行开发者模式
+   - 键入 `pnpm start` 开始开发者模式。默认监听 `5173` 端口，因此启动服务后访问 http://127.0.0.1:5173/ 访问应用。
+7. 需要停止以开发模式运行，按下 <kbd>ctrl-c</kbd> 组合键结束。
+
+## 更新并运行
+
+1. 更新索引
+   - 键入 `git fetch --all -p` 并回车
+2. 放弃本地更改
+   - 键入 `git reset --hard` 并回车 - 任何本地更改都将被丢弃
+   - 键入 `git pull` 并回车来更新
+3. 安装/更新依赖
+   - 键入 `pnpm i --frozen-lockfile` 并回车来安装需要的依赖
+4. 运行开发者模式
+   - 键入 `pnpm start` 开始开发者模式。默认监听 `5173` 端口，因此启动服务后访问 http://127.0.0.1:5173/ 访问应用。
+5. 需要停止以开发模式运行，按下 <kbd>ctrl-c</kbd> 组合键结束。