chore: 同步阅读页、脚本、API 配置与小程序管理文档

Made-with: Cursor

scripts/deploy_kr_btapi_verify.py

@@ -4,7 +4,8 @@
 kr 宝塔：正式环境发布 + 宝塔面板 API 重启 Go 项目 + 线上冒烟验证。
 
 说明（与现状一致）：
-- soul-api 的**文件上传与解压**仍通过 SSH/SFTP（稳定）；**进程重启**使用宝塔「Go 项目」插件 API（与 master.py --restart-method btapi 一致）。
+- soul-api 默认 **全程宝塔 API**：`/files?action=upload` 上传、`UnZip` 解压、`DeleteFile` 删包、`SiteStop/SiteStart` 重启（见 soul-api/master.py `--deploy-method btapi`，无需 SSH）。
+- 若需旧版 SSH 上传：设置环境变量 `DEPLOY_METHOD=ssh` 或 `python master.py --deploy-method ssh`（需服务器允许密码/密钥）。
 - soul-admin 静态资源仍通过 soul-admin/master.py（SSH），宝塔无统一「站点文件 API」封装。
 - 环境变量与 soul-api/master.py 相同：DEPLOY_HOST、DEPLOY_PASSWORD、BT_PANEL_URL、BT_API_KEY、BT_GO_PROJECT_NAME 等。
 
@@ -160,7 +161,11 @@ def main():
         return 0 if verify_public() else 1
 
     py = sys.executable
-    if not run_cmd(SOUL_API, [py, "master.py", "--restart-method", args.restart_method]):
+    # master.py 默认也会做 GetDiskInfo 探活；本脚本已探活则跳过，避免重复请求
+    master_args = [py, "master.py", "--restart-method", args.restart_method]
+    if not args.skip_bt_ping:
+        master_args.append("--skip-bt-ping")
+    if not run_cmd(SOUL_API, master_args):
         print("[失败] soul-api 部署失败")
         return 1