butubb
2112c1a870
移植自 mac-agent-os 的 mediacrawler_adapter：不起子进程、不开页面，用浏览器里那份
登录态直接调抖音 Web 接口。产物键名照抄 store/douyin，所以 ingest 那条链路一个字不用改。
**目前能用的（真环境实测，非推断）**：
profile/other : 200, 7075 字节 —— 博主主页指标（粉丝/获赞/作品数/昵称）
aweme/detail : 200, 45425 字节 —— 单条作品详情（含点赞/评论/收藏/分享）
**目前不能用的：作品列表 `aweme/post`。** 两个互相独立的原因：
1. 这个接口被抖音单独升级成了真校验：不带 x-tt-argus 回 403「Uifid Not Found」，
带上 dummy 值回 200 + **空 body**。也就是说「头在不在」骗得过，「真校验」过不了。
同一套头打 profile/other 和 aweme/detail 都是通的 —— 抖音是挑着接口加保护的，
挑中的恰好是「批量拉作品列表」这个最敏感的动作。
2. 改走页面截获也不行：CDP 浏览器打开博主主页会落到「验证码中间页」（当天大量探测的
代价，过几小时要重测）。
所以现在的边界是：**已知作品的指标刷新能做，自动发现新作品做不了**。
**排查中控住变量后得到的两条事实**（都写进注释了）：
· `Accept` / `Accept-Language` / `Referer` 才是主页接口能返回真数据的原因 —— 只有
UA+client hints+Cookie 时是 200 但仅 121 字节的空壳，补上这三个头变 7074 字节。
（我先前猜的 sec-ch-ua 不是关键。）
· 因此 UA 与 client hints 必须**成套地取自同一个浏览器**，所以 BrowserIdentity 一次
从 CDP 取齐 cookie + UA + hints，而不是各自写死。
「200 + 空 body 必须当场报错」也是刻意写死的：放过去它会在下游变成「这个博主没作品」，
把一次失败伪装成一条正常结果 —— 爬虫那条路正是这么栽的，还被翻译成「账号被封」。
测试 +11：cookie 解析、请求头成套性（含 uifid 缺失/回退）、产物键名与 store 对齐、
以及 _get 的三条失败路径（空 body / 403 带网关原话 / 正常返回）。
4.6 KiB
4.6 KiB
AgentOS 新机器部署指南
版本: v2.0 | 最后更新: 2026-06-15 本文件供 AI 智能体读取后自动执行部署。
架构说明
与旧版部署的关系
| 旧版 (v1.0) | 新版 (v2.0) | 关系 |
|---|---|---|
init.sh |
保留，增加代码签名检测 | 扩展 |
deploy.sh |
保留，增加步骤 | 扩展 |
setup_env.sh |
保留 | 不变 |
| — | requirements.txt |
新增：版本锁定 |
| — | Python 重签步骤 | 新增：解决代码签名问题 |
旧版部署方案仍然可用，v2.0 是在其基础上增加了 2 个新步骤：
- 检测 WorkBuddy 管理的 Python 是否有代码签名问题 → 自动修复
- 从
requirements.txt安装锁定版本的核心依赖
联邦系统 CLI
底层 CLI 是 mc（05_tools/07_matrix/mc），它统一管理养号、采集、远程执行等功能。未来 AgentOS 系统级的 CLI 可以在此基础上扩展，但目前 mc 已经覆盖了所有核心操作。
一、前置条件
- ✅ 本机已安装 WorkBuddy（从官网下载）
- ✅ 已拥有 Gitee 仓库的 SSH 访问权限
- ✅ macOS 版本 ≥ 14.0
- ✅ Tailscale 已安装并登录（跨局域网通信用）
- ✅ 远程登录已开启：系统设置 → 通用 → 共享 → 远程登录
二、部署步骤（AI 请按顺序执行）
步骤 1：克隆仓库
cd ~
git clone [email protected]:babycalf/mac-agent-os.git workbuddy-agent-os/agent-sync
步骤 2：运行部署脚本
cd ~/workbuddy-agent-os/agent-sync
bash 00_bootstrap/deploy.sh
deploy.sh 会自动：
- 设置环境变量
AGENT_SYNC/AGENT_LOCAL并写入.zshrc - 创建
agent-local/目录结构 - 创建
agent-local/config.yaml默认配置 - 检测 Tailscale 状态
步骤 3：修复 Python 代码签名（新增）
WorkBuddy 管理的 Python 二进制被腾讯签名，带有 Team ID，导致 orjson 等 .so 文件无法加载。需要移除签名：
PYTHON_BIN="$HOME/.workbuddy/binaries/python/versions/3.13.12/bin/python3"
codesign -f -s - "$PYTHON_BIN"
验证修复：
"$PYTHON_BIN" -c "import orjson; print(orjson.__version__)"
预期输出：3.11.9
步骤 4：安装核心依赖（新增）
cd ~/workbuddy-agent-os/agent-sync
pip install -r requirements.txt
步骤 5：验证环境
bash 00_bootstrap/fleet_reconcile.sh
所有检查项应为绿色 ✅。如果红色 ❌，请根据提示修复。
步骤 6：启动 Dashboard
cd ~/workbuddy-agent-os/agent-sync/05_tools/10_dashboard
nohup python3 run.py 9988 > /dev/null 2>&1 &
三、新机器加入联邦集群
上述步骤完成后，通知主控机器（chengzigedeAir）的管理员，将新机器信息加入 ORACLE.yaml：
machines:
新机器名:
hostname: 新机器名
tailscale_host: 新机器tailscale名
tailscale_ip: 100.x.x.x
ssh_user: 用户名
uid_prefix: 新机器的 uid 前8位
role: worker
os: macOS arm64
然后在本机执行同步：
bash 00_bootstrap/fleet_sync.sh
四、已知问题与处理
1. 登录进程卡死
mc account login 命令在 Cookie 过期或需要扫码时，会打开浏览器等待用户操作，不会自动超时退出。如果调度器连续 spawn 多个登录命令且无人操作，会积累大量僵尸进程。
预防: 启动养号前先验证账号登录状态：
python3 -m mc status all | grep -i "login"
处理: 如果已累积僵尸进程，手动 kill：
pkill -f "mc account login"
2. Python 代码签名问题复发
如果 WorkBuddy 升级后重新安装了 Python，代码签名可能会恢复。重新执行步骤 3 即可。
3. 包版本不一致
三台机器从 requirements.txt 安装即可对齐：
pip install -r requirements.txt --force-reinstall
五、完整部署流程（速查）
# 新机器部署（6步，约10分钟）
git clone [email protected]:babycalf/mac-agent-os.git ~/workbuddy-agent-os/agent-sync
cd ~/workbuddy-agent-os/agent-sync
bash 00_bootstrap/deploy.sh
source ~/.zshrc
codesign -f -s - $HOME/.workbuddy/binaries/python/versions/3.13.12/bin/python3
pip install -r requirements.txt
bash 00_bootstrap/fleet_reconcile.sh
六、联邦常用操作
# 一键同步所有机器
bash 00_bootstrap/fleet_sync.sh
# 单机对账检查
bash 00_bootstrap/fleet_reconcile.sh
# 远程执行命令
python3 -m mc remote exec 机器名 "命令" --via ssh
# 查看所有机器状态
python3 -m mc remote status