Linux DO

通过您已连接 OOMOL 的账号操作 Linux DO。该能力调用 linux_do 连接器（connector），底层由 oo CLI 执行；OOMOL 在服务端注入凭据，因此您无需直接处理原始 token。

执行一个操作

Linux DO 无需预先建立账号连接。请确保 oo CLI 已安装并已登录。 请勿主动运行 oo auth login — 直接执行操作即可。 仅当某条命令实际失败时，才回退至首次设置流程。

1. 查看契约（contract）：在构造请求载荷（payload）前，先获取该操作权威的输入/输出 Schema：

oo connector schema "linux_do" --action ""

2. 执行操作：传入符合输入 Schema 的 JSON 载荷：

oo connector run "linux_do" --action "" --data '' --json

• --data 接受一个 JSON 对象字符串，或以 @path/to/file.json 形式指定本地文件路径；若省略此参数，则默认发送空对象 {}。
• 响应格式为 { "data": ..., "meta": { "executionId": "..." } }；其中执行 ID 位于 meta.executionId 字段下。

以下列出了所有可用操作，每项附有一行简要说明；凡会改变状态的操作均标有 [write] 或 [destructive] 标签。在构造 --data 前，请务必使用 oo connector schema 获取该操作最新的、权威的输入字段定义。

可用操作

• list_badge_grants — 列出某 Linux DO badge 最近的授予记录。RSS 接口地址：GET https://linux.do/badges/{id}.rss。若目标资源为私有或无法匿名访问，则返回 404；404 并不必然表示该资源不存在。遇到 429（限流）错误时，请稍后重试，或直接从本地网络请求该接口 URL。
• list_category_tag_topics — 列出某分类（category）内带指定标签（tag）的主题（topic）。RSS 接口地址：GET https://linux.do/tags/c/{slug}/{id}/{tag}.rss。若目标资源为私有或无法匿名访问，则返回 404；404 并不必然表示该资源不存在。遇到 429（限流）错误时，请稍后重试，或直接从本地网络请求该接口 URL。
• list_category_topics — 列出某 Linux DO 分类中的主题。RSS 接口地址：GET https://linux.do/c/{slug}/{id}.rss。若目标资源为私有或无法匿名访问，则返回 404；404 并不必然表示该资源不存在。遇到 429（限流）错误时，请稍后重试，或直接从本地网络请求该接口 URL。
• list_group_mentions — 列出提及某 Linux DO 群组（group）的帖子。RSS 接口地址：GET https://linux.do/g/{name}/mentions.rss。若目标资源为私有或无法匿名访问，则返回 404；404 并不必然表示该资源不存在。遇到 429（限流）错误时，请稍后重试，或直接从本地网络请求该接口 URL。
• list_group_posts — 列出某 Linux DO 群组成员发布的帖子。RSS 接口地址：GET https://linux.do/g/{name}/posts.rss。若目标资源为私有或无法匿名访问，则返回 404；404 并不必然表示该资源不存在。遇到 429（限流）错误时，请稍后重试，或直接从本地网络请求该接口 URL。
• list_hot_topics — 列出 Linux DO 上当前公开的热门/趋势主题。RSS 接口地址：GET https://linux.do/hot.rss。遇到 429（限流）错误时，请稍后重试，或直接从本地网络请求该接口 URL。
• list_latest_posts — 列出 Linux DO 全站最新的公开帖子。RSS 接口地址：GET https://linux.do/posts.rss。遇到 429（限流）错误时，请稍后重试，或直接从本地网络请求该接口 URL。
• list_latest_topics — 列出 Linux DO 上最新的公开主题。RSS 接口地址：GET https://linux.do/latest.rss。遇到 429（限流）错误时，请稍后重试，或直接从本地网络请求该接口 URL。
• list_tag_topics — 列出带有某 Linux DO 标签（tag）的主题。RSS 接口地址：GET https://linux.do/tag/{tag}.rss。若目标资源为私有或无法匿名访问，则返回 404；404 并不必然表示该资源不存在。遇到 429（限流）错误时，请稍后重试，或直接从本地网络请求该接口 URL。
• list_top_topics — 列出 Linux DO 上某时间段内的公开热门主题（top topics）。RSS 接口地址：GET https://linux.do/top.rss?period={period}（支持值：daily / weekly / monthly / quarterly / yearly / all）。遇到 429（限流）错误时，请稍后重试，或直接从本地网络请求该接口 URL。
• list_topic_posts — 列出某 Linux DO 主题下的所有帖子。RSS 接口地址：GET https://linux.do/t/{slug}/{id}.rss（slug 默认为 "topic"）。若目标资源为私有或无法匿名访问，则返回 404；404 并不必然表示该资源不存在。遇到 429（限流）错误时，请稍后重试，或直接从本地网络请求该接口 URL。
• list_user_posts — 列出某 Linux DO 用户发布的帖子。RSS 接口地址：GET https://linux.do/u/{username}/activity.rss。若目标资源为私有或无法匿名访问，则返回 404；404 并不必然表示该资源不存在。遇到 429（限流）错误时，请稍后重试，或直接从本地网络请求该接口 URL。
• list_user_topics — 列出某 Linux DO 用户创建的主题。RSS 接口地址：GET https://linux.do/u/{username}/activity/topics.rss。若目标资源为私有或无法匿名访问，则返回 404；404 并不必然表示该资源不存在。遇到 429（限流）错误时，请稍后重试，或直接从本地网络请求该接口 URL。

安全性

• 未标注标签的操作均为只读操作（get / list / search），可安全直接执行。
• 标注 [write] 的操作会更改 Linux DO 状态 — 执行前必须向用户确认载荷内容与预期影响。
• 标注 [destructive] 的操作将删除或覆盖数据 — 执行前必须明确确认目标对象，并获得用户的显式授权。

首次设置

以下步骤均为 一次性 操作 — 不必在每次调用时重复执行。仅当某条命令因对应原因失败时，才运行相应步骤。

• oo: command not found — 安装 oo CLI（其他平台安装指南：https://cli.oomol.com/install-guide.md）：

  curl -fsSL https://cli.oomol.com/install.sh | bash    # macOS / Linux
  

  irm https://cli.oomol.com/install.ps1 | iex           # Windows PowerShell
  

• 未登录 / 认证失败 — 一次性登录您的 OOMOL 账号：

  oo auth login
  

• HTTP 402 错误 / OOMOL_INSUFFICIENT_CREDIT — 账户余额不足导致服务暂停。请前往 https://console.oomol.com/billing/token-recharge 充值后重试。

相关资源

• Linux DO 官网：https://linux.do