@web-auto/webauto 0.1.1 → 0.1.3

package/apps/desktop-console/src/renderer/tabs/xiaohongshu.test.mts

@@ -1,291 +0,0 @@
-import { readFile } from 'node:fs/promises';
-import path from 'node:path';
-import { test } from 'node:test';
-import assert from 'node:assert/strict';
-import { fileURLToPath } from 'node:url';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const entryPath = path.join(__dirname, 'xiaohongshu.mts');
-const helperPath = path.join(__dirname, 'xiaohongshu', 'helpers.mts');
-const layoutPath = path.join(__dirname, 'xiaohongshu', 'layout-block.mts');
-const accountPath = path.join(__dirname, 'xiaohongshu', 'account-flow.mts');
-const runPath = path.join(__dirname, 'xiaohongshu', 'run-flow.mts');
-const livePath = path.join(__dirname, 'xiaohongshu', 'live-stats.mts');
-const guidePath = path.join(__dirname, 'xiaohongshu', 'guide-browser-check.mts');
-
-async function readText(filePath: string) {
-  return readFile(filePath, 'utf8');
-}
-
-async function readAll() {
-  const [entry, helper, layout, account, run, live, guide] = await Promise.all([
-    readText(entryPath),
-    readText(helperPath),
-    readText(layoutPath),
-    readText(accountPath),
-    readText(runPath),
-    readText(livePath),
-    readText(guidePath),
-  ]);
-  return { entry, helper, layout, account, run, live, guide, all: [entry, helper, layout, account, run, live, guide].join('\n') };
-}
-
-test('xiaohongshu tab keeps orchestrate modes and run script wiring after modular split', async () => {
-  const { entry, run, layout } = await readAll();
-  assert.match(entry, /buildXhsLayout/);
-  assert.match(entry, /createRunFlowController/);
-  assert.match(entry, /xhs-tile--\$\{id\}/);
-  assert.match(layout, /phase1-phase2-unified/);
-  assert.match(layout, /phase1-phase2/);
-  assert.match(layout, /phase1-only/);
-  assert.match(layout, /unified-only/);
-  assert.match(run, /xhs-orchestrate\.mjs/);
-});
-
-test('xiaohongshu layout uses bento grid cards for account and operation areas', async () => {
-  const { layout, entry } = await readAll();
-  assert.match(layout, /xhs-bento-grid/);
-  assert.match(layout, /accountBento/);
-  assert.match(layout, /commentBento/);
-  assert.match(layout, /collectBento/);
-  assert.match(layout, /\[boardTile\.tile, likeTile\.tile, runTile\.tile, accountTile\.tile, commentTile\.tile, collectTile\.tile\]/);
-  assert.match(entry, /xhs-guide-grid/);
-  assert.match(entry, /xhs-guide-step/);
-});
-
-test('xiaohongshu layout includes shard stats board section', async () => {
-  const { layout } = await readAll();
-  assert.match(layout, /分片进度（合并 \+ 明细）/);
-  assert.match(layout, /const shardStatsList = createEl\('div'/);
-});
-
-test('xiaohongshu module files are split and each stays under maintainable line caps', async () => {
-  const files = [entryPath, helperPath, layoutPath, accountPath, runPath, livePath, guidePath];
-  const lengths = await Promise.all(files.map(async (p) => String((await readText(p)).split(/\r?\n/g).length)));
-  files.forEach((file, i) => {
-    const lines = Number(lengths[i]);
-    assert.ok(lines <= 800, `${path.basename(file)} has ${lines} lines`);
-  });
-});
-
-test('xiaohongshu layout imports stringifyLikeRule helper used by rule chips', async () => {
-  const { layout } = await readAll();
-  assert.match(layout, /stringifyLikeRule/);
-  assert.match(layout, /from '\.\/helpers\.mjs'/);
-});
-
-test('xiaohongshu keeps homepage toggle wiring between layout and tab orchestration', async () => {
-  const { entry, layout } = await readAll();
-  assert.match(layout, /homepageToggle/);
-  assert.match(layout, /imagesToggle/);
-  assert.match(entry, /homepageToggle/);
-  assert.match(entry, /imagesToggle/);
-});
-
-test('xiaohongshu keeps preferred profile selectors and shard args', async () => {
-  const { entry, run, layout } = await readAll();
-  assert.match(layout, /const profilePickSel = createEl\('select'/);
-  assert.match(layout, /const shardProfilesBox = createEl\('div'/);
-  assert.match(entry, /getSelectedShardProfiles/);
-  assert.match(entry, /void refreshProfileChoices\(\);/);
-  assert.match(run, /profileArgs\.push\('--profiles', shardProfiles\.join\(','\)\)/);
-  assert.match(run, /profileArgs\.push\('--profile', singleProfile\)/);
-});
-
-test('xiaohongshu history helper supports autocomplete and hotkey delete', async () => {
-  const { helper, run } = await readAll();
-  assert.match(helper, /INPUT_HISTORY_MAX = 10/);
-  assert.match(helper, /bindInputHistory\(input: HTMLInputElement, key: string/);
-  assert.match(helper, /input\.setAttribute\('list', safeId\)/);
-  assert.match(helper, /evt\.ctrlKey && evt\.shiftKey && evt\.key === 'Backspace'/);
-  assert.match(run, /persistHistoryFns\.forEach\(\(persist\) => persist\(\)\)/);
-});
-
-test('xiaohongshu persists and restores last config via helper storage', async () => {
-  const { helper, entry } = await readAll();
-  assert.match(helper, /XHS_LAST_CONFIG_KEY = 'webauto\.xhs\.lastConfig\.v1'/);
-  assert.match(entry, /const persistedConfig = readLastConfig\(\);/);
-  assert.match(entry, /writeLastConfig\(\{/);
-  assert.match(entry, /bindLikeRulePersistence\(\{/);
-});
-
-test('xiaohongshu add-account flow creates profile then starts login-profile run', async () => {
-  const { account } = await readAll();
-  assert.match(account, /apps', 'webauto', 'entry', 'profilepool\.mjs'/);
-  assert.match(account, /'add', kw, '--json'/);
-  assert.match(account, /'login-profile'/);
-  assert.match(account, /cmdRunJson/);
-  assert.match(account, /cmdSpawn/);
-  assert.match(account, /await refreshProfileChoices\(targetProfile\)/);
-});
-
-test('xiaohongshu account flow uses one fixed profile naming prefix', async () => {
-  const { account } = await readAll();
-  assert.match(account, /export function extractBatchBase\(_profileId: string\): string/);
-  assert.match(account, /export function inferDefaultBatchBase\(_currentProfileId: string, _latestProfiles: string\[\]\): string/);
-  assert.match(account, /const resolveAddBatchPrefix = \(\): string => \{\s*return XHS_DEFAULT_BATCH_KEY;/);
-  assert.match(account, /setNavHint\(`Account IDs use fixed pattern: \$\{XHS_DEFAULT_BATCH_KEY\}-N`\);/);
-});
-
-test('xiaohongshu account flow auto-selects single profile in shard list', async () => {
-  const { account } = await readAll();
-  assert.match(account, /profiles\.length === 1 && prevSelected\.size === 0/);
-});
-
-test('xiaohongshu account flow deduplicates profile ids before render and audit', async () => {
-  const { account } = await readAll();
-  assert.match(account, /const uniqueProfileIds = \(items: string\[\]\) => \{/);
-  assert.match(account, /const isNewFormatProfileId = \(id: string\) => \/\.\+-batch-\\d\+\$\/\.test/);
-  assert.match(account, /let refreshSeq = 0;/);
-  assert.match(account, /const seq = \+\+refreshSeq;/);
-  assert.match(account, /if \(seq !== refreshSeq\) return;/);
-  assert.match(account, /const profiles: string\[\] = uniqueProfileIds\(entries\.map/);
-  assert.match(account, /filter\(isNewFormatProfileId\)/);
-  assert.match(account, /const uniqueProfiles = uniqueProfileIds\(profiles\);/);
-});
-
-test('xiaohongshu consumes preflight navigation target and checks browser with runJson when available', async () => {
-  const { entry, guide } = await readAll();
-  assert.match(entry, /consumeNavTarget/);
-  assert.match(entry, /runGuideBrowserCheck/);
-  assert.match(guide, /XHS_NAV_TARGET_KEY/);
-  assert.match(guide, /'--check-browser-only'/);
-  assert.match(guide, /cmdRunJson/);
-});
-
-test('xiaohongshu account check uses browser-status probe without confirm dialog', async () => {
-  const { entry } = await readAll();
-  assert.match(entry, /browser-status\.mjs/);
-  assert.match(entry, /const runBrowserStatusCheck = async/);
-  assert.doesNotMatch(entry, /window\.confirm/);
-});
-
-test('xiaohongshu live stats combines cmd-event and state-update streams', async () => {
-  const { live } = await readAll();
-  assert.match(live, /state\+cmd-event/);
-  assert.doesNotMatch(live, /fsReadTextTail/);
-  assert.match(live, /const activeRunIds = new Set<string>\(\);/);
-  assert.match(live, /window\.api\?\.onStateUpdate/);
-  assert.match(live, /noteProgressMatch/);
-});
-
-test('xiaohongshu run flow forwards ocr command and gate/reply guard', async () => {
-  const { run, entry } = await readAll();
-  assert.match(run, /if \(unifiedEnabled && replyToggle\.checked && !gateToggle\.checked\)/);
-  assert.match(run, /jumpToAccountSetup\(\)/);
-  assert.match(run, /jumpToKeywordSetup\(\)/);
-  assert.match(run, /--no-dry-run/);
-  assert.match(run, /\[ui-run-flags\] dryRun=\$\{dryRunCheckbox\.checked\} doLikes=\$\{likesToggle\.checked\}/);
-  assert.match(run, /--do-ocr/);
-  assert.match(run, /--ocr-command/);
-  assert.match(run, /--match-keywords/);
-  assert.match(entry, /focusAccountSetup/);
-  assert.match(entry, /focusKeywordSetup/);
-});
-
-
-test('xiaohongshu run flow keeps logs shortcut in action row', async () => {
-  const { run } = await readAll();
-  assert.match(run, /const logsBtn = createEl\('button', \{ type: 'button', className: 'secondary' \}, \['日志'\]\)/);
-  assert.match(run, /api\.setActiveTab\('logs'\)/);
-  assert.match(run, /setExpectedLinksTarget\(/);
-});
-
-test('xiaohongshu live stats parser accepts rotated events files and phase2 progress lines', async () => {
-  const { live } = await readAll();
-  assert.match(live, /setExpectedLinksTarget: \(target: number\) => void/);
-  assert.ok(live.includes('run-events(?:'));
-  assert.ok(live.includes('Phase2Collect(?:Links)?'));
-  assert.ok(live.includes('liveStats.linksTarget = Math.max(liveStats.linksTarget, target);'));
-  assert.ok(live.includes('Like Gate:'));
-  assert.ok(live.includes("const readToken = (key: string) =>"));
-  assert.ok(live.includes("const ruleHits = readToken('ruleHits');"));
-  assert.ok(live.includes("const dedupSkipped = readToken('dedup');"));
-  assert.ok(live.includes("const alreadyLikedSkipped = readToken('alreadyLiked');"));
-  assert.ok(live.includes("const newLikes = readToken('newLikes');"));
-  assert.ok(live.includes("const likedTotalMatch = text.match(/likedTotal=(\\d+)\\s*\\/\\s*(\\d+)/i);"));
-});
-
-test('xiaohongshu live stats surfaces phase2 block and fatal reasons on board', async () => {
-  const { live } = await readAll();
-  assert.match(live, /Rigid gate blocked click index=/);
-  assert.match(live, /阻断原因：/);
-  assert.match(live, /Post-click gate FAILED/);
-  assert.match(live, /Click strategy failed:/);
-  assert.match(live, /Click strategy no-open:/);
-  assert.match(live, /Phase\\s\*2\\s\*失败/);
-});
-
-test('xiaohongshu layout and live stats include like-skip metrics', async () => {
-  const { layout, entry, live } = await readAll();
-  assert.match(layout, /点赞跳过：0/);
-  assert.match(layout, /likesSkipStat/);
-  assert.match(entry, /likesSkipStat/);
-  assert.match(live, /点赞跳过：\$\{merged\.likesSkippedTotal\}/);
-  assert.match(live, /跳过明细：去重/);
-});
-
-test('xiaohongshu guide account step always brings account tile into view before checks', async () => {
-  const { entry } = await readAll();
-  assert.match(entry, /accountStep\.onclick = \(\) => \{ focusTile\('account'\); void runInteractiveAccountCheck\(\); \};/);
-});
-
-
-test('xiaohongshu browser guide checks browser only once at startup', async () => {
-  const { entry } = await readAll();
-  assert.match(entry, /let startupBrowserChecked = false;/);
-  assert.match(entry, /let startupBrowserCheckDone = false;/);
-  assert.match(entry, /let browserCheckAttempted = false;/);
-  assert.match(entry, /if \(startupBrowserChecked\) return void finalizeGuide\(\);/);
-  assert.match(entry, /if \(browserCheckAttempted \|\| startupBrowserCheckDone \|\| guideState\.browserReady\) return;/);
-  assert.match(entry, /startupBrowserCheckDone = true;/);
-  assert.match(entry, /startupBrowserChecked = true;/);
-});
-
-test('xiaohongshu guide does not hard-block run button when not ready', async () => {
-  const { entry } = await readAll();
-  assert.match(entry, /guideCard\.style\.display = allReady \? 'none' : '';/);
-  assert.match(entry, /startRunBtn\.textContent = '仍然开始运行';/);
-  assert.match(entry, /if \(!runBtn\.disabled\) \{\s*runBtn\.title = allReady \? '' : '引导未完成，仍可直接运行';/);
-});
-
-test('xiaohongshu run flow only consumes stdout/stderr from current run id', async () => {
-  const { run } = await readAll();
-  assert.match(run, /if \(!localRunId\) return;/);
-  assert.match(run, /if \(evtRunId && evtRunId !== localRunId\) return;/);
-});
-
-test('xiaohongshu run flow resets board before binding run id and keeps live-stats subscription after exit', async () => {
-  const { run } = await readAll();
-  assert.match(run, /liveStats\.resetLiveStats\(\);\s*liveStats\.setActiveRunId\(localRunId\);/);
-  assert.match(run, /if \(runMode !== 'phase1-only' && Number\.isFinite\(targetNum\) && targetNum > 0\) \{\s*liveStats\.setExpectedLinksTarget\(targetNum\);/);
-  assert.match(run, /if \(eventType === 'exit'\) \{\s*const exitedRunId = localRunId;/);
-  assert.match(run, /liveStats\.parseStdoutForEvents\(\s*`\[rid:\$\{evtRunId \|\| localRunId\}\] \[exit\] code=\$\{evt\?\.exitCode \?\? 'null'\} signal=\$\{evt\?\.signal \?\? 'null'\}`,/);
-  assert.match(run, /void recoverRunFromStateTasks\(\)\.then\(\(restored\) => \{\s*if \(!restored \|\| restored === exitedRunId\) setRunningUi\(false\);/);
-  assert.doesNotMatch(run, /if \(eventType === 'exit'\) \{\s*liveStats\.dispose\(\);/);
-});
-
-test('xiaohongshu run flow restores running runId after tab re-entry and updates run button label', async () => {
-  const { run } = await readAll();
-  assert.match(run, /const resolveRunningXhsRunId = \(\) => \{/);
-  assert.match(run, /const restoredRunId = resolveRunningXhsRunId\(\);/);
-  assert.match(run, /runBtn\.textContent = running \? '编排运行中\.\.\.' : '开始执行编排';/);
-  assert.match(run, /runBtn\.disabled = running/);
-});
-
-test('xiaohongshu live stats accepts prefixed rid and allows progress\/stats updates from related run ids', async () => {
-  const { live } = await readAll();
-  assert.match(live, /const prefixedRid = rawText\.match\(\/\^\\\[rid:/);
-  assert.match(live, /运行账号 \$\{shardItems\.length\} · 运行中 \$\{runningCount\} · 异常 \$\{errorCount\}/);
-  assert.match(live, /阶段 \$\{item\.phase \|\| '未知'\} · 状态 \$\{statusLabel\(item\)\} · 动作 \$\{item\.action \|\| '等待日志'\}/);
-  assert.match(live, /异常：\$\{item\.anomaly\}/);
-  assert.match(live, /const looksProgress =/);
-  assert.match(live, /const looksStats =/);
-  assert.match(live, /if \(activeRunIds\.size > 0 && !activeRunIds\.has\(rid\) && !\(looksProgress \|\| looksStats\)\) return;/);
-  assert.match(live, /const t = String\(update\?\.type \|\| ''\)\.trim\(\);/);
-  assert.match(live, /if \(t === 'progress'\) \{\s*applyStatePatch\(\{ progress: patch \}, rid\);/);
-  assert.match(live, /else if \(t === 'stats'\) \{\s*applyStatePatch\(\{ stats: patch \}, rid\);/);
-  assert.match(live, /const shardStats = new Map<string, ShardProgress>\(\);/);
-  assert.match(live, /const renderShardStats = \(\) => \{/);
-  assert.match(live, /setShardProfiles: \(profiles: string\[\]\) => void/);
-});

package/apps/desktop-console/src/renderer/ui-components.mts

@@ -1,31 +0,0 @@
-export function createEl<K extends keyof HTMLElementTagNameMap>(
-  tag: K,
-  props: Partial<HTMLElementTagNameMap[K]> & Record<string, any> = {},
-  children: Array<HTMLElement | string> = [],
-): HTMLElementTagNameMap[K] {
-  const el = document.createElement(tag);
-  for (const [k, v] of Object.entries(props)) {
-    // @ts-ignore
-    el[k] = v;
-  }
-  for (const c of children) {
-    if (typeof c === 'string') el.appendChild(document.createTextNode(c));
-    else el.appendChild(c);
-  }
-  return el;
-}
-
-export function labeledInput(label: string, input: HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement) {
-  // Avoid forcing wide min-width so toolbars can fit on smaller windows.
-  const wrap = createEl('div', { style: 'display:flex; flex-direction:column; gap:6px; min-width:140px; max-width:260px;' });
-  wrap.appendChild(createEl('label', {}, [label]));
-  wrap.appendChild(input);
-  return wrap;
-}
-
-export function section(title: string, children: HTMLElement[]) {
-  const card = createEl('div', { className: 'card' });
-  card.appendChild(createEl('div', { style: 'font-weight:700; margin-bottom:10px;' }, [title]));
-  children.forEach((c) => card.appendChild(c));
-  return card;
-}

package/docs/README_camoufox_chinese.md

@@ -1,141 +0,0 @@
-# Camoufox 中文配置指南
-
-## 问题解决
-
-经过多次测试，发现 Camoufox 中文乱码问题的根源是配置过于复杂。正确的解决方案是使用最小化但有效的配置。
-
-## 核心配置
-
-**成功的配置只需要两个参数：**
-
-```python
-{
-    'locale': 'zh-CN',      # 设置浏览器语言环境
-    'args': ['--lang=zh-CN']  # 设置浏览器语言
-}
-```
-
-## 使用方法
-
-### 方式1：函数式（推荐）
-
-```python
-from camoufox_final_setup import launch_camoufox_chinese
-
-# 启动浏览器
-playwright, browser = launch_camoufox_chinese(headless=False)
-
-try:
-    page = browser.new_page()
-    page.goto('https://www.baidu.com')
-    print(page.title())  # 输出：百度一下，你就知道
-finally:
-    browser.close()
-    playwright.stop()
-```
-
-### 方式2：类式（自动管理资源）
-
-```python
-from camoufox_final_setup import CamoufoxChineseBrowser
-
-# 使用上下文管理器
-with CamoufoxChineseBrowser(headless=False) as browser:
-    page = browser.new_page()
-    page.goto('https://www.baidu.com')
-    print(page.title())
-```
-
-### 方式3：快速测试
-
-```python
-from camoufox_final_setup import CamoufoxChineseBrowser
-
-browser = CamoufoxChineseBrowser(headless=False)
-browser.start()
-try:
-    browser.quick_test('https://www.baidu.com', wait_time=3)
-finally:
-    browser.stop()
-```
-
-## 配置文件说明
-
-- `camoufox_final_setup.py` - **最终版本**，使用最小化有效配置
-- `camoufox_minimal_chinese.py` - 最小化配置测试版本
-- `camoufox_chinese_setup.py` - 早期版本（配置过于复杂）
-- `camoufox_browser.py` - 功能完整但配置复杂的版本
-
-## 关键发现
-
-1. **最小配置原则**：只需要 `locale='zh-CN'` 和 `args=['--lang=zh-CN']`
-2. **避免过度配置**：过多的参数可能导致冲突
-3. **系统字体支持**：macOS 系统自带中文字体支持良好
-4. **UTF-8 自动处理**：浏览器会自动处理 UTF-8 编码
-
-## 测试结果验证
-
-成功的测试输出：
-```
-页面标题: 百度一下，你就知道
-字符集: UTF-8, 语言: zh-CN
-```
-
-## 注意事项
-
-- 确保系统有中文字体支持（macOS 默认支持）
-- 避免添加不必要的参数
-- 使用 `with` 语句确保资源正确释放
-- 无头模式设置 `headless=True`
-
-## 故障排除
-
-如果仍有问题：
-1. 检查系统字体：`fc-list :lang=zh`
-2. 测试其他中文网站
-3. 确认使用的是 `camoufox_final_setup.py` 中的配置
-
-## 高级问题：中文变成「口口口」方框
-
-在部分版本的 Camoufox 中，浏览器会通过指纹系统动态修改字体列表（`update_fonts`），某些随机组合可能会 **去掉 CJK 字体**，导致页面编码是 UTF-8，标题也是中文，但页面上所有汉字渲染成「口口口」方框。
-
-### 现象特征
-
-- `document.characterSet == 'UTF-8'`
-- `page.title()` 输出正常中文
-- 页面绝大部分正文/链接文字显示为方框（尤其是百度首页）
-
-### WebAuto 中的解决方案
-
-在 `browser_interface.py` 中已经内置了专门的修复逻辑：
-
-- 启动时：
-  - 禁用 Camoufox 默认扩展下载与路径校验；
-  - Monkey patch `camoufox.utils.update_fonts`，**不再改动系统字体列表**，避免指纹算法把中文字体移除。
-- 页面级别：
-  - 在每次 `goto()` 后注入一段 CSS，强制使用常见中文字体栈：
-
-    ```python
-    html, body, * {
-        font-family: "PingFang SC", "Microsoft YaHei", "SimHei",
-                     system-ui, -apple-system, BlinkMacSystemFont,
-                     sans-serif !important;
-    }
-    ```
-
-只要通过统一入口使用浏览器，即可自动避开字体指纹带来的中文方框问题：
-
-```python
-from browser_interface import create_browser
-
-with create_browser({'headless': False}) as browser:
-    page = browser.new_page()
-    page.goto('https://www.baidu.com')
-    print(page.title())
-```
-
-### 使用建议
-
-- **不要** 在业务代码里直接调用 `camoufox.launch_options` / `update_fonts` / `custom_fonts_only` 等底层 API。
-- 始终通过 `browser_interface.create_browser` 创建 Camoufox 实例，让字体与语言配置由统一入口托管。
-- 如遇到旧 profile 仍然出现方框，可尝试关闭所有 Camoufox 进程后使用全新 profile 再次启动。

package/docs/USAGE_V3.md

@@ -1,163 +0,0 @@
-# 小红书采集工具 v3 - 快速使用指南
-
-## 🚀 版本说明
-
-**v3.0.0** 是统一入口版本，整合了 Phase1、Phase2 和 Phase34 三个阶段，提供更简单的使用体验。
-
-## 📦 安装包结构
-
-```
-xiaohongshu-collector/
-├── bin/
-│   ├── xhs-cli              # Unix/Linux 入口
-│   └── xhs-cli.bat          # Windows 入口
-├── scripts/
-│   └── run-xiaohongshu-phase1-2-34-v3.mjs  # v3 核心脚本
-├── README.md
-├── install.sh               # Unix 安装脚本
-├── install.bat              # Windows 安装脚本
-└── package.json
-```
-
-## 🎯 快速开始
-
-### 1. 安装依赖
-
-```bash
-# macOS/Linux
-./install.sh
-
-# Windows
-install.bat
-```
-
-### 2. 使用 v3 统一入口（推荐）
-
-**一键完整运行：**
-```bash
-# macOS/Linux
-./bin/xhs-cli v3 --keyword "手机壳" --count 50 --env prod
-
-# Windows
-bin\xhs-cli.bat v3 --keyword "手机壳" --count 50 --env prod
-```
-
-**查看帮助：**
-```bash
-./bin/xhs-cli v3 --help
-```
-
-**查看版本：**
-```bash
-./bin/xhs-cli v3 --version
-```
-
-## 🔧 高级用法
-
-### 分阶段执行
-
-v3 支持灵活的阶段控制：
-
-**仅运行 Phase1（登录）：**
-```bash
-./bin/xhs-cli v3 --keyword "测试" --stopAfter phase1
-```
-
-**从 Phase34 开始（跳过搜索）：**
-```bash
-./bin/xhs-cli v3 --keyword "测试" --startAt phase34 --count 20
-```
-
-**只运行 Phase2（采集链接）：**
-```bash
-./bin/xhs-cli v3 --keyword "测试" --startAt phase2 --stopAfter phase2
-```
-
-### 完整参数列表
-
-| 参数 | 说明 | 默认值 |
-|------|------|--------|
-| `--keyword` | 搜索关键词（必填） | - |
-| `--count` | 目标采集数量 | 20 |
-| `--sessionId` | 会话ID | xiaohongshu_fresh |
-| `--startAt` | 起始阶段 (phase1/phase2/phase34) | phase1 |
-| `--stopAfter` | 结束阶段 (phase1/phase2/phase34) | phase34 |
-| `--linksCount` | Phase2 链接目标数 | max(count*2, count+30) |
-| `--env` | 运行环境 | debug |
-| `--version, -v` | 显示版本信息 | - |
-| `--help, -h` | 显示帮助信息 | - |
-
-## 📂 数据存储位置
-
-采集结果保存在：
-```
-~/.webauto/download/xiaohongshu/{env}/{keyword}/
-```
-
-例如：
-```
-~/.webauto/download/xiaohongshu/prod/手机壳/
-├── phase2-links.jsonl          # Phase2 采集的链接
-├── notes/                      # Phase34 采集的笔记详情
-│   ├── note_001.json
-│   ├── note_002.json
-│   └── ...
-└── organized/                  # 整理后的数据
-```
-
-## ⚠️ 注意事项
-
-1. **Node.js 版本**：需要 Node.js >= 22.0.0
-2. **频率控制**：Phase2 会触发站内搜索，频繁运行可能触发风控
-3. **迭代调试建议**：
-   - Phase1 运行一次（登录）
-   - Phase2 运行一次（采集链接）
-   - Phase34 反复运行（采集详情）
-4. **端口占用**：确保以下端口未被占用：7701, 7704, 8765, 7790
-
-## 🐛 故障排除
-
-### 问题：Node.js 版本过低
-```bash
-# 查看当前版本
-node -v
-
-# 升级 Node.js
-# macOS
-brew install node
-
-# Windows
-# 访问 https://nodejs.org/ 下载安装
-```
-
-### 问题：缺少构建产物
-```bash
-# 错误信息：❌ 缺少必要的构建产物
-
-# 解决方案：重新安装
-./install.sh  # 或 install.bat
-```
-
-### 问题：崩溃信息
-查看崩溃日志：
-```bash
-cat ~/.webauto/logs/crash-state.json
-```
-
-## 📞 技术支持
-
-- **GitHub**: https://github.com/your-repo/webauto
-- **文档**: https://github.com/your-repo/webauto/docs
-- **Issues**: https://github.com/your-repo/webauto/issues
-
-## 📝 更新日志
-
-### v3.0.0 (2026-01-22)
-- ✨ 统一 Phase1-2-34 入口
-- ✨ 添加版本管理和环境检查
-- ✨ 增强错误处理和崩溃恢复
-- ✨ 支持 Linux 平台
-- ✨ 改进帮助文档（中文）
-- ✨ 添加 SIGINT/SIGTERM 优雅退出
-- 🐛 修复路径检查问题
-- 📚 完善使用文档

package/docs/arch/OCR_MACOS_PLUGIN.md

@@ -1,39 +0,0 @@
-# macOS OCR 插件（Vision）
-
-## 目的
-
-在开发/守护进程（daemon）模式下，将 OCR 作为 **独立的 macOS 插件二进制** 执行，避免把 OCR 逻辑耦合在 Node 依赖或第三方 OCR 运行时里。
-
-## 构建与安装
-
-构建（产物写入仓库 `dist/`）：
-
-```bash
-npm run build:ocr:macos
-```
-
-安装到用户目录（推荐，运行时默认会优先从这里查找）：
-
-```bash
-node scripts/build/build-ocr-macos.mjs --install
-```
-
-安装后位置：
-
-- `~/.webauto/bin/webauto-ocr-macos`
-
-也可以通过环境变量指定路径：
-
-- `WEBAUTO_OCR_BIN=/absolute/path/to/webauto-ocr-macos`
-
-## 运行示例
-
-```bash
-./dist/plugins/ocr-macos/webauto-ocr-macos --json --langs "chi_sim+eng" /path/to/image.jpg
-```
-
-说明：
-
-- `--langs` 支持 `chi_sim+eng`（会映射为 Vision 的 `zh-Hans,en-US`）
-- 输出为 JSON 数组：`[{ image, text?, error? }]`
-