技能介绍

要解决什么问题

网页与文档里的图片若缺少 alt 文本，读屏软件与搜索引擎都难以理解画面内容；手工为每张图写描述又慢，且难以在图库规模变大后统一检索与维护。AltText.ai 提供基于 URL 的替代文本生成与图库管理，但若在 Agent 里直接拼 API Key，凭证容易泄露、轮换也麻烦。

本技能通过已登录的 OOMOL 账号与 oo CLI 调用 alt_text_ai 连接器：密钥在服务端注入，Agent 侧只构造符合 schema 的 JSON 载荷并执行动作，适合「加图 → 生成 alt → 查库 / 搜图 → 必要时删记录」这类流水线。

技能如何工作

执行前应先 oo connector schema 查看当前动作的输入/输出契约，再按 schema 用 --data 传入 JSON（或 @file.json）。响应形如 { "data": ..., "meta": { "executionId": "..." } }，便于追踪单次执行。

可用动作包括：

create_image：提交公网可访问的图片 URL，生成 alt 文本
list_images / search_images / get_image：按 URL、资产 ID 或 alt 内容浏览与检索图库
scrape_page：抓取页面或原始 HTML，将发现的图片排队生成 alt
get_account：查看账号设置与 API 用量
delete_image：按资产 ID 删除图库记录

SKILL 约定：用户已安装 oo、已登录且已连接 AltText.ai 时，不要主动跑登录或打开连接页；仅在命令因鉴权/连接失败时再走首次配置。

适用边界与注意点

只读类（get / list / search）可直接执行；会改状态的创建、更新类动作需与用户确认载荷与影响后再跑。
delete_image 等删除操作不可逆，必须明确目标 ID 并取得用户同意。
图片 URL 需 公网可访问，否则 create_image 可能失败。
若返回 402 / OOMOLINSUFFICIENTCREDIT，需在 OOMOL 控制台充值后再试；连接过期或缺少 scope 时需重新绑定 AltText.ai（API key 方式）。

截图预览

使用场景

新营销页上线后，对目标 URL 执行 `scrape_page`，将页面内嵌图片排队送入 AltText.ai 生成 alt 文本。
内容编辑持有 CDN 公网图址时，用 `create_image` 提交 URL，拿到生成结果后粘贴进 CMS 或 Markdown front matter。
站点改版前，用 `search_images` 按页面 URL 或 asset ID 检索图库，确认某张图是否已有 alt 记录再决定是否重建。
无障碍自查阶段，通过 `list_images` 与 `get_image` 对照线上页面引用的图片，查缺漏或错配的 alt 文案。