新增技术文档，详细描述了项目的技术栈、配置、鉴权与安全、数据层等内容。同时，更新小程序页面以支持收益数据的加载与刷新功能，优化用户体验。新增收益接口以返回用户的累计收益和可提现金额，并调整相关逻辑以确保数据准确性。

soul-api/dev_dev.py

@@ -142,6 +142,28 @@ def set_env_port(env_path, port=DEPLOY_PORT):
         f.writelines(new_lines)
 
 
+def set_env_mini_program_state(env_path, state):
+    """将 .env 中的 WECHAT_MINI_PROGRAM_STATE 设为 developer/formal（打包前按环境覆盖）"""
+    if not os.path.isfile(env_path):
+        return
+    key = "WECHAT_MINI_PROGRAM_STATE"
+    with open(env_path, "r", encoding="utf-8", errors="replace") as f:
+        lines = f.readlines()
+    found = False
+    new_lines = []
+    for line in lines:
+        s = line.strip()
+        if "=" in s and s.split("=", 1)[0].strip() == key:
+            new_lines.append("%s=%s\n" % (key, state))
+            found = True
+        else:
+            new_lines.append(line)
+    if not found:
+        new_lines.append("%s=%s\n" % (key, state))
+    with open(env_path, "w", encoding="utf-8", newline="\n") as f:
+        f.writelines(new_lines)
+
+
 def pack_deploy(root, binary_path, include_env=True):
     """打包二进制和 .env 为 tar.gz"""
     print("[2/4] 打包部署文件 ...")
@@ -160,7 +182,8 @@ def pack_deploy(root, binary_path, include_env=True):
                 print("  [已包含] .env.example -> .env (请服务器上检查配置)")
         if os.path.isfile(staging_env):
             set_env_port(staging_env, DEPLOY_PORT)
-            print("  [已设置] PORT=%s（部署用）" % DEPLOY_PORT)
+            set_env_mini_program_state(staging_env, "developer")
+            print("  [已设置] PORT=%s（部署用）, WECHAT_MINI_PROGRAM_STATE=developer（测试环境）" % DEPLOY_PORT)
         tarball = os.path.join(tempfile.gettempdir(), "soul_api_deploy.tar.gz")
         with tarfile.open(tarball, "w:gz") as tf:
             for name in os.listdir(staging):
@@ -276,11 +299,13 @@ def upload_and_extract(cfg, tarball_path, no_restart=False, restart_method="auto
             if restart_method in ("auto", "btapi") and (cfg.get("bt_panel_url") and cfg.get("bt_api_key")):
                 ok = restart_via_bt_api(cfg)
             if not ok and restart_method in ("auto", "ssh"):
-                # SSH：用 setsid nohup 避免断开杀进程，多等几秒再检测
+                # SSH：只杀「工作目录为本项目」的 soul-api，避免误杀其他 Go 项目
                 restart_cmd = (
-                    "cd %s && pkill -f './soul-api' 2>/dev/null; sleep 2; "
-                    "setsid nohup ./soul-api >> soul-api.log 2>&1 </dev/null & "
-                    "sleep 3; pgrep -f './soul-api' >/dev/null && echo RESTART_OK || echo RESTART_FAIL"
+                    "cd %s && T=$(readlink -f .) && for p in $(pgrep -f soul-api 2>/dev/null); do "
+                    "[ \"$(readlink -f /proc/$p/cwd 2>/dev/null)\" = \"$T\" ] && kill $p 2>/dev/null; done; "
+                    "sleep 2; setsid nohup ./soul-api >> soul-api.log 2>&1 </dev/null & "
+                    "sleep 3; T=$(readlink -f .) && for p in $(pgrep -f soul-api 2>/dev/null); do "
+                    "[ \"$(readlink -f /proc/$p/cwd 2>/dev/null)\" = \"$T\" ] && echo RESTART_OK && exit 0; done; echo RESTART_FAIL"
                 ) % project_path
                 stdin, stdout, stderr = client.exec_command(restart_cmd, timeout=20)
                 out = stdout.read().decode("utf-8", errors="replace").strip()