插件体系
BokeBox 把可替换能力拆成四类插件，共用 plugin-kit（启停、配置、清单加载），业务接口按能力区分。
四类插件
| 类型 | 作用 | 目录 | 文档 |
|---|---|---|---|
| Source | 内容获取 → 统一 SourceArtifact | storage/plugins/source/ | 说明 · 开发 |
| ASR | 语音转写 | storage/plugins/asr/ | 说明 · 开发 |
| TTS | 语音合成 | storage/plugins/tts/ | 说明 · 开发 |
| Schedule | 定时订阅候选 URL | storage/plugins/schedule/ | 说明 · 开发 |
设计原则
- 核心只消费统一契约 — 高风险抓取、第三方榜单等以可选外部插件接入
- 默认最小权限 —
riskLevel: high时强制默认关闭 - 热插拔 — 放入目录或 zip 上传后，设置页「重新扫描」即可
- 示例可跑 — 仓库
examples/*-plugin-*
管理入口
- Web：设置 → 插件
- API：各类
/api/{source|asr|tts|schedule}-plugins（列表 / rescan / 启停 / 配置 / 安装）
下一步
- 先读对应「说明」理解架构
- 再读「开发」写自己的插件
- 从
examples/复制一份改起最快