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 快速上手
版本 3.0 | 多智能体协同模式
前置条件
- ✅ WorkBuddy 桌面客户端（codebuddy.cn 下载）— 必需
- ✅ Git（macOS 自带）— 代码同步必需
- ✅ Gitee 或 GitHub 账号 — 用于多机协同
- ⬜ Obsidian（obsidian.md 下载）— 推荐，浏览知识库
Python 和 Node.js 由 WorkBuddy 自动管理，不需要手动安装。
新机器部署流程
1. 克隆仓库
git clone [email protected]:babycalf/mac-agent-os.git ~/workbuddy-agent-os/agent-sync
cd ~/workbuddy-agent-os/agent-sync
如果 SSH 未配置，用
git_sync_manager技能引导配置。
2. 一键初始化
bash 00_bootstrap/init.sh
脚本自动完成：
- 创建
agent-local/目录结构（identity/memory/materials/submissions...） - 重建 3 条软链接（raw/vector_db/cache）
- 安装 Python 依赖
- 检测设备和系统信息
- 创建 L1 关键词索引
3. 生成本机身份
agentos localize
执行后：
agent-local/identity/IDENTITY.md— 本机身份（含主机名、路径等）agent-local/identity/USER.md— 用户信息agent-local/identity/HOST_ID.md— 本机角色 + 能力开关
关键步骤：编辑 HOST_ID.md 设置角色：
# 选择一种角色：
# master → 知识提纯/记忆汇总/核心维护（推荐主电脑）
# maintainer → 内容采集/本地记忆/提交价值内容（推荐工作机）
# node → 信息采集/素材上传（推荐轻量设备）
角色: master
角色决定自动化任务：master 自动执行 inbox_refine，其他角色跳过。
4. 同步技能到 WorkBuddy
agentos sync
将 02_skills/ 下的技能注册到 WorkBuddy，同时部署 MCP 配置。
5. 升级依赖
agentos upgrade
拉取最新代码 + 安装依赖 + 环境检查。
6. 重建向量数据库
agentos rebuild-vector
在本地重建语义检索索引（升级后必须执行）。
7. 验证系统状态
agentos check
日常使用流程
拉取最新代码
cd ~/workbuddy-agent-os/agent-sync && git pull
主节点（master）操作
# 查看待提纯内容
ls 03_knowledge/01_submissions/
# 手动触发收件箱提纯
agentos skill run inbox_refine
# 查看各节点提交
find 03_knowledge/01_submissions/ -name "*.md"
# 提交变更到协同仓库
git add -A
git commit -m "知识库更新摘要"
git push
工作/采集节点操作
# 提交知识内容
cp 提炼后的笔记.md ~/workbuddy-agent-os/agent-local/submissions/inbox/
# 然后 git commit + git pull request 或手动同步
# 本机记忆提炼（自动运行）
# 结果保存在 agent-local/memory/daily/
升级流程
git pull
agentos upgrade
agentos rebuild-vector
角色行为速查
| 场景 | master | maintainer | node |
|---|---|---|---|
| 本地记忆提炼 | ✅ 自动 | ✅ 自动 | ✅ 自动 |
| 内容采集 | ✅ 自动 | ✅ 自动 | ✅ 自动 |
| 知识库提纯 | ✅ 自动 | ⛔ 跳过 | ⛔ 跳过 |
| Git 推送 | ✅ 自动 | ❌ 手动 | ❌ 手动 |
| 提交有价值内容 | — | ✅ 通过 submissions | ✅ 通过 submissions |
| 向量库重建 | ✅ 升级后执行 | ✅ 升级后执行 | ✅ 升级后执行 |
验证
# 1. 检查角色
cat ~/workbuddy-agent-os/agent-local/identity/HOST_ID.md
# 2. 检查角色检查工具
python3 ~/workbuddy-agent-os/agent-sync/05_tools/01_system/role_check.py
# 3. 检查向量库状态
agentos rebuild-vector --dry-run
# 4. 检查 Git 状态
cd ~/workbuddy-agent-os/agent-sync && git status
多机首次协同设置
# 机器A（master）：
git clone ... && bash init.sh && agentos localize
# 编辑 HOST_ID.md → role: master
agentos sync && agentos upgrade && agentos rebuild-vector
# 机器B（maintainer）：
git clone ... && bash init.sh && agentos localize
# 编辑 HOST_ID.md → role: maintainer
agentos sync && agentos upgrade && agentos rebuild-vector
# 机器B 采集后提交：
cp 内容 ~/agent-local/submissions/inbox/
cd ~/agent-sync && git add -A && git commit -m "提交内容" && git push
# 机器A 提纯发布：
cd ~/agent-sync && git pull
# → inbox_refine 自动检测 submissions/ 中的新内容
# → 审核后发布到知识库 → git push
# 机器B 获取最新知识库：
cd ~/agent-sync && git pull
🎉 完成！ 你的多智能体联邦已就绪。各节点按角色自动运行对应任务。