Yomitan与AnkiConnect集成问题排查指南

问题现象

用户在使用Yomitan浏览器扩展时，发现无法通过AnkiConnect将生词添加至Anki。具体表现为添加按钮（"+"）呈灰色不可用状态，尽管：

1. 浏览器能正常连接AnkiConnect
2. Yomitan扩展本身也能建立连接

核心原因分析

该问题通常由Anki卡片模板配置缺失引起。Yomitan需要通过AnkiConnect向指定牌组（Deck）和笔记类型（Note Model）添加内容，当这两项配置未完成时，系统会禁用添加功能作为保护机制。

解决方案

配置步骤

1. 打开Yomitan设置面板
2. 导航至Anki集成配置区域
3. 确保以下字段已正确填写：
   • 目标牌组：选择要添加卡片的Anki牌组名称
   • 笔记类型：选择匹配的Anki笔记模板

配置验证

完成配置后：

1. 检查AnkiConnect连接状态指示灯（通常显示为绿色）
2. 尝试选中页面文本，观察添加按钮是否变为可用状态
3. 测试添加简单词汇验证功能

技术实现原理

Yomitan通过以下流程与Anki交互：

1. 建立WebSocket连接至AnkiConnect
2. 验证API密钥（如配置）
3. 检查目标牌组和笔记模板是否存在
4. 只有当前三步验证通过后才会启用添加功能

高级排查建议

若问题持续存在：

1. 检查Anki日志是否存在连接错误
2. 确认AnkiConnect插件版本兼容性
3. 尝试在Anki中手动创建测试牌组和模板
4. 重启Anki及浏览器进程

用户界面优化建议

开发团队可考虑以下改进：

1. 在禁用按钮旁添加提示文字说明原因
2. 实现配置向导引导用户完成必要设置
3. 增加配置验证状态的可视化反馈

通过正确配置和系统验证，用户可充分利用Yomitan与AnkiConnect的协同工作流，实现高效的语言学习卡片管理。