1. “Superpowers”到底是哪个项目先别急着装凡是搜过“superpowers”的人大概都有过这种体验搜索结果是清一色的超能力、超级英雄、超级大国翻好几页都找不到一个能“安装”的东西。但如果你在开发者社区或日语学习圈子里混过一阵就会知道这个词组其实是一个真实存在的工具名而且不止一个项目叫这个名字。其中被搜索“想要安装”最多的是 VS Code 编辑器里的一款日语学习辅助扩展全名叫“Superpowers for Japanese Learning”一般直接搜 Superpowers 就能在扩展市场里找到。这个扩展做的事情说起来很朴素把 Anki、网页阅读、VS Code 编辑器这三样东西串起来让你在读日文网页、日文小说、日文脚本的时候随手就能把生词和例句做成 Anki 卡片然后按照记忆曲线复习。它不解决“背单词”这个动作本身但能把你从“遇到生词就手动查词典、手动做卡片、手动复制例句”这种重复劳动里解放出来。对于日语学习者尤其是靠着 Anki 维持日常单词量的人这款扩展的价值相当直接。除了 VS Code 这个版本之外开源社区里还有一个叫 Superpowers 的 HTML5 游戏创作平台以及 Chrome 商店里一个同名浏览器扩展功能跟日语学习没有半点关系。很多人装了以后发现“这跟我想要的不一样”其实就是装错了。所以先把目标搞清楚本文要讲的是 VS Code 下的 Superpowers 日语学习扩展从安装、配置到实际用起来一条线走完。2. 为什么需要这样一个工具使用场景拆解2.1 日语学习里最耗时的一环不是背是“做卡”用过 Anki 的人都知道Anki 本身只是一个卡片复习工具真正费时间的其实是卡片的生产过程。读日文网页的时候遇到一个不认识的词正常流程是复制句子打开词典查读音和释义切到 Anki 找到对应笔记本新建卡片把句子、单词、释义、读音填进对应字段有时候还要处理一下变形最后才能开始复习。一天读三五段日文新闻手动的取词做卡流程能占掉一大半学习时间。Superpowers 这个扩展的思路是把取词到做卡这一段尽可能自动化。它跑在 VS Code 里你把日文文本放进编辑器选中一个句子、一个段落甚至整篇文章通过快捷键调出命令面板它能自动完成分词、读音标注、从词典源拉取释义然后按你配置好的卡片模板直接写入本地 Anki。整个过程从几分钟压缩到十几秒而且卡片的字段格式是稳定的不会像手动做卡那样时好时坏。2.2 为什么选择 VS Code 而不是浏览器插件有些人会问读网页的时候直接在浏览器里点一下取词不更自然吗这里就涉及这个扩展的设计选择了。浏览器端做取词插件确实很多也有很成熟的比如各类划词翻译工具。但这类工具普遍的问题是它们倾向于“即时显示释义”看完就过了跟 Anki 之间的联动要么没有要么很浅。而 Superpowers 选择的路径是把 VS Code 当做一个“文本加工车间”强调批处理和卡片的可控性。VS Code 本身是一个文本编辑器处理日文原文、复制粘贴、批量选中、正则替换这些操作都非常顺手而且它有强大的命令系统可以自定义快捷键可以把一连串操作绑定到一个组合键上。实际用起来的感觉是你在浏览器里读文章看到有学习价值的段落复制到 VS Code一键生成卡片然后继续读下一篇。这个流程不打断阅读节奏又保证每一张卡都是经过你确认过的而不是那种“整页全抓下来、卡库爆炸”的模式。2.3 核心功能清单与实际学习闭环往细了说这个扩展的核心能力可以分成几块自动拆词与标记对日文文本进行分词识别汉字、假名、动词变形还原词典原形。注音辅助为汉字标注假名配读音信息方便不熟悉读音的学习者确认。卡片模板化输出按照你在 Anki 里建好的字段结构自动把单词、读音、释义、例句写入对应字段。Anki 桥接通过本机 AnkiConnect 接口写入 Anki不需要手动复制粘贴。自定义计划脚本支持 JavaScript 编写的自定义脚本可以对文本做项目特定的处理比如只提取 JLPT N2 以上词汇、过滤掉简单词等。整个学习闭环就变成了“读文章 → 批量选句 → 一键生成卡片 → 日常 Anki 复习”。这里面的每一步你都可以控制卡片最终长什么样而不是被工具牵着走。这也是我喜欢它的原因它不替你决定学什么只帮你把“想做卡”这个过程做到最快。3. 完整安装流程从装 VS Code 到连通 Anki3.1 环境准备Anki 与 AnkiConnect安装扩展本身不难但如果你的本机还没有 Anki那得先装好 Anki 桌面版。Superpowers 扩展本身不做间隔复习它只负责把数据写入 Anki 的数据库接口所以 Anki 是本机必须存在的组件。建议使用较新的 Anki 版本至少在 Anki 2.1 以上因为 AnkiConnect 插件对 2.1 之后的支持明显更好旧版本容易遇上兼容问题。Anki 安装好之后需要给 Anki 装上 AnkiConnect 插件。AnkiConnect 是一个为本机应用提供 HTTP API 的插件Superpowers 通过这个口子跟 Anki 通信。在 Anki 里打开“工具 → 插件 → 获取插件”输入 AnkiConnect 的代码即可以安装。装完以后不需要额外配置端口默认会跑在http://127.0.0.1:8765。需要注意的是AnkiConnect 默认只监听本机回环地址不会对外开放这个默认策略别去改它否则你的卡片数据就暴露到局域网了。3.2 安装 Superpowers 扩展本体打开 VS Code进入扩展面板快捷键CtrlShiftX或CmdShiftX搜索“Superpowers”。搜索结果里可能出现多个同名或名字相似的扩展认准Superpowers for Japanese Learning这个名称和对应的发布者我建议看一眼扩展详情页里的说明确认里面提到 Anki 和日语学习再装。点击“安装”之后VS Code 会提示重新加载窗口重载即可。装完扩展左侧活动栏应该多出一个 Superpowers 的图标点开它可以看到一个简单的面板里面会有当前连接状态、字典源状态、以及几个快捷按钮。如果面板上直接显示类似“Anki not connected”的红字说明 AnkiConnect 还没被 Superpowers 检测到别慌下一步就是解决连通问题。3.3 配置 Anki 连接与验证连通打开 VS Code 的设置Ctrl,或Cmd,点击右上角的“打开设置(JSON)”图标在用户配置里添加以下基础配置{ superpowers.ankiConnectURL: http://127.0.0.1:8765, superpowers.ankiDeck: 日语核心, superpowers.ankiModel: SuperpowersCard, superpowers.ankiFields: { Expression: {expression}, Reading: {reading}, Meaning: {meaning}, Example: {example} } }这里有几个字段我要解释一下。“deck” 和 “model” 不是随便填的deck 可以是 Anki 里已经存在的牌组名也可以让扩展帮你新建model 则对应卡片模板类型。如果你之前没有建过对应的模板建议先到 Anki 里手动新建一个牌组再按需配置字段。“ankiFields” 里的键名必须跟你 Anki 模板里的字段名完全一致不然卡片写入时字段会错位。配置保存之后回到 Superpowers 面板如果连接状态变成 “Anki connected”就说明扩展已经能跟 Anki 通信了。此时可以先做一个简单的测试在 VS Code 里新建一个文本文件输入一句日文比如 “今日は天気がいいですね”全选这句然后从命令面板CtrlShiftP运行 “Superpowers: Create New Anki Card”。几秒之后打开 Anki如果对应牌组里多出一张卡片且单词、读音、释义、例句都各归各位恭喜你整条流水线已经通了。3.4 安装过程中的几个易忽视细节这个安装过程看起来不长但有几个细节值得单独拎出来说。第一个是防火墙或者代理脚本的干扰。AnkiConnect 走的是本机 HTTP正常情况下不会有问题但如果你本机装了比较严格的安全软件或者开了系统代理偶尔会出现扩展能装上但连不上 Anki 的情况。排查方法很简单浏览器里直接访问http://127.0.0.1:8765如果浏览器都返回不了 AnkiConnect 的 JSON 响应那就是环境层面的问题跟扩展本身无关。第二个是 VS Code 版本太老的问题。这个扩展对 VS Code 的 API 有一定要求建议使用 1.80 以上版本太旧版本装上了也会出现命令找不到的情况。第三个是 Anki 如果正在同步或者占用了数据库写入卡片会延迟甚至失败。Anki 的同步锁和写入锁虽然是排队机制但为了保证流畅建议在批量做卡的间隙再同步不要在批量写入的同时频繁触发 Anki 同步。整体来说安装配置这一步只要把“Anki 装上 → AnkiConnect 装上 → VS Code 装上扩展 → 配置 JSON 指向同一个 deck/model”这四件事按顺序做好就没太大问题。真正的学习成本在后面的使用环节。4. 核心功能实操把一段日文变成一组 Anki 卡片4.1 文本处理和分词规则的理解Superpowers 的取词逻辑并不是简单的“按空格拆词”它对日文有一套分词模型能识别出汉字的边界、助词、活用词尾并且把动词的活用形还原到原形。比如你选中“食べた”它能分析出这是“食べる”的过去式于是卡片上的词条主词是“食べる”而不是“食べた”。这对做 Anki 卡片来说很重要因为按照原形做卡复习的时候才能真正理解这个词的变形路径。使用的时候不用管这些机制但在批量处理之前最好知道文本质量会直接影响分词结果。如果你从网页上复制的日文文本里混入了大量换行、全角空格、特殊符号分词器就容易出错。我的经验是把复制的文本先粘贴到 VS Code 里用查找替换把多余空格压掉再选中干净文本做卡片。别小看这个习惯处理越长的文本越能体会它的重要性。4.2 批量生成卡片与字段映射实际操作里最常用的流程是这样的打开 VS Code新建一个.txt文件把准备读的日文段落粘贴进去然后一段一段选中运行命令生成卡片。如果你是第一次用建议先选中一小段一到两句生成之后去 Anki 里看看卡片结构是不是符合预期再决定是否批量处理整篇文章。批量处理的时候扩展会在底部输出面板打印日志显示每张卡片的生成结果。如果某一句因为文本太短、全是假名没有汉字、或者分词后全是助词而无法生成有效卡片扩展会跳过该句并给出提示。这个设计很实用它不是每句话都硬塞成卡片而是让卡片列表保持在一个可复习的质量线上。字段映射的实际含义说起来有点像做表格模板。你在 Anki 里定义了五个字段扩展就往对应的位置塞内容。一旦模板字段跟配置里的字段名对不上常见表现是卡片生成了但 Anki 里只显示一堆空字段。遇到这种情况优先检查配置里superpowers.ankiFields的键名是否跟 Anki 卡片模板字段完全一致。另一个常见问题是字段内容携带格式符号比如换行符失效建议在配置里给例句字段加一个addNewlineTransform: true或者在模板字段层面处理换行。4.3 自定义快捷键把整套操作压成一个按键如果每次都用命令面板操作效率其实还是差点意思。这个扩展允许自定义快捷键来实现“选中文本 → 生成卡片”的一键完成。在 VS Code 的keybindings.json里加一行即可{ key: ctrlalta, command: superpowers.createCardFromSelection }我用的是CtrlAltA这个组合键因为它在左手附近选完文本手不用离开键盘就能按下。如果你经常需要一边看网页一边做卡建议把快捷键设置成顺手的位置比如CmdEnter也行但要确保不会跟其他扩展的快捷键冲突。配置完之后整个流程变成在浏览器里读到一段有价值的日文复制切到 VS Code粘贴选中句子按一下快捷键回 Anki 复习的时候卡片已经在里面了。看着是省了几次点击但在高频使用下这个体验差异会被放大非常大。我大概用了两周之后已经没法接受回到手动做卡的状态了。4.4 进阶用法只挑选特定难度词汇这个扩展支持通过自定义脚本过滤词汇一定程度上对不同的学习者可以定制卡片内容。最简单的做法是利用它内置的 JLPT 级别过滤器在配置里加一个superpowers.jlptFilter填上想要的下限或排除项。比如只保留 N2 和 N1 的词汇把 N3、N4、N5 的简单词直接过滤掉这样卡片库就不会被大量已知词淹没。但我要提醒一点JLPT 等级是一个参考值不代表你实际掌握情况。如果盲目过滤有可能把一些高频但你不熟悉的词漏掉。我的做法是先不过滤跑完一批卡片后在 Anki 里批量暂停掉那些我明显认识的简单词效果比事前过滤更精准。而且这样做也能帮助你发现“哦原来我以为自己认识这个词其实压根不知道它有这个用法”。5. 使用过程中的常见问题与解决方案5.1 AnkiConnect 连接失败这是装完以后最容易碰到的拦路虎现象就是扩展面板一直显示未连接。按顺序做以下检查确认 Anki 处于运行状态AnkiConnect 插件已安装且启用。浏览器访问http://127.0.0.1:8765预期能看到 JSON 格式的响应。如果浏览器都访问不通检查是否被本机防火墙拦截或者 Anki 的插件文件夹是否损坏。如果浏览器能访问但扩展还是连不上检查配置里的superpowers.ankiConnectURL是否多写了斜杠或空格。部分安全软件会拦截本机回环请求给 VS Code 相关进程添加白名单再试。这个排查路径从小到大基本覆盖九成以上连接问题。5.2 卡片生成了但 Anki 里是空的这种状态比连接失败更让人头疼因为看起来“流程是通的”。排查点集中在字段名和模板类型上打开 Anki 的“浏览”窗口查看这张空卡的笔记类型和字段结构。确认 Anki 模板里字段名和配置 JSON 中的键名一字不差包括大小写。检查字段内容是不是被写入到了错误字段比如释义跑到了发音字段里。如果字段里有多余的花括号或者模板标签没解析可能是 VS Code 里粘贴配置时引入了转义字符清理后重新写入配置。这个问题的根源百分之八十都是“模板字段名和配置键名没对齐”花两分钟对比一下就能解决。5.3 分词不准、注音异常日语文本的自动处理再智能也逃不过自然语言的复杂性。最容易出问题的是人名、地名、外来语、以及年轻人爱用的网络缩写。比如“キモい”这种缩写词或者“推し”这种流行语词典未必收录分词也可能拆得乱七八糟。我的处理方式是对这类特殊词不追求自动化一步到位选中句子后手动在生成的卡片上补充释义和读音。扩展提供了“编辑卡片”的入口可以在写入 Anki 之前修改字段用完这个功能相当于半自动半人工效率还是在的。另一个处理技巧是读完一整段再生成卡片不要让扩展逐字逐句生成太多低频、无学习价值的碎片卡。控制文本粒度本身就能减少分词错误率。5.4 常见问题速查总表我把日常使用里频率较高的问题整理成一个速查表方便直接对照排查问题现象常见原因解决方案扩展未连接 AnkiAnkiConnect 未启用或端口被占用重启 Anki浏览器验证接口通畅命令面板找不到 Superpowers 命令扩展未真正激活重载 VS Code 窗口确认扩展已安装卡片生成但 Anki 无数据模板字段与配置键名不一致打开 Anki 模板对照字段名汉字注音缺失分词模型未加载词典检查扩展更新或手动在卡片补读音批量生成卡顿文本过长、一次性生成的卡片过多分段处理每批控制在二三十句卡片变成纯假名无汉字分词过滤掉了汉字词调整过滤配置或者手动改卡片自定义脚本不生效脚本路径写错检查脚本路径和使用说明中的相对位置这个表不用全背下来真遇到了再来看能省下不少到处搜的时间。6. 其他同名项目与选择建议6.1 VS Code 日语扩展 vs Superpowers 游戏创作平台前面提到开源社区有一个叫 Superpowers 的 HTML5 游戏开发平台。这个项目的历史比 VS Code 扩展要早主打可视化编程、实时协作、Web 端发布。如果你是想做网页游戏搜到了这个项目也不奇怪但如果你的目标是日语学习那这个平台对你来说毫无帮助。这里给大家一个判别方法装之前看一眼项目主页或者扩展详情页的标签日语学习扩展必然会提到 Japanese、Anki、Vocabulary 这类词游戏平台必然提到 Game Development、3D、Real-time Collaboration。一秒就能分辨。6.2 对同款浏览器扩展的安全提醒Chrome 或 Edge 扩展商店里也出现过叫 Superpowers 的扩展功能是聚合各种 AI 服务到一个侧边栏界面看起来挺唬人。这里我不评价它的具体功能好坏但有个原则值得记住凡是要求读取“所有网站数据”的扩展安装之前都要多留个心眼尤其是那些并非来自知名开发者、也没有开源代码托管的扩展。浏览器扩展的权限比 VS Code 扩展大得多安装前查看权限列表和用户评价是最基本的自我保护。真正做日语学习VS Code 这个版本权限上收敛得多活动范围基本限制在 Anki 接口和编辑器内部用起来更安心。6.3 我的选择建议如果你日常学习路径是“读文章 Anki 复习”并且你已经习惯用 VS Code 做文本整理那这款扩展值得投入一段时间去适应。如果你是更偏向在手机上学日语、不做系统性自制卡片的人那它可能不是你的菜用手机上的即点即译工具反而更轻快。它不是一个面向所有人的工具它是为“想要自己掌握卡片质量”的学习者准备的。安装之前有一个小建议先在你的 Anki 里新建一个测试牌组把扩展的 deck 指向那个测试牌组用两三天时间跑通流程、摸清字段配置再正式切到主力牌组。这样即使配置有问题也不影响你正常的复习计划能最大限度地降低试错成本。7. 实操体验用了三个月之后的一点感想如果要说这套流程给我带来的最大变化我觉得不是“省了多少时间”而是它把“做卡片”从一件需要刻意安排的事情变成了一件随时随地可以顺手做的事。以前读日文文章遇到好句子想着“待会做完卡再继续读”结果常常一整篇文章读完了一张卡也没做现在反而是读到哪、选到哪、按一下快捷键卡片就已经躺在 Anki 里了。最后分享一个我踩过几次坑之后总结出的习惯每次批量导入之后不要在 Anki 里马上开始大规模复习先花一分钟扫一遍新卡把那些因为分词错误产生的不合理卡片删掉再进入正常复习节奏。这一步虽然看起来多花了时间但能防止错误卡片进入长期复习循环等你复习到第十遍才发现卡片内容有问题那才是真正浪费了时间。工具再智能也只是把你从一个重复劳动里解放出来的通道真正让卡片发挥作用的地方仍然是 Anki 里面的反复练习。这大概是我用 Superpowers 这段时间里最想对刚开始接触这套工具的人说的话。
Superpowers扩展指南：在VS Code中自动化生成日语Anki卡片
1. “Superpowers”到底是哪个项目先别急着装凡是搜过“superpowers”的人大概都有过这种体验搜索结果是清一色的超能力、超级英雄、超级大国翻好几页都找不到一个能“安装”的东西。但如果你在开发者社区或日语学习圈子里混过一阵就会知道这个词组其实是一个真实存在的工具名而且不止一个项目叫这个名字。其中被搜索“想要安装”最多的是 VS Code 编辑器里的一款日语学习辅助扩展全名叫“Superpowers for Japanese Learning”一般直接搜 Superpowers 就能在扩展市场里找到。这个扩展做的事情说起来很朴素把 Anki、网页阅读、VS Code 编辑器这三样东西串起来让你在读日文网页、日文小说、日文脚本的时候随手就能把生词和例句做成 Anki 卡片然后按照记忆曲线复习。它不解决“背单词”这个动作本身但能把你从“遇到生词就手动查词典、手动做卡片、手动复制例句”这种重复劳动里解放出来。对于日语学习者尤其是靠着 Anki 维持日常单词量的人这款扩展的价值相当直接。除了 VS Code 这个版本之外开源社区里还有一个叫 Superpowers 的 HTML5 游戏创作平台以及 Chrome 商店里一个同名浏览器扩展功能跟日语学习没有半点关系。很多人装了以后发现“这跟我想要的不一样”其实就是装错了。所以先把目标搞清楚本文要讲的是 VS Code 下的 Superpowers 日语学习扩展从安装、配置到实际用起来一条线走完。2. 为什么需要这样一个工具使用场景拆解2.1 日语学习里最耗时的一环不是背是“做卡”用过 Anki 的人都知道Anki 本身只是一个卡片复习工具真正费时间的其实是卡片的生产过程。读日文网页的时候遇到一个不认识的词正常流程是复制句子打开词典查读音和释义切到 Anki 找到对应笔记本新建卡片把句子、单词、释义、读音填进对应字段有时候还要处理一下变形最后才能开始复习。一天读三五段日文新闻手动的取词做卡流程能占掉一大半学习时间。Superpowers 这个扩展的思路是把取词到做卡这一段尽可能自动化。它跑在 VS Code 里你把日文文本放进编辑器选中一个句子、一个段落甚至整篇文章通过快捷键调出命令面板它能自动完成分词、读音标注、从词典源拉取释义然后按你配置好的卡片模板直接写入本地 Anki。整个过程从几分钟压缩到十几秒而且卡片的字段格式是稳定的不会像手动做卡那样时好时坏。2.2 为什么选择 VS Code 而不是浏览器插件有些人会问读网页的时候直接在浏览器里点一下取词不更自然吗这里就涉及这个扩展的设计选择了。浏览器端做取词插件确实很多也有很成熟的比如各类划词翻译工具。但这类工具普遍的问题是它们倾向于“即时显示释义”看完就过了跟 Anki 之间的联动要么没有要么很浅。而 Superpowers 选择的路径是把 VS Code 当做一个“文本加工车间”强调批处理和卡片的可控性。VS Code 本身是一个文本编辑器处理日文原文、复制粘贴、批量选中、正则替换这些操作都非常顺手而且它有强大的命令系统可以自定义快捷键可以把一连串操作绑定到一个组合键上。实际用起来的感觉是你在浏览器里读文章看到有学习价值的段落复制到 VS Code一键生成卡片然后继续读下一篇。这个流程不打断阅读节奏又保证每一张卡都是经过你确认过的而不是那种“整页全抓下来、卡库爆炸”的模式。2.3 核心功能清单与实际学习闭环往细了说这个扩展的核心能力可以分成几块自动拆词与标记对日文文本进行分词识别汉字、假名、动词变形还原词典原形。注音辅助为汉字标注假名配读音信息方便不熟悉读音的学习者确认。卡片模板化输出按照你在 Anki 里建好的字段结构自动把单词、读音、释义、例句写入对应字段。Anki 桥接通过本机 AnkiConnect 接口写入 Anki不需要手动复制粘贴。自定义计划脚本支持 JavaScript 编写的自定义脚本可以对文本做项目特定的处理比如只提取 JLPT N2 以上词汇、过滤掉简单词等。整个学习闭环就变成了“读文章 → 批量选句 → 一键生成卡片 → 日常 Anki 复习”。这里面的每一步你都可以控制卡片最终长什么样而不是被工具牵着走。这也是我喜欢它的原因它不替你决定学什么只帮你把“想做卡”这个过程做到最快。3. 完整安装流程从装 VS Code 到连通 Anki3.1 环境准备Anki 与 AnkiConnect安装扩展本身不难但如果你的本机还没有 Anki那得先装好 Anki 桌面版。Superpowers 扩展本身不做间隔复习它只负责把数据写入 Anki 的数据库接口所以 Anki 是本机必须存在的组件。建议使用较新的 Anki 版本至少在 Anki 2.1 以上因为 AnkiConnect 插件对 2.1 之后的支持明显更好旧版本容易遇上兼容问题。Anki 安装好之后需要给 Anki 装上 AnkiConnect 插件。AnkiConnect 是一个为本机应用提供 HTTP API 的插件Superpowers 通过这个口子跟 Anki 通信。在 Anki 里打开“工具 → 插件 → 获取插件”输入 AnkiConnect 的代码即可以安装。装完以后不需要额外配置端口默认会跑在http://127.0.0.1:8765。需要注意的是AnkiConnect 默认只监听本机回环地址不会对外开放这个默认策略别去改它否则你的卡片数据就暴露到局域网了。3.2 安装 Superpowers 扩展本体打开 VS Code进入扩展面板快捷键CtrlShiftX或CmdShiftX搜索“Superpowers”。搜索结果里可能出现多个同名或名字相似的扩展认准Superpowers for Japanese Learning这个名称和对应的发布者我建议看一眼扩展详情页里的说明确认里面提到 Anki 和日语学习再装。点击“安装”之后VS Code 会提示重新加载窗口重载即可。装完扩展左侧活动栏应该多出一个 Superpowers 的图标点开它可以看到一个简单的面板里面会有当前连接状态、字典源状态、以及几个快捷按钮。如果面板上直接显示类似“Anki not connected”的红字说明 AnkiConnect 还没被 Superpowers 检测到别慌下一步就是解决连通问题。3.3 配置 Anki 连接与验证连通打开 VS Code 的设置Ctrl,或Cmd,点击右上角的“打开设置(JSON)”图标在用户配置里添加以下基础配置{ superpowers.ankiConnectURL: http://127.0.0.1:8765, superpowers.ankiDeck: 日语核心, superpowers.ankiModel: SuperpowersCard, superpowers.ankiFields: { Expression: {expression}, Reading: {reading}, Meaning: {meaning}, Example: {example} } }这里有几个字段我要解释一下。“deck” 和 “model” 不是随便填的deck 可以是 Anki 里已经存在的牌组名也可以让扩展帮你新建model 则对应卡片模板类型。如果你之前没有建过对应的模板建议先到 Anki 里手动新建一个牌组再按需配置字段。“ankiFields” 里的键名必须跟你 Anki 模板里的字段名完全一致不然卡片写入时字段会错位。配置保存之后回到 Superpowers 面板如果连接状态变成 “Anki connected”就说明扩展已经能跟 Anki 通信了。此时可以先做一个简单的测试在 VS Code 里新建一个文本文件输入一句日文比如 “今日は天気がいいですね”全选这句然后从命令面板CtrlShiftP运行 “Superpowers: Create New Anki Card”。几秒之后打开 Anki如果对应牌组里多出一张卡片且单词、读音、释义、例句都各归各位恭喜你整条流水线已经通了。3.4 安装过程中的几个易忽视细节这个安装过程看起来不长但有几个细节值得单独拎出来说。第一个是防火墙或者代理脚本的干扰。AnkiConnect 走的是本机 HTTP正常情况下不会有问题但如果你本机装了比较严格的安全软件或者开了系统代理偶尔会出现扩展能装上但连不上 Anki 的情况。排查方法很简单浏览器里直接访问http://127.0.0.1:8765如果浏览器都返回不了 AnkiConnect 的 JSON 响应那就是环境层面的问题跟扩展本身无关。第二个是 VS Code 版本太老的问题。这个扩展对 VS Code 的 API 有一定要求建议使用 1.80 以上版本太旧版本装上了也会出现命令找不到的情况。第三个是 Anki 如果正在同步或者占用了数据库写入卡片会延迟甚至失败。Anki 的同步锁和写入锁虽然是排队机制但为了保证流畅建议在批量做卡的间隙再同步不要在批量写入的同时频繁触发 Anki 同步。整体来说安装配置这一步只要把“Anki 装上 → AnkiConnect 装上 → VS Code 装上扩展 → 配置 JSON 指向同一个 deck/model”这四件事按顺序做好就没太大问题。真正的学习成本在后面的使用环节。4. 核心功能实操把一段日文变成一组 Anki 卡片4.1 文本处理和分词规则的理解Superpowers 的取词逻辑并不是简单的“按空格拆词”它对日文有一套分词模型能识别出汉字的边界、助词、活用词尾并且把动词的活用形还原到原形。比如你选中“食べた”它能分析出这是“食べる”的过去式于是卡片上的词条主词是“食べる”而不是“食べた”。这对做 Anki 卡片来说很重要因为按照原形做卡复习的时候才能真正理解这个词的变形路径。使用的时候不用管这些机制但在批量处理之前最好知道文本质量会直接影响分词结果。如果你从网页上复制的日文文本里混入了大量换行、全角空格、特殊符号分词器就容易出错。我的经验是把复制的文本先粘贴到 VS Code 里用查找替换把多余空格压掉再选中干净文本做卡片。别小看这个习惯处理越长的文本越能体会它的重要性。4.2 批量生成卡片与字段映射实际操作里最常用的流程是这样的打开 VS Code新建一个.txt文件把准备读的日文段落粘贴进去然后一段一段选中运行命令生成卡片。如果你是第一次用建议先选中一小段一到两句生成之后去 Anki 里看看卡片结构是不是符合预期再决定是否批量处理整篇文章。批量处理的时候扩展会在底部输出面板打印日志显示每张卡片的生成结果。如果某一句因为文本太短、全是假名没有汉字、或者分词后全是助词而无法生成有效卡片扩展会跳过该句并给出提示。这个设计很实用它不是每句话都硬塞成卡片而是让卡片列表保持在一个可复习的质量线上。字段映射的实际含义说起来有点像做表格模板。你在 Anki 里定义了五个字段扩展就往对应的位置塞内容。一旦模板字段跟配置里的字段名对不上常见表现是卡片生成了但 Anki 里只显示一堆空字段。遇到这种情况优先检查配置里superpowers.ankiFields的键名是否跟 Anki 卡片模板字段完全一致。另一个常见问题是字段内容携带格式符号比如换行符失效建议在配置里给例句字段加一个addNewlineTransform: true或者在模板字段层面处理换行。4.3 自定义快捷键把整套操作压成一个按键如果每次都用命令面板操作效率其实还是差点意思。这个扩展允许自定义快捷键来实现“选中文本 → 生成卡片”的一键完成。在 VS Code 的keybindings.json里加一行即可{ key: ctrlalta, command: superpowers.createCardFromSelection }我用的是CtrlAltA这个组合键因为它在左手附近选完文本手不用离开键盘就能按下。如果你经常需要一边看网页一边做卡建议把快捷键设置成顺手的位置比如CmdEnter也行但要确保不会跟其他扩展的快捷键冲突。配置完之后整个流程变成在浏览器里读到一段有价值的日文复制切到 VS Code粘贴选中句子按一下快捷键回 Anki 复习的时候卡片已经在里面了。看着是省了几次点击但在高频使用下这个体验差异会被放大非常大。我大概用了两周之后已经没法接受回到手动做卡的状态了。4.4 进阶用法只挑选特定难度词汇这个扩展支持通过自定义脚本过滤词汇一定程度上对不同的学习者可以定制卡片内容。最简单的做法是利用它内置的 JLPT 级别过滤器在配置里加一个superpowers.jlptFilter填上想要的下限或排除项。比如只保留 N2 和 N1 的词汇把 N3、N4、N5 的简单词直接过滤掉这样卡片库就不会被大量已知词淹没。但我要提醒一点JLPT 等级是一个参考值不代表你实际掌握情况。如果盲目过滤有可能把一些高频但你不熟悉的词漏掉。我的做法是先不过滤跑完一批卡片后在 Anki 里批量暂停掉那些我明显认识的简单词效果比事前过滤更精准。而且这样做也能帮助你发现“哦原来我以为自己认识这个词其实压根不知道它有这个用法”。5. 使用过程中的常见问题与解决方案5.1 AnkiConnect 连接失败这是装完以后最容易碰到的拦路虎现象就是扩展面板一直显示未连接。按顺序做以下检查确认 Anki 处于运行状态AnkiConnect 插件已安装且启用。浏览器访问http://127.0.0.1:8765预期能看到 JSON 格式的响应。如果浏览器都访问不通检查是否被本机防火墙拦截或者 Anki 的插件文件夹是否损坏。如果浏览器能访问但扩展还是连不上检查配置里的superpowers.ankiConnectURL是否多写了斜杠或空格。部分安全软件会拦截本机回环请求给 VS Code 相关进程添加白名单再试。这个排查路径从小到大基本覆盖九成以上连接问题。5.2 卡片生成了但 Anki 里是空的这种状态比连接失败更让人头疼因为看起来“流程是通的”。排查点集中在字段名和模板类型上打开 Anki 的“浏览”窗口查看这张空卡的笔记类型和字段结构。确认 Anki 模板里字段名和配置 JSON 中的键名一字不差包括大小写。检查字段内容是不是被写入到了错误字段比如释义跑到了发音字段里。如果字段里有多余的花括号或者模板标签没解析可能是 VS Code 里粘贴配置时引入了转义字符清理后重新写入配置。这个问题的根源百分之八十都是“模板字段名和配置键名没对齐”花两分钟对比一下就能解决。5.3 分词不准、注音异常日语文本的自动处理再智能也逃不过自然语言的复杂性。最容易出问题的是人名、地名、外来语、以及年轻人爱用的网络缩写。比如“キモい”这种缩写词或者“推し”这种流行语词典未必收录分词也可能拆得乱七八糟。我的处理方式是对这类特殊词不追求自动化一步到位选中句子后手动在生成的卡片上补充释义和读音。扩展提供了“编辑卡片”的入口可以在写入 Anki 之前修改字段用完这个功能相当于半自动半人工效率还是在的。另一个处理技巧是读完一整段再生成卡片不要让扩展逐字逐句生成太多低频、无学习价值的碎片卡。控制文本粒度本身就能减少分词错误率。5.4 常见问题速查总表我把日常使用里频率较高的问题整理成一个速查表方便直接对照排查问题现象常见原因解决方案扩展未连接 AnkiAnkiConnect 未启用或端口被占用重启 Anki浏览器验证接口通畅命令面板找不到 Superpowers 命令扩展未真正激活重载 VS Code 窗口确认扩展已安装卡片生成但 Anki 无数据模板字段与配置键名不一致打开 Anki 模板对照字段名汉字注音缺失分词模型未加载词典检查扩展更新或手动在卡片补读音批量生成卡顿文本过长、一次性生成的卡片过多分段处理每批控制在二三十句卡片变成纯假名无汉字分词过滤掉了汉字词调整过滤配置或者手动改卡片自定义脚本不生效脚本路径写错检查脚本路径和使用说明中的相对位置这个表不用全背下来真遇到了再来看能省下不少到处搜的时间。6. 其他同名项目与选择建议6.1 VS Code 日语扩展 vs Superpowers 游戏创作平台前面提到开源社区有一个叫 Superpowers 的 HTML5 游戏开发平台。这个项目的历史比 VS Code 扩展要早主打可视化编程、实时协作、Web 端发布。如果你是想做网页游戏搜到了这个项目也不奇怪但如果你的目标是日语学习那这个平台对你来说毫无帮助。这里给大家一个判别方法装之前看一眼项目主页或者扩展详情页的标签日语学习扩展必然会提到 Japanese、Anki、Vocabulary 这类词游戏平台必然提到 Game Development、3D、Real-time Collaboration。一秒就能分辨。6.2 对同款浏览器扩展的安全提醒Chrome 或 Edge 扩展商店里也出现过叫 Superpowers 的扩展功能是聚合各种 AI 服务到一个侧边栏界面看起来挺唬人。这里我不评价它的具体功能好坏但有个原则值得记住凡是要求读取“所有网站数据”的扩展安装之前都要多留个心眼尤其是那些并非来自知名开发者、也没有开源代码托管的扩展。浏览器扩展的权限比 VS Code 扩展大得多安装前查看权限列表和用户评价是最基本的自我保护。真正做日语学习VS Code 这个版本权限上收敛得多活动范围基本限制在 Anki 接口和编辑器内部用起来更安心。6.3 我的选择建议如果你日常学习路径是“读文章 Anki 复习”并且你已经习惯用 VS Code 做文本整理那这款扩展值得投入一段时间去适应。如果你是更偏向在手机上学日语、不做系统性自制卡片的人那它可能不是你的菜用手机上的即点即译工具反而更轻快。它不是一个面向所有人的工具它是为“想要自己掌握卡片质量”的学习者准备的。安装之前有一个小建议先在你的 Anki 里新建一个测试牌组把扩展的 deck 指向那个测试牌组用两三天时间跑通流程、摸清字段配置再正式切到主力牌组。这样即使配置有问题也不影响你正常的复习计划能最大限度地降低试错成本。7. 实操体验用了三个月之后的一点感想如果要说这套流程给我带来的最大变化我觉得不是“省了多少时间”而是它把“做卡片”从一件需要刻意安排的事情变成了一件随时随地可以顺手做的事。以前读日文文章遇到好句子想着“待会做完卡再继续读”结果常常一整篇文章读完了一张卡也没做现在反而是读到哪、选到哪、按一下快捷键卡片就已经躺在 Anki 里了。最后分享一个我踩过几次坑之后总结出的习惯每次批量导入之后不要在 Anki 里马上开始大规模复习先花一分钟扫一遍新卡把那些因为分词错误产生的不合理卡片删掉再进入正常复习节奏。这一步虽然看起来多花了时间但能防止错误卡片进入长期复习循环等你复习到第十遍才发现卡片内容有问题那才是真正浪费了时间。工具再智能也只是把你从一个重复劳动里解放出来的通道真正让卡片发挥作用的地方仍然是 Anki 里面的反复练习。这大概是我用 Superpowers 这段时间里最想对刚开始接触这套工具的人说的话。