- video_url: 必填，B 站/YouTube/抖音/快手链接或本地文件路径；
- platform: 可省略，自动识别；
- quality: fast / medium / slow；
- provider_id: LLM 供应商 id（先 list_providers 查看，add_provider 新增）；
- model_name: 省略时取已配置的默认模型（setup 向导设置），否则取该供应商第一个可用模型；
- format: 附加内容，如 ["toc","link","screenshot","summary"]；
- style: 输出风格（minimal 精简/detailed 详细/academic 学术/tutorial 教程/xiaohongshu 小红书/life_journal 生活向/task_oriented 任务导向/business 商业风格/meeting_minutes 会议纪要）；
- extras: 附加到 prompt 末尾的自定义指令（如自定义笔记风格要求）；内置风格用 style，自定义风格用 extras；
- video_understanding / video_interval / grid_size: 视频理解（需多模态模型）；不传时用 setup ③ 配置的默认（默认关 / 6s）；显式传入始终覆盖；
- screenshot + format 含 "screenshot": 插入图片，产出便携笔记 note.md + Assets/（相对引用）；
- notes_dir: 便携笔记的输出目录（可选；缺省 BILINOTE_NOTES_DIR 环境变量，再缺省 note_results/{task_id}/）。

返回 {task_id, status, platform}。之后用 get_task_status / wait_for_note 查询结果；
SUCCESS 时 result.note_dir 指向便携笔记目录。

返回与 get_task_status 相同的结构，SUCCESS 时 result 含最终 Markdown。

添加后建议调用 list_models 确认模型可用，或用 add_model 手动添加模型名。

填 api_key 建议走对话外通道（更安全）：用户在独立终端执行
`bilinote-mcp providers set <provider_id> --api-key '...'`。
本工具也接受 api_key（给明确接受 key 经过对话的用户用）；改非敏感字段不受限。

transcriber_type: fast-whisper（本地，需下载模型）/ groq（云端）/ bcut / kuaishou / mlx-whisper。
切到 fast-whisper 时可用 whisper_model_size 指定模型尺寸（tiny/base/small/medium/large-v3）。