安装之前你可能想问的问题
kamishibai 适合谁？
适合准备长期、规律地做间隔重复的人——以月计，而不是两三个晚上。kamishibai 不是一门课程。它不挑主题，也不带你走教学大纲：你带来在书里、字幕里或对话中偶然遇到的单词，kamishibai 把它们变成卡片。
接下来交给 Anki：它自己决定今天出多少张卡，不让每日复习失控膨胀。复习间隔逐渐拉长——从几天到几周、几个月。
可以输入什么？
主要路径是单词清单：你选出需要的词义，kamishibai 为每一个写一条新例句。如果卡片内容已经写好，就以 cards JSON 格式传入：字段里放什么都行，只要符合模式——配音和图片由 kamishibai 自己补上。
Anki 做什么，kamishibai 做什么？
kamishibai 准备卡片，并打包成 .apkg 文件——Anki 的导入格式。Anki 负责安排复习、记录你的评分。如果需要实体卡片，kamishibai 还会生成 PDF：打印出来剪开即可。
需要会编程吗？
不需要。主要模式是终端里的分步 TUI：粘贴单词、选择词义、检查卡片、拿到牌组。JSON CLI 只是给脚本和外部智能体用的。
谁决定卡片上放什么？
你。在终端里你处理的是自己的单词：选择词义，决定保留哪些卡片。同样的工作可以交给智能体，但检查结果始终是你的事。
支持哪些语言？
EN、ZH、ES、JA、FR、DE、RU、IT、PT、EL 和 NL——任意配对。一次运行处理一个语言对。并非所有组合模型都掌握得同样好。如果需要其他语言，在 GitHub 上开一个 issue——我们看看能做什么。
运行之前需要准备什么？
一台电脑、生成期间的网络连接，以及你自己的 Gemini API 密钥——可以在 Google AI Studio 创建 → 复习需要 Anki → 第一次生成插图时，kamishibai 会补充下载 OCR 模型。
支持哪些系统？
macOS、Linux 和 Windows 都有预编译版本。Homebrew 适用于 macOS 和 Linux。Shell 安装脚本也可以在 Windows 的 Git Bash、MSYS 或 Cygwin 里运行。
要花多少钱？
kamishibai 本身免费且开源，但对 Gemini 的请求按你的密钥计费。生成 100 张卡片大约需要 $15。这只是粗略估计：最终金额取决于有多少卡片需要重新生成。模型不用你挑，已经配置好了：我尽量选择较新但价格适中的模型，并把卡片质量放在最省 token 之前。
一百张卡片意味着 100 条完整例句和几百个带语境的单词，通常够学一两个月。所以 kamishibai 最好用在你真正想记住的单词上。
单词和密钥会流向哪里？
会话、缓存和成品文件都在你的磁盘上。kamishibai 没有自己的服务器。生成通过 Gemini、用你的密钥进行，所以单词和例句会离开你的电脑。保存的密钥放在本地设置文件里，而不是系统的密钥管理器中。
生成的材料会出错吗？
会。模型可能选错词义的细微差别，可能在 IPA 上出错，配音也可能不理想。插图的质量和风格由 kamishibai 自己检查，失败的会重试——内置最多三次重试，所以 token 有时会多花一些。极少数情况下，一个单词可能用尽全部尝试而最终没有卡片。开始复习之前请检查牌组。
Agent Ready 到底是什么意思？
意思是这个工具不仅人可以用，Claude Code 之类的智能体也可以用。JSON CLI 的命令——new、select 或 exclude、generate、status、result——不需要交互输入，返回机器可读的结果，因此智能体可以异步调用它们，并行推进多个会话。命令的用法写在 llms.txt 里——把这个文件给智能体看就够了。
可以交给智能体的事：
- 为特定目标整理单词清单，
- 选择词义，
- 在导入前检查做好的卡片。
大批量时这很方便，但多余的检查和重新生成会增加 token 消耗和费用。
自带 JSON 有什么用？
当措辞必须完全出自你手时，自己的 cards JSON 就派上用场：现成的句子、小对话、课上学的表达。把内容传进来——kamishibai 补上配音和插图，然后打包成 APKG 和 PDF。严格的模式定义在 cards-json.md →
可以在手机上复习吗？
生成在电脑上进行。之后通常双击 .apkg 文件就够了：Anki 会打开并开始导入（如果没有，选择文件 → 导入）。牌组与手机的同步由 Anki 自己完成。
PDF 里没有复习计划，但可以做成纸质卡片：打印、剪开、对折。最重要或最难的句子可以摆在桌上——只是没有声音。
文本、配音和插图是谁生成的？
文本、配音和插图由 Gemini 系列模型生成。
一张卡片怎么都想不起来怎么办？
点「重来」，继续往下。评分的严格程度按自己的水平调整。刚开始时，只要记得句子的意思和关键词，冠词或介词错了也可以算过。等前 50 个句子学扎实了，再提高要求。
如果几个月后突然想不起一张熟悉的卡片，就点「重来」：往往正是这样一次失误之后，句子才被记得牢牢的。
什么时候能看到效果？
学扎实前 50 个句子之后，效果就开始显现：熟悉的句式回忆起来更轻松，语感也一点点建立起来——至少在这些句子所来自的领域里。