WorkBuddy
df56c2c137
内容分四块： 1、产品规划产出 —— MCN 短视频整合营销工作台的①段五份（1a 需求／1b 竞品／1c 画像／1d 策略／1e 场景）、②段两份（2a 功能／2b 布局）、③段界面（DESIGN.md 契约与令牌表 ＋ mcn-workbench.html 原型 ＋ 实测/会诊/审查三份 ＋ 23 张闸门截图）。 2、开源竞品调研 —— 5 个内容工作台项目的取证原始件与 1b 系列分析文档。 3、参考资料 —— 竞品视频抽帧 1145 张 ＋ 2 个源视频 ＋ 功能点截图。 4、机制侧 —— 协作脚本与状态台账、工作区记忆日志、抽帧/OCR 脚本。 .gitignore 只排运行时日志、脚本备份副本与一次性探针输出，其余按原样入库。
3.0 KiB
3.0 KiB
浏览器访问操作规范（SOP）
适用于 aigc-idea-impression 各 subskill 中的网页抓取场景（抖音账号/视频、小红书/B站内容等）。 工具：browser-harness（抖音专项，推荐）+ agent-browser（通用兜底）。本机实测环境：browser-harness 0.1.8，
~/.local/bin/browser-harness.exe。
一、环境准备（每次任务前【必做】）
1. 清除代理环境变量（最重要，漏掉必踩坑）
本机 Shadowsocks 的 Privoxy 组件监听 10800，会劫持 127.0.0.1 的 CDP 请求（报 "Internal Privoxy Error" 或连接失败）：
unset http_proxy https_proxy HTTP_PROXY HTTPS_PROXY
export NO_PROXY="127.0.0.1,localhost,::1"
2. 连接方式（按顺序尝试）
| 方式 | 操作 | 说明 |
|---|---|---|
| A. 自动（推荐） | 直接运行 browser-harness（daemon 自动启动连接浏览器） | 最简单；可能触发 Chrome 授权弹窗（见二） |
| B. 定向连接 | export BU_CDP_URL="http://127.0.0.1:<端口>" 后运行 |
端口：9222（用户 Chrome）/ 9223（独立实例） |
| C. 独立实例 | chrome.exe --remote-debugging-port=9223 --user-data-dir=<固定目录> about:blank |
与用户浏览器隔离 |
3. 环境检查
browser-harness doctor # 确认 工具/daemon/Chrome 三要素；daemon 失败用 browser-harness --reload
二、Chrome 远程调试授权（关键机制）
- Chrome 151+ 首次连接会弹 「Allow remote debugging?」 授权框，点击「允许」后才可用（记住后不再弹）
- 弹窗可能在后台：看不到时打开
chrome://inspect/#remote-debugging勾选启用 - 连接前探测：
curl http://127.0.0.1:<端口>/json/version返回含 "Browser" 的 JSON = 可用
三、标签页复用规则（避免窗口/标签堆积）
- 先检查已有标签页（
cdp("Target.getTargets", flatten=True)），有则直接导航复用，不新建 - 没有才
new_tab(...) - 用完不关闭标签页（留给后续任务复用）
四、调用示例
BH="$HOME/.local/bin/browser-harness.exe"
# 打开抖音搜索账号（type=user 限定用户结果）
"$BH" <<'PY'
import time
goto_url("https://www.douyin.com/search/{昵称URL编码}?type=user")
time.sleep(6)
r = js("document.body.innerText")
text = r.get("value", "") if isinstance(r, dict) else str(r)
print(text)
PY
五、适度访问（红线）
- 控制频率：搜索/详情页访问间隔拉长，不连续高频请求
- 视频列表懒加载：滚动 2~3 次收集足够数据即停
- 未登录态功能受限：如实告知（如作品列表需登录），不假装已获取
六、失败排查顺序
1. doctor（工具/daemon/Chrome 三要素）
2. 端口探测 9222/9223/9224 的 /json/version（IPv4 + [::1]）
3. 代理检查：确认 HTTP(S)_PROXY 已清
4. daemon 异常：browser-harness --reload
5. 仍失败 → 提示用户 Chrome 点「允许」+ chrome://inspect 检查