基本用法 🧰

如果说 16 AI 代理讲的是“这是什么”，那从这里开始讲的就是“怎么把它用到 200%”。先从最该学会的基本功开始吧！（仅限桌面版）

← 回首页：ObsiKO 101 · 上一层：16 AI 代理

代理不是“聊天机器人”，而是“工作伙伴”

ObsiKO 的代理不是只会回话的聊天机器人，而是直接在你的笔记库里读写文件的工作伙伴。懂了这个差别，就能发挥 200% 的功力。

像“帮我整理○○／帮我写草稿／帮我做成表格”这样要它做出成果时 → 不会在对话里写一大串，而是保存为干净的 .md 文件，只告诉你一行摘要。
“这是什么？／要怎么做？”这类简短的问题、说明，就直接在对话里回答。
所以需要成果时，动词要说清楚 — 用“帮我写／帮我做／帮我整理”来拜托它。

按下输入框下方工具栏的引擎按钮 (✨)，菜单会往上展开 — 在 Claude／Gemini／Codex 之间挑选。
扫描 PDF 的 OCR、看图片仅限 Claude，其他资料搜集、搜索工具三个引擎大多都能用。不过 Codex 要在选项 (≡) 打开“把 obsiko 工具连给 Codex”才会接上这些工具（默认关闭）。🪟 Windows 上看不到 Gemini 代理引擎 — Gemini 请填入 API 密钥、当对话引擎用。
就算是同一个要求，每个引擎的语气、强项也有点不同。卡住的时候换个引擎试试也是个办法！→ 各引擎说明请看 16 AI 代理

在输入框只要打 /，就会跳出各领域的助手清单（写作、读书、资料搜集、结构化等）。
在笔记库创建 Markdown 文件，也能加入自己的命令。文件夹有两个 — .claude/commands/（仅限桌面版代理，兼容 Claude Code）／_ObsiKO/commands/（桌面版 + 手机、网页版对话都能用）。想在哪里都能用，就放在 _ObsiKO/commands/（同名时以这边为准）。
详细的命令清单请看 16 AI 代理，写作命令请看 16-3 写作与创作应用。

代理只在当前的笔记库里活动。碰笔记库外面的文件、运行危险的命令，ObsiKO 都会挡下来。
修改文件后会更新文件树给你看；你正在编辑（还没存盘）的文件不会被随便覆盖，而是先发出警告。
还原安全网：不喜欢 AI 改的内容时，可以在右侧边栏的时钟图标（AI 变更记录）按每次运行比较变更前／后并还原（单一文件或全部，三个引擎都支持）。→ 16 AI 代理

要求越具体，结果越好。与其说“帮我整理”→ 不如说“以○○为标准、用△△格式、附上出处帮我整理”。
指定输出格式 — “做成表格”“列成清单”“300 字以内”“做成检查清单”。
中途停下来就说“请接着做” — 长的工作会分段进行。
省 Token 模式（面板选项 (≡) 菜单的“代理 Token 优化”，默认打开）：平常会简洁回答，说“详细一点／深入一点／写长一点”就会回答得比较长。
自己检查的循环（Claude，面板选项 (≡) →“循环”）：代理每次保存笔记，都会自己检查、修正语法，结束时再做最后检查。质量很重要的话，连评论者循环也打开；想让它咬住不放、做到最后，就打开无限尝试（会有 Token 警告）。→ 16 AI 代理
免费的外部工具（pandoc、whisper、yt-dlp、poppler）只有在你要用那个功能时，才会跳出一行安装说明。不必事先安装。（转录就算没有 whisper，只要有 OpenAI／Gemini API 密钥就会走云端 — whisper 是选用的！）
结果不满意的话，像“再短一点／再简单一点／加上例子／换个语气”这样用一句话再拜托一次就行。