用途：把已有 Web 应用套上 Capacitor 原生壳（iOS 和/或 Android），使其能通过蓝牙与 Plaud 录音设备通信。因 iOS 无 Web Bluetooth、移动浏览器也无法访问 Plaud 私有握手与音频编解码，故需原生外壳加载 Web 应用 URL，并经自定义 Capacitor 插件 PlaudSdk 暴露预编译原生 SDK。
主要能力：两平台插件方法名与事件一致，Web 层无需区分平台；覆盖扫描→连接→导出流程，录音由设备触发并以 recordStart/recordStop/recordPause/recordResume 事件反馈。
使用方式：需先具备 Plaud Embedded 凭证与签发用户令牌的能力（否则先看 setup skill）。克隆仓库：git clone https://github.com/Plaud-AI/embedded-capacitor.git。安装并初始化 Capacitor：npm i @capacitor/core @capacitor/ios @capacitor/android @capacitor-community/bluetooth-le；npm i -D @capacitor/cli；npx cap init；npx cap add ios；npx cap add android；npx cap sync ios；npx cap sync android。在根 capacitor.config.ts 设 server.url 指向已部署的 Web 应用，再执行 npx cap sync。iOS 需复制 ios/PlaudPlugin/ 与 MainViewController.swift，手工注册插件，最低 iOS 15.0，并在 Info.plist 声明 NSBluetoothAlwaysUsageDescription 与 bluetooth-central 后台模式。Android 需复制 plaud-sdk.aar 与 PlaudSdkPlugin.java，改包名，在 MainActivity 的 super.onCreate() 之前 registerPlugin，并在 build.gradle 补全 .aar 传递依赖、把 fileTree 改为 ['.jar','.aar']。Web 侧复制 plaud-sdk.ts 到 lib/，用 Capacitor.isNativePlatform() 守卫后调用 PlaudSdk.initSDK、startScan 等。
限制：必须在真机运行（iOS 框架仅 arm64 设备、Android 模拟器无蓝牙）；Web 改动需重新部署，npx cap sync 不打包 Web 代码；原生改动需 npx cap sync 后重编译；fetch 到 file:// 或 S3 受 CORS 阻止，须用 readExportedFile/putBinaryNative；customDomain 仅填域名如 platform-us.plaud.ai。平台差异（设备标识、supportWiFi、penState、时长、导出目录、Android 独有诊断事件）见 plaud-sdk.ts 类型注释。纯音频转录请用 transcription-api-skill。