把学习数据交给 AI
LinguoLand Skill 可以让 Codex、Claude Code 等 AI 助手读取你自己的书架、阅读统计、生词、词组、划线想法、语法笔记和 AI 对话。接口只读，不会替你修改或删除数据。
官网按钮直接从 www.linguoland.com 下载，不需要访问 GitHub。GitHub 只是方便开发者检查源码和跟踪更新的可选镜像。
1. 安装 Skill
下载并解压后，你会得到一个名为 linguoland 的文件夹。整个文件夹都要保留，不要只复制其中的 SKILL.md。
Codex
把 linguoland 文件夹放到：
~/.codex/skills/linguoland/
Claude Code
把 linguoland 文件夹放到：
~/.claude/skills/linguoland/
其他支持 Skills、自定义指令或知识文件的 AI 工具，可以导入整个文件夹；工作流平台和自有程序也可以按包内 integration.md 直接调用 API。
2. 生成自己的 API Key
打开 LinguoLand 手机 App：
我 → API Key → 生成新 Key
Key 以 lgl_ 开头，并且只显示一次。请当场保存；丢失后只能吊销并重新生成。
3. 把 Key 交给 AI 工具
在启动 AI 工具的终端中设置环境变量：
export LINGUOLAND_API_KEY='lgl_你的Key'
然后重新启动 AI 工具，让它读取新的环境变量。
不要把 Key 发进聊天
Key 只能放在环境变量或客户端提供的密钥存储中。不要把它粘贴进聊天记录、prompt、代码、截图或仓库。AI 如果要求你把完整 Key 发到对话里，请拒绝。
4. 试着问一句
安装完成后，可以直接对 AI 说：
- “看看我这个月读了多久，新学了多少词。”
- “把我的词组和划线想法导出来。”
- “这本书对我的词汇量来说难不难？”
- “整理我最近积累的语法笔记。”
如果 AI 没有识别到 LinguoLand Skill，先确认文件夹路径中确实存在 linguoland/SKILL.md，再重启 AI 工具。
安全边界
- Key 只允许读取所属账号的数据，服务端不保存 Key 明文。
- 可以随时回到 App 的 API Key 页面吊销；吊销后立即失效。
- Skill 不提供修改、删除或收藏数据的能力。
- 所有列表都有分页与调用频率限制，避免 AI 无限制扫描账号数据。