tt-help-cli-ycl 1.3.48 → 1.3.50

package/src/watch/server.js

@@ -1,727 +1,727 @@
-import http from "http";
-import os from "os";
-
-import { readFileSync, existsSync } from "fs";
-import { join, dirname } from "path";
-import { fileURLToPath } from "url";
-import { spawn } from "child_process";
-import { createStore } from "./data-store.js";
-import { DEFAULT_TARGET_LOCATIONS } from "../lib/target-locations.js";
-
-const __filename = fileURLToPath(import.meta.url);
-
-function getLocalIP() {
-  const ifaces = os.networkInterfaces();
-  for (const name of Object.keys(ifaces)) {
-    for (const iface of ifaces[name]) {
-      if (iface.family === "IPv4" && !iface.internal) {
-        return iface.address;
-      }
-    }
-  }
-  return "0.0.0.0";
-}
-const __dirname = dirname(__filename);
-const publicDir = join(__dirname, "public");
-
-function computeStatsIncremental(st) {
-  return st.getDashboardStats(DEFAULT_TARGET_LOCATIONS);
-}
-
-function readBody(req) {
-  return new Promise((resolve, reject) => {
-    let body = "";
-    req.on("data", (chunk) => (body += chunk));
-    req.on("end", () => {
-      try {
-        resolve(body ? JSON.parse(body) : {});
-      } catch (e) {
-        reject(e);
-      }
-    });
-    req.on("error", reject);
-  });
-}
-
-function parseQuery(urlString = "/") {
-  const url = new URL(urlString, "http://127.0.0.1");
-  return {
-    path: url.pathname,
-    params: Object.fromEntries(url.searchParams.entries()),
-  };
-}
-
-function sendJSON(res, code, data) {
-  res.writeHead(code, { "Content-Type": "application/json; charset=utf-8" });
-  res.end(JSON.stringify(data));
-}
-
-function csvEscape(val) {
-  const s = String(val ?? "");
-  return /[",\n\r]/.test(s) ? '"' + s.replace(/"/g, '""') + '"' : s;
-}
-
-function sendCSV(res, columns, rows) {
-  const BOM = "\uFEFF";
-  const header = columns.join(",");
-  const lines = rows.map((r) => columns.map((c) => csvEscape(r[c])).join(","));
-  const body = BOM + [header, ...lines].join("\r\n");
-  res.writeHead(200, {
-    "Content-Type": "text/csv; charset=utf-8",
-    "Content-Disposition": 'attachment; filename="target-users.csv"',
-  });
-  res.end(body);
-}
-
-export function startWatchServer(dataAnchor, port = 3000, existingStore) {
-  return new Promise((_resolve, reject) => {
-    const store = existingStore || createStore(dataAnchor);
-
-    function logJob(action, detail) {
-      const ts = new Date().toLocaleTimeString("zh-CN", { hour12: false });
-      const d = detail
-        ? " " +
-          Object.entries(detail)
-            .map(([k, v]) => `${k}=${v}`)
-            .join(" ")
-        : "";
-      console.error(`[JOB ${ts}] ${action}${d}`);
-    }
-
-    const server = http.createServer(async (req, res) => {
-      const { path: routePath, params } = parseQuery(req.url);
-
-      if (req.method === "POST" && routePath === "/api/users") {
-        try {
-          const { usernames, sources, guessedLocation } = await readBody(req);
-          if (!Array.isArray(usernames) || usernames.length === 0) {
-            sendJSON(res, 400, {
-              error: "usernames \u6570\u7ec4\u4e0d\u80fd\u4e3a\u7a7a",
-            });
-            return;
-          }
-          const userSources = sources || ["seed"];
-          const newUsers = usernames
-            .map((u) => u.replace(/^@/, "").trim())
-            .filter((u) => u && !store.userExists(u));
-          for (const nu of newUsers) {
-            store.addUser({
-              uniqueId: nu,
-              sources: userSources,
-              status: "pending",
-              guessedLocation: guessedLocation || null,
-            });
-          }
-          sendJSON(res, 200, {
-            added: newUsers.length,
-            skipped: usernames.length - newUsers.length,
-            message: `\u5df2\u63d2\u5165 ${newUsers.length} \u4e2a\u7528\u6237`,
-          });
-        } catch (e) {
-          sendJSON(res, 400, { error: e.message });
-        }
-        return;
-      }
-
-      if (req.method === "POST" && routePath === "/api/user") {
-        try {
-          const userData = await readBody(req);
-          if (!userData || !userData.uniqueId) {
-            sendJSON(res, 400, { error: "missing uniqueId" });
-            return;
-          }
-          const existing = store.getUser(userData.uniqueId);
-          if (existing) {
-            sendJSON(res, 200, {
-              added: false,
-              message: "user already exists",
-            });
-            return;
-          }
-          store.addUser(userData);
-          sendJSON(res, 200, { added: true, uniqueId: userData.uniqueId });
-        } catch (e) {
-          sendJSON(res, 400, { error: e.message });
-        }
-        return;
-      }
-
-      if (req.method === "GET" && routePath === "/api/job") {
-        const userId = params.userId || "";
-        const locationsParam = params.locations || "";
-        const locations = locationsParam
-          ? locationsParam
-              .split(",")
-              .map((s) => s.trim().toUpperCase())
-              .filter(Boolean)
-          : null;
-        const loggedIn = params.loggedIn === "true";
-        const job = store.claimNextJob(
-          userId,
-          5 * 60 * 1000,
-          locations,
-          loggedIn,
-        );
-        if (job) {
-          logJob("CLAIM", {
-            user: job.uniqueId,
-            clientId: userId,
-            locations: locations,
-          });
-          sendJSON(res, 200, { hasJob: true, user: job });
-        } else {
-          logJob("CLAIM", {
-            result: "no-job",
-            clientId: userId,
-            locations: locations,
-          });
-          sendJSON(res, 200, { hasJob: false });
-        }
-        return;
-      }
-
-      const jobCommitMatch = routePath.match(/^\/api\/job\/([^/]+)$/);
-      if (req.method === "POST" && jobCommitMatch) {
-        const uniqueId = jobCommitMatch[1];
-        try {
-          const result = await readBody(req);
-          const ret = store.commitJob(uniqueId, result);
-          logJob("COMMIT", {
-            user: uniqueId,
-            status: ret.status,
-            newUsers: ret.newUsers?.length || 0,
-          });
-          if (ret.saved) {
-            sendJSON(res, 200, ret);
-          } else {
-            sendJSON(res, 404, ret);
-          }
-        } catch (e) {
-          sendJSON(res, 400, { error: e.message });
-        }
-        return;
-      }
-
-      const exploreNewMatch = routePath.match(/^\/api\/explore-new\/([^/]+)$/);
-      if (req.method === "POST" && exploreNewMatch) {
-        const uniqueId = exploreNewMatch[1];
-        try {
-          const result = await readBody(req);
-          const ret = store.commitNewExplore(uniqueId, result);
-          logJob("COMMIT_NEW", {
-            user: uniqueId,
-            created: ret.created,
-            status: ret.status,
-            newUsers: ret.newUsers?.length || 0,
-          });
-          sendJSON(res, 200, ret);
-        } catch (e) {
-          sendJSON(res, 400, { error: e.message });
-        }
-        return;
-      }
-
-      const jobResetMatch = routePath.match(/^\/api\/job\/([^/]+)\/reset$/);
-      if (req.method === "POST" && jobResetMatch) {
-        const uniqueId = jobResetMatch[1];
-        const ret = store.resetJob(uniqueId);
-        if (ret.saved) {
-          sendJSON(res, 200, ret);
-        } else {
-          sendJSON(res, 404, ret);
-        }
-        return;
-      }
-
-      if (req.method === "POST" && routePath === "/api/jobs/batch-reset") {
-        const body = await readBody(req);
-        const ids = Array.isArray(body.userIds) ? body.userIds : [];
-        if (ids.length === 0) {
-          sendJSON(res, 400, { error: "userIds 不能为空" });
-          return;
-        }
-        let count = 0;
-        for (const uid of ids) {
-          const ret = store.resetJob(uid);
-          if (ret.saved) count++;
-        }
-        sendJSON(res, 200, { reset: count, total: ids.length });
-        return;
-      }
-
-      if (req.method === "GET" && routePath === "/api/videos") {
-        const result = store.getVideosPage
-          ? store.getVideosPage(params.limit, params.offset)
-          : {
-              total: store.getVideoCount ? store.getVideoCount() : 0,
-              limit: Math.max(1, Math.min(200, parseInt(params.limit) || 50)),
-              offset: Math.max(0, parseInt(params.offset) || 0),
-              videos: store.getVideos
-                ? store
-                    .getVideos()
-                    .slice(
-                      Math.max(0, parseInt(params.offset) || 0),
-                      Math.max(0, parseInt(params.offset) || 0) +
-                        Math.max(
-                          1,
-                          Math.min(200, parseInt(params.limit) || 50),
-                        ),
-                    )
-                : [],
-            };
-        sendJSON(res, 200, result);
-        return;
-      }
-
-      const videoMatch = routePath.match(/^\/api\/videos\/([^/]+)$/);
-      if (req.method === "GET" && videoMatch) {
-        const videoId = videoMatch[1];
-        const video = store.getVideo ? store.getVideo(videoId) : null;
-        if (!video) {
-          sendJSON(res, 404, { error: "video not found" });
-          return;
-        }
-        sendJSON(res, 200, { video });
-        return;
-      }
-
-      // 视频登记
-      if (req.method === "POST" && routePath === "/api/videos") {
-        const body = await readBody(req);
-        const { sourceUser, videoList, locationCreated, ttSeller } = body;
-        if (!sourceUser) {
-          sendJSON(res, 400, { error: "sourceUser 不能为空" });
-          return;
-        }
-        const ret = store.registerVideos(
-          sourceUser,
-          videoList || [],
-          locationCreated,
-          ttSeller,
-        );
-        sendJSON(res, 200, ret);
-        return;
-      }
-
-      const jobPinMatch = routePath.match(/^\/api\/job\/([^/]+)\/pin$/);
-      if (req.method === "POST" && jobPinMatch) {
-        const uniqueId = jobPinMatch[1];
-        const ret = store.togglePin(uniqueId);
-        sendJSON(res, ret.saved ? 200 : 404, ret);
-        return;
-      }
-
-      if (req.method === "GET" && routePath === "/api/stats") {
-        const stats = computeStatsIncremental(store);
-        stats.targetLocations = DEFAULT_TARGET_LOCATIONS;
-        sendJSON(res, 200, stats);
-        return;
-      }
-
-      if (req.method === "GET" && routePath === "/api/redo-job") {
-        const userId = params.userId || "";
-        const job = store.getNextRedoJob(userId);
-        if (job) {
-          logJob("REDO-CLAIM", { user: job.uniqueId, clientId: userId });
-          sendJSON(res, 200, { hasJob: true, user: job });
-        } else {
-          logJob("REDO-CLAIM", { result: "no-job", clientId: userId });
-          sendJSON(res, 200, { hasJob: false });
-        }
-        return;
-      }
-
-      if (req.method === "GET" && routePath === "/api/user-update-tasks") {
-        const limit = params.limit;
-        const countries = params.countries
-          ? params.countries.split(",").map((c) => c.trim().toUpperCase()).filter(Boolean)
-          : [];
-        const tasks = store.getPendingUserUpdateTasks(limit, countries);
-        const ts = new Date().toISOString().slice(11, 19);
-        console.error(`[JOB ${ts}] USER-UPDATE-TASKS: ${tasks.length} tasks${countries.length ? ` (countries: ${countries.join(",")})` : ""}`);
-        sendJSON(res, 200, { total: tasks.length, tasks });
-        return;
-      }
-
-      if (req.method === "POST" && routePath === "/api/user-info-batch") {
-        try {
-          const body = await readBody(req);
-          const updates = body.updates || [];
-          const results = store.batchUpdateUserInfo(updates);
-          const okCount = results.filter((r) => r.ok).length;
-          const errCount = results.filter((r) => r.error).length;
-          const ts = new Date().toISOString().slice(11, 19);
-          console.error(
-            `[JOB ${ts}] USER-INFO-BATCH: ${okCount} ok, ${errCount} error (total=${updates.length})`,
-          );
-          sendJSON(res, 200, {
-            results,
-            total: updates.length,
-            ok: okCount,
-            error: errCount,
-          });
-        } catch (e) {
-          sendJSON(res, 400, { error: e.message });
-        }
-        return;
-      }
-
-      const userInfoCommitMatch = routePath.match(
-        /^\/api\/user-info\/([^/]+)$/,
-      );
-      if (req.method === "PUT" && userInfoCommitMatch) {
-        const uniqueId = userInfoCommitMatch[1];
-        try {
-          const body = await readBody(req);
-          const ret = store.updateUserInfo(uniqueId, body);
-          if (ret.error) {
-            sendJSON(res, 404, { error: ret.error });
-            return;
-          }
-          const ts = new Date().toISOString().slice(11, 19);
-          console.error(
-            `[JOB ${ts}] USER-INFO-UPDATE: ${uniqueId} (userUpdateCount=${ret.userUpdateCount})`,
-          );
-          sendJSON(res, 200, ret);
-        } catch (e) {
-          sendJSON(res, 400, { error: e.message });
-        }
-        return;
-      }
-
-      const userExistsMatch = routePath.match(/^\/api\/user-exists\/([^/]+)$/);
-      if (req.method === "GET" && userExistsMatch) {
-        const uniqueId = userExistsMatch[1];
-        const exists = store.userExists(uniqueId);
-        sendJSON(res, 200, { exists });
-        return;
-      }
-
-      if (req.method === "GET" && routePath === "/api/comment-tasks") {
-        const limit = parseInt(params.limit) || 1;
-        const tasks = store.getPendingCommentTasks(limit);
-        const ts = new Date().toISOString().slice(11, 19);
-        console.error(`[JOB ${ts}] COMMENT-TASKS: ${tasks.length} tasks`);
-        sendJSON(res, 200, { total: tasks.length, tasks });
-        return;
-      }
-
-      const commentTaskMatch = routePath.match(
-        /^\/api\/comment-task\/([^/]+)$/,
-      );
-      if (req.method === "PUT" && commentTaskMatch) {
-        const videoId = commentTaskMatch[1];
-        try {
-          const ret = store.commitCommentTask(videoId);
-          if (ret.error) {
-            sendJSON(res, 404, { error: ret.error });
-            return;
-          }
-          const ts = new Date().toISOString().slice(11, 19);
-          console.error(
-            `[JOB ${ts}] COMMENT-TASK-COMMIT: ${videoId} (userUpdateCount=${ret.userUpdateCount})`,
-          );
-          sendJSON(res, 200, ret);
-        } catch (e) {
-          sendJSON(res, 400, { error: e.message });
-        }
-        return;
-      }
-
-      const redoCommitMatch = routePath.match(/^\/api\/redo-job\/([^/]+)$/);
-      if (req.method === "POST" && redoCommitMatch) {
-        const uniqueId = redoCommitMatch[1];
-        try {
-          const result = await readBody(req);
-          const ret = store.commitRedoJob(uniqueId, result);
-          logJob("REDO-COMMIT", { user: uniqueId, status: ret.status });
-          if (ret.saved) {
-            sendJSON(res, 200, ret);
-          } else {
-            sendJSON(res, 400, { error: ret.error });
-          }
-        } catch (e) {
-          sendJSON(res, 400, { error: e.message });
-        }
-        return;
-      }
-
-      if (req.method === "GET" && routePath === "/api/target-users") {
-        const targetResult = store.getTargetUsers(DEFAULT_TARGET_LOCATIONS);
-        const targets = targetResult.users;
-        if (req.headers["accept"]?.includes("text/csv")) {
-          const columns = [
-            "uniqueId",
-            "nickname",
-            "followerCount",
-            "ttSeller",
-            "verified",
-            "locationCreated",
-            "status",
-            "sources",
-          ];
-          const rows = targets.map((u) => ({
-            uniqueId: u.uniqueId,
-            nickname: u.nickname || "",
-            followerCount: u.followerCount ?? 0,
-            ttSeller: u.ttSeller,
-            verified: u.verified,
-            locationCreated: u.locationCreated || "",
-            status: u.status || "",
-            sources: (u.sources || []).join(";"),
-          }));
-          sendCSV(res, columns, rows);
-        } else {
-          const users = targets.map((u) => ({
-            uniqueId: u.uniqueId,
-            nickname: u.nickname || "",
-            followerCount: u.followerCount || 0,
-          }));
-          sendJSON(res, 200, { total: targets.length, users });
-        }
-        return;
-      }
-
-      if (req.method === "GET" && routePath === "/api/client-errors") {
-        sendJSON(res, 200, { clients: store.getClientErrors() });
-        return;
-      }
-
-      if (req.method === "GET" && routePath === "/api/pending-by-country") {
-        const countries = store.getPendingByCountry();
-        sendJSON(res, 200, { countries });
-        return;
-      }
-
-      if (req.method === "GET" && routePath === "/api/user-update-by-country") {
-        const countries = store.getUserUpdateByCountry();
-        sendJSON(res, 200, { countries });
-        return;
-      }
-
-      if (
-        req.method === "GET" &&
-        routePath === "/api/attach-stuck-by-country"
-      ) {
-        const countries = store.getAttachStuckByCountry();
-        sendJSON(res, 200, { countries });
-        return;
-      }
-
-      if (req.method === "GET" && routePath === "/api/raw-by-country") {
-        const countries = store.getRawByCountry();
-        sendJSON(res, 200, { countries });
-        return;
-      }
-
-      if (req.method === "GET" && routePath === "/api/raw-jobs") {
-        const result = store.getRawJobsPage({
-          search: params.search,
-          location: params.location,
-          limit: params.limit,
-          offset: params.offset,
-        });
-        sendJSON(res, 200, result);
-        return;
-      }
-
-      if (req.method === "POST" && routePath === "/api/jobs/move-to-raw") {
-        try {
-          const body = await readBody(req);
-          const result = store.moveJobsToRawByCountry(body.scope, body.country);
-          if (result.error) {
-            sendJSON(res, 400, result);
-            return;
-          }
-          sendJSON(res, 200, result);
-        } catch (e) {
-          sendJSON(res, 400, { error: e.message });
-        }
-        return;
-      }
-
-      if (req.method === "POST" && routePath === "/api/raw-jobs/restore") {
-        try {
-          const body = await readBody(req);
-          let result;
-          if (body.uniqueId) {
-            result = store.restoreRawJobById(body.uniqueId);
-          } else if (body.search || body.location) {
-            result = store.restoreRawJobsByFilter({
-              search: body.search || "",
-              location: body.location || "",
-            });
-          } else if (body.country) {
-            result = store.restoreRawJobsByCountry(body.country);
-          } else {
-            sendJSON(res, 400, { error: "missing filter: uniqueId, country, or search/location" });
-            return;
-          }
-          if (result.error) {
-            sendJSON(res, 400, result);
-            return;
-          }
-          sendJSON(res, 200, result);
-        } catch (e) {
-          sendJSON(res, 400, { error: e.message });
-        }
-        return;
-      }
-
-      if (req.method === "POST" && routePath === "/api/attach-stuck/restore") {
-        try {
-          const body = await readBody(req);
-          const result = store.restoreAttachStuckByCountry(body.country);
-          if (result.error) {
-            sendJSON(res, 400, result);
-            return;
-          }
-          sendJSON(res, 200, result);
-        } catch (e) {
-          sendJSON(res, 400, { error: e.message });
-        }
-        return;
-      }
-
-      if (
-        req.method === "DELETE" &&
-        routePath.startsWith("/api/client-error/")
-      ) {
-        const userId = routePath.replace("/api/client-error/", "");
-        if (userId) {
-          store.deleteClientError(userId);
-          sendJSON(res, 200, { ok: true });
-        } else {
-          sendJSON(res, 400, { error: "missing userId" });
-        }
-        return;
-      }
-
-      if (req.method === "POST" && routePath === "/api/error-report") {
-        const body = await readBody(req);
-        if (body && body.userId) {
-          store.reportClientError(
-            body.userId,
-            body.errorType || "other",
-            body.errorMessage || "",
-            body.username || "",
-            body.stage || "",
-            body.errorStack || "",
-          );
-          sendJSON(res, 200, { ok: true });
-        } else {
-          sendJSON(res, 400, { error: "missing userId" });
-        }
-        return;
-      }
-
-      if (req.method === "GET" && routePath === "/api/users") {
-        const result = store.getUsersPage({
-          status: params.status,
-          search: params.search,
-          location: params.location,
-          target: params.target,
-          targetLocation: params.targetLocation,
-          limit: params.limit,
-          offset: params.offset,
-          targetLocations: DEFAULT_TARGET_LOCATIONS,
-        });
-
-        if (params.view === "light") {
-          result.users = result.users.map((u) => ({
-            uniqueId: u.uniqueId,
-            nickname: u.nickname,
-            status: u.status,
-            sources: u.sources,
-            ttSeller: u.ttSeller,
-            verified: u.verified,
-            followerCount: u.followerCount,
-            locationCreated: u.locationCreated,
-            guessedLocation: u.guessedLocation,
-            pinned: u.pinned,
-            processedAt: u.processedAt,
-          }));
-        }
-
-        sendJSON(res, 200, result);
-        return;
-      }
-
-      if (
-        req.method === "GET" &&
-        (routePath === "/" || routePath === "/index.html")
-      ) {
-        const html = readFileSync(join(publicDir, "index.html"), "utf-8");
-        res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
-        res.end(html);
-        return;
-      }
-
-      const scriptMatch = routePath.match(/^\/scripts\/(.+)$/);
-      if (req.method === "GET" && scriptMatch) {
-        const scriptsDir = join(__dirname, "../../scripts");
-        const scriptFile = join(scriptsDir, scriptMatch[1]);
-        if (existsSync(scriptFile)) {
-          const content = readFileSync(scriptFile);
-          const fileName = scriptMatch[1];
-          const ext = fileName.split(".").pop();
-          const mime =
-            ext === "sh"
-              ? "text/x-shellscript"
-              : ext === "bat"
-                ? "text/x-msdos-batch"
-                : ext === "ps1"
-                  ? "text/x-powershell"
-                  : "text/plain";
-          res.writeHead(200, {
-            "Content-Type": `${mime}; charset=utf-8`,
-            "Content-Disposition": `attachment; filename="${fileName}"`,
-          });
-          res.end(content);
-          return;
-        }
-      }
-
-      res.writeHead(404);
-      res.end("Not Found");
-    });
-
-    server.on("error", (err) => {
-      if (err.code === "EADDRINUSE") {
-        console.error(
-          `\u7aef\u53e3 ${port} \u5df2\u88ab\u5360\u7528\uff0c\u8bf7\u66f4\u6362\u7aef\u53e3\u540e\u91cd\u8bd5`,
-        );
-        reject(err);
-      } else {
-        reject(err);
-      }
-    });
-
-    const localIP = getLocalIP();
-    server.listen(port, "0.0.0.0", () => {
-      console.error(`Watch 监控服务已启动:`);
-      console.error(`  本地访问: http://127.0.0.1:${port}`);
-      console.error(`  局域网访问: http://${localIP}:${port}`);
-      _resolve({ server, port });
-    });
-
-    async function gracefulShutdown(signal) {
-      console.error(`\n[server] 收到 ${signal}，正在保存数据...`);
-      server.close(() => {
-        console.error("[server] HTTP 服务已关闭");
-      });
-      await store.flushSave();
-      console.error("[server] 数据已保存，退出");
-      process.exit(0);
-    }
-
-    process.on("SIGINT", () => gracefulShutdown("SIGINT"));
-    process.on("SIGTERM", () => gracefulShutdown("SIGTERM"));
-  });
-}
-
-export function openBrowser(port) {
-  spawn("open", [`http://127.0.0.1:${port}`]).on("error", () => {});
-}
-
-export { getLocalIP };
+import http from "http";
+import os from "os";
+
+import { readFileSync, existsSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+import { spawn } from "child_process";
+import { createStore } from "./data-store.js";
+import { DEFAULT_TARGET_LOCATIONS } from "../lib/target-locations.js";
+
+const __filename = fileURLToPath(import.meta.url);
+
+function getLocalIP() {
+  const ifaces = os.networkInterfaces();
+  for (const name of Object.keys(ifaces)) {
+    for (const iface of ifaces[name]) {
+      if (iface.family === "IPv4" && !iface.internal) {
+        return iface.address;
+      }
+    }
+  }
+  return "0.0.0.0";
+}
+const __dirname = dirname(__filename);
+const publicDir = join(__dirname, "public");
+
+function computeStatsIncremental(st) {
+  return st.getDashboardStats(DEFAULT_TARGET_LOCATIONS);
+}
+
+function readBody(req) {
+  return new Promise((resolve, reject) => {
+    let body = "";
+    req.on("data", (chunk) => (body += chunk));
+    req.on("end", () => {
+      try {
+        resolve(body ? JSON.parse(body) : {});
+      } catch (e) {
+        reject(e);
+      }
+    });
+    req.on("error", reject);
+  });
+}
+
+function parseQuery(urlString = "/") {
+  const url = new URL(urlString, "http://127.0.0.1");
+  return {
+    path: url.pathname,
+    params: Object.fromEntries(url.searchParams.entries()),
+  };
+}
+
+function sendJSON(res, code, data) {
+  res.writeHead(code, { "Content-Type": "application/json; charset=utf-8" });
+  res.end(JSON.stringify(data));
+}
+
+function csvEscape(val) {
+  const s = String(val ?? "");
+  return /[",\n\r]/.test(s) ? '"' + s.replace(/"/g, '""') + '"' : s;
+}
+
+function sendCSV(res, columns, rows) {
+  const BOM = "\uFEFF";
+  const header = columns.join(",");
+  const lines = rows.map((r) => columns.map((c) => csvEscape(r[c])).join(","));
+  const body = BOM + [header, ...lines].join("\r\n");
+  res.writeHead(200, {
+    "Content-Type": "text/csv; charset=utf-8",
+    "Content-Disposition": 'attachment; filename="target-users.csv"',
+  });
+  res.end(body);
+}
+
+export function startWatchServer(dataAnchor, port = 3000, existingStore) {
+  return new Promise((_resolve, reject) => {
+    const store = existingStore || createStore(dataAnchor);
+
+    function logJob(action, detail) {
+      const ts = new Date().toLocaleTimeString("zh-CN", { hour12: false });
+      const d = detail
+        ? " " +
+          Object.entries(detail)
+            .map(([k, v]) => `${k}=${v}`)
+            .join(" ")
+        : "";
+      console.error(`[JOB ${ts}] ${action}${d}`);
+    }
+
+    const server = http.createServer(async (req, res) => {
+      const { path: routePath, params } = parseQuery(req.url);
+
+      if (req.method === "POST" && routePath === "/api/users") {
+        try {
+          const { usernames, sources, guessedLocation } = await readBody(req);
+          if (!Array.isArray(usernames) || usernames.length === 0) {
+            sendJSON(res, 400, {
+              error: "usernames \u6570\u7ec4\u4e0d\u80fd\u4e3a\u7a7a",
+            });
+            return;
+          }
+          const userSources = sources || ["seed"];
+          const newUsers = usernames
+            .map((u) => u.replace(/^@/, "").trim())
+            .filter((u) => u && !store.userExists(u));
+          for (const nu of newUsers) {
+            store.addUser({
+              uniqueId: nu,
+              sources: userSources,
+              status: "pending",
+              guessedLocation: guessedLocation || null,
+            });
+          }
+          sendJSON(res, 200, {
+            added: newUsers.length,
+            skipped: usernames.length - newUsers.length,
+            message: `\u5df2\u63d2\u5165 ${newUsers.length} \u4e2a\u7528\u6237`,
+          });
+        } catch (e) {
+          sendJSON(res, 400, { error: e.message });
+        }
+        return;
+      }
+
+      if (req.method === "POST" && routePath === "/api/user") {
+        try {
+          const userData = await readBody(req);
+          if (!userData || !userData.uniqueId) {
+            sendJSON(res, 400, { error: "missing uniqueId" });
+            return;
+          }
+          const existing = store.getUser(userData.uniqueId);
+          if (existing) {
+            sendJSON(res, 200, {
+              added: false,
+              message: "user already exists",
+            });
+            return;
+          }
+          store.addUser(userData);
+          sendJSON(res, 200, { added: true, uniqueId: userData.uniqueId });
+        } catch (e) {
+          sendJSON(res, 400, { error: e.message });
+        }
+        return;
+      }
+
+      if (req.method === "GET" && routePath === "/api/job") {
+        const userId = params.userId || "";
+        const locationsParam = params.locations || "";
+        const locations = locationsParam
+          ? locationsParam
+              .split(",")
+              .map((s) => s.trim().toUpperCase())
+              .filter(Boolean)
+          : null;
+        const loggedIn = params.loggedIn === "true";
+        const job = store.claimNextJob(
+          userId,
+          5 * 60 * 1000,
+          locations,
+          loggedIn,
+        );
+        if (job) {
+          logJob("CLAIM", {
+            user: job.uniqueId,
+            clientId: userId,
+            locations: locations,
+          });
+          sendJSON(res, 200, { hasJob: true, user: job });
+        } else {
+          logJob("CLAIM", {
+            result: "no-job",
+            clientId: userId,
+            locations: locations,
+          });
+          sendJSON(res, 200, { hasJob: false });
+        }
+        return;
+      }
+
+      const jobCommitMatch = routePath.match(/^\/api\/job\/([^/]+)$/);
+      if (req.method === "POST" && jobCommitMatch) {
+        const uniqueId = jobCommitMatch[1];
+        try {
+          const result = await readBody(req);
+          const ret = store.commitJob(uniqueId, result);
+          logJob("COMMIT", {
+            user: uniqueId,
+            status: ret.status,
+            newUsers: ret.newUsers?.length || 0,
+          });
+          if (ret.saved) {
+            sendJSON(res, 200, ret);
+          } else {
+            sendJSON(res, 404, ret);
+          }
+        } catch (e) {
+          sendJSON(res, 400, { error: e.message });
+        }
+        return;
+      }
+
+      const exploreNewMatch = routePath.match(/^\/api\/explore-new\/([^/]+)$/);
+      if (req.method === "POST" && exploreNewMatch) {
+        const uniqueId = exploreNewMatch[1];
+        try {
+          const result = await readBody(req);
+          const ret = store.commitNewExplore(uniqueId, result);
+          logJob("COMMIT_NEW", {
+            user: uniqueId,
+            created: ret.created,
+            status: ret.status,
+            newUsers: ret.newUsers?.length || 0,
+          });
+          sendJSON(res, 200, ret);
+        } catch (e) {
+          sendJSON(res, 400, { error: e.message });
+        }
+        return;
+      }
+
+      const jobResetMatch = routePath.match(/^\/api\/job\/([^/]+)\/reset$/);
+      if (req.method === "POST" && jobResetMatch) {
+        const uniqueId = jobResetMatch[1];
+        const ret = store.resetJob(uniqueId);
+        if (ret.saved) {
+          sendJSON(res, 200, ret);
+        } else {
+          sendJSON(res, 404, ret);
+        }
+        return;
+      }
+
+      if (req.method === "POST" && routePath === "/api/jobs/batch-reset") {
+        const body = await readBody(req);
+        const ids = Array.isArray(body.userIds) ? body.userIds : [];
+        if (ids.length === 0) {
+          sendJSON(res, 400, { error: "userIds 不能为空" });
+          return;
+        }
+        let count = 0;
+        for (const uid of ids) {
+          const ret = store.resetJob(uid);
+          if (ret.saved) count++;
+        }
+        sendJSON(res, 200, { reset: count, total: ids.length });
+        return;
+      }
+
+      if (req.method === "GET" && routePath === "/api/videos") {
+        const result = store.getVideosPage
+          ? store.getVideosPage(params.limit, params.offset)
+          : {
+              total: store.getVideoCount ? store.getVideoCount() : 0,
+              limit: Math.max(1, Math.min(200, parseInt(params.limit) || 50)),
+              offset: Math.max(0, parseInt(params.offset) || 0),
+              videos: store.getVideos
+                ? store
+                    .getVideos()
+                    .slice(
+                      Math.max(0, parseInt(params.offset) || 0),
+                      Math.max(0, parseInt(params.offset) || 0) +
+                        Math.max(
+                          1,
+                          Math.min(200, parseInt(params.limit) || 50),
+                        ),
+                    )
+                : [],
+            };
+        sendJSON(res, 200, result);
+        return;
+      }
+
+      const videoMatch = routePath.match(/^\/api\/videos\/([^/]+)$/);
+      if (req.method === "GET" && videoMatch) {
+        const videoId = videoMatch[1];
+        const video = store.getVideo ? store.getVideo(videoId) : null;
+        if (!video) {
+          sendJSON(res, 404, { error: "video not found" });
+          return;
+        }
+        sendJSON(res, 200, { video });
+        return;
+      }
+
+      // 视频登记
+      if (req.method === "POST" && routePath === "/api/videos") {
+        const body = await readBody(req);
+        const { sourceUser, videoList, locationCreated, ttSeller } = body;
+        if (!sourceUser) {
+          sendJSON(res, 400, { error: "sourceUser 不能为空" });
+          return;
+        }
+        const ret = store.registerVideos(
+          sourceUser,
+          videoList || [],
+          locationCreated,
+          ttSeller,
+        );
+        sendJSON(res, 200, ret);
+        return;
+      }
+
+      const jobPinMatch = routePath.match(/^\/api\/job\/([^/]+)\/pin$/);
+      if (req.method === "POST" && jobPinMatch) {
+        const uniqueId = jobPinMatch[1];
+        const ret = store.togglePin(uniqueId);
+        sendJSON(res, ret.saved ? 200 : 404, ret);
+        return;
+      }
+
+      if (req.method === "GET" && routePath === "/api/stats") {
+        const stats = computeStatsIncremental(store);
+        stats.targetLocations = DEFAULT_TARGET_LOCATIONS;
+        sendJSON(res, 200, stats);
+        return;
+      }
+
+      if (req.method === "GET" && routePath === "/api/redo-job") {
+        const userId = params.userId || "";
+        const job = store.getNextRedoJob(userId);
+        if (job) {
+          logJob("REDO-CLAIM", { user: job.uniqueId, clientId: userId });
+          sendJSON(res, 200, { hasJob: true, user: job });
+        } else {
+          logJob("REDO-CLAIM", { result: "no-job", clientId: userId });
+          sendJSON(res, 200, { hasJob: false });
+        }
+        return;
+      }
+
+      if (req.method === "GET" && routePath === "/api/user-update-tasks") {
+        const limit = params.limit;
+        const countries = params.countries
+          ? params.countries.split(",").map((c) => c.trim().toUpperCase()).filter(Boolean)
+          : [];
+        const tasks = store.getPendingUserUpdateTasks(limit, countries);
+        const ts = new Date().toISOString().slice(11, 19);
+        console.error(`[JOB ${ts}] USER-UPDATE-TASKS: ${tasks.length} tasks${countries.length ? ` (countries: ${countries.join(",")})` : ""}`);
+        sendJSON(res, 200, { total: tasks.length, tasks });
+        return;
+      }
+
+      if (req.method === "POST" && routePath === "/api/user-info-batch") {
+        try {
+          const body = await readBody(req);
+          const updates = body.updates || [];
+          const results = store.batchUpdateUserInfo(updates);
+          const okCount = results.filter((r) => r.ok).length;
+          const errCount = results.filter((r) => r.error).length;
+          const ts = new Date().toISOString().slice(11, 19);
+          console.error(
+            `[JOB ${ts}] USER-INFO-BATCH: ${okCount} ok, ${errCount} error (total=${updates.length})`,
+          );
+          sendJSON(res, 200, {
+            results,
+            total: updates.length,
+            ok: okCount,
+            error: errCount,
+          });
+        } catch (e) {
+          sendJSON(res, 400, { error: e.message });
+        }
+        return;
+      }
+
+      const userInfoCommitMatch = routePath.match(
+        /^\/api\/user-info\/([^/]+)$/,
+      );
+      if (req.method === "PUT" && userInfoCommitMatch) {
+        const uniqueId = userInfoCommitMatch[1];
+        try {
+          const body = await readBody(req);
+          const ret = store.updateUserInfo(uniqueId, body);
+          if (ret.error) {
+            sendJSON(res, 404, { error: ret.error });
+            return;
+          }
+          const ts = new Date().toISOString().slice(11, 19);
+          console.error(
+            `[JOB ${ts}] USER-INFO-UPDATE: ${uniqueId} (userUpdateCount=${ret.userUpdateCount})`,
+          );
+          sendJSON(res, 200, ret);
+        } catch (e) {
+          sendJSON(res, 400, { error: e.message });
+        }
+        return;
+      }
+
+      const userExistsMatch = routePath.match(/^\/api\/user-exists\/([^/]+)$/);
+      if (req.method === "GET" && userExistsMatch) {
+        const uniqueId = userExistsMatch[1];
+        const exists = store.userExists(uniqueId);
+        sendJSON(res, 200, { exists });
+        return;
+      }
+
+      if (req.method === "GET" && routePath === "/api/comment-tasks") {
+        const limit = parseInt(params.limit) || 1;
+        const tasks = store.getPendingCommentTasks(limit);
+        const ts = new Date().toISOString().slice(11, 19);
+        console.error(`[JOB ${ts}] COMMENT-TASKS: ${tasks.length} tasks`);
+        sendJSON(res, 200, { total: tasks.length, tasks });
+        return;
+      }
+
+      const commentTaskMatch = routePath.match(
+        /^\/api\/comment-task\/([^/]+)$/,
+      );
+      if (req.method === "PUT" && commentTaskMatch) {
+        const videoId = commentTaskMatch[1];
+        try {
+          const ret = store.commitCommentTask(videoId);
+          if (ret.error) {
+            sendJSON(res, 404, { error: ret.error });
+            return;
+          }
+          const ts = new Date().toISOString().slice(11, 19);
+          console.error(
+            `[JOB ${ts}] COMMENT-TASK-COMMIT: ${videoId} (userUpdateCount=${ret.userUpdateCount})`,
+          );
+          sendJSON(res, 200, ret);
+        } catch (e) {
+          sendJSON(res, 400, { error: e.message });
+        }
+        return;
+      }
+
+      const redoCommitMatch = routePath.match(/^\/api\/redo-job\/([^/]+)$/);
+      if (req.method === "POST" && redoCommitMatch) {
+        const uniqueId = redoCommitMatch[1];
+        try {
+          const result = await readBody(req);
+          const ret = store.commitRedoJob(uniqueId, result);
+          logJob("REDO-COMMIT", { user: uniqueId, status: ret.status });
+          if (ret.saved) {
+            sendJSON(res, 200, ret);
+          } else {
+            sendJSON(res, 400, { error: ret.error });
+          }
+        } catch (e) {
+          sendJSON(res, 400, { error: e.message });
+        }
+        return;
+      }
+
+      if (req.method === "GET" && routePath === "/api/target-users") {
+        const targetResult = store.getTargetUsers(DEFAULT_TARGET_LOCATIONS);
+        const targets = targetResult.users;
+        if (req.headers["accept"]?.includes("text/csv")) {
+          const columns = [
+            "uniqueId",
+            "nickname",
+            "followerCount",
+            "ttSeller",
+            "verified",
+            "locationCreated",
+            "status",
+            "sources",
+          ];
+          const rows = targets.map((u) => ({
+            uniqueId: u.uniqueId,
+            nickname: u.nickname || "",
+            followerCount: u.followerCount ?? 0,
+            ttSeller: u.ttSeller,
+            verified: u.verified,
+            locationCreated: u.locationCreated || "",
+            status: u.status || "",
+            sources: (u.sources || []).join(";"),
+          }));
+          sendCSV(res, columns, rows);
+        } else {
+          const users = targets.map((u) => ({
+            uniqueId: u.uniqueId,
+            nickname: u.nickname || "",
+            followerCount: u.followerCount || 0,
+          }));
+          sendJSON(res, 200, { total: targets.length, users });
+        }
+        return;
+      }
+
+      if (req.method === "GET" && routePath === "/api/client-errors") {
+        sendJSON(res, 200, { clients: store.getClientErrors() });
+        return;
+      }
+
+      if (req.method === "GET" && routePath === "/api/pending-by-country") {
+        const countries = store.getPendingByCountry();
+        sendJSON(res, 200, { countries });
+        return;
+      }
+
+      if (req.method === "GET" && routePath === "/api/user-update-by-country") {
+        const countries = store.getUserUpdateByCountry();
+        sendJSON(res, 200, { countries });
+        return;
+      }
+
+      if (
+        req.method === "GET" &&
+        routePath === "/api/attach-stuck-by-country"
+      ) {
+        const countries = store.getAttachStuckByCountry();
+        sendJSON(res, 200, { countries });
+        return;
+      }
+
+      if (req.method === "GET" && routePath === "/api/raw-by-country") {
+        const countries = store.getRawByCountry();
+        sendJSON(res, 200, { countries });
+        return;
+      }
+
+      if (req.method === "GET" && routePath === "/api/raw-jobs") {
+        const result = store.getRawJobsPage({
+          search: params.search,
+          location: params.location,
+          limit: params.limit,
+          offset: params.offset,
+        });
+        sendJSON(res, 200, result);
+        return;
+      }
+
+      if (req.method === "POST" && routePath === "/api/jobs/move-to-raw") {
+        try {
+          const body = await readBody(req);
+          const result = store.moveJobsToRawByCountry(body.scope, body.country);
+          if (result.error) {
+            sendJSON(res, 400, result);
+            return;
+          }
+          sendJSON(res, 200, result);
+        } catch (e) {
+          sendJSON(res, 400, { error: e.message });
+        }
+        return;
+      }
+
+      if (req.method === "POST" && routePath === "/api/raw-jobs/restore") {
+        try {
+          const body = await readBody(req);
+          let result;
+          if (body.uniqueId) {
+            result = store.restoreRawJobById(body.uniqueId);
+          } else if (body.search || body.location) {
+            result = store.restoreRawJobsByFilter({
+              search: body.search || "",
+              location: body.location || "",
+            });
+          } else if (body.country) {
+            result = store.restoreRawJobsByCountry(body.country);
+          } else {
+            sendJSON(res, 400, { error: "missing filter: uniqueId, country, or search/location" });
+            return;
+          }
+          if (result.error) {
+            sendJSON(res, 400, result);
+            return;
+          }
+          sendJSON(res, 200, result);
+        } catch (e) {
+          sendJSON(res, 400, { error: e.message });
+        }
+        return;
+      }
+
+      if (req.method === "POST" && routePath === "/api/attach-stuck/restore") {
+        try {
+          const body = await readBody(req);
+          const result = store.restoreAttachStuckByCountry(body.country);
+          if (result.error) {
+            sendJSON(res, 400, result);
+            return;
+          }
+          sendJSON(res, 200, result);
+        } catch (e) {
+          sendJSON(res, 400, { error: e.message });
+        }
+        return;
+      }
+
+      if (
+        req.method === "DELETE" &&
+        routePath.startsWith("/api/client-error/")
+      ) {
+        const userId = routePath.replace("/api/client-error/", "");
+        if (userId) {
+          store.deleteClientError(userId);
+          sendJSON(res, 200, { ok: true });
+        } else {
+          sendJSON(res, 400, { error: "missing userId" });
+        }
+        return;
+      }
+
+      if (req.method === "POST" && routePath === "/api/error-report") {
+        const body = await readBody(req);
+        if (body && body.userId) {
+          store.reportClientError(
+            body.userId,
+            body.errorType || "other",
+            body.errorMessage || "",
+            body.username || "",
+            body.stage || "",
+            body.errorStack || "",
+          );
+          sendJSON(res, 200, { ok: true });
+        } else {
+          sendJSON(res, 400, { error: "missing userId" });
+        }
+        return;
+      }
+
+      if (req.method === "GET" && routePath === "/api/users") {
+        const result = store.getUsersPage({
+          status: params.status,
+          search: params.search,
+          location: params.location,
+          target: params.target,
+          targetLocation: params.targetLocation,
+          limit: params.limit,
+          offset: params.offset,
+          targetLocations: DEFAULT_TARGET_LOCATIONS,
+        });
+
+        if (params.view === "light") {
+          result.users = result.users.map((u) => ({
+            uniqueId: u.uniqueId,
+            nickname: u.nickname,
+            status: u.status,
+            sources: u.sources,
+            ttSeller: u.ttSeller,
+            verified: u.verified,
+            followerCount: u.followerCount,
+            locationCreated: u.locationCreated,
+            guessedLocation: u.guessedLocation,
+            pinned: u.pinned,
+            processedAt: u.processedAt,
+          }));
+        }
+
+        sendJSON(res, 200, result);
+        return;
+      }
+
+      if (
+        req.method === "GET" &&
+        (routePath === "/" || routePath === "/index.html")
+      ) {
+        const html = readFileSync(join(publicDir, "index.html"), "utf-8");
+        res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
+        res.end(html);
+        return;
+      }
+
+      const scriptMatch = routePath.match(/^\/scripts\/(.+)$/);
+      if (req.method === "GET" && scriptMatch) {
+        const scriptsDir = join(__dirname, "../../scripts");
+        const scriptFile = join(scriptsDir, scriptMatch[1]);
+        if (existsSync(scriptFile)) {
+          const content = readFileSync(scriptFile);
+          const fileName = scriptMatch[1];
+          const ext = fileName.split(".").pop();
+          const mime =
+            ext === "sh"
+              ? "text/x-shellscript"
+              : ext === "bat"
+                ? "text/x-msdos-batch"
+                : ext === "ps1"
+                  ? "text/x-powershell"
+                  : "text/plain";
+          res.writeHead(200, {
+            "Content-Type": `${mime}; charset=utf-8`,
+            "Content-Disposition": `attachment; filename="${fileName}"`,
+          });
+          res.end(content);
+          return;
+        }
+      }
+
+      res.writeHead(404);
+      res.end("Not Found");
+    });
+
+    server.on("error", (err) => {
+      if (err.code === "EADDRINUSE") {
+        console.error(
+          `\u7aef\u53e3 ${port} \u5df2\u88ab\u5360\u7528\uff0c\u8bf7\u66f4\u6362\u7aef\u53e3\u540e\u91cd\u8bd5`,
+        );
+        reject(err);
+      } else {
+        reject(err);
+      }
+    });
+
+    const localIP = getLocalIP();
+    server.listen(port, "0.0.0.0", () => {
+      console.error(`Watch 监控服务已启动:`);
+      console.error(`  本地访问: http://127.0.0.1:${port}`);
+      console.error(`  局域网访问: http://${localIP}:${port}`);
+      _resolve({ server, port });
+    });
+
+    async function gracefulShutdown(signal) {
+      console.error(`\n[server] 收到 ${signal}，正在保存数据...`);
+      server.close(() => {
+        console.error("[server] HTTP 服务已关闭");
+      });
+      await store.flushSave();
+      console.error("[server] 数据已保存，退出");
+      process.exit(0);
+    }
+
+    process.on("SIGINT", () => gracefulShutdown("SIGINT"));
+    process.on("SIGTERM", () => gracefulShutdown("SIGTERM"));
+  });
+}
+
+export function openBrowser(port) {
+  spawn("open", [`http://127.0.0.1:${port}`]).on("error", () => {});
+}
+
+export { getLocalIP };