用途:基于 React/TypeScript 起始模板,帮助创建、修改或扩展 macOS 媒体播放器 IINA 的插件。IINA 插件分为两种执行环境:入口脚本(src/index.ts、src/global.ts)运行于 JavaScriptCore,无 DOM,通过全局 iina 对象访问 API;React webview(src/ui/*/)运行于 WKWebView,拥有完整 DOM 与 React,通过 postMessage/onMessage 与入口脚本通信。
主要能力:提供插件架构与消息桥接(src/ui/bridge.ts 的 sendToPlugin、onPluginMessage),类型定义在 src/types.ts。API 模块包含 iina.core(播放控制)、iina.mpv(mpv 引擎读取与 observe)、iina.event(事件监听)、iina.overlay / iina.sidebar / iina.standaloneWindow(界面与窗口)、iina.http、iina.file、iina.menu、iina.preferences、iina.console、iina.global。
使用方式:复制起始模板到新目录;编辑 Info.json 设置名称、标识、描述、作者与权限;编辑 src/index.ts;修改 React UI;用 bridge 连接通信;在 types.ts 添加消息类型;执行 pnpm run build 构建;执行 pnpm run link 后重启 IINA 测试并查看 Log Viewer。
限制与规则:入口脚本禁用 window、document、fetch、console.log,改用 iina.console.log();React 代码无 iina 全局,需经 bridge;使用需权限的 API 前必须在 Info.json 的 permissions 中声明(show-osd、show-alert、video-overlay、network-request、file-system);状态更新用 mpv.observe() 而非 setInterval 轮询;入口脚本与 UI 分别使用 tsconfig.entry.json 与 tsconfig.ui.json。其余细节暂未提供。