插件，让 Shadowing 做更多事。

1. 下载

   点插件上的「下载」，得到一个 .zip。

2. 解压

   在“下载”文件夹里双击这个 zip，得到插件的文件夹，比如 youtube。

3. 从文件夹安装

   在 Shadowing 里打开 设置 → 插件，点「从文件夹安装…」，选刚才解压出的文件夹。

4. 看清楚再装

   设置里会列出插件是谁写的、会联网到哪里、会下载或运行什么，确认后点「安装」。不想用了，在同一个地方删除。

插件是运行在你 Mac 上的程序。应用不会把你的文件夹和钥匙串里的 Key 交给插件，但系统层面拦不住一个原生程序，所以这里只放审过源代码的插件。从别处拿到的插件，只装你信任的。

manifest.json：它是谁、程序在哪、接哪些链接、会联网到哪里

{
  "id": "podcast",
  "name": "播客导入",
  "version": "0.1.0",
  "protocol": 1,
  "minAppVersion": "0.9.0",
  "author": "你的名字",
  "description": "粘贴播客单集的链接，导入音频。",
  "main": { "darwin-arm64": "bin/podcast" },
  "contributes": {
    "importers": [{
      "id": "episode",
      "title": "播客",
      "match": ["https://*.example.fm/episodes/*"]
    }]
  },
  "permissions": {
    "network": ["example.fm"],
    "runs": "只下载这一集的音频"
  }
}

一次导入：先读出是什么，确认后再下载（→ 应用发出，← 插件回答）

→ initialize     { protocol, appVersion, dataDir }
← { "name": "播客导入", "version": "0.1.0" }
→ import/resolve { url, importer }
← { "title": "第 42 集", "duration": 1834.5, "subtitles": [] }
→ import/run     { url, importer, outDir, subtitles }
← progress       { "message": "下载音频", "done": 4200000, "total": 10800000 }
← { "files": [{ "path": "42.mp3", "kind": "audio" }] }

一个文件夹

manifest.json 加上程序（放在 bin/）。程序要能直接在 Mac 上运行：Rust、Go、Swift 编译出来的都行，Mac 自带的 shell 脚本也行。

几条消息

import/resolve 读出标题、时长、有哪些字幕，给用户确认；import/run 把音频和字幕下载到应用给的暂存文件夹，中间发 progress 报进度。出错时回一句中文，应用直接显示给用户。

应用替你收尾

插件只往暂存文件夹和自己的 data/ 写。应用检查下载的文件、用标题起好名字，再放进用户的文件夹；字幕存成可以移除的导入字幕。

现在能接的地方

从链接导入。导出（比如导出到 Anki）、查词典这些位置在计划中，接口按“以后还会有别的”设计。