类型总览与选型
先在这页确定
type，再去对应卡片抄模板。
12 种 type
| type | 职责 | 入口基类 | 数量 | 备注 |
|---|---|---|---|---|
asr | 语音识别 | BaseASRProvider | 互斥（当前引擎） | 支持双轨独立路由或单例共享 |
mt | 机器翻译 | BaseMTEngineProvider | 互斥（当前引擎） | 同上 |
tts | 语音合成 | BaseTTSProvider | 互斥（当前引擎） | 上轨耳机 / 下轨虚拟麦克风 / 静默 |
interpretation | 同声传译直通 | BaseInterpretationProvider | 互斥（当前引擎） | 单体同传（如科大讯飞），绕过 ASR→MT→TTS 级联 |
glossary | 术语库 | 数据文件 | 可多开 | 只写 terms.json |
theme | 主题 / UI 插槽 | BaseThemePlugin / QML | full 层互斥 | material/typography/effects 可叠层 |
i18n | 语言包 | JSON | 互斥 | 整包界面翻译 |
middleware | 管线中间件 | BasePipelineMiddleware | 可多开 | 按 priority 排序 |
assistant | AI 助手 | BaseAssistantPlugin | 可多开 | 浮窗 / 答题 / 对话协程 |
tool | 工具 / 文本源 / 划词 | BaseToolPlugin / BasePlugin | 可多开 | hotkeys + action_*，不挂管线 |
caption_bridge | 网页字幕桥 | 工坊插件 community_web_caption_bridge | 一个传输服务 | 走创意工坊，不打进官方包；第三方不要再写一个桥 |
caption_extractor | 视频站字幕提取 | 开放（extractor.js） | 可多开 | 给浏览器扩展加网站支持 |
历史幽灵类型：audio_filter、bundle —— 已废弃，宿主不识别，禁止出现在 mod.json。
mt插件用target_langs声明“能翻译成哪些语言”，宿主据此生成字幕翻译下拉框； 详见 语言代码与可翻译语种。
选型速查
| 你想做的事 | 选它 |
|---|---|
| 游戏/行业专名对照（多语向） | glossary（零代码） |
| 换字幕配色 / 透明度 | theme（JSON） |
| 换底板 / 音柱 / 装饰视觉组件 | theme + QML，或单独 ui-qml |
| 文本清洗、敏感词过滤 | middleware |
| 接私有语音识别 | asr |
| 接 DeepL / LLM / 本地翻译 | mt |
| 接 Edge-TTS / GPT-SoVITS / 本地 TTS | tts |
| 端到端实时同传（自带 ASR+MT+TTS） | interpretation |
| AI 面试 / 答辩副驾 | assistant |
| 划词翻译 / 全局快捷键工具 | tool |
| 界面翻译成更多语言 | i18n |
| 给别的视频站加字幕提取 | caption_extractor |
不要用
middleware挂action_*来冒充工具插件——工具/文本源必须用正式的type: tool， 否则工坊分类错、热键语义也错。
工坊分类映射
宿主把 type 映射成工坊卡片上的分类：
| type | 工坊分类 |
|---|---|
middleware | 流水线工具 |
tool | 流水线工具 |
asr / mt / tts | 对应能力分类 |
interpretation | 实时同传 |
| 未识别的 type | 其他 |
UI 分类与插槽互斥（摘要）
tool→ 「流水线工具」；未知 type → 「其他」。- 共享 UI 插槽互斥（仅这些）：
overlay_background、caption_view、audio_level、alert_capsule、overlay_decorations、settings_background、history_background、dialog_background、window_background、copilot_window。 settings_view不得互斥（每个插件自己的设置表单）。- 完整糟位清单与背景插槽准则见 UI 插槽。
相关
- 目录结构与 mod.json — 字段权威表
- 运行架构与生命周期 — 双轨分流、启用与互斥
- Provider 签名与数据类型
- 示例库