xiaoyuan-assistant 0.5.47 → 0.5.48

package/CHANGELOG.md

@@ -397,3 +397,9 @@ ls -lh /mnt/data/xiaoyuan-assistant-siliconflow-v0.5.29.zip
 - 组件内部改为直接从共享 runtime context 获取 `manager / speech / options`。
 - 保留对外 `useXiaoyuan()` API，不改变 `app.use(Xiaoyuan, ...)` 使用方式。
 - 修复部分 Vite/NPM 环境下出现 `请先在 main.js 中 app.use(Xiaoyuan)` 的误报。
+## v0.5.48
+
+- 修复 Vue3 + Vite/NPM 场景下 `useXiaoyuan()` 偶发提示“请先在 main.js 中 app.use(Xiaoyuan)”的问题。
+- `XiaoyuanAssistant.vue` 改为优先通过 `app.provide('xiaoyuan', runtime)` 获取运行时，避免 NPM 重复依赖/重复模块实例导致 singleton 不一致。
+- `useXiaoyuan()` 对外返回 `runtime.api`，可直接调用 `registerData`、`registerFunction`、`setContext` 等 API。
+

package/README.md

@@ -227,3 +227,7 @@ app.use(Xiaoyuan, {
 ### v0.5.45 本地前置 TTS
 
 包内已内置 `zh-CN-XiaoxiaoNeural` 的“收到指令，请您稍等”MP3。使用该 voice 时首次打开即可直接播放本地资源，无需网络请求。
+
+
+### v0.5.48
+修复 NPM/Vite 环境下运行时注入与 `useXiaoyuan()` 的初始化问题。

package/XIAOYUAN-BUSINESS-FLOW.md

@@ -1227,3 +1227,8 @@ AI 分析开始提示音与数据获取/模型分析并行；多个数据源采
 5. Vue 渲染组件时直接从共享 context 读取 runtime，不再反向依赖入口 `index.js`。
 
 这样可以避免 NPM/Vite 构建场景下 singleton 尚未可见而触发“请先在 main.js 中 app.use(Xiaoyuan)”的误报。
+
+
+## v0.5.48 运行时注入修复
+- 组件内部通过 Vue `app.provide('xiaoyuan', runtime)` 获取运行时，不再依赖可能被重复打包的模块级 singleton。
+- `useXiaoyuan()` 返回公开 API 对象，直接支持注册数据、注册函数、设置上下文等调用。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xiaoyuan-assistant",
-  "version": "0.5.47",
+  "version": "0.5.48",
   "type": "module",
   "main": "./src/index.js",
   "module": "./src/index.js",

package/src/components/XiaoyuanAssistant.vue

@@ -105,10 +105,17 @@
 </template>
 
 <script setup>
-import { computed, nextTick, onBeforeUnmount, onMounted, ref } from 'vue'
-import { useXiaoyuanSingleton } from '../context.js'
+import { computed, inject, nextTick, onBeforeUnmount, onMounted, ref, getCurrentInstance } from 'vue'
 
-const { manager, speech, options } = useXiaoyuanSingleton()
+// 使用 Vue app.provide 的字符串 key 获取运行时，避免 NPM 被重复打包/解析时
+// context.js 出现多份 singleton 导致‘请先 app.use(Xiaoyuan)’误报。
+const runtime = inject('xiaoyuan', null) || getCurrentInstance()?.appContext.config.globalProperties.$xiaoyuan
+
+if (!runtime) {
+  throw new Error('请先在 main.js 中 app.use(Xiaoyuan)')
+}
+
+const { manager, speech, options } = runtime
 const wakeWord = options.wakeWord || '你好小园'
 const autoCollapseMs = options.autoCollapseMs ?? 0
 

package/src/index.js

@@ -9,7 +9,9 @@ import { HewoyiTTSProvider } from './voice/hewoyi.js'
 import { KEY, getXiaoyuanSingleton, setXiaoyuanSingleton } from './context.js'
 
 export function useXiaoyuan() {
-  return getXiaoyuanSingleton() || (() => { throw new Error('请先在 main.js 中 app.use(Xiaoyuan)') })()
+  const runtime = getXiaoyuanSingleton()
+  if (!runtime) throw new Error('请先在 main.js 中 app.use(Xiaoyuan)')
+  return runtime.api
 }
 
 const Xiaoyuan = {