x-opslisted

# X 操作手册(x-manager) 三个工具:`x_status`(看就绪状态)、`x_search`(搜 X 并总结)、`x_post`(以用户身份发帖)。 ## 1. 通道选择决策树 1. 不确定能不能用 → 先 `x_status`(免费)。看 `search_route`: - `oauth` → 走用户的 Grok 订阅,**零边际成本**,直接搜。 - `api_key` → 走 xAI API 按量付费,能用但花钱,搜之前想清楚要几次。 - `unknown` → 电子脑读不到凭证状态,直接调 `x_search` 试;失败会告诉你缺什么。 - `none` → 两条都没配。把 `setup_pointers` 里的原话转给用户去配;用户���想配就 改用浏览器方案(见 §5),不要空转重试。 2. 搜索失败时**不用你手动降级**:`x_search` 内部按 OAuth → API key 顺序自动降级, 成功时在 `route_used` / `degraded_from` / `degrade_reason` 里如实标注。 3. 用户抱怨"明明连上了却搜不出来": - `x_status` 传 `probe: true` 只能**排除凭证与网络**这两类原因——它打的是 账号/目录端点,**看不到订阅档位门禁**(那个 403 只在真正的搜索请求上才触发)。 所以别拿 probe 通过当作"搜索可用"的结论,也别据此向用户下判断。 - 要确认搜索到底行不行,只有真跑一次 `x_search`。真被门禁挡下时工具会自动 降级到 API key,并在 `route_used` / `degrade_reason` 里标明。 - 若真是 **403 订阅档位门禁**(xAI 只对部分订阅档放行 OAuth 推理面):这不是 登录失败,**别让用户反复重登**,让他配一个 xAI API key 兜底。 4. 要发帖 / 要精确的结构化帖子数据 → 那是 X 官方 API 的活,和上面两条通道无关 (凭证是用户自己的 developer app)。 ## 2. 自然语言代搜技巧 - **把用户的整句意图原样交给 `query`**。检索是 xAI 侧模型代做的,给���完整意图 ("过去两天关于某发布的讨论,主要争议点是什么")比你自己拆关键词准得多。 不要压缩成 `keyword1 OR keyword2`。 - 用户点了名的账号才传 `handles`(不带 @,≤10 个);`exclude_handles` 与它互斥。 - **找回复 / 对话串时必须点明搜索算子,否则会漏得离谱**。笼统问"某某有没有回复过我" 很容易得到错误的"没找到";把 query 写成明确指令——例如「请用 `from:DashHuang to:zkyo` 搜索并向前翻页,列出所有回复」——同一个问题就能翻出几十条。找某人提到 某人用 `@某某`,找回复用 `to:某某`,找某人发的用 `from:某某`。**一次搜不到不等于 不存在,先换成算子式提问再下结论**,尤其在你要据此判断"能不能回这条"的时候(§6)。 - 用户给了时间范围才传 `from_date` / `to_date`,格式 `YYYY-MM-DD`; "最近两天"这类相对表述你自己换算成日期。 - `mode` 缺省 `fast`,足