chore: 重写初始提交(清空历史,整理后全量提交)

docs/guide/quickstart.md

@@ -0,0 +1,114 @@
+# 快速开始
+
+本文介绍如何在本地搭建 YwxApp 开发环境并运行第一个页面。
+
+## 环境要求
+
+| 项目 | 要求 |
+| --- | --- |
+| PHP | >= 8.0（推荐 8.3） |
+| 数据库 | MySQL 5.7+ / MariaDB 10.3+ |
+| Composer | 2.x |
+| 扩展 | pdo_mysql、mbstring、openssl、fileinfo、zip |
+
+## 安装步骤
+
+### 1. 获取代码并安装依赖
+
+```bash
+git clone <仓库地址> ywxapp
+cd ywxapp
+composer install
+```
+
+### 2. 配置环境变量
+
+复制示例配置并按实际情况修改：
+
+```bash
+cp .env.example .env
+```
+
+关键配置项：
+
+```ini
+APP_DEBUG = true
+
+[DATABASE]
+TYPE     = mysql
+HOSTNAME = 127.0.0.1
+DATABASE = ywxapp
+USERNAME = root
+PASSWORD = 
+HOSTPORT = 3306
+PREFIX   = wxapp_
+```
+
+### 3. 导入数据库
+
+将 `install.sql` 导入到你创建的数据库中，或访问安装向导按提示完成。
+
+### 4. 配置 Web 服务器
+
+将站点根目录指向 `public/`，并配置伪静态。
+
+**Nginx**：
+
+```nginx
+location / {
+    if (!-e $request_filename) {
+        rewrite ^(.*)$ /index.php?s=$1 last;
+    }
+}
+```
+
+**Apache**：`public/.htaccess` 已内置规则，确保开启 `mod_rewrite`。
+
+### 5. 本地快速启动
+
+若暂时不配置 Web 服务器，可用 PHP 内置服务器：
+
+```bash
+php think run -p 8000
+```
+
+访问 `http://127.0.0.1:8000` 即可看到展示官网首页。
+
+## 目录权限
+
+以下目录需要可写权限：
+
+```
+runtime/
+public/uploads/
+addon/
+config/
+```
+
+Linux 下执行：
+
+```bash
+chmod -R 755 runtime public/uploads addon config
+```
+
+## 常用命令
+
+```bash
+# 创建插件脚手架
+php think addon:make demo -a build
+
+# 安装 / 开发模式安装插件
+php think addon:manage demo -a develop
+
+# 刷新插件后台菜单
+php think addon:manage demo -a refresh-menu
+
+# 插件健康体检
+php think addon:health --detail
+```
+
+## 下一步
+
+- [插件开发指南](addon/development)：编写你的第一个插件
+- [支付钩子机制](pay/hooks)：了解事件驱动的扩展方式
+- [自定义命令清单](cli/commands)：查看全部 CLI 工具