自定义 AI 动作 - 在陪读蛙里打造属于你的 AI 阅读工作流

自定义 AI 动作，让陪读蛙变成你的专属 AI 工作台

阅读时，翻译只是第一步。很多时候，你还会想把一段内容改写得更容易理解，或者快速生成摘要、术语表，甚至输出一个方便复制到别处的结构化结果。

自定义 AI 动作就是为这个场景准备的。

你可以在陪读蛙里定义自己的提示词，并直接从划词工具栏运行。无论你正在看文章、文档还是教程，只要选中文本，就能立刻得到更贴合当前任务的 AI 结果。

你可以用它做什么

自定义 AI 动作既适合轻量小工具，也适合固定工作流：

• 把长段落总结成 3 条要点
• 用更简单的语言解释难句
• 把表达改写得更自然
• 提取术语和定义
• 生成便于复用的结构化输出
• 从选中文本生成学习卡片、提纲或待办事项

如果你本来就会针对不同任务切换不同模型，这个功能会让整个过程顺手很多。

现在要去哪里配置

按当前扩展源码，自定义 AI 动作有独立的设置页：

1. 打开陪读蛙设置页。
2. 在左侧边栏进入 自定义 AI 动作。
3. 先确认你已经启用了至少一个 LLM 提供商。

第三步很关键。因为这个功能依赖结构化输出，所以如果当前没有启用可用的 LLM 提供商，界面会直接阻止你新建动作。

现在内置了哪些模板

当前新增动作的弹窗里有 3 个模板：

• 词典：适合查词，返回词条、音标、词性、释义、段落内容、段落翻译和 CEFR 难度
• Improve Writing：适合改作文或润色，返回错误分析和改进后的版本
• Blank：空白模板，只给你一个默认结果字段，从头开始配

另外，扩展默认配置里已经内置了一个 Dictionary 动作，也就是 DEFAULT_CONFIG.selectionToolbar.customActions 里自带的默认词典动作。

所以从产品实际行为来看，自定义 AI 动作并不是“完全空白起步”的功能，它已经给了你一个明确的起点。

你现在能配置哪些字段

根据当前设置页源码，一个动作可以配置这些内容：

• 名称
• 图标（Iconify）
• 提供商
• 系统提示词
• 提示词
• 输出 Schema

其中输出 Schema 最关键。每个输出字段都可以配置：

• 字段名
• 字段类型：目前只有 string 和 number
• 字段描述
• 启用朗读

而且至少要有一个输出字段，字段名也不能重复。

提示词里现在能插哪些 token

当前代码里，系统提示词和提示词都支持插入 4 个 token：

• {{selection}}：当前选中的文本
• {{paragraphs}}：与选区相交的段落内容，会用空行拼接
• {{targetLanguage}}：用户当前设置的目标语言
• {{webTitle}}：网页标题

这里有一个很实用的实现细节：{{paragraphs}} 在真正发请求前，会被截断到前 2000 个字符。

这意味着你可以安全地把上下文段落放进提示词，但也要知道它不是无限长的全文上下文。

最终结果会怎么显示

自定义 AI 动作返回的不是一整坨自由文本，而是根据你的输出 Schema 生成一个结构化 JSON 对象。

扩展再把这个对象渲染回划词工具栏里的结果面板：

• 每个字段单独成行
• 字段名就是你的 Schema 标签
• string 和 number 会按字段类型展示
• 如果某个字段打开了 启用朗读，这个字段旁边还会出现朗读按钮

这也是它和普通 AI 聊天框最大的区别：你配置的是一个可以反复执行的结构化小工具。

一个更靠谱的入门配置

如果你第一次配置，建议不要一上来就做复杂工作流，直接从 Blank 开始，先做一个“阅读摘要”动作。

名称

阅读摘要

系统提示词

你是一个简洁的阅读助手。
请根据要求的结构化输出，对选中文本做总结。
优先使用具体、可执行的表达，不要空泛。

提示词

Selection: {{selection}}

Paragraphs: {{paragraphs}}

Target language: {{targetLanguage}}

Webpage title: {{webTitle}}

输出 Schema

• summary -> string
• keywords -> string
• nextSteps -> string

这样你马上就能得到一个可复用的阅读助手，而不是每次都手动复制文本去外部 AI 工具里重新写 prompt。

基于当前源码，我更推荐这样开始

如果你是第一次上手，最实用的顺序不是“先自由发挥”，而是：

• 想查词和理解上下文，就先用 词典
• 想改写或纠正文案，就先用 Improve Writing
• 已经明确知道自己要什么字段返回，再用 Blank

这更符合当前产品真正优化的方向：不是做一个大而泛的 AI 沙盒，而是做一组可以在划词工具栏里反复调用的小型结构化动作。