Vue Audio Native

一个内核，覆盖 Vue 3、移动浏览器与 WebView。

事件驱动、完整 TypeScript、兼容旧 Vue API，并为人类与 AI 同时提供可检索的工程知识。

框架无关 audio-core 管理播放、缓冲、列表、错误、互斥和生命周期。

现代 props、composable 和实例句柄，与 0.x 公开接入面保持明确兼容。

同一构建生成搜索、Markdown、llms.txt、Agent Contract 与只读 MCP。

这套文档解决什么问题

Vue Audio Native 1.0 不只是一个播放器组件。它把浏览器媒体状态、Vue 适配、旧 API 兼容、WebView 能力检测、发布约束和真机证据放进同一套可验证契约。

如果你是使用者，从快速开始进入；如果你在维护项目，先看项目地图和架构知识；如果你是 AI 客户端，读取构建生成的 /.well-known/silen/manifest.json，并保持只读直到用户明确授权写入。

@trsoliu/audio-core@1.0.1 与 vue-audio-native@1.0.1 已通过 OIDC Trusted Publishing 发布到 npm 的 latest，均携带 SLSA provenance；本次补丁只更新安装指引与发布安全性，不改变 1.0.0 的音频运行时行为，next 保留最后一个 beta。
Vue 2 继续使用 vue-audio-native@legacy，当前解析到 0.1.41。
稳定版采用维护者的版本绑定评估授权；未执行的真机场景与剩余风险在兼容性评估与真机记录中如实保留。

目标	文档
安装并播放第一段音频	安装与快速开始
从 0.x 或 Vue 2 迁移	Vue 1.0 迁移指南
查找 props、事件 payload、状态、错误、插槽和句柄	公共 API
理解 core、Vue、Demo 与 fixtures	Monorepo 项目地图
处理浏览器/WebView 差异	浏览器与 WebView
准备 beta 或稳定发布	发布知识库