doc:补充文档

Author: Taois

docs/envdoc.md

@@ -26,6 +26,7 @@
 | VIRTUAL_ENV               | 本地python虚拟环境路径                 | 同上，差别在于虚拟环境会自动拼scripts路径下的python.exe,跟真实环境二选一                     |
 | daemonMode                | 守护进程版本                         | 0: 旗舰版 1:轻量版                                                      |
 | DS_REQ_LIB                | ds/cat 默认req实现                 | 0:fetch 1:axios  （已知模式1为前面版本默认功能，但是后面发现某些场景无法获取源码，新写了模式0，不保证完全兼容） |
+| PHP_PATH                  | 本地PHP可执行文件路径                  | php (全局) 或 /usr/bin/php8.3 (指定路径)                                |
 | CLIPBOARD_MAX_SIZE        | 单次文本传输最大体积 默认100KB             | 102400                                                            |
 | CLIPBOARD_SECURITY_CODE   | 剪切板接口请求头安全码                    | drpys                                                             |
 | CLIPBOARD_ALLOWED_CHARSET | 允许字符集，默认utf-8                  | utf-8                                                             |
@@ -35,3 +36,65 @@
 | MAX_TEXT_SIZE             | 设置最大文本大小(剪切板插件)                | 0.1 * 1024 * 1024                                                 |
 | MAX_IMAGE_SIZE            | 设置最大图片大小(图片插件)                 | 0.5 * 1024 * 1024                                                 |
 
+# 用户自定义配置 (config/env.json)
+
+该文件位于 `config/env.json`，存储用户自定义的运行时配置。
+
+| 参数键 | 参数说明 | 备注 |
+| :--- | :--- | :--- |
+| enable_php | 是否开启 PHP 源支持 | 0:关闭 1:开启 (默认开启，需 PHP 环境可用) |
+| api_pwd | 全局接口访问密码 | 访问敏感接口或文件时需要 |
+| thread | 爬虫并发数 | 建议设置在 4-8 之间 |
+| quark_cookie | 夸克网盘 Cookie | 观看夸克网盘资源需要 |
+| uc_cookie | UC 网盘 Cookie | 观看 UC 网盘资源需要 |
+| ali_token | 阿里云盘 Token | 观看阿里云盘资源需要 |
+| deepseek_apiKey | DeepSeek API Key | AI 搜索/对话功能需要 |
+| kimi_apiKey | Kimi API Key | AI 搜索/对话功能需要 |
+| bili_cookie | Bilibili Cookie | B站相关资源需要 |
+| play_proxy_mode | 播放代理模式 | 0:直接播放 1:代理播放 |
+
+## 环境搭建指南
+
+### 1. PHP 环境搭建 (推荐)
+
+本项目支持 PHP 爬虫源（`spider/php/*.php`），需要本地安装 PHP 环境。
+
+#### Linux (Ubuntu/Debian)
+
+推荐使用 PPA 安装 PHP 8.3+：
+
+```bash
+# 1. 添加 PPA 源
+sudo apt install software-properties-common -y
+sudo add-apt-repository ppa:ondrej/php -y
+sudo apt update
+
+# 2. 安装 PHP 8.3 及常用扩展 (drpy 爬虫需要 curl, mbstring, xml, mysql 等)
+sudo apt install php8.3-cli php8.3-curl php8.3-mbstring php8.3-xml php8.3-mysql -y
+
+# 3. 验证安装
+php -v
+```
+
+#### Windows
+
+1. 下载 PHP 8.3+ NTS 版本 (推荐)。
+2. 解压到 `C:\php` 等目录。
+3. 将解压目录添加到系统 `Path` 环境变量中。
+4. 修改 `php.ini`，开启 `extension=curl`, `mbstring`, `openssl` 等扩展。
+
+### 2. 7-Zip 工具安装 (可选)
+
+部分功能可能依赖 7z 进行解压操作。
+
+#### Linux (Ubuntu/Debian)
+
+```bash
+sudo apt update
+sudo apt install p7zip-full -y
+```
+
+验证安装：
+```bash
+7z
+```