feat: add browser-assisted douyin capture flow

docs/AUDIT_2026-03-18.md

@@ -116,6 +116,9 @@
   - public 页面命中抖音反爬挑战时的显式诊断返回
 - 真实 smoke 结果表明，纯 public 主页抓取会落到 `byted_acrawler` 挑战页，而不是正常 profile 数据页
 - 同时，`manual_profile_payload + manual_work_payloads` 已验证可完成账号入库、分析报告生成、相似账号搜索和对标关系写入
+- 现已新增浏览器辅助采集工具 `/Users/kris/code/StoryForge-gitea/scripts/douyin-browser-capture/capture_and_sync.mjs`
+- 该工具使用真实 Playwright Chromium 会话打开抖音页面，允许人工登录 / 过滑块后继续自动提取 `<script>` JSON、网络 JSON、视频详情页和创作者中心页数据
+- 浏览器工具最终直接调用现有 `/v2/douyin/accounts/sync`，不新增第二套持久化模型
 
 结论：`douyin` 方向不再是“接口存在但不可用”，当前状态是“public 直抓受反爬限制，但人工采集兜底链已跑通”。
 
@@ -181,6 +184,6 @@
 ## 当前主要风险
 
 1. 小红书账号级内容源还未做真实平台验证
-2. `douyin` public 直抓仍受反爬限制，生产落地还需要补 cookie 或人工页面采集协作链
+2. `douyin` public 直抓仍受反爬限制，但现在已经有“真实浏览器 + 人工登录 + 自动提取 + 回写现有工作台”的可落地协作链
 3. `huobao-drama-upstream` 已完成代码迁移并可编译，但 fresh smoke 受外部图片/视频凭证 `403 invalid user` 阻塞
 4. Android 端目前已能完成 Debug APK 构建，但仍缺少真机安装和功能回归验证

docs/LAN_E2E_GUIDE_2026-03-18.md

@@ -158,6 +158,26 @@ docker compose up -d --build
 - 相似账号搜索：`dysearch_c247b75db0df49429a1d127407fe4486`
 - 对标关系：`dyrel_c8df266341e74237b99c880eb4b572d8`
 
+浏览器辅助采集：
+
+```bash
+cd /Users/kris/code/StoryForge-gitea/scripts/douyin-browser-capture
+npm install
+npx playwright install chromium
+npm run capture -- \
+  --profile-url https://www.douyin.com/user/your_account \
+  --storyforge-username kris \
+  --storyforge-password 'Asd123456.'
+```
+
+说明：
+
+- 脚本会打开真实 Chromium 会话，默认复用 `~/.storyforge/douyin-playwright` 登录态
+- 如果出现扫码登录、滑块或挑战页，先在浏览器里人工完成，再回终端继续
+- 脚本会保存 `profile-bundle.json`、`storyforge-sync-request.json` 和同步响应
+- 当前已完成 headless 最小 smoke，输出目录：
+  - `/tmp/storyforge-douyin-capture-smoke/2026-03-20T06-49-37.705Z-storyforge_test_001`
+
 ## 7. `cutvideo` 实拍剪辑链路验证
 
 调用 `POST /v2/pipelines/real-cut`

docs/MVP_STATUS_2026-03-18.md

@@ -23,6 +23,7 @@
 - live `collector` 已挂出 `/v2/douyin/*` 能力并通过认证接口验证
 - `douyin` 支持从分享文案中提取 `profile_url`，并在 public 页面命中抖音反爬挑战时返回明确诊断
 - `douyin` 手工 payload 导入与账号分析链路已跑通
+- `douyin` 浏览器辅助采集工具已接入，可用真实 Playwright Chromium 会话采集主页 / 视频页并直接调用现有 `/v2/douyin/accounts/sync`
 - 本机 `huobao-drama` API 调度、首尾帧生成、视频生成与结果回写接口
 - FastGPT 运行时依赖删除
 - 旧 FastGPT 运行残留容器已实际下线
@@ -45,11 +46,13 @@
 - `huobao-upstream` 隔离 smoke 剧本：`drama_id=11` (`http://127.0.0.1:5681`)
 - `huobao-upstream` 隔离 smoke 启动脚本：`/Users/kris/code/huobao-drama-upstream/scripts/run_storyforge_smoke.sh`
 - Android Debug APK：`/Users/kris/code/StoryForge-gitea/android-app/app/build/outputs/apk/debug/app-debug.apk`
+- `douyin` 浏览器采集最小 smoke：`/tmp/storyforge-douyin-capture-smoke/2026-03-20T06-49-37.705Z-storyforge_test_001`
 
 ## 尚未完全跑通
 
 - 小红书账号级内容源还未做真实平台验证
 - `douyin` public 主页直抓会命中 `public_profile_anti_bot_challenge`；当前已验证手工 payload 导入、分析、相似账号搜索和对标关系可作为可用兜底路径
+- `douyin` 浏览器辅助采集已经能真实输出 `profile-bundle.json / storyforge-sync-request.json`，但要拿到有效主页数据仍需要用户在浏览器里完成登录或挑战校验
 - `huobao-upstream` 已能全量编译；并且旧改版隔离实例也已重放确认，当前 fresh 生成被外部图片/视频凭证统一返回 `403 invalid user`
 - `huobao-upstream` 已新增 `HUOBAO_TEXT_* / HUOBAO_IMAGE_* / HUOBAO_VIDEO_*` 运行时覆盖能力，后续补新 key 可直接接管数据库配置
 - Android Debug 包已可本地构建，但尚未完成真机安装验证