使用欧路词典OpenAPI，对生词本及笔记进行查询、修改等操作。

通过欧路词典OpenAPI管理生词本和笔记，实现查询、添加、修改、删除及语音评分功能。

Security Scan

该技能说明和运行指令总体上与欧路词典 OpenAPI 的用途一致，但存在元数据与运行时所需凭据不一致、来源未知与潜在账号修改权限的风险，应在信任凭据与授权行为前谨慎评估。

Purpose & Capability

SKILL.md 的接口列表、HTTP 方法与参数与‘管理生词本/笔记/语料’的描述一致——列出了查询、添加、修改、删除及语音评分等 API 调用。问题是元数据中未声明任何凭据或 primary credential，但文档明确要求使用 'Authorization: NIS {Token}'。此外 Skill 源与主页未知，降低可审计性。

Instruction Scope

运行时指令只描述对 https://api.frdic.com 的 curl 调用并使用 Authorization 头，未要求读取本地文件或访问其他第三方端点。指令包含有破坏性操作（DELETE、PATCH 等），这与技能目的相符但意味着一旦有有效 token，技能能修改或删除用户数据。

Install Mechanism

这是纯文本指令型技能（无安装脚本、无代码文件、无外部下载），因此没有写磁盘或执行远程安装的风险。

Credentials

SKILL.md 明确需要用户的 OpenAPI Token ('NIS {Token}')，但技能声明中没有要求任何环境变量或列出 primary credential —— 这是不一致且容易导致用户在运行时以不安全方式提供凭据。该 token 可用于读取和修改/删除生词本与笔记，权限范围较大，应当明确并最小化所需权限。

Persistence & Privilege

技能未设置 always:true（正常），但默认允许模型自动调用。结合技能会使用用户 API token 的事实，这意味着若授予 token 并允许自动调用，代理可能在未经额外确认的情况下对用户账户进行读写操作。

What to consider before installing

要不要安装/启用这个技能前请考虑： - 技能需要你的欧路词典 OpenAPI Token（格式为 'NIS {token}'）；授予后技能可以读取、添加、修改和删除你的生词本、笔记和语料。仅在你信任技能来源并愿意让其管理这些数据时才提供。 - 元数据未声明需要凭据且没有主页/来源信息，这降低了可审计性；最好只在知道并信任作者或源码的情况下继续。 - 如果可能，避免把长期有效的全权限 token 存在全局环境或让技能长期自动使用；优先在会话中一次性输入并在用毕后撤销/重置 token。 - 考虑要求技能仅在用户明确确认后才执行有写入/删除动作（关闭自动调用或在代理设置中限制自动化权限）。 - 若不确定来源，可选择不安装或联系技能发布者索取源码/主页以进一步审查。

欧路词典/法语助手/德语助手/西语助手 (Eudic OpenAPI)

本技能提供 欧路词典/法语助手/德语助手/西语助手OpenAPI 的调用能力，用于管理生词本、用户语料、笔记和语音评分等功能。

何时使用 (触发条件)

当用户提出以下类型的请求时，应使用本技能：

• "查看我的生词本"
• "添加单词到生词本"
• "查询某个单词"
• "查询我的语料"
• "按最近N天或是否已收藏筛选语料"
• "批量查询语料单词详情"
• "添加笔记"
• "查看笔记"
• "删除生词本/单词/笔记"

环境配置

获取 API Token

1. 访问 https://my.eudic.net/OpenAPI/Authorization 获取 API Token
2. 格式：NIS {token}

支持的语言与应用名称

语言	language 参数	应用名称
英语	en	欧路词典
法语	fr	法语助手
德语	de	德语助手
西班牙语	es	西语助手

注意: 调用 API 时需要通过 language query 参数指定语言。

---

核心功能与用法

1. 获取所有生词本

# language: en=欧路词典, fr=法语助手, de=德语助手, es=西语助手
curl -s "https://api.frdic.com/api/open/v1/studylist/category?language=en" \
  -H "Authorization: NIS {Token}"

参数:

• language: en/fr/de/es (必填)

返回: 生词本列表 (id, language, name, add_time)

---

2. 添加新生词本

curl -s -X POST "https://api.frdic.com/api/open/v1/studylist/category" \
  -H "Authorization: NIS {Token}" \
  -H "Content-Type: application/json" \
  -d '{"language": "en", "name": "新单词本"}'

参数:

• language: en/fr/de/es (必填)
• name: 生词本名称 (必填)

---

3. 重命名生词本

curl -s -X PATCH "https://api.frdic.com/api/open/v1/studylist/category" \
  -H "Authorization: NIS {Token}" \
  -H "Content-Type: application/json" \
  -d '{"id": "生词本ID", "language": "en", "name": "新名称"}'

参数:

• id: 生词本ID (必填)
• language: en/fr/de/es (必填)
• name: 新名称 (必填)

---

4. 删除生词本

curl -s -X DELETE "https://api.frdic.com/api/open/v1/studylist/category" \
  -H "Authorization: NIS {Token}" \
  -H "Content-Type: application/json" \
  -d '{"id": "生词本ID", "language": "en", "name": "生词本名称"}'

---

5. 获取生词本单词

curl -s "https://api.frdic.com/api/open/v1/studylist/words?language=en&category_id=0&page=1&page_size=100" \
  -H "Authorization: NIS {Token}"

参数:

• language: en/fr/de/es (必填)
• category_id: 生词本ID (必填)
• page: 页码 (可选，默认1)
• page_size: 每页数量 (可选，默认100)

返回: 单词列表 (word, phon, exp, add_time, star, context_line)

---

6. 批量添加单词

curl -s -X POST "https://api.frdic.com/api/open/v1/studylist/words" \
  -H "Authorization: NIS {Token}" \
  -H "Content-Type: application/json" \
  -d '{"language": "en", "category_id": "0", "words": ["apple", "banana", "orange"]}'

参数:

• language: en/fr/de/es (必填)
• category_id: 生词本ID (必填)
• words: 单词数组 (必填)

---

7. 删除单词

curl -s -X DELETE "https://api.frdic.com/api/open/v1/studylist/words" \
  -H "Authorization: NIS {Token}" \
  -H "Content-Type: application/json" \
  -d '{"language": "en", "category_id": "0", "words": ["apple"]}'

---

8. 新增单个单词

curl -s -X POST "https://api.frdic.com/api/open/v1/studylist/word" \
  -H "Authorization: NIS {Token}" \
  -H "Content-Type: application/json" \
  -d '{"language": "en", "word": "hello", "star": 2, "context_line": "Hello, how are you?"}'

参数:

• language: en/fr/de/es (必填)
• word: 单词 (必填)
• star: 星级 1-5 (可选)
• context_line: 语境例句 (可选)
• category_ids: 分组ID列表 (可选)

---

9. 查询单词

curl -s "https://api.frdic.com/api/open/v1/studylist/word?language=en&word=hello" \
  -H "Authorization: NIS {Token}"

参数:

• language: en/fr/de/es (必填)
• word: 单词 (必填)

返回: 单词详情

---

10. 获取笔记列表

curl -s "https://api.frdic.com/api/open/v1/studylist/notes?page=0&page_size=100" \
  -H "Authorization: NIS {Token}"

参数:

• page: 页码 (可选，默认0)
• page_size: 每页数量 (可选，默认100)

返回: 笔记列表 (word, note, language, add_time)

---

11. 查询用户语料列表

curl -s "https://api.frdic.com/api/open/v1/studylist/vocab_entries?language=en&recent_days=30&is_favorited=true&page=0&page_size=20" \
  -H "Authorization: NIS {Token}"

参数:

• language: en/fr/de/es (必填)
• recent_days: 最近N天 (可选，小于等于0表示不筛选)
• is_favorited: 是否已收藏到生词本 (可选，true 只看已收藏，false 只看未收藏)
• page: 页码 (可选，默认 -1；-1 表示不分页)
• page_size: 每页数量 (可选，默认100；仅在 page >= 0 时生效)

返回: 语料列表 (word, exp, add_time, rating, contexts)

---

12. 批量查询用户语料单词详情

curl -s -X POST "https://api.frdic.com/api/open/v1/studylist/vocab_words" \
  -H "Authorization: NIS {Token}" \
  -H "Content-Type: application/json" \
  -d '{"language": "en", "words": ["action", "amplify"]}'

参数:

• language: en/fr/de/es (必填)
• words: 单词数组 (必填，会自动忽略空白并去重)

返回: 单词详情列表 (word, exp, contexts)

---

13. 获取单个单词笔记

curl -s "https://api.frdic.com/api/open/v1/studylist/note?word=hello" \
  -H "Authorization: NIS {Token}"

参数:

• word: 单词 (必填)

返回:单词笔记不存在会返回404.存在会返回单词内容

14. 新增笔记

curl -s -X POST "https://api.frdic.com/api/open/v1/studylist/note" \
  -H "Authorization: NIS {Token}" \
  -H "Content-Type: application/json" \
  -d '{"word": "hello", "note": "这是笔记内容"}'

参数:

• word: 单词 (必填)
• note: 笔记内容 (必填)

---

15. 删除笔记

curl -s -X DELETE "https://api.frdic.com/api/open/v1/studylist/note" \
  -H "Authorization: NIS {Token}" \
  -H "Content-Type: application/json" \
  -d '{"word": "hello"}'

---

响应码

响应码	含义
200	成功 (GET)
201	创建/修改成功 (POST/PATCH)
204	删除成功 (DELETE)
400	参数错误
401	授权认证失败
403	访问过于频繁

流量限制

周期	限制次数	封停时间
1分钟	30次	1小时
30分钟	500次	24小时