跳转至

AnkiBatch 使用教程

AnkiBatch 是一款 AI 驱动的 Anki 批量制卡工具，可以自动从文档中提取知识点并生成高质量的 Anki 卡片。

一、快速开始

1.1 首次配置

启动软件后，先进入「设置」标签页完成基础配置。

配置 AI 模型（必填）

推荐：获取 API Key 教程

如果您没有现成的 API Key，推荐使用稳定的大模型中转平台 智拓AI ( https://ai.ztough.cn )。

获取步骤：

  1. 访问平台：打开 https://ai.ztough.cn 并注册/登录
  2. 获取 Key：
  3. 进入控制台，在「令牌（Token）管理」页面创建一个新令牌
  4. 渠道选择：建议选择 Auto 以获得最佳稳定性 > 💡 渠道可根据需求自由选择，有些渠道价格低但速度会慢些
  5. 创建成功后，复制以 sk- 开头的密钥字符串
  6. 获取模型名称：
  7. 在平台的「模型广场」查看可用模型
  8. 复制您想使用的模型名称（例如 gemini-2.5-flash 或 gpt-5.1）
  9. 充值：如果余额不足，请在平台「钱包」页面进行充值

配置项说明：

  • 大模型地址：默认为 https://ai.ztough.cn/v1（使用智拓AI平台请保持此默认值）
  • 大模型密钥：粘贴您获取的 sk-... 密钥
  • 大模型名称：输入您在模型广场选择的模型名称（如 gemini-2.5-flash）
  • 温度：控制 AI 生成的随机性，推荐 0.7（越高越有创意，越低越稳定）
  • 多模态：如果您使用的模型支持图片理解（如 gemini-2.5-flash、gpt-5.1），开启后 AI 将能直接"看"到截图内容，识别效果远超传统 OCR

    ⚠️ 仅支持多模态大模型，普通文本模型请勿开启

系统提示词（可选）：

  • 自定义 AI 的出题风格和要求
  • 留空则使用默认提示词

基础设置

  • 分批处理：每次处理的页数（1-10页），建议 3-5 页
  • 字符截断：文本文件每次处理的字符数（1000-100000），建议 5000

1.2 制作第一张卡片

  1. 切换到「批量制卡」标签页
  2. 拖拽或点击选择文件（支持 PDF、Word、PPT、Excel、Markdown、TXT）
  3. 设置题型比例（默认全部为问答题）
  4. 选择页面范围（如 1-10 或 all）
  5. 选择输出文件保存位置
  6. 点击「开始处理」

二、核心功能详解

2.1 文件格式支持

格式 扩展名 处理方式
PDF .pdf 自动识别文字或 OCR 扫描件
Word .docx/.doc 转换为 PDF 后处理
PowerPoint .pptx/.ppt 转换为 PDF 后处理
Excel .xlsx/.xls 转换为 PDF 后处理
Markdown .md 直接文本处理
纯文本 .txt 直接文本处理

2.2 题型比例设置

在「批量制卡」页面可以调整五种题型的比例：

  • 问答题：简答/论述题，适合概念解释
  • 单选题：4 选 1，适合知识点判断
  • 多选题：5 选 2-5 个，适合多要素知识点
  • 判断题：对/错，适合是非判断
  • 填空题：挖空关键词，适合记忆要点

⚠️ 比例为 0 的题型不会生成，至少保留一种题型

2.3 页面范围选择

支持灵活的页面选择： - 留空 - 处理全部页面 - 5-10 - 处理第 5 到第 10 页 - 3,7 - 处理第3页和第7页

💡 对于 TXT/MD 文件，"页面"指的是按字符截断后的分块数

2.4 多模态识图模式

在「设置」→「大模型设置」中开启「多模态」开关：

开启后： - 直接将页面截图发送给 AI 识别 - 不进行文字识别（OCR） - 识别更准确，尤其适合图表、公式、复杂排版 - 要求模型支持视觉能力（如 gpt-5.2、gemini-2.5-flash等）

关闭时： - 先提取文字或 OCR 识别 - 再将文字发送给 AI - 适合纯文字内容，成本更低

💡 推荐多模态模型：智拓AI平台的 gemini-2.5-flash 性价比极高，识别准确且速度快

2.5 系统提示词自定义

在「设置」→「系统提示词」中可以自定义 AI 的出题风格：

示例场景：

请用英文出题，适合雅思考试备考

请侧重于代码示例，适合编程学习

💡 系统提示词优先级最高，但不能影响输出格式

三、高级技巧

3.1 批量处理大文件

对于超过 100 页的大文件： 1. 设置「分批处理」为 5-10 页 2. 每批处理完成后会自动保存，避免中途失败丢失进度

3.2 处理数学公式(请开启多模态才能准确识别到公式，需要支持视觉的模型)

软件支持 MathJax 公式渲染： - 行内公式：\(E = mc^2\) - 块级公式：\[x = \frac{-b \pm \sqrt{b^2-4ac}}{2a}\]

AI 会自动识别公式并使用正确格式输出。

3.3 处理已有题目

如果文档中已包含现成题目： - AI 会直接采纳原题目 - 自动补充缺失的答案和解析 - 保持原题格式不变

3.4 查看处理进度

处理过程中： - 进度条显示当前进度 - 完成后弹窗显示统计报告

3.5 中途停止

点击「停止处理」可立即终止： - 已生成的卡片会保存 - 未完成的批次会丢弃 - 可以重新开始处理

四、常见问题

4.1 AI 请求失败

可能原因： - API 地址或密钥错误 - 网络连接问题 - 模型不支持多模态（开启了多模态开关但模型不支持） - API 额度不足或余额不足

解决方法： 1. 检查「设置」中的 API 配置是否正确 2. 确认 API Key 是否有效（登录智拓AI平台查看余额） 3. 关闭多模态开关（如果模型不支持视觉功能） 4. 查看控制台日志获取详细错误信息 5. 软件会自动重试 3 次，如果仍失败请检查网络或更换模型

4.2 OCR 识别不准确

解决方法： - 开启「多模态」模式（需要支持视觉的模型） - 提高原文档的清晰度 - 在系统提示词中添加"请纠正识别错误的文字"

4.3 生成的题目质量不佳

优化方法： 1. 调整温度参数（降低温度提高稳定性，如设为 0.5-0.7） 2. 使用更强大的模型（如智拓AI平台的 gpt-5.2、gemini-3-pro-preview） 3. 在系统提示词中明确要求（如"请确保题目难度适中"、"请纠正识别错误"） 4. 调整题型比例，减少不适合的题型 5. 开启多模态模式（如果是图表、公式识别不准确）

4.4 卡片导入 Anki 失败

检查事项： - 确保 Anki 已安装 - 双击 .apkg 文件导入 - 如果提示模板冲突，选择"保留现有"或"覆盖"

4.5 软件最小化到托盘

点击关闭按钮会最小化到系统托盘： - 双击托盘图标恢复窗口 - 右键托盘图标 → 退出 完全关闭软件

五、最佳实践

5.1 推荐工作流程

  1. 准备阶段：整理学习资料为 PDF 或 Markdown
  2. 配置阶段：根据内容类型调整题型比例和系统提示词
  3. 测试阶段：先处理 1-5 页测试效果
  4. 批量处理：确认效果后处理完整文档
  5. 导入复习：将 .apkg 导入 Anki 开始复习

六、技术支持

  • 官网： https://ztough.cn
  • QQ 群：707617139

附录：快捷操作

操作 方法
选择文件 拖拽文件到窗口 / 点击选择
开始制卡 点击「开始处理」按钮
停止制卡 点击「停止处理」按钮
最小化到托盘 点击窗口关闭按钮
恢复窗口 双击托盘图标
完全退出 右键托盘图标 → 退出

祝你学习愉快！🎉