让 AI 替你写教程

一句话产出带标注的教程图

本章功能需要 v0.1.2 及以上版本的 CLI/Skill（once status --json 的 version 字段可查）。

上一章 AI 已经会截图取字了，这一章再往前一步：让它把操作过程写成图文教程。你只要说「帮我把刚才的操作写成教程」，AI 就会自动完成截图、取字、标注、成稿——就像你现在读的这套官方教程，配图全部由这条产线自己产出。

原理：一条产线，三个命令

AI 写教程靠的是定影的三个命令串成链：

once capture window --json                    # ① 拍下每一步的画面
once ocr last --json                          # ② 读出画面文字和坐标
once annotate last --script ops.json --out out.png   # ③ 按坐标画标注

关键在 ②：取字结果自带每个文字块的坐标框，AI 据此精确画出「箭头指向哪个按钮、序号标在哪一步」——不需要它真的「看懂」图片。

安装：一条命令

curl -fsSL --retry 3 https://github.com/wample0105/apo-once-glance/releases/latest/download/install.sh | bash

这条命令会同时装好 once 命令行和 onceglance-tutorial Skill（教程写作工作流）到通用 Agent Skills 目录。装完在 Agent 里说：

帮我确认 onceglance-tutorial skill 已安装

实战：一句话产教程

对装好 Skill 的 Agent 说：

我马上要在系统设置里关闭 HDR，请跟着我的操作写一篇带标注图文的教程

然后你正常操作，Agent 会：

每完成一步自动截一张图（或让你按 Alt+Shift+A 后它取最近一张）；
从图里读出按钮文字和位置；
按「红框圈重点 + 序号标步骤 + 中文指令签」的规范给每张图加标注；
输出一篇 Markdown 教程，图片引用本地相对路径。

产出的教程直接可用：发群、发文档、贴博客都行。

标注风格：继承你的主题

AI 画标注不自带样式——颜色、线宽、序号样式全部继承你在定影里调好的标注主题。你平时怎么标，AI 就怎么标，产出的图和你的手笔一致。

想固定某种风格批量出图？在标注主题页把默认值调好即可，不用在指令里写死任何颜色参数。

下一步

到附录查阅快捷键总表、CLI/MCP 速查、常见问题——按需回来翻。