用 Python 生成 Anki 卡片

创建并激活虚拟环境，然后安装公开 PyPI 包：

python -m venv .venv
. .venv/bin/activate
python -m pip install ankiforge==0.3.1

Windows 使用 .venv\Scripts\Activate.ps1 激活。使用普通 CPython 3.11 或更高版本及匹配的平台 wheel；已有发布检查覆盖 CPython 3.11–3.14，参见已验证环境。

导出牌组

将以下程序保存为 main.py：

from ankiforge import Project, Note, BuildOptions

project = Project('spanish', default_deck='Spanish')
project.add('es:hola', Note.basic('hola', 'hello'))
output = project.build(BuildOptions.to('spanish.apkg'))
print(output.artifact.path)

python main.py

在 Anki 中打开持久保存的 spanish.apkg，其中 Spanish 牌组包含 hola → hello。后续编辑时保持命名空间 spanish 和笔记键 es:hola 不变。导出不需要安装 Anki。

继续学习

已有词汇表时，参考 CSV 转 Anki。需要根据原始笔记起草卡片时， 可从 AI 辅助制卡开始。

完整媒体与更新任务见 JSON 到 Anki。

• 图片与音频及 Python 媒体 API
• 自定义笔记类型和模板包
• 图片遮挡
• 比较与更新
• Python API及诊断
• 从 genanki 迁移

原生源码编译见源码构建。