Doudou

可交付的 Codex Skill 与 Python CLI，用项目本地 Camoufox Profile 读取抖音聊天、图片、系统事件、用户视频和评论，并通过常驻浏览器执行受控页面写操作。

安装

只要求 Node.js >=18.18。npm 包只携带启动器和 Skill 源码；setup 自行下载校验专用 Python，不使用用户系统 Python，也不把 Python、venv、依赖或浏览器打进 npm 包。

npm install -g @follenfang/doudou
doudou doctor

doudou 首次运行会把版本匹配的 Skill 原子安装到 ~/.agents/skills/doudou/。首次业务命令发现运行时缺失时，会自动执行 setup：下载校验专用 Python 3.12.13，在 ${DOUDOU_HOME:-~/.doudou} 创建版本化 venv、安装锁定依赖、受控下载并验证专用 Camoufox 152.0.4-beta.28，然后继续原命令。也可以提前执行：

doudou setup
doudou profile create --profile work
doudou profile login --profile work

不希望全局安装时可使用 npx；即使 npm lifecycle scripts 被禁用，首次命令仍会补齐 Skill：

npx --yes @follenfang/doudou -- doctor
npx --yes @follenfang/doudou -- profile list

Skill 目录可用 --skill-dir <完整路径> 临时覆盖，或用 DOUDOU_AGENT_HOME 把默认位置改为 <home>/skills/doudou。DOUDOU_HOME 只覆盖用户级 Python、venv、浏览器和安装状态的位置；Profile 与业务记录始终留在运行命令时的当前项目：

profile/<profile>/
message/profiles/<profile>/

工作方式

• 每个项目和 Profile 只有一个 Python broker。
• Windows 默认真无头；登录、短信、滑块或 Passkey 等人工认证出现时，串行切换同一 Profile 到可见有头，完成后恢复真无头。Linux 保留 Xvfb 虚拟有头。
• broker 串行执行命令，空闲 20 分钟退出。
• 首条业务命令内部初始化页面与 IM；没有用户侧预热流程。
• 会话、消息、图片、视频和评论读取使用页面上下文协议。
• 文字、引用、图片、聊天点赞、视频评论/回复/点赞通过一次正常页面动作提交；聊天文字/引用和评论/回复使用编辑器 Enter。网络回执验证写结果，只读协议负责补充复查。
• 图片下载先校验 AES-GCM，再按平台字段口径校验加密体或明文 MD5、明文大小与实际文件格式。
• 视频列表从协议响应读取；翻页由版本化 Profile Component 的受控滚动触发，不复用过期签名 URL。
• 页面读协议统一按 HTTP、Content-Type、Retry-After、响应长度/哈希和 JSON 业务状态分类；评论分页逐页保存检查点，可从失败游标恢复。
• 接口路径/字段别名集中在版本化 Protocol Adapter，页面 selector 集中在版本化 UI Adapter。写控件依次校验稳定语义、局部组件结构、唯一可见/启用状态和几何关系；不唯一时在点击前返回 PAGE_ADAPTER_DRIFTED，不会猜测点击。接口结构变化返回 PROTOCOL_SCHEMA_DRIFTED，不伪装成登录失效。
• 写操作先生成计划，确认后只使用 --confirm --plan-id <id>。

常用命令

doudou conversations refresh --profile work --kind all
doudou messages collect --profile work --conversation "会话名称"
doudou protocol send --profile work --recipient "会话名称" --text "你好"
doudou protocol send --profile work --confirm --plan-id <id>
doudou protocol send-batch --profile work --conversation-ids <ID1,ID2> --text "你好"
doudou videos collect --profile work --douyin-id Rurutia.wow
doudou video collect --profile work --sec-uid <sec_uid> --aweme-id <视频ID>

完整 Agent 编排见 doudou/SKILL.md，文件结构见 doudou/references/layout.md。

升级与卸载

doudou update --check
doudou update
doudou uninstall

doudou update 只升级已有全局 npm 安装并原子更新 Skill；runtime manifest 没变化时复用当前 runtime，变化时并排验证新 runtime 后切换。npx 模式只报告版本状态，不创建全局安装。

doudou uninstall 会停止受管 broker，删除全部 npm 管理的 Skill、整个 ${DOUDOU_HOME:-~/.doudou}，再删除 npm 包自身。项目中的 profile/、message/ 会保留。npm 7+ 不执行卸载 lifecycle，直接使用 npm uninstall 不会清理这些运行文件。

故障诊断

• SKILL_INSTALL_FAILED：目标 Skill 目录存在未知内容；换用 --skill-dir，或先人工核对该目录。
• DEPENDENCY_INSTALL_FAILED：锁定依赖安装失败；再次 setup 会创建新的临时 runtime，不复用半安装 venv。
• BROWSER_DOWNLOAD_STALLED：浏览器下载 90 秒无新字节；网络恢复后再次 setup 会续传有效 .part。
• BROWSER_DOWNLOAD_CHECKSUM_MISMATCH：浏览器资产哈希不符，损坏文件不会激活。
• RUNTIME_SETUP_FAILED：运行 doudou doctor 查看 setup owner、下载 partial、缓存和可执行修复命令。
• 登录、短信、滑块或 Passkey：运行对应命令后，由同一 broker 关闭后台 context，再用同一 Profile 显示有头浏览器供人工接管。

发布

GitHub Actions 只在 v* tag 推送时发布。tag 去掉 v 后必须与 package.json.version 和 Python Skill 版本完全一致。npm Trusted Publisher 需要绑定仓库 Follen/doudou 和 workflow publish-npm.yml，发布使用 GitHub OIDC，不使用长期 NPM_TOKEN。npm 目前不为私有 GitHub 仓库生成 provenance；仓库保持私有时仍使用 OIDC 发布，但发布记录不带 provenance。

git tag -a vX.Y.Z -m "Doudou X.Y.Z"
git push origin vX.Y.Z

开发验证

$env:PYTHONPATH = "doudou\scripts"
python -m pytest docs\verification\tests -q

发布 tarball 包含 npm 启动器和完整 Skill 源码，但不包含 venv、Python packages、浏览器二进制、Profile、消息或 analyze/ 数据。

批量发送一次确认后复用同一 broker，严格串行，相邻尝试至少间隔 5 秒；首个失败后其余项目标记为 skipped，不会继续写入。