lovstudio 词库适配器 · Vocabulary Adapters
把规范词库的字段映射成某款具体 App 的词汇表格式，并负责读写。映射是声明式的；读取目标 App 时只读、不覆盖对方已有词条。
Triggers
Activate when
- 用户要把词库导入/导出到 OpenLess、Typeless 或其它语音输入法。
- 用户提供了某款 App 的词汇表文件或接口，要求解析或转换。
- The user wants to read or write a specific app's vocabulary.
Do not activate when
- 用户只维护规范词库（交给 canonical-store）。
- 用户要决定哪些词推给哪些 App（交给 sync-plan）。
Adapter registry
| app | 存储 | 字段映射 | 状态 |
|---|---|---|---|
| openless | ~/Library/Application Support/OpenLess/dictionary.json |
phrase → phrase；note → note；enabled → enabled；hits → hits；createdAt → created_at | 已实测 |
| typeless | GET https://api.typeless.com/user/dictionary/list（Bearer 用户 token） |
phrase → term；category → category；lang → lang；auto → auto；replace → replace | 已实测 |
| capcut / 剪映 | 待探测 | 待探测 | 未确认 |
OpenLess 词条结构为 {id, phrase, note, enabled, hits, createdAt}；Typeless 词条结构为 {user_dictionary_id, term, lang, category, auto, replace, replace_targets, created_at, updated_at}。
Workflow
- 确认目标 App 与读写方向（读入规范/写回 App）。
- 本地 JSON（OpenLess）直接按字段映射读写；
vocab_cli.py render已内置 openless 映射。 - 走 API 的（Typeless）用用户自己的凭据，仅做只读探测获取词条。不得在命令、日志或聊天中打印 token；查询用
auto=0/1数字值并禁用缓存，避免字符串布尔导致空数据。 - 格式未确认的 App（剪映）先探测真实存储与字段，确认后再补映射；未确认前标注"未确认"，不编造。
Dependencies
- Python 3.9+ 标准库；API 调用使用系统代理或用户既有网络。
- 需要用户授权访问其本地词库文件或账号凭据；凭据不持久化。