docs: improve expression

Author: TrueRou

docs/.vitepress/config.mts

@@ -8,8 +8,7 @@ export default defineConfig({
     themeConfig: {
     // https://vitepress.dev/reference/default-theme-config
         nav: [
-            { text: '主页', link: '/' },
-            { text: '手册', link: '/implementation' },
+            { text: '快速开始', link: '/' },
             { text: '博客', link: 'https://turou.fun/' },
             { text: '❤️', link: 'https://afdian.com/a/turou' },
         ],
@@ -18,20 +17,20 @@ export default defineConfig({
             {
                 text: '介绍',
                 items: [
-                    { text: '安装', link: '/begin' },
+                    { text: '快速开始', link: '/begin' },
                 ],
             },
             {
-                text: '代理',
+                text: '受支持的代理',
                 items: [
-                    { text: 'Clash', link: '/proxies/clash' },
+                    { text: 'Clash / Mihomo', link: '/proxies/clash' },
                     { text: 'Shadowrocket', link: '/proxies/rocket' },
                     { text: 'Sing-box', link: '/proxies/singbox' },
                     { text: 'Quantumult X', link: '/proxies/quantx' },
                 ],
             },
             {
-                text: '手册',
+                text: '开发者手册',
                 items: [
                     { text: '实现方式', link: '/implementation' },
                     { text: '参与开发', link: '/development' },

docs/begin.md

@@ -16,38 +16,64 @@ DXPass 是**日服限定**的，可以在制卡机上制作的具有特殊功能
 
 安装 UsagiPass 需要你具有一定的动手能力，下面我们将逐步讲解如何安装 UsagiPass：
 
-1. 安装代理软件，UsagiPass 需要代理才能运行，如果你不清楚什么是代理，请点击下方推荐方式即可：
-    - 安卓：[**Clash（推荐）**](https://dxpass.turou.fun/proxies/clash.html)，[Sing-box](https://dxpass.turou.fun/proxies/singbox.html)
-    - iOS：[**Shadowrocket（推荐）**](https://dxpass.turou.fun/proxies/rocket.html)，[Sing-box](https://dxpass.turou.fun/proxies/singbox.html)，[QuantX](https://dxpass.turou.fun/proxies/quantx.html)
-2. 启动代理软件：UsagiPass 需要代理才能运行，请确保你的代理已经运行在手机后台；
-3. 在**微信 -> 舞萌|中二公众号**中正常打开**登入二维码**，你应该已经跳转到 UsagiPass 的登录界面；
-4. 使用水鱼或落雪查分器账号进行登录，登录后即可进入 UsagiPass 主页，享受可登录的国服 DXPass 功能。
-
-::: tip
-UsagiPass 利用代理来重定向华立二维码网页，请保证在使用过程中代理不要关闭。
+### 第一步：安装 CA 证书
+
+UsagiPass 需要代理 HTTPS 流量以实现二维码页面的替换功能，故需要安装 CA 证书。
+
+::: details 安卓设备
+下载 [https://up.turou.fun/ca.pem](https://up.turou.fun/ca.pem) 并安装。
+:::
+
+::: details iOS 设备
+下载 [https://up.turou.fun/ca.pem](https://up.turou.fun/ca.pem) 并安装。
 :::
 
-## 使用 UsagiPass
+### 第二步：配置代理软件
+
+UsagiPass 需要代理才能运行，请根据你的设备选择合适的代理软件：
+
+::: details 安卓设备
+推荐使用 **Mihomo**：
 
-登录 UsagiPass 后，将使用默认的个性化配置，点击画面右下方的齿轮图标可以进入设置页面。
+1. 下载安装 Mihomo：
+   - **Github（推荐）**：[https://github.com/MetaCubeX/ClashMetaForAndroid/releases](https://github.com/MetaCubeX/ClashMetaForAndroid/releases)
+   - **蓝奏云（国内）**：[https://wwps.lanzouj.com/iXMCk2cydjmd](https://wwps.lanzouj.com/iXMCk2cydjmd)
+   - 加入 UsagiPass 用户群，在群公告处获取：363346002
 
-在设置中，可以按照喜好调整个性化配置，切换背景、角色、边框等资源，在调整结束后可以点击最下方的保存。
+2. 导入 UsagiPass 配置：
+   - 一键导入：[导入 Clash 配置](clash://install-config?url=https://up.turou.fun/UsagiPass.yaml&name=UsagiPass)
+   - 复制链接到 Clash 导入：`https://up.turou.fun/UsagiPass.yaml`
+   - 从群文件获取配置：363346002
+:::
+
+::: details iOS 设备
+推荐使用 **Singbox**：
 
-请初次使用的玩家在设置中粘贴自己的好友代码（可在舞萌DX-好友页面查询）。
+1. 切换外区账号，在 AppStore 中搜索 **Singbox VT** 并下载
 
-同时，我们还支持覆盖页面中的部分文本，玩家可以自行尝试相关功能。
+2. Profiles -> New Profile -> Name: 随意，Type: Remote，URL: `https://up.turou.fun/UsagiPass.json` -> Create
 
-::: tip
-想了解更多 UsagiPass 的功能，可以在左侧的目录（手机用户请点击左上角 Menu 按钮）找到。
+3. **确保选择了 UsagiPass 配置，点击启动代理即可生效！**
 :::
 
+### 第三步：访问 UsagiPass
+
+1. 在**微信 -> 舞萌|中二公众号**中正常打开**登入二维码**
+2. 你应该已经跳转到 UsagiPass 的登录界面
+3. 使用水鱼或落雪查分器账号进行登录
+4. 登录后即可进入 UsagiPass 主页，享受可登录的国服 DXPass 功能
+
 ## 支持 UsagiPass
 
 如果觉得 UsagiPass 好用的话，不妨给[我们的仓库](https://github.com/TrueRou/UsagiPass)点一个 ⭐ 吧。
 
 我们也开放了爱发电入口，如果你愿意[赞助 UsagiPass](https://afdian.com/a/turou) 我们会在特别感谢中提到你的名字。
 
-## Q&A
+## 常见问题
+
+### Q: 打开网页后提示不安全，或者证书无效
+
+A: 请确保你已经正确安装了 UsagiPass 的 CA 证书。
 
 **Q：我不清楚 UsagiPass 的某某功能如何使用**
 

docs/development.md

@@ -10,34 +10,47 @@ UsagiPass 的前后端以及官网均已开源，欢迎提出 Issues 和 PullReq
 
 我们的 GitHub 仓库：https://github.com/TrueRou/UsagiPass
 
-## 配置私人MITM
+## 项目部署
 
-UsagiPass 使用 [MITM 中间人](https://developer.mozilla.org/zh-CN/docs/Glossary/MitM)转发并修改来自华立服务器的流量。
+### 前置环境
 
-当前版本的 UsagiPass 会修改来自 `wq.sys-all.cn` 和 `tgk-wcaime.wahlap.com` 的流量，后者主要用于更新查分器。
+- Node.js 18+ 或 Bun 1.0+
+- pnpm 包管理器
+- **PostgreSQL 15.0+** 数据库
 
-有条件的开发者可以搭建属于自己的代理服务器，可以在降低服务器负载的同时提升安全性。
+### 部署方式
 
-### 前置环境
+1. **克隆项目并安装依赖**
+
+```bash
+git clone https://github.com/TrueRou/UsagiPass.git
+cd UsagiPass
+pnpm install
+```
+
+保证 PostgreSQL 服务已启动，并创建好用于 UsagiPass 的数据库。
+
+2. **配置环境变量**
+
+创建 `.env` 文件，至少配置以下环境变量：
+
+```env
+# 数据库配置（请根据实际情况修改：postgresql://用户名:密码@主机:端口/数据库名））
+NUXT_USAGIPASS_DATABASE_URL=postgresql://postgres:password@localhost:5432/usagipass
+```
+
+3. **启动开发服务器**
 
-- 合适的 Linux 发行版，这里以 Debian 为例
-- 能够连接至 GitHub 的网络环境
-- Python 3.12+
-- MySQL Community Server
+```bash
+pnpm dev
+```
 
-### 搭建方式
+访问 `http://localhost:7200` 即可使用。
 
-- 前往对应的查分器网站申请开发者密钥并等待审核通过；
-- 在 项目根目录 下创建 `.env` 文件, 可以根据 `.env.example.mitm-only` 模板文件进行配置，别忘了在 `LXNS_DEVELOPER_TOKEN` 或 `DIVINGFISH_DEVELOPER_TOKEN` 中填入你申请的开发者密钥；
-- 执行 `pip install poetry` 全局安装 Poetry；
-- 执行 `poetry install` 安装项目依赖；
-- 执行 `poetry run app` 运行后端及代理；
-- 执行 `cd web && npm run dev` 运行前端。
+### 关于代理
 
-> 更新项目: `git pull && poetry install && poetry run app`
+UsagiPass 更新成绩需要配合中间人代理（MITM）使用，在开发环境下，需要使用支持 ClashMeta 规则的代理软件。
 
-::: tip
-切记：必须暴露 TCP `2560` 端口，如部署防火墙的请在规则允许 `2560` 端口的外网访问
+在 `pnpm dev` 启动后，默认监听 HTTP 代理 `http://localhost:7300`。
 
-端口可以在 `.env` 文件中进行配置
-:::
+将 `public/UsagiPassDev.yaml` 导入支持 ClashMeta 规则的代理软件后，启动系统代理即可。

docs/index.md

@@ -9,10 +9,10 @@ hero:
   tagline: 从零开始美化你的玩家二维码
   actions:
     - theme: brand
-      text: 开始使用
+      text: 快速开始
       link: /begin
     - theme: alt
-      text: 手册
+      text: 开发者手册
       link: /implementation
     - theme: alt
       text: ⭐
@@ -22,7 +22,7 @@ hero:
 
 features:
   - title: 动态生成
-    details: 基于水鱼 / 落雪查分器的数据动态生成玩家的 DXPASS，用户个性化数据云端储存。
+    details: 基于舞萌 NET 的数据动态生成玩家的 DXPASS，用户个性化数据云端储存。
   - title: 高度自定义
     details: 自定义 DXPASS 背景、外框、角色，支持使用预设素材或个性化上传自己的图片。
   - title: 支持登录