tt-help-cli-ycl 1.3.45 → 1.3.46

package/src/lib/constants.js

@@ -1,287 +1,297 @@
-import { join, dirname } from "path";
-import { readFileSync, writeFileSync, existsSync } from "fs";
-import { fileURLToPath } from "url";
-import { DEFAULT_TARGET_LOCATIONS_CSV } from "./target-locations.js";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-const homeDir = process.env.HOME || process.env.USERPROFILE || "";
-const configPath = join(homeDir, ".tt-help.json");
-
-const DEFAULT_PROXY = "http://127.0.0.1:7897";
-const DEFAULT_OUTPUT = "tiktok_data.json";
-
-let proxy = DEFAULT_PROXY;
-let server = "http://127.0.0.1:3001";
-let configFile = null;
-let browser = null;
-let userId = null;
-let maxFollowing = 50;
-let maxFollowers = 50;
-let maxVideos = 16;
-let maxComments = 10;
-
-try {
-  if (existsSync(configPath)) {
-    const cfg = JSON.parse(readFileSync(configPath, "utf-8"));
-    if (cfg.proxy) {
-      proxy = cfg.proxy;
-    }
-    if (cfg.server) {
-      server = cfg.server;
-    }
-    if (cfg.browser) {
-      browser = cfg.browser;
-    }
-    if (cfg.userId) {
-      userId = cfg.userId;
-    }
-    if (cfg.maxFollowing !== undefined) {
-      maxFollowing = cfg.maxFollowing;
-    }
-    if (cfg.maxFollowers !== undefined) {
-      maxFollowers = cfg.maxFollowers;
-    }
-    if (cfg.maxVideos !== undefined) {
-      maxVideos = cfg.maxVideos;
-    }
-    if (cfg.maxComments !== undefined) {
-      maxComments = cfg.maxComments;
-    }
-    configFile = configPath;
-  }
-} catch {
-  // no config file
-}
-
-function saveBrowser(path) {
-  const cfg = existsSync(configPath)
-    ? JSON.parse(readFileSync(configPath, "utf-8"))
-    : {};
-  cfg.browser = path;
-  writeFileSync(configPath, JSON.stringify(cfg, null, 2), "utf-8");
-  browser = path;
-  configFile = configPath;
-}
-
-function saveUserId(id) {
-  const cfg = existsSync(configPath)
-    ? JSON.parse(readFileSync(configPath, "utf-8"))
-    : {};
-  cfg.userId = id;
-  writeFileSync(configPath, JSON.stringify(cfg, null, 2), "utf-8");
-  userId = id;
-  configFile = configPath;
-}
-
-function saveMaxFollowing(val) {
-  const cfg = existsSync(configPath)
-    ? JSON.parse(readFileSync(configPath, "utf-8"))
-    : {};
-  cfg.maxFollowing = parseInt(val) || 5;
-  writeFileSync(configPath, JSON.stringify(cfg, null, 2), "utf-8");
-  maxFollowing = cfg.maxFollowing;
-  configFile = configPath;
-}
-
-function saveMaxFollowers(val) {
-  const cfg = existsSync(configPath)
-    ? JSON.parse(readFileSync(configPath, "utf-8"))
-    : {};
-  cfg.maxFollowers = parseInt(val) || 5;
-  writeFileSync(configPath, JSON.stringify(cfg, null, 2), "utf-8");
-  maxFollowers = cfg.maxFollowers;
-  configFile = configPath;
-}
-
-function saveMaxVideos(val) {
-  const cfg = existsSync(configPath)
-    ? JSON.parse(readFileSync(configPath, "utf-8"))
-    : {};
-  cfg.maxVideos = parseInt(val) || 16;
-  writeFileSync(configPath, JSON.stringify(cfg, null, 2), "utf-8");
-  maxVideos = cfg.maxVideos;
-  configFile = configPath;
-}
-
-function saveMaxComments(val) {
-  const cfg = existsSync(configPath)
-    ? JSON.parse(readFileSync(configPath, "utf-8"))
-    : {};
-  cfg.maxComments = parseInt(val) || 10;
-  writeFileSync(configPath, JSON.stringify(cfg, null, 2), "utf-8");
-  maxComments = cfg.maxComments;
-  configFile = configPath;
-}
-
-const HELP_TEXT = [
-  "用法:",
-  "",
-  "  tt-help explore <用户名> [preset] [选项]",
-  "    支持多个用户名: tt-help explore @user1 @user2 --server http://127.0.0.1:3001",
-  "    预设: fast, normal（默认）, slow, stealth",
-  "    选项:",
-  "      --server <URL>            服务端地址，默认 http://127.0.0.1:3001",
-  `      --location <国家代码>     国家筛选，逗号分隔，默认 ${DEFAULT_TARGET_LOCATIONS_CSV}`,
-  "      --job-locations <国家>    任务国家筛选，逗号分隔（仅筛选服务端任务）",
-  "      --max-comments <数量>     每视频最大评论数，默认 10",
-  "      --max-guess <数量>        每视频最大猜你喜欢数，默认 0",
-  "      --max-videos <数量>       每用户最大视频数，默认 16",
-  "      --enable-follow           启用关注/粉丝提取（默认启用）",
-  "      --disable-follow          禁用关注/粉丝提取",
-  "      --max-following <数量>    最大获取关注数，默认 50",
-  "      --max-followers <数量>    最大获取粉丝数，默认 50",
-  "      --max-users <数量>        最大处理用户数，默认无限制",
-  "      -i, --interval <秒数>     无任务时轮询间隔，默认 10 秒",
-  "      --port <端口号>           固定 CDP 端口（调试用，关闭自动轮换）",
-  "      --base-port <端口号>      起始端口，默认 9222",
-  "      --port-count <数量>       端口数量（账户数），默认 10",
-  "      --user-id <编号>          客户端编号（设备ID），默认自动生成",
-  "",
-  "  tt-help info <URL> [URL2 ...] [--onlyvideo]",
-  "    获取用户/视频信息，支持多个 URL",
-  "    主页 URL      → 返回用户信息",
-  "    视频 URL      → 返回用户信息 + 视频信息",
-  "    视频 URL + --onlyvideo → 只返回视频信息",
-  "    示例: tt-help info https://www.tiktok.com/@nike",
-  "          tt-help info https://www.tiktok.com/@nike/video/7234567890 --onlyvideo",
-  "",
-  "  tt-help attach [-p 并行数] [-i 间隔秒数] [-s 服务端地址] [-c 国家列表]",
-  "    后台轮询服务端任务接口，自动抓取 TikTok 用户信息",
-  "    -p, --parallel <N>     并行抓取数（默认: 1）",
-  "    -i, --interval <N>     无任务时轮询间隔，单位秒（默认: 10）",
-  "    -s, --server <URL>     服务端地址（默认: http://127.0.0.1:3001）",
-  "    -c, --countries <A,B>  猜测国家列表（逗号分隔，如 PL,DE,FR）",
-  "    示例: tt-help attach -p 5 -i 10",
-  "          tt-help attach -c PL,DE,FR -p 5",
-  "",
-  "  tt-help watch -o <db路径> [-p 端口]",
-  "    启动监控服务；运行期主数据仅来自 SQLite",
-  "    示例: tt-help watch -o data/result.db",
-  "          tt-help watch -o data/result.db -p 8080",
-  "",
-  "  tt-help open <端口号>",
-  "    打开指定端口的浏览器，用于配置 TikTok 登录账户",
-  "    端口范围: 9222 - 9231（对应 explore 的 10 个内置账户）",
-  "    --list                  列出所有端口和配置",
-  "    示例: tt-help open 9222",
-  "          tt-help open --list",
-  "",
-  "  videostats  <db路径> -p <并发数>",
-  "    批量刷新视频统计数据（playCount, diggCount, commentCount, shareCount, collectCount）",
-  "    直接读取并更新 SQLite videos 表",
-  "    -p, --parallel <N>       并发数（默认: 3）",
-  "    示例: tt-help videostats data/result.db -p 3",
-  "",
-  "  db-import  --db <db路径> [--users users.json] [--done done.json] [--videos videos.json]",
-  "    将 legacy JSON 显式导入 SQLite；运行期不再自动读取 result*.json",
-  "    示例: tt-help db-import --db data/result.db --users data/result.json --done data/result-done.json --videos data/result-videos.json",
-  "",
-  "  config  [show|set|reset]",
-  "    config                    查看当前配置",
-  "    config set <key> <value>  设置配置（key: proxy, server, browser, userId, maxFollowing, maxFollowers, maxVideos, maxComments）",
-  "    config reset              重置所有配置为默认",
-  "",
-  "  全局选项:",
-  "    -h, --help                显示帮助",
-  "    --version                 显示版本号",
-  "",
-  "  示例: tt-help info https://www.tiktok.com/@nike https://www.tiktok.com/@adidas",
-  "        tt-help explore qiqi23280 fast --location ES --max-comments 50",
-  "        tt-help config set server http://127.0.0.1:3001",
-  "        tt-help attach -p 5 -i 10",
-  "        tt-help watch -o data/result.db",
-  "        tt-help videostats data/result.db -p 3",
-];
-
-const PUBLIC_HELP_HIDDEN_HEADERS = new Set([
-  "  tt-help watch -o <db路径> [-p 端口]",
-  "  videostats  <db路径> -p <并发数>",
-  "  db-import  --db <db路径> [--users users.json] [--done done.json] [--videos videos.json]",
-]);
-
-const PUBLIC_HELP_HIDDEN_LINES = new Set([
-  "        tt-help watch -o data/result.db",
-  "        tt-help videostats data/result.db -p 3",
-]);
-
-function removeHelpSections(lines, hiddenHeaders, hiddenLines = new Set()) {
-  const result = [];
-  let skipping = false;
-
-  for (const line of lines) {
-    if (hiddenHeaders.has(line)) {
-      skipping = true;
-      continue;
-    }
-
-    if (skipping) {
-      if (line === "") {
-        skipping = false;
-      }
-      continue;
-    }
-
-    if (hiddenLines.has(line)) {
-      continue;
-    }
-
-    result.push(line);
-  }
-
-  return result;
-}
-
-const PUBLIC_HELP_TEXT = removeHelpSections(
-  HELP_TEXT,
-  PUBLIC_HELP_HIDDEN_HEADERS,
-  PUBLIC_HELP_HIDDEN_LINES,
-);
-
-function getConfigText() {
-  let currentUserId = userId;
-  if (!currentUserId && existsSync(configPath)) {
-    try {
-      const cfg = JSON.parse(readFileSync(configPath, "utf-8"));
-      if (cfg.userId) currentUserId = cfg.userId;
-    } catch {}
-  }
-  return [
-    "tt-help v1.0.1",
-    "",
-    "配置:",
-    `  代理: ${proxy}`,
-    `  服务端: ${server}`,
-    `  浏览器: ${browser || "未配置（将自动探测或回退）"}`,
-    `  用户号: ${currentUserId || "未设置（首次运行 auto 自动创建）"}`,
-    `  商家关注采集数: ${maxFollowing}`,
-    `  粉丝采集数: ${maxFollowers}`,
-    `  视频采集数: ${maxVideos}`,
-    `  评论采集数: ${maxComments}`,
-    `  输出格式: json`,
-    `  默认输出: ${DEFAULT_OUTPUT}`,
-    `  配置文件: ${configFile || "无（使用默认值）"}`,
-  ];
-}
-
-export {
-  proxy,
-  server,
-  configPath,
-  DEFAULT_PROXY,
-  HELP_TEXT,
-  PUBLIC_HELP_TEXT,
-  browser,
-  userId,
-  maxFollowing,
-  maxFollowers,
-  maxVideos,
-  maxComments,
-  saveBrowser,
-  saveUserId,
-  saveMaxFollowing,
-  saveMaxFollowers,
-  saveMaxVideos,
-  saveMaxComments,
-  getConfigText,
-};
+import { join, dirname } from "path";
+import { readFileSync, writeFileSync, existsSync } from "fs";
+import { fileURLToPath } from "url";
+import { DEFAULT_TARGET_LOCATIONS_CSV } from "./target-locations.js";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const homeDir = process.env.HOME || process.env.USERPROFILE || "";
+const configPath = join(homeDir, ".tt-help.json");
+
+const DEFAULT_PROXY = "http://127.0.0.1:7897";
+const DEFAULT_OUTPUT = "tiktok_data.json";
+
+let proxy = DEFAULT_PROXY;
+let server = "http://127.0.0.1:3001";
+let configFile = null;
+let browser = null;
+let userId = null;
+let maxFollowing = 50;
+let maxFollowers = 50;
+let maxVideos = 16;
+let maxComments = 10;
+
+try {
+  if (existsSync(configPath)) {
+    const cfg = JSON.parse(readFileSync(configPath, "utf-8"));
+    if (cfg.proxy) {
+      proxy = cfg.proxy;
+    }
+    if (cfg.server) {
+      server = cfg.server;
+    }
+    if (cfg.browser) {
+      browser = cfg.browser;
+    }
+    if (cfg.userId) {
+      userId = cfg.userId;
+    }
+    if (cfg.maxFollowing !== undefined) {
+      maxFollowing = cfg.maxFollowing;
+    }
+    if (cfg.maxFollowers !== undefined) {
+      maxFollowers = cfg.maxFollowers;
+    }
+    if (cfg.maxVideos !== undefined) {
+      maxVideos = cfg.maxVideos;
+    }
+    if (cfg.maxComments !== undefined) {
+      maxComments = cfg.maxComments;
+    }
+    configFile = configPath;
+  }
+} catch {
+  // no config file
+}
+
+function saveBrowser(path) {
+  const cfg = existsSync(configPath)
+    ? JSON.parse(readFileSync(configPath, "utf-8"))
+    : {};
+  cfg.browser = path;
+  writeFileSync(configPath, JSON.stringify(cfg, null, 2), "utf-8");
+  browser = path;
+  configFile = configPath;
+}
+
+function saveUserId(id) {
+  const cfg = existsSync(configPath)
+    ? JSON.parse(readFileSync(configPath, "utf-8"))
+    : {};
+  cfg.userId = id;
+  writeFileSync(configPath, JSON.stringify(cfg, null, 2), "utf-8");
+  userId = id;
+  configFile = configPath;
+}
+
+function saveMaxFollowing(val) {
+  const cfg = existsSync(configPath)
+    ? JSON.parse(readFileSync(configPath, "utf-8"))
+    : {};
+  cfg.maxFollowing = parseInt(val) || 5;
+  writeFileSync(configPath, JSON.stringify(cfg, null, 2), "utf-8");
+  maxFollowing = cfg.maxFollowing;
+  configFile = configPath;
+}
+
+function saveMaxFollowers(val) {
+  const cfg = existsSync(configPath)
+    ? JSON.parse(readFileSync(configPath, "utf-8"))
+    : {};
+  cfg.maxFollowers = parseInt(val) || 5;
+  writeFileSync(configPath, JSON.stringify(cfg, null, 2), "utf-8");
+  maxFollowers = cfg.maxFollowers;
+  configFile = configPath;
+}
+
+function saveMaxVideos(val) {
+  const cfg = existsSync(configPath)
+    ? JSON.parse(readFileSync(configPath, "utf-8"))
+    : {};
+  cfg.maxVideos = parseInt(val) || 16;
+  writeFileSync(configPath, JSON.stringify(cfg, null, 2), "utf-8");
+  maxVideos = cfg.maxVideos;
+  configFile = configPath;
+}
+
+function saveMaxComments(val) {
+  const cfg = existsSync(configPath)
+    ? JSON.parse(readFileSync(configPath, "utf-8"))
+    : {};
+  cfg.maxComments = parseInt(val) || 10;
+  writeFileSync(configPath, JSON.stringify(cfg, null, 2), "utf-8");
+  maxComments = cfg.maxComments;
+  configFile = configPath;
+}
+
+const HELP_TEXT = [
+  "用法:",
+  "",
+  "  tt-help explore <用户名> [preset] [选项]",
+  "    支持多个用户名: tt-help explore @user1 @user2 --server http://127.0.0.1:3001",
+  "    预设: fast, normal（默认）, slow, stealth",
+  "    选项:",
+  "      --server <URL>            服务端地址，默认 http://127.0.0.1:3001",
+  `      --location <国家代码>     国家筛选，逗号分隔，默认 ${DEFAULT_TARGET_LOCATIONS_CSV}`,
+  "      --job-locations <国家>    任务国家筛选，逗号分隔（仅筛选服务端任务）",
+  "      --max-comments <数量>     每视频最大评论数，默认 10",
+  "      --max-guess <数量>        每视频最大猜你喜欢数，默认 0",
+  "      --max-videos <数量>       每用户最大视频数，默认 16",
+  "      --enable-follow           启用关注/粉丝提取（默认启用）",
+  "      --disable-follow          禁用关注/粉丝提取",
+  "      --max-following <数量>    最大获取关注数，默认 50",
+  "      --max-followers <数量>    最大获取粉丝数，默认 50",
+  "      --max-users <数量>        最大处理用户数，默认无限制",
+  "      -i, --interval <秒数>     无任务时轮询间隔，默认 10 秒",
+  "      --port <端口号>           固定 CDP 端口（调试用，关闭自动轮换）",
+  "      --base-port <端口号>      起始端口，默认 9222",
+  "      --port-count <数量>       端口数量（账户数），默认 10",
+  "      --user-id <编号>          客户端编号（设备ID），默认自动生成",
+  "",
+  "  tt-help info <URL> [URL2 ...] [--onlyvideo]",
+  "    获取用户/视频信息，支持多个 URL",
+  "    主页 URL      → 返回用户信息",
+  "    视频 URL      → 返回用户信息 + 视频信息",
+  "    视频 URL + --onlyvideo → 只返回视频信息",
+  "    示例: tt-help info https://www.tiktok.com/@nike",
+  "          tt-help info https://www.tiktok.com/@nike/video/7234567890 --onlyvideo",
+  "",
+  "  tt-help attach [-p 并行数] [-i 间隔秒数] [-s 服务端地址] [-c 国家列表]",
+  "    后台轮询服务端任务接口，自动抓取 TikTok 用户信息",
+  "    -p, --parallel <N>     并行抓取数（默认: 1）",
+  "    -i, --interval <N>     无任务时轮询间隔，单位秒（默认: 10）",
+  "    -s, --server <URL>     服务端地址（默认: http://127.0.0.1:3001）",
+  "    -c, --countries <A,B>  猜测国家列表（逗号分隔，如 PL,DE,FR）",
+  "    示例: tt-help attach -p 5 -i 10",
+  "          tt-help attach -c PL,DE,FR -p 5",
+  "",
+  "  tt-help watch -o <db路径> [-p 端口]",
+  "    启动监控服务；运行期主数据仅来自 SQLite",
+  "    示例: tt-help watch -o data/result.db",
+  "          tt-help watch -o data/result.db -p 8080",
+  "",
+  "  tt-help open <端口号>",
+  "    打开指定端口的浏览器，用于配置 TikTok 登录账户",
+  "    端口范围: 9222 - 9231（对应 explore 的 10 个内置账户）",
+  "    --list                  列出所有端口和配置",
+  "    示例: tt-help open 9222",
+  "          tt-help open --list",
+  "",
+  "  videostats  <db路径> -p <并发数>",
+  "    批量刷新视频统计数据（playCount, diggCount, commentCount, shareCount, collectCount）",
+  "    直接读取并更新 SQLite videos 表",
+  "    -p, --parallel <N>       并发数（默认: 3）",
+  "    示例: tt-help videostats data/result.db -p 3",
+  "",
+  "  db-import  --db <db路径> [--users users.json] [--done done.json] [--videos videos.json]",
+  "    将 legacy JSON 显式导入 SQLite；运行期不再自动读取 result*.json",
+  "    示例: tt-help db-import --db data/result.db --users data/result.json --done data/result-done.json --videos data/result-videos.json",
+  "",
+  "  webserver [选项]",
+  "    启动 HTTP 服务，对外提供 TikTok 数据抓取 API",
+  "    选项:",
+  "      -p, --port <端口号>    监听端口，默认 3000",
+  "    API:",
+  "      POST /api/tiktok/user   获取用户信息 { uniqueId: string }",
+  "      POST /api/tiktok/video  获取视频信息 { videoUrl: string }",
+  "      POST /api/tiktok/lookup 同时获取视频和作者信息 { videoUrl: string }",
+  "    示例: tt-help webserver -p 3000",
+  "",
+  "  config  [show|set|reset]",
+  "    config                    查看当前配置",
+  "    config set <key> <value>  设置配置（key: proxy, server, browser, userId, maxFollowing, maxFollowers, maxVideos, maxComments）",
+  "    config reset              重置所有配置为默认",
+  "",
+  "  全局选项:",
+  "    -h, --help                显示帮助",
+  "    --version                 显示版本号",
+  "",
+  "  示例: tt-help info https://www.tiktok.com/@nike https://www.tiktok.com/@adidas",
+  "        tt-help explore qiqi23280 fast --location ES --max-comments 50",
+  "        tt-help config set server http://127.0.0.1:3001",
+  "        tt-help attach -p 5 -i 10",
+  "        tt-help watch -o data/result.db",
+  "        tt-help videostats data/result.db -p 3",
+];
+
+const PUBLIC_HELP_HIDDEN_HEADERS = new Set([
+  "  tt-help watch -o <db路径> [-p 端口]",
+  "  videostats  <db路径> -p <并发数>",
+  "  db-import  --db <db路径> [--users users.json] [--done done.json] [--videos videos.json]",
+]);
+
+const PUBLIC_HELP_HIDDEN_LINES = new Set([
+  "        tt-help watch -o data/result.db",
+  "        tt-help videostats data/result.db -p 3",
+]);
+
+function removeHelpSections(lines, hiddenHeaders, hiddenLines = new Set()) {
+  const result = [];
+  let skipping = false;
+
+  for (const line of lines) {
+    if (hiddenHeaders.has(line)) {
+      skipping = true;
+      continue;
+    }
+
+    if (skipping) {
+      if (line === "") {
+        skipping = false;
+      }
+      continue;
+    }
+
+    if (hiddenLines.has(line)) {
+      continue;
+    }
+
+    result.push(line);
+  }
+
+  return result;
+}
+
+const PUBLIC_HELP_TEXT = removeHelpSections(
+  HELP_TEXT,
+  PUBLIC_HELP_HIDDEN_HEADERS,
+  PUBLIC_HELP_HIDDEN_LINES,
+);
+
+function getConfigText() {
+  let currentUserId = userId;
+  if (!currentUserId && existsSync(configPath)) {
+    try {
+      const cfg = JSON.parse(readFileSync(configPath, "utf-8"));
+      if (cfg.userId) currentUserId = cfg.userId;
+    } catch {}
+  }
+  return [
+    "tt-help v1.0.1",
+    "",
+    "配置:",
+    `  代理: ${proxy}`,
+    `  服务端: ${server}`,
+    `  浏览器: ${browser || "未配置（将自动探测或回退）"}`,
+    `  用户号: ${currentUserId || "未设置（首次运行 auto 自动创建）"}`,
+    `  商家关注采集数: ${maxFollowing}`,
+    `  粉丝采集数: ${maxFollowers}`,
+    `  视频采集数: ${maxVideos}`,
+    `  评论采集数: ${maxComments}`,
+    `  输出格式: json`,
+    `  默认输出: ${DEFAULT_OUTPUT}`,
+    `  配置文件: ${configFile || "无（使用默认值）"}`,
+  ];
+}
+
+export {
+  proxy,
+  server,
+  configPath,
+  DEFAULT_PROXY,
+  HELP_TEXT,
+  PUBLIC_HELP_TEXT,
+  browser,
+  userId,
+  maxFollowing,
+  maxFollowers,
+  maxVideos,
+  maxComments,
+  saveBrowser,
+  saveUserId,
+  saveMaxFollowing,
+  saveMaxFollowers,
+  saveMaxVideos,
+  saveMaxComments,
+  getConfigText,
+};