xiaoyuan-assistant 0.5.45 → 0.5.46

package/CHANGELOG.md

@@ -386,3 +386,10 @@ ls -lh /mnt/data/xiaoyuan-assistant-siliconflow-v0.5.29.zip
 - 新增内置 `zh-CN-XiaoxiaoNeural` 本地‘收到指令，请您稍等’MP3。
 - 与 `zh-CN-XiaoyiNeural` 一样优先使用包内静态音频，不请求网络 TTS。
 - voice 切换时按 voice 分别匹配内置本地音频与 IndexedDB 缓存。
+
+## v0.5.46 - 修复 NPM 安装后 useXiaoyuan 单例初始化报错
+
+- 将运行时 singleton / KEY 提取到独立 `src/context.js`，解除 `src/index.js` 与 `XiaoyuanAssistant.vue` 的循环依赖。
+- 组件内部改为直接从共享 runtime context 获取 `manager / speech / options`。
+- 保留对外 `useXiaoyuan()` API，不改变 `app.use(Xiaoyuan, ...)` 使用方式。
+- 修复部分 Vite/NPM 环境下出现 `请先在 main.js 中 app.use(Xiaoyuan)` 的误报。

package/XIAOYUAN-BUSINESS-FLOW.md

@@ -1212,3 +1212,18 @@ AI 分析开始提示音与数据获取/模型分析并行；多个数据源采
 ## v0.5.45：新增 XiaoxiaoNeural 本地前置提示音
 
 小园现在内置 `zh-CN-XiaoxiaoNeural` 的“收到指令，请您稍等”MP3。当前 voice 命中内置资源时直接播放本地文件；未命中时再查询对应 voice 的 IndexedDB 缓存，仍未命中才请求远程 TTS。
+
+## v0.5.46 - NPM Runtime Context 稳定性
+
+### Runtime Context
+
+小园将全局 runtime singleton 独立到 `src/context.js`，避免入口文件与 Vue 组件互相 import 形成循环依赖。
+
+初始化流程：
+1. `main.js` 执行 `app.use(Xiaoyuan, options)`。
+2. Xiaoyuan 创建 registry、speech、AI、manager。
+3. runtime 写入共享 context。
+4. 注册 `XiaoyuanAssistant` 组件。
+5. Vue 渲染组件时直接从共享 context 读取 runtime，不再反向依赖入口 `index.js`。
+
+这样可以避免 NPM/Vite 构建场景下 singleton 尚未可见而触发“请先在 main.js 中 app.use(Xiaoyuan)”的误报。

package/package.json

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

package/package.json.bak

@@ -0,0 +1,18 @@
+{
+  "name": "xiaoyuan-assistant",
+  "version": "0.5.45",
+  "type": "module",
+  "main": "./src/index.js",
+  "module": "./src/index.js",
+  "exports": {
+    ".": {
+      "import": "./src/index.js",
+      "default": "./src/index.js"
+    },
+    "./style.css": "./src/styles/index.css"
+  },
+  "peerDependencies": {
+    "vue": "^3.3.0"
+  },
+  "scripts": {}
+}

package/src/components/XiaoyuanAssistant.vue

@@ -106,9 +106,9 @@
 
 <script setup>
 import { computed, nextTick, onBeforeUnmount, onMounted, ref } from 'vue'
-import { useXiaoyuan } from '../index.js'
+import { useXiaoyuanSingleton } from '../context.js'
 
-const { manager, speech, options } = useXiaoyuan()
+const { manager, speech, options } = useXiaoyuanSingleton()
 const wakeWord = options.wakeWord || '你好小园'
 const autoCollapseMs = options.autoCollapseMs ?? 0
 

package/src/context.js

@@ -0,0 +1,23 @@
+// Shared runtime context for Xiaoyuan.
+// Kept in its own module to avoid a circular dependency between
+// src/index.js and components/XiaoyuanAssistant.vue.
+export const KEY = Symbol('xiaoyuan')
+
+let singleton = null
+
+export function setXiaoyuanSingleton(value) {
+  singleton = value
+}
+
+export function getXiaoyuanSingleton() {
+  return singleton
+}
+
+export function useXiaoyuanSingleton() {
+  if (!singleton) throw new Error('请先在 main.js 中 app.use(Xiaoyuan)')
+  return singleton
+}
+
+export function resetXiaoyuanSingleton() {
+  singleton = null
+}

package/src/index.js

@@ -1,4 +1,3 @@
-import { inject } from 'vue'
 import XiaoyuanAssistant from './components/XiaoyuanAssistant.vue'
 import { Registry } from './core/registry.js'
 import { XiaoyuanManager } from './core/manager.js'
@@ -7,19 +6,15 @@ import './styles/index.css'
 import { createSiliconFlowProvider } from './providers/siliconflow.js'
 import { registerBuiltinFunctions } from './core/builtins.js'
 import { HewoyiTTSProvider } from './voice/hewoyi.js'
-
-const KEY = Symbol('xiaoyuan')
-
-let singleton = null
+import { KEY, getXiaoyuanSingleton, setXiaoyuanSingleton } from './context.js'
 
 export function useXiaoyuan() {
-  if (!singleton) throw new Error('请先在 main.js 中 app.use(Xiaoyuan)')
-  return singleton
+  return getXiaoyuanSingleton() || (() => { throw new Error('请先在 main.js 中 app.use(Xiaoyuan)') })()
 }
 
 const Xiaoyuan = {
   install(app, options = {}) {
-    if (singleton) return
+    if (getXiaoyuanSingleton()) return
 
     const registry = new Registry()
     registerBuiltinFunctions(registry)
@@ -83,11 +78,12 @@ const Xiaoyuan = {
       createSiliconFlowProvider
     }
 
-    singleton = { api, registry, manager, speech, options: normalizedOptions }
+    const runtime = { api, registry, manager, speech, options: normalizedOptions }
+    setXiaoyuanSingleton(runtime)
 
     app.config.globalProperties.$xiaoyuan = api
-    app.provide(KEY, singleton)
-    app.provide('xiaoyuan', singleton)
+    app.provide(KEY, runtime)
+    app.provide('xiaoyuan', runtime)
     app.component('XiaoyuanAssistant', XiaoyuanAssistant)
 
     if (typeof window !== 'undefined') {