tt-help-cli-ycl 1.0.7 → 1.1.0

package/src/lib/auto-browser.mjs

@@ -1,11 +1,13 @@
-import { createRequire } from 'module';
-
-const require = createRequire(import.meta.url);
-const core = require('../auto-core.cjs');
-const helpers = require('../scraper/modules/page-helpers.cjs');
-
-export const runAuto = core.runAuto;
-export const processUser = core.processUser;
-export const ensureBrowserReady = helpers.ensureBrowserReady;
-export const ensureTikTokPage = helpers.ensureTikTokPage;
+import { createRequire } from 'module';
+
+const require = createRequire(import.meta.url);
+const core = require('../auto-core.cjs');
+const exploreCore = require('../explore-core.cjs');
+const helpers = require('../scraper/modules/page-helpers.cjs');
+
+export const runAuto = core.runAuto;
+export const processUser = core.processUser;
+export const processExplore = exploreCore.processExplore;
+export const ensureBrowserReady = helpers.ensureBrowserReady;
+export const ensureTikTokPage = helpers.ensureTikTokPage;
 export const closeCommentPanel = helpers.closeCommentPanel;

package/src/lib/constants.js

@@ -1,148 +1,151 @@
-import { join, dirname } from 'path';
-import { readFileSync, writeFileSync, existsSync } from 'fs';
-import { fileURLToPath } from 'url';
-
-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';
-const USER_SECTION_SIZE = 12000;
-
-let proxy = DEFAULT_PROXY;
-let configFile = null;
-let browser = null;
-
-try {
-  if (existsSync(configPath)) {
-    const cfg = JSON.parse(readFileSync(configPath, 'utf-8'));
-    if (cfg.proxy) {
-      proxy = cfg.proxy;
-    }
-    if (cfg.browser) {
-      browser = cfg.browser;
-    }
-    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;
-}
-
-const HELP_TEXT = [
-  '用法: tt-help [选项]',
-  '       tt-help scrape <URL> [预设] [选项]',
-  '       tt-help videos <用户名> [最大视频数] [选项]',
-  '       tt-help auto <用户名> [preset] [收集数] [切换数] [每视频评论数] [选项]',
-  '',
-  '参数:',
-  '  --explore [count]      从 Explore 页面获取视频列表（默认: 100）',
-  '  --pipe                 将 Explore 结果自动传给 URL 爬取',
-  '  --proxy <地址>          临时指定代理地址',
-  '  --filter <条件>         过滤结果（格式: key=value&key2=value2）',
-  '  -i, --input <file>     从文件读取 URL 列表（每行一个）',
-  '  -o, --output <file>    指定输出文件（默认: tiktok_data.json）',
-  '  -f, --format <fmt>     输出格式: json（默认）, table, raw',
-  '  -c, --config           显示当前配置',
-  '  -h, --help             显示帮助',
-  '',
-  '浏览器抓取模式 (scrape):',
-  '  tt-help scrape <URL> [preset] [最大视频数] [最大评论数] [-o 输出路径]',
-  '  tt-help scrape <URL> [最大视频数] [最大评论数] [--switch-delay ms] [--comment-delay ms]',
-  '  预设: fast(600ms/400ms), normal(1.5s/800ms), slow(3s/2s), stealth(5s/3.5s)',
-  '  不指定 -o 则输出到 stdout（可 pipe）',
-  '',
-  '用户视频模式 (videos):',
-  '  tt-help videos <用户名> [最大视频数] [-o 输出路径]',
-  '  获取用户信息和视频列表（浏览器模式）',
-  '  不指定 -o 则输出到 stdout（可 pipe）',
-  '',
-  '自动探索模式 (auto):',
-  '  tt-help auto [用户名...] [preset] [收集数] [切换数] [每视频评论数] [选项]',
-  '  支持多个用户名: tt-help auto @user1 @user2 -o data.json',
-  '  不指定用户名: 从 -o 数据源中读取未处理的用户继续探索',
-  '  收集数: 从种子用户收集的种子视频数（默认 1）',
-  '  切换数: 每个种子作者主页下切换视频的次数（默认 50）',
-  '  每视频评论数: 每个视频抓取评论数（默认 200）',
-  '  预设: fast（默认）, normal, slow, stealth',
-  '  选项: -o <路径>             数据源文件（不指定则输出到 stdout）',
-  '        --switch-delay <ms>   视频切换延迟（毫秒）',
-  '        --comment-delay <ms>  评论滚动延迟（毫秒）',
-  '        --watch [-p 3000]     启动 Web 监控页面实时查看数据',
-  '  返回: 纯用户数组，按 uniqueId 去重',
-  '  示例: tt-help auto username -o result.json',
-  '        tt-help auto @a @b fast 1 30 100 -o data.json',
-  '        tt-help auto -o data.json                  # 续跑',
-  '        tt-help auto username --watch -o data.json  # 带监控页面',
-  '',
-  '实时监控模式 (watch):',
-  '  tt-help watch -o <数据文件> [-p 端口]',
-  '  启动 Web 监控页面，实时查看采集数据',
-  '  支持在 auto 模式中通过 --watch 参数同时启动',
-  '  示例: tt-help watch -o data.json',
-  '        tt-help watch -o data.json -p 8080',
-  '',
-  '过滤示例:',
-  '  --filter "ttSeller=true&verified=false"           过滤卖家且未认证',
-  '  --filter "locationCreated=DE,ES"                  过滤指定地区',
-  '  --filter "ttSeller=true&locationCreated=US"       组合条件',
-  '',
-  '配置代理:',
-  '  tt-help config set http://127.0.0.1:7890  设置代理',
-  '  tt-help config show                        查看配置',
-  '  tt-help config reset                       恢复默认',
-  '',
-  '配置浏览器:',
-  '  tt-help config set-browser /path/to/chrome  手动指定浏览器路径',
-  '  tt-help config set-browser auto             自动探测浏览器',
-  '',
-  '示例:',
-  '  tt-help --explore 200                    # 先预览 Explore 结果',
-  '  tt-help --explore 50 --pipe -o result.json  # 自动抓取用户数据',
-  '  tt-help --explore -f raw                 # 仅输出 URL 列表',
-  '  tt-help --explore -f raw -o urls.txt     # 保存 URL 到文件',
-  '  tt-help -i urls.txt -o result.json       # 再爬取这些 URL',
-  '  tt-help scrape <URL> fast 50 999        # 浏览器抓取（快速预设）',
-  '  tt-help scrape <URL> slow -o out.json    # 慢速预设，输出到文件',
-  '  tt-help scrape <URL> 20 999 | jq .       # 输出到 stdout 可 pipe',
-  '  tt-help videos username 100              # 获取用户 100 个视频',
-  '  tt-help videos username 50 -o out.json   # 输出到文件',
-  '  tt-help auto username -o out.json  # 自动探索（默认 fast/1/50/200）',
-  '  tt-help auto username slow 1 30 100 -o out.json  # 慢速探索',
-  '  tt-help config set http://127.0.0.1:7890',
-  '  tt-help https://www.tiktok.com/@username',
-  '  tt-help https://... --filter "ttSeller=true&locationCreated=DE"',
-];
-
-const CONFIG_TEXT = [
-  'tt-help v1.0.1',
-  '',
-  '配置:',
-  `  代理: ${proxy}`,
-  `  浏览器: ${browser || '未配置（将自动探测或回退）'}`,
-  `  输出格式: json`,
-  `  默认输出: ${DEFAULT_OUTPUT}`,
-  `  配置文件: ${configFile || '无（使用默认值）'}`,
-];
-
-export {
-  proxy,
-  configFile,
-  configPath,
-  DEFAULT_PROXY,
-  DEFAULT_OUTPUT,
-  USER_SECTION_SIZE,
-  HELP_TEXT,
-  CONFIG_TEXT,
-  browser,
-  saveBrowser,
-};
+import { join, dirname } from 'path';
+import { readFileSync, writeFileSync, existsSync } from 'fs';
+import { fileURLToPath } from 'url';
+
+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';
+const USER_SECTION_SIZE = 12000;
+
+let proxy = DEFAULT_PROXY;
+let configFile = null;
+let browser = null;
+
+try {
+  if (existsSync(configPath)) {
+    const cfg = JSON.parse(readFileSync(configPath, 'utf-8'));
+    if (cfg.proxy) {
+      proxy = cfg.proxy;
+    }
+    if (cfg.browser) {
+      browser = cfg.browser;
+    }
+    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;
+}
+
+const HELP_TEXT = [
+  '用法: tt-help [选项]',
+  '       tt-help scrape <URL> [预设] [选项]',
+  '       tt-help videos <用户名> [最大视频数] [选项]',
+  '       tt-help auto <用户名> [preset] [收集数] [切换数] [每视频评论数] [选项]',
+  '',
+  '参数:',
+  '  --explore [count]      从 Explore 页面获取视频列表（默认: 100）',
+  '  --pipe                 将 Explore 结果自动传给 URL 爬取',
+  '  --proxy <地址>          临时指定代理地址',
+  '  --filter <条件>         过滤结果（格式: key=value&key2=value2）',
+  '  -i, --input <file>     从文件读取 URL 列表（每行一个）',
+  '  -o, --output <file>    指定输出文件（默认: tiktok_data.json）',
+  '  -f, --format <fmt>     输出格式: json（默认）, table, raw',
+  '  -c, --config           显示当前配置',
+  '  -h, --help             显示帮助',
+  '',
+  '浏览器抓取模式 (scrape):',
+  '  tt-help scrape <URL> [preset] [最大视频数] [最大评论数] [-o 输出路径]',
+  '  tt-help scrape <URL> [最大视频数] [最大评论数] [--switch-delay ms] [--comment-delay ms]',
+  '  预设: fast(600ms/400ms), normal(1.5s/800ms), slow(3s/2s), stealth(5s/3.5s)',
+  '  不指定 -o 则输出到 stdout（可 pipe）',
+  '',
+  '用户视频模式 (videos):',
+  '  tt-help videos <用户名> [最大视频数] [-o 输出路径]',
+  '  获取用户信息和视频列表（浏览器模式）',
+  '  不指定 -o 则输出到 stdout（可 pipe）',
+  '',
+  '自动探索模式 (auto):',
+  '  tt-help auto [用户名...] [preset] [收集数] [切换数] [每视频评论数] [选项]',
+  '  支持多个用户名: tt-help auto @user1 @user2 -o data.json',
+  '  不指定用户名: 从 -o 数据源中读取未处理的用户继续探索',
+  '  收集数: 从种子用户收集的种子视频数（默认 1）',
+  '  切换数: 每个种子作者主页下切换视频的次数（默认 50）',
+  '  每视频评论数: 每个视频抓取评论数（默认 200）',
+  '  预设: fast（默认）, normal, slow, stealth',
+  '  选项: -o <路径>             数据源文件（不指定则输出到 stdout）',
+  '        --switch-delay <ms>   视频切换延迟（毫秒）',
+  '        --comment-delay <ms>  评论滚动延迟（毫秒）',
+  '        --watch [-p 3000]     启动 Web 监控页面实时查看数据',
+  '        --enable-follow       启用关注/粉丝列表提取（需已登录）',
+  '        --max-following <n>   关注列表最大提取数（默认 200）',
+  '        --max-followers <n>   粉丝列表最大提取数（默认 200）',
+  '  返回: 纯用户数组，按 uniqueId 去重',
+  '  示例: tt-help auto username -o result.json',
+  '        tt-help auto @a @b fast 1 30 100 -o data.json',
+  '        tt-help auto -o data.json                  # 续跑',
+  '        tt-help auto username --watch -o data.json  # 带监控页面',
+  '',
+  '实时监控模式 (watch):',
+  '  tt-help watch -o <数据文件> [-p 端口]',
+  '  启动 Web 监控页面，实时查看采集数据',
+  '  支持在 auto 模式中通过 --watch 参数同时启动',
+  '  示例: tt-help watch -o data.json',
+  '        tt-help watch -o data.json -p 8080',
+  '',
+  '过滤示例:',
+  '  --filter "ttSeller=true&verified=false"           过滤卖家且未认证',
+  '  --filter "locationCreated=DE,ES"                  过滤指定地区',
+  '  --filter "ttSeller=true&locationCreated=US"       组合条件',
+  '',
+  '配置代理:',
+  '  tt-help config set http://127.0.0.1:7890  设置代理',
+  '  tt-help config show                        查看配置',
+  '  tt-help config reset                       恢复默认',
+  '',
+  '配置浏览器:',
+  '  tt-help config set-browser /path/to/chrome  手动指定浏览器路径',
+  '  tt-help config set-browser auto             自动探测浏览器',
+  '',
+  '示例:',
+  '  tt-help --explore 200                    # 先预览 Explore 结果',
+  '  tt-help --explore 50 --pipe -o result.json  # 自动抓取用户数据',
+  '  tt-help --explore -f raw                 # 仅输出 URL 列表',
+  '  tt-help --explore -f raw -o urls.txt     # 保存 URL 到文件',
+  '  tt-help -i urls.txt -o result.json       # 再爬取这些 URL',
+  '  tt-help scrape <URL> fast 50 999        # 浏览器抓取（快速预设）',
+  '  tt-help scrape <URL> slow -o out.json    # 慢速预设，输出到文件',
+  '  tt-help scrape <URL> 20 999 | jq .       # 输出到 stdout 可 pipe',
+  '  tt-help videos username 100              # 获取用户 100 个视频',
+  '  tt-help videos username 50 -o out.json   # 输出到文件',
+  '  tt-help auto username -o out.json  # 自动探索（默认 fast/1/50/200）',
+  '  tt-help auto username slow 1 30 100 -o out.json  # 慢速探索',
+  '  tt-help config set http://127.0.0.1:7890',
+  '  tt-help https://www.tiktok.com/@username',
+  '  tt-help https://... --filter "ttSeller=true&locationCreated=DE"',
+];
+
+const CONFIG_TEXT = [
+  'tt-help v1.0.1',
+  '',
+  '配置:',
+  `  代理: ${proxy}`,
+  `  浏览器: ${browser || '未配置（将自动探测或回退）'}`,
+  `  输出格式: json`,
+  `  默认输出: ${DEFAULT_OUTPUT}`,
+  `  配置文件: ${configFile || '无（使用默认值）'}`,
+];
+
+export {
+  proxy,
+  configFile,
+  configPath,
+  DEFAULT_PROXY,
+  DEFAULT_OUTPUT,
+  USER_SECTION_SIZE,
+  HELP_TEXT,
+  CONFIG_TEXT,
+  browser,
+  saveBrowser,
+};