fix(assets): 修复 Electron 便携版相对路径加载 3D 模型失败的问题，优化 sync-version 脚本 (v0.8.57)

YoKONCy · YoKONCy · commit 70952876f4ab · 2026-04-04T17:53:13.000+08:00
diff --git a/backend/nit_core/interpreter/rust_binding/Cargo.toml b/backend/nit_core/interpreter/rust_binding/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "nit_rust_runtime"
-version = "0.8.56"
+version = "0.8.57"
 edition = "2021"
 
 [lib]
diff --git a/backend/nit_core/interpreter/rust_binding/pyproject.toml b/backend/nit_core/interpreter/rust_binding/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "maturin"
 
 [project]
 name = "nit_rust_runtime"
-version = "0.8.56"
+version = "0.8.57"
 description = "NIT Rust Runtime"
 requires-python = ">=3.8"
 dependencies = []
diff --git a/backend/nit_core/nit_terminal_auditor/Cargo.toml b/backend/nit_core/nit_terminal_auditor/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "nit_terminal_auditor"
-version = "0.8.56"
+version = "0.8.57"
 edition = "2021"
 
 [lib]
diff --git a/backend/nit_core/tools/work/CodeSearcher/src/Cargo.toml b/backend/nit_core/tools/work/CodeSearcher/src/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "CodeSearcher"
-version = "0.8.56"
+version = "0.8.57"
 edition = "2021"
 
 # See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
diff --git a/backend/pyproject.toml b/backend/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "pero-backend"
-version = "0.8.56"
+version = "0.8.57"
 description = "萌动链接：PeroperoChat！ 后端服务"
 requires-python = ">=3.10,<3.11"
 dependencies = [
diff --git a/backend/vision_core/Cargo.toml b/backend/vision_core/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "pero_vision_core"
-version = "0.8.56"
+version = "0.8.57"
 edition = "2021"
 
 [lib]
diff --git a/backend/vision_core/pyproject.toml b/backend/vision_core/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "maturin"
 
 [project]
 name = "pero_vision_core"
-version = "0.8.56"
+version = "0.8.57"
 description = "High-performance computer vision core for Pero using Rust"
 license = { text = "Apache-2.0" }
 authors = [
diff --git a/electron/main/index.ts b/electron/main/index.ts
@@ -258,6 +258,11 @@ ipcMain.handle('scan-local-models', async () => {
   return await scanLocalModels()
 })
 
+// 暴露 app 根路径，供渲染进程将相对 assets/ 路径转换为 asset:// 绝对 URL
+ipcMain.handle('get-app-path', () => {
+  return app.getAppPath()
+})
+
 // 3D 模型资产扫描 (包括 Workshop)
 ipcMain.handle('scan-3d-models', async () => {
   return await scan3DModels()
diff --git a/electron/preload/index.ts b/electron/preload/index.ts
@@ -13,5 +13,7 @@ contextBridge.exposeInMainWorld('electron', {
     ipcRenderer.invoke('native-load-standard-model', buffer, filterPatterns),
   loadPeroContainer: (buffer: Uint8Array) =>
     ipcRenderer.invoke('native-load-pero-container', buffer),
-  scanLocalModels: () => ipcRenderer.invoke('scan-local-models')
+  scanLocalModels: () => ipcRenderer.invoke('scan-local-models'),
+  // 暴露应用根路径，供渲染进程将相对 assets/ 路径转换为 asset:// 绝对路径
+  appPath: () => ipcRenderer.invoke('get-app-path')
 })
diff --git a/package.json b/package.json
@@ -1,7 +1,7 @@
 {
   "name": "peropero-chat",
   "private": true,
-  "version": "0.8.56",
+  "version": "0.8.57",
   "description": "萌动链接：PeroperoChat！- 一个充满活力的 3D 桌面宠物应用",
   "author": "YoKONCy",
   "license": "Apache-2.0",
diff --git a/scripts/sync-version.js b/scripts/sync-version.js
@@ -1,16 +1,20 @@
-const fs = require('fs')
-const path = require('path')
+import fs from 'fs'
+import path from 'path'
+import { fileURLToPath } from 'url'
+
+// ES Module 下没有 __dirname，需要手动构造
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
 
 const envPath = path.join(__dirname, '../.env')
 const pkgPath = path.join(__dirname, '../package.json')
-const pyTomlPath = path.join(__dirname, '../backend/pyproject.toml')
 
-let version = '0.8.56' // Default fallback
+let version = '0.8.57' // Default fallback
 
-// 1. Read version from .env
+// 1. 从 .env 读取版本号
 if (fs.existsSync(envPath)) {
   const envContent = fs.readFileSync(envPath, 'utf-8')
-  // Match PERO_VERSION=x.y.z
+  // 匹配 PERO_VERSION=x.y.z
   const match = envContent.match(/^PERO_VERSION\s*=\s*(.+)$/m)
   if (match) {
     version = match[1].replace(/['"]/g, '').trim()
@@ -24,7 +28,7 @@ if (fs.existsSync(envPath)) {
 function updateVersion() {
   let updated = false
 
-  // 2. Update package.json
+  // 2. 更新 package.json
   if (fs.existsSync(pkgPath)) {
     const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'))
     if (pkg.version !== version) {
@@ -35,7 +39,7 @@ function updateVersion() {
     }
   }
 
-  // 3. Update TOML configs (Python and Rust)
+  // 3. 更新所有 TOML 配置（Python & Rust）
   const tomlPaths = [
     '../backend/pyproject.toml',
     '../backend/vision_core/pyproject.toml',
@@ -49,7 +53,7 @@ function updateVersion() {
   for (const relPath of tomlPaths) {
     const fullPath = path.join(__dirname, relPath)
     if (fs.existsSync(fullPath)) {
-      let content = fs.readFileSync(fullPath, 'utf8')
+      const content = fs.readFileSync(fullPath, 'utf8')
       // 匹配行首的 version = "..."
       const replaced = content.replace(/^version\s*=\s*".*"/m, `version = "${version}"`)
       if (content !== replaced) {
diff --git a/src/components/avatar/BedrockAvatar.vue b/src/components/avatar/BedrockAvatar.vue
@@ -52,6 +52,7 @@ import { StandardBones } from './lib/retargeting/RetargetingConfig'
 import { FeatureButton, IAvatarManifest } from './lib/adapter/IAvatarManifest'
 import { ManifestBasedAdapter } from './lib/adapter/ManifestBasedAdapter'
 import { ManifestLoader } from './lib/adapter/ManifestLoader'
+import { initAssetUrlCache } from '../../utils/assetUrl'
 
 const props = defineProps<{
   isDragging?: boolean
@@ -306,6 +307,8 @@ let animationFrameId: number
 let currentProvider: IModelProvider | undefined
 
 onMounted(async () => {
+  // [修复] 预热 appPath 缓存，确保 resolveAssetUrl 能将相对 assets/ 路径转为 asset:// 绝对路径
+  await initAssetUrlCache()
   initThree()
   await loadDefaultManifest()
   animate()
diff --git a/src/utils/assetUrl.ts b/src/utils/assetUrl.ts
@@ -1,9 +1,29 @@
 /**
  * 解析资产路径为可加载的 URL
  *
- * @param path 原始路径 (可能是相对路径 assets/..., 或绝对路径 C:/...)
+ * @param path 原始路径 (可能是相对路径 assets/..., 或绝对路径 C:/...，或已解析的 URL)
  * @returns 可用于 fetch 或 img src 的 URL
  */
+
+// 缓存 appPath，避免每次都发起 IPC 调用
+let _cachedAppPath: string | null = null
+
+async function getAppPath(): Promise<string> {
+  if (_cachedAppPath) return _cachedAppPath
+  try {
+    // @ts-ignore
+    const p = await window.electron.appPath()
+    _cachedAppPath = p
+    return p
+  } catch {
+    return ''
+  }
+}
+
+/**
+ * 同步版本（用于已缓存或非 Electron 场景）
+ * 注意：在 Electron 下首次调用前需先调用 initAssetUrlCache() 预热
+ */
 export function resolveAssetUrl(path: string): string {
   if (!path) return path
 
@@ -17,20 +37,38 @@ export function resolveAssetUrl(path: string): string {
 
   if (isElectron) {
     // 如果是绝对路径 (Windows 盘符或 Unix 根路径)
-    // Windows: C:\... -> asset:///C:/...
-    // Unix: /home/... -> asset:///home/...
-
-    // 简单的绝对路径检测
+    // Windows: C:\... -> asset://C:/...
     const isAbsolute = /^[a-zA-Z]:\\|^[a-zA-Z]:\/|^\//.test(path)
 
     if (isAbsolute) {
-      // 规范化路径分隔符
       const normalizedPath = path.replace(/\\/g, '/')
-      // 确保以 / 开头 (对于 Windows 盘符，如 C:/... 变成 /C:/...)
       const pathPart = normalizedPath.startsWith('/') ? normalizedPath : '/' + normalizedPath
       return `asset://${pathPart}`
     }
+
+    // [修复] 相对路径 (如 assets/3d/Pero.pero) 在 Electron Portable 下走 file:// 会失败，
+    // 因为 fetch 的基准 URL 是 dist/index.html 所在目录，而非 asar 根目录。
+    // 需要将其转为 asset:// 绝对路径，基于已缓存的 appPath。
+    if (_cachedAppPath) {
+      const normalizedAppPath = _cachedAppPath.replace(/\\/g, '/')
+      const appPathPart = normalizedAppPath.startsWith('/') ? normalizedAppPath : '/' + normalizedAppPath
+      return `asset://${appPathPart}/${path}`
+    }
+
+    // appPath 尚未缓存（首帧可能发生），降级保底返回原路径
+    console.warn(`[resolveAssetUrl] appPath 未缓存，无法解析相对路径: ${path}`)
   }
 
   return path
 }
+
+/**
+ * 在 Electron 环境下，应在应用初始化时调用此函数预热 appPath 缓存，
+ * 确保 resolveAssetUrl 同步版本能正确处理相对路径。
+ */
+export async function initAssetUrlCache(): Promise<void> {
+  const isElectron = (window as any).electron !== undefined
+  if (isElectron && !_cachedAppPath) {
+    await getAppPath()
+  }
+}

Original file line number	Diff line number	Diff line change
`@@ -1,7 +1,7 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "peropero-chat",`
`3`	`3`	`"private": true,`
`4`		`- "version": "0.8.56",`
	`4`	`+ "version": "0.8.57",`
`5`	`5`	`"description": "萌动链接：PeroperoChat！- 一个充满活力的 3D 桌面宠物应用",`
`6`	`6`	`"author": "YoKONCy",`
`7`	`7`	`"license": "Apache-2.0",`