---

name: lov-app-adapters description: > 定义各语音输入法与剪辑工具的词汇表读写映射：OpenLess、Typeless 等。本地 JSON 直接读写，API 走用户凭据只读探测，未知格式先探测不编造。Trigger: 读/写 OpenLess 词库、同步到 Typeless、适配剪映词库、app vocabulary adapter. license: MIT metadata: author: LovStudio / 手工川工作室 version: "0.1.1" card_standard: lovstudio/skill-card/v1 tags: - vocabulary - adapter - openless - typeless compatibility: "Portable Agent Skills format; reads local JSON or calls a vendor API with the user's own credential. Never persists credentials." dependencies: []

词库适配器 · 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

1. 确认目标 App 与读写方向（读入规范/写回 App）。
2. 本地 JSON（OpenLess）直接按字段映射读写；vocab_cli.py render 已内置 openless 映射。
3. 走 API 的（Typeless）用用户自己的凭据，仅做只读探测获取词条。不得在命令、日志或聊天中打印 token；查询用 auto=0/1 数字值并禁用缓存，避免字符串布尔导致空数据。
4. 格式未确认的 App（剪映）先探测真实存储与字段，确认后再补映射；未确认前标注"未确认"，不编造。

Dependencies

• Python 3.9+ 标准库；API 调用使用系统代理或用户既有网络。
• 需要用户授权访问其本地词库文件或账号凭据；凭据不持久化。