Min Anki	Max Anki	Updated
24.06	25.12+	2026-08-25

AnkiForge AI

v0.16.0：先决定学什么，再制作卡片

v0.16.0 先根据四种学习目标和三档内容深度，确定材料中值得记忆的知识点，再制作卡片。语义覆盖、十种安全模板族、可选 DeckStyle 摘要、实验性 Knowledge Gap Preview 和审核快捷键均保持来源约束、人工审核与最终确认边界。

把自己的学习材料变成可审核、可安全写入的 Anki 卡片。

English

这是 Anki 桌面端插件，不是共享牌组，也不是网页服务。它不提供现成卡组；请不要在 Shared Decks 中搜索。

AnkiForge AI 是一个本地优先、中文优先的 AI 制卡工作台。你提供材料、选择学习目标，AI 只生成候选卡；本地质量检查和人工审核完成后，插件才会进入重复检查、写入预览和最终确认。

当前版本为 v0.16.0。本仓库中的完成状态不代表已自动发布到 AnkiWeb；发布仍需单独授权和真实 Anki 验收。

快速安装

通过 AnkiWeb

打开 Anki Desktop。
选择 工具 → 插件 → 获取插件。
输入插件代码 1227582295。
安装后重启 Anki，从牌组主页打开 AnkiForge AI；也可以使用 工具 → AnkiForge AI 或快捷键 Ctrl+Alt+F。

打开 AnkiWeb 页面 · 完整安装说明

从源码安装

git clone https://github.com/Gzx-070829/Ankiforge-ai.git

将 ankiforge_ai 文件夹复制到 Anki 的 addons21 目录，然后重启 Anki。

第一次制卡

在右上角打开 AI 设置，选择 Provider 和 Model，输入自己的 API key。
粘贴材料，或导入 v0.14 支持的本地文档；也可以先使用内置示例。
选择卡片模式和生成设置，主动点击生成。
逐张编辑、保留或丢弃候选卡。blocking 卡必须先修正或丢弃。
选择已有牌组、笔记类型和字段映射，执行重复检查。
查看写入摘要，并在最终确认后写入。建议第一次使用独立的测试牌组。

新手指南

产品能力

粘贴文本，以及 Markdown/TXT、Office、表格、HTML/JSON/XML、Notebook、EPUB、字幕与安全代码文件的选择/拖拽导入
PDF 安全 fallback；也可在“支持能力”中为本次会话明确选择已安装的 Docling / MarkItDown 本地后端，当前不内置 OCR
DeepSeek 与 OpenAI-compatible Provider；AI 设置留在独立 Modal
concept、definition、exam、quick_review、compare_contrast、process_steps、formula_rule 和 mistake_trap 八种公开模式；Cloze 仅保留内部 fail-closed 兼容检查，当前 UI 不开放
模板感知的生成提示，以及卡片数量、答案长度和输出语言控制
四种学习目标、Core / Standard / Detailed 三档深度，以及来源约束的知识规划与语义覆盖
默认关闭的 DeckStyle：仅汇总所选牌组最多 20 条 note，不读取完整卡片正文，也不修改旧卡
实验性的会话内 Knowledge Gap Preview：由用户自评影响本次计划，不是客观测量，也不持久化
完全本地、确定性的 card-quality 检查，统一使用 ready / review / blocked，并由版本化多学科 benchmark 做回归验证
安全、有限的来源证据，以及不会自动删除候选卡的本地近重复提示；Anki collection 查重仍是写入前门禁
pending → 编辑/复制/还原 → 保留/丢弃的 Review 工作台
Front / Back / Source 字段建议；不自动新增字段或修改笔记类型
重复检查、写入摘要、最终确认、来源标签、Tags 和最后写入批次摘要
中英文界面、可复现 .ankiaddon 打包和 forbidden-file 审计
仅保存语言、Provider/Model 和现有生成选项等非敏感 preferences；API key、Base URL、材料与审核/写入历史永不保存

安全与隐私

API key 仅在本次会话使用，保持 session-only，不写入 config、日志、文档或安装包。
插件不会自动调用 AI；只有你点击生成后，当前材料才会发送给所选 Provider。
AI 生成的只是候选卡，必须经过人工审核。
插件不会自动写入 Anki；写入前必须完成重复检查和最终确认。
可能重复的卡默认跳过；不会自动修改或删除已有 notes/cards、牌组、笔记类型或字段。
文件导入在本地完成；插件不上传文件，也不扫描 Obsidian vault。
质量提示不能保证事实正确或学习效果，你需要对最终卡片负责。
完整 Undo 仍未开放；当前只记录本次窗口的最后写入批次，不提供自动删除入口。

AI 设置与隐私 · 写入安全与追踪 · 隐私政策 · 安全报告

文档

开发与贡献

python -m unittest discover
python -m compileall .
python scripts/build_ankiaddon.py
git diff --check

欢迎提交 bug、文档改进和脱敏的 card-quality fixture。请先阅读 CONTRIBUTING.md 和 CODE_OF_CONDUCT.md，安全问题请按 SECURITY.md 私下报告。

状态

这是面向真实用户验收的 product-grade preview，仍要求逐张审核，不能无人值守运行。公开发布前仍需真实 Anki 安装、重复检查、取消确认和测试牌组写入验收。

AnkiForge AI - AI Card Maker for Anki(支持中文)

AnkiWeb

Maintenance

GitHub

Will it work on my Anki?

Similar addons

README