jackwener--opencli
wehub-resource-sync
9b395f5cc3
E2E Headed Chrome / e2e-headed (macos-15) (push) Has been cancelled
E2E Headed Chrome / e2e-headed (ubuntu-latest) (push) Has been cancelled
E2E Headed Chrome / e2e-headed (windows-latest) (push) Has been cancelled
CI / build (macos-latest) (push) Has been cancelled
CI / build (ubuntu-latest) (push) Has been cancelled
CI / build (windows-latest) (push) Has been cancelled
CI / unit-test (push) Has been cancelled
CI / bun-test (push) Has been cancelled
CI / adapter-test (push) Has been cancelled
CI / smoke-test (macos-latest) (push) Has been cancelled
CI / smoke-test (ubuntu-latest) (push) Has been cancelled
Security Audit / audit (push) Has been cancelled
Build Chrome Extension / build (push) Has been cancelled
Trigger Website Rebuild (Docs Updated) / dispatch (push) Has been cancelled
79 行
2.7 KiB
Markdown
79 行
2.7 KiB
Markdown
---
|
||
schema_version: 1.1
|
||
workflow_id: post
|
||
intent: publish a text-only public post
|
||
last_verified: 2026-06-02
|
||
source: global
|
||
---
|
||
|
||
## Goal
|
||
|
||
发一条公开 **text-only post，≤ 280 char，无 media / poll / schedule / thread-split**。
|
||
|
||
- 带 media 走 adapter `opencli twitter post --image-url` 直接路径
|
||
- thread-split (> 280 char) / poll / schedule 不在 v1 PoC scope（caller 应在调本 workflow 前处理 split 或选其他 workflow）
|
||
|
||
## State signature
|
||
|
||
- entry: 任意 page on x.com, logged_in (cookie `auth_token` 有效)
|
||
- success: timeline 5s 内看到新 post 出现在自己的 home / profile
|
||
|
||
## Best path
|
||
|
||
```yaml
|
||
adapter: opencli twitter post
|
||
adapter_health: healthy
|
||
preconditions:
|
||
- logged_in
|
||
- text content ready (<= 280 chars)
|
||
estimated_turns: 1
|
||
```
|
||
|
||
直接 `opencli twitter post --text "<content>"`。adapter 内部 handle COOKIE 注入 / queryId rotation / verify。
|
||
|
||
## Fallback path
|
||
|
||
当 adapter 抛 typed error (EmptyResultError | CommandExecutionError) 或返回 unexpected empty 时：
|
||
|
||
```yaml
|
||
on_adapter_fail:
|
||
- adapter_health_update: opencli twitter post -> suspect
|
||
- opencli browser state (verify current page)
|
||
- if not on /home: goto /home
|
||
- action:open_compose in pages/home.md
|
||
- type content into [data-testid="tweetTextarea_0"]
|
||
- action:submit_post in pages/home.md
|
||
- verify timeline top shows new post within 5s
|
||
estimated_turns: 4
|
||
```
|
||
|
||
## Avoid
|
||
|
||
- 不要在 mobile UA 下手 click sidebar `New Post` 按钮 — `pitfall:wrong_dom_when_ua_mobile`
|
||
- 不要 `goto /compose/tweet` 后再用 inline composer testid `tweetButtonInline`，modal 形态用 `tweetButton`（见 `pages/compose.md`）
|
||
- RTL 内容不要单段一次 type — `pitfall:rtl_text_breaks_compose_verify`
|
||
- 不要 adapter 失败时反复 retry adapter — 直接走 Fallback，否则浪费 turn
|
||
|
||
## Re-entry checkpoints
|
||
|
||
agent 中断后醒来按 `browser state` URL 判断：
|
||
|
||
- on /home, compose dialog NOT visible → 从 Fallback step 2 起
|
||
- on /home OR /compose/tweet, textarea visible 且 text 已部分输入 → step 3 起（continue type 剩余）
|
||
- on /home, 新 post 已在 timeline 顶部 → 已完成
|
||
|
||
## State validation
|
||
|
||
- timeline 顶部出现 author=self 的新 entry
|
||
- entry text **normalized 匹配** submitted content：
|
||
- trim 前后 whitespace
|
||
- Twitter 自动 URL 化（裸 URL → t.co shortlink + display URL，按 display URL 或原 URL substring 匹配）
|
||
- emoji / unicode NFC normalize 保留
|
||
- **不要** 用 strict equality（whitespace 折叠 / URL 转换造成假失败）
|
||
- entry 时间显示 "now" / "1s ago"
|
||
|
||
## Stale markers
|
||
|
||
- adapter `opencli twitter post` 30 天内 fix PR 增多 → adapter_health audit 标 suspect
|
||
- submit button text "Post" 变化（i18n / rebrand 二轮）→ visual anchors 需更新
|