技能介绍

解决的问题

Hacker News 的数据入口分散在三条 API 上:故事流、条目详情和 Algolia 搜索。直接对接要自己处理 id 游标分页、deleted/dead 条目过滤,以及 item 只返回 id、正文需要二次请求拼装的问题。oo-hackernews 把这些复杂度收敛成一个技能:声明你要哪类数据,由连接器负责取数和整形。

技能如何工作

技能背后是 Hacker News 连接器,共暴露 14 个 action,通过 oo CLI 调用,凭证由 OOMOL 服务端注入,本地不保存 token。运行流程固定为两步:

先用 oo connector schema 取权威输入输出契约,不要凭记忆拼 payload。
再按契约构造 --data,支持 JSON 对象字符串或 @path/to/file.json;响应统一为 {"data": ..., "meta": {"executionId": "..."}},执行 id 位于 meta.executionId。

能力大致分四组:故事流拉取(get_new_stories、get_best_stories、get_top_stories、get_ask_stories、get_show_stories、get_job_stories)、条目与评论树(get_item、get_item_with_id)、变更与游标(get_updates、get_max_item_id)、用户与检索(get_user、get_user_by_username、get_latest_posts、search_posts)。Algolia 那条链路额外提供全文检索和按时间倒序的最新帖子。

适用边界与注意点

这套技能是纯读的:当前 action 清单里没有 create、update、post 或 delete,不会改动 Hacker News 上的任何状态。不过按安全约定,任何涉及写操作的技能都应在执行前确认 payload 与预期效果,破坏性操作更要先取得明确同意。

几个工程上的注意点:故事流接口返回的是 id 列表,需要再调条目接口才有标题和正文;get_item_with_id 的嵌套评论深度有限,不是完整线程;分页与速率上限由连接器和上游共同决定,批量拉取时应在业务层做退避;get_updates 适合做增量同步,但它只返回近期变化的条目和用户,不能当作完整变更日志。命令报错时再走一次性登录,不要在每次调用前重复登录。