chore(release): 更新版本至 0.8.4 并修复代码规范问题

Author: YoKONCy

.env.example

@@ -1,2 +1,3 @@
 ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/
 ELECTRON_BUILDER_BINARIES_MIRROR=https://npmmirror.com/mirrors/electron-builder-binaries/
+PERO_VERSION=0.8.4

.github/workflows/build-electron.yml

@@ -312,35 +312,51 @@ jobs:
             PeroCore-Electron/dist_electron/*.exe
             PeroCore-Portable-*.zip
             PeroCore-Browser-Extension.zip
-          name: 'PeroCore ${{ github.ref_name }}'
+          name: '萌动链接：PeroperoChat！ ${{ github.ref_name }}'
           body: |
-            ## ${{ github.ref_name }} Release Notes
-
-            ### Downloads
-            - **Setup 安装版** (`.exe`): 推荐大多数用户使用，数据存储在系统用户目录
-            - **Portable 便携版** (`.zip`): 解压即用，数据存储在程序目录下的 `data/` 文件夹中
-            - **Browser Extension** (`.zip`): 浏览器扩展插件
-
-            ### Architecture
-            - Gateway embedded into Python backend (removed Go dependency)
-            - Agent service refactored into 6 submodules
-            - Build pipeline cleaned up (removed copy-gateway.js)
-
-            ### Features
-            - Auto-hide launcher after startup
-            - 3D character system improvements
-            - Pixel-style UI enhancements
-            - **NEW: Portable version support**
-
-            ### Stability
-            - Fixed file:// URL format issue causing production build to not launch
-            - Steam module lazy loading to prevent native crashes
-            - Google Fonts localized for offline/China network support
-            - Global exception handling improvements
-            - TypeScript type fixes
-
-            Automated release by GitHub Actions
+            ## 🎉 ${{ github.ref_name }} 版本更新
+
+            > 萌动链接：PeroperoChat！是一款开源的 AI 桌面伴侣应用，集成本地大模型、3D 桌宠、Plugin 系统与多智能体框架。
+
+            ---
+
+            ### 📦 下载说明
+
+            | 文件 | 说明 | 推荐人群 |
+            |------|------|----------|
+            | `*-Setup-*.exe` | 安装版 | 普通用户，数据存储在系统用户目录 |
+            | `PeroCore-Portable-*.zip` | 便携版（解压即用） | 随身携带或多设备使用，数据存储于 `data/` 文件夹 |
+            | `PeroCore-Browser-Extension.zip` | 浏览器扩展 | 配合主程序在浏览器中使用 |
+
+            > ⚠️ Windows 可能弹出 SmartScreen 警告，点击"仍要运行"即可。本软件为开源项目，源码可在仓库中查阅。
+
+            ---
+
+            ### 🆕 本版本更新内容
+
+            #### ✨ 新特性
+            - 请查阅本次 Commit 记录了解具体变更
+
+            #### 🐛 问题修复
+            - 请查阅本次 Commit 记录了解具体变更
+
+            #### 🏗️ 架构优化
+            - 请查阅本次 Commit 记录了解具体变更
+
+            ---
+
+            ### 🚀 快速开始
+
+            1. 下载并安装（安装版）或解压（便携版）
+            2. 首次启动需同意《用户许可协议》
+            3. 在启动器中配置 LLM API Key 后即可使用
+            4. 详细使用文档请参阅 [项目 Wiki](https://github.com/${{ github.repository }}/wiki)
+
+            ---
+
+            *由 GitHub Actions 自动构建发布 · 构建时间：${{ github.event.head_commit.timestamp }}*
           draft: false
           prerelease: false
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+

backend/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "pero-backend"
-version = "0.8.3"
+version = "0.8.4"
 description = "萌动链接：PeroperoChat！ 后端服务"
 requires-python = ">=3.10,<3.11"
 dependencies = [

docs/STEAM_INTEGRATION_GUIDE.md

@@ -32,30 +32,55 @@
 
 为了确保资产加载的统一性，我们将对以下类型的资源进行联邦化管理。**注意：** 此处的“模型”指 Bedrock 3D 渲染资源（如 Rossi 形象），而非 AI 语言模型权重。
 
-| 资产类型 (Type)        | 物理位置 (Physical Path)        | 说明                                       |
-| :--------------------- | :------------------------------ | :----------------------------------------- |
-| **3D 模型 (model_3d)** | `public/assets/3d/`             | Bedrock 3D 模型文件夹 (含 `manifest.json`) |
-| **人设 (persona)**     | `backend/services/mdp/(xxx...)` | 包含提示词组件、Agent 专属配置等           |
-| **插件 (plugin)**      | `backend/nit_core/plugins/`     | 具有独立功能的 Python 插件                 |
-| **模组 (mod)**         | `backend/mods/`                 | 用户自定义的功能扩展                       |
-| **接口 (interface)**   | `backend/interfaces/`           | 系统核心接口定义与扩展                     |
+| 资产类型 (Type) | 内置位置 (Official Path) | 标识文件 | 说明 |
+| :--- | :--- | :--- | :--- |
+| **人设 (persona)** | `@app/backend/services/mdp/agents/<name>/` | `asset.json` + `config.json` | 提示词、模式 Persona、碎碎念、头像 |
+| **插件 (plugin)** | `@app/backend/nit_core/plugins/<name>/` | `description.json` + `schema.json` | Python 插件入口 + OpenAI Tool 定义 |
+| **3D 模型 (model_3d)** | `@app/public/assets/3d/` | `manifest.json` 或 `.pero` | Bedrock 3D 模型，支持加密容器 |
+| **模组 (mod)** | `@app/backend/mods/<name>/` | `mod.toml` | 三层扩展体系 (EventBus/Pipeline/External) |
+
+每种类型在用户覆盖层也有对应位置：`@data/custom/<type>/<name>/`。
 
 ### 3.2 统一资产定义 (`asset.json`)
 
-所有资产（无论是内置、本地还是创意工坊下载）均需在根目录包含一个 `manifest.json`（如果是 Bedrock 模型，则在现有 `manifest.json` 中嵌入元数据）：
+新建资产的标准元数据文件为 `asset.json`。`AssetRegistry` 也兼容以下格式（按检测优先级排列）：
+
+| 优先级 | 文件名 | 适用类型 | 说明 |
+| :----- | :----- | :------- | :--- |
+| 1 | `asset.json` | 所有类型 | **标准格式**，新资产必须使用 |
+| 2 | `manifest.json` | model_3d | 兼容旧版 Bedrock 模型清单 |
+| 3 | `description.json` | plugin | 兼容现有插件格式（含 `entryPoint` 字段） |
+| 4 | `mod.toml` | mod | TOML 格式，从 `[mod]` section 读取 |
+
+#### `asset.json` 标准格式
 
 ```json
 {
-  "asset_id": "com.user.cute_pero_model",
-  "type": "model_3d", // plugin | persona | model_3d | mod | interface
-  "source": "workshop", // official | local | workshop
-  "display_name": "超级可爱的 Pero 模型",
-  "version": "1.0.2",
-  "workshop_id": "123456789", // 仅当 source 为 workshop 时存在
-  "config": {} // 特定资产配置
+  "asset_id": "com.perocore.persona.pero",
+  "type": "persona",
+  "source": "official",
+  "display_name": "Pero",
+  "version": "1.0.0",
+  "description": "看板娘Pero! 核心桌宠角色",
+  "author": "PeroCore",
+  "config": {
+    "agent_id": "pero",
+    "personas": ["work", "social", "group"],
+    "social_enabled": true
+  }
 }
 ```
 
+#### Asset ID 命名规范
+
+采用反向域名格式：`<scope>.<type>.<name>`
+
+| scope | 含义 | 示例 |
+| :---- | :--- | :--- |
+| `com.perocore` | 官方内置 | `com.perocore.persona.pero` |
+| `com.workshop` | 创意工坊 | `com.workshop.model.123456` |
+| `com.user` | 用户自定义 | `com.user.plugin.my_tool` |
+
 ---
 
 ## 4. 虚拟路径管理器 (Virtual Path Resolver)
@@ -90,7 +115,16 @@
 
 ### 4.3 资产注册表 (Asset Registry)
 
-系统维护一个全局单例 `AssetRegistry`，负责扫描并注册所有可用资产。程序逻辑（如前端加载模型、后端加载人设）通过 `asset_id` 进行资源请求，由注册表根据虚拟路径解析出真实的物理地址。
+系统维护一个全局单例 `AssetRegistry` (`core/asset_registry.py`)，负责扫描并注册所有可用资产。
+
+**扫描顺序与冲突策略**：按 `official → workshop → local` 顺序扫描，**后者覆盖前者**（同 `asset_id` 时）。这意味着用户可以在 `@data/custom/` 中放置与官方同 ID 的资产来实现覆盖。
+
+**关键 API**：
+- `scan_all()` — 全量扫描所有来源目录
+- `get_asset(asset_id)` — 按 ID 检索已注册资产
+- `get_assets_by_type(type)` — 按类型查询所有资产
+
+**代码位置**: [`asset_registry.py`](file:///c:/Users/Administrator/OneDrive/桌面/workspace/PeroCore/backend/core/asset_registry.py) | [`path_resolver.py`](file:///c:/Users/Administrator/OneDrive/桌面/workspace/PeroCore/backend/core/path_resolver.py)
 
 ---
 
@@ -109,17 +143,23 @@
 
 ---
 
-## 6. 后续行动计划 (Action Plan)
-
-1.  **[Backend] 虚拟路径适配**:
-    - 实现 `core/path_resolver.py`，支持环境感知和逻辑路径转换。
-    - 在 Python 端，识别 `sys.frozen` 或打包环境，动态调整 `@app` 路径。
-2.  **[Backend] 资产加载重构**:
-    - 将 `MDPManager` (人设)、`PluginManager` (插件) 接入 `PathResolver`。
-    - 实现 `AssetRegistry` 统一管理 `backend/mods` 和 `backend/interfaces` 目录。
-3.  **[Frontend] 模型加载适配**:
-    - 更新 Bedrock 加载逻辑，支持从外部目录（如 `@workshop`）加载 3D 模型资产。
-4.  **[DevOps] 目录规范化**:
-    - 统一 `data` 目录入口，支持通过环境变量 `PERO_DATA_DIR` 迁移，为云同步做准备。
-5.  **[Steam] 功能接入**:
-    - 接入 Steamworks SDK 正式 App ID，测试 Overlay 弹出与云存档上传。
+## 6. 行动计划 (Action Plan)
+
+### ✅ 已完成
+
+1.  **[Backend] 虚拟路径适配**: `core/path_resolver.py` 已实现，支持 `@app`/`@data`/`@workshop`/`@temp` 四个逻辑前缀，支持 `sys.frozen` 打包环境检测和 `PERO_DATA_DIR` 环境变量。
+2.  **[Backend] AssetRegistry**: `core/asset_registry.py` 已实现全量扫描与冲突覆盖，支持 `asset.json`、`manifest.json`、`description.json`、`mod.toml` 四种元数据格式。
+3.  **[Backend] 管理器接入**: `PluginManager`、`ModelManager` 均已通过 `get_asset_registry()` 查询资产，不再硬编码路径。
+4.  **[Frontend] 模型联邦加载**: Electron 端 `assets.ts` 支持 `official`/`workshop`/`local` 三源扫描与 `asset://` 协议。
+5.  **[DevOps] 目录规范**: `@data` 默认为 `@app/data`，可通过 `PERO_DATA_DIR` 环境变量迁移。
+6.  **[Tool] PeroClawd!**: 资产创建工具已实现人设编辑器、插件工作台、3D 资产打包，含 `asset.json` 自动生成和 asset_id 规范校验。
+
+### 🚧 进行中
+
+7.  **[Tool] PeroClawd! 资源管理器联动**: 将 PeroClawd! 的文件资源管理器与 `AssetRegistry` 的扫描逻辑对齐，实现从磁盘打开现有资产到工作台编辑的双向流程。
+8.  **[Steam] 功能接入**: 接入 Steamworks SDK 正式 App ID (4457100)，测试 Overlay 弹出与云存档上传。
+
+### 📋 待规划
+
+9.  **[Tool] Mod 工作台**: 在 PeroClawd! 中新增 `mod.toml` 编辑器，覆盖三层扩展体系 (EventBus/Pipeline/External)。
+10. **[Workshop] 上传流程**: 从 PeroClawd! 直接发布资产到 Steam 创意工坊。

electron/main/services/tray.ts

@@ -40,8 +40,6 @@ export function createTray() {
 
   try {
     const icon = nativeImage.createFromPath(iconPath)
-    // 如需调整大小
-    // icon.resize({ width: 16, height: 16 })
 
     tray = new Tray(icon)
 

electron/main/utils/env.ts

@@ -40,7 +40,7 @@ if (isElectron) {
   } else if (!app.isPackaged) {
     // 开发模式：数据统一存放在项目的 backend/ 目录下
     // 这样 paths.data = {project}/backend/data/ 与 Python 后端数据位于同一目录
-    const projectRoot = path.resolve(__dirname, '../../..')   // dist-electron/main -> electron -> 项目根
+    const projectRoot = path.resolve(__dirname, '../../..') // dist-electron/main -> electron -> 项目根
     appUserData = path.join(projectRoot, 'backend')
     console.log(`[Env] 开发模式，数据目录: ${appUserData}/data/`)
   } else {
@@ -75,7 +75,13 @@ export const isPortable = isElectron && isPackaged && detectPortableMode(appExe)
  * 用于 Logger 的双写：开发模式下日志同时存在项目目录 + 系统目录。
  */
 export const systemUserData: string = isElectron
-  ? (() => { try { return require('electron').app.getPath('userData') } catch { return appUserData } })()
+  ? (() => {
+      try {
+        return require('electron').app.getPath('userData')
+      } catch {
+        return appUserData
+      }
+    })()
   : appUserData
 
 export const paths = {

electron/main/utils/logger.ts

@@ -19,7 +19,7 @@ export type LogSource =
 class Logger {
   private static instance: Logger
   private logFile: string | null = null
-  private secondaryLogFile: string | null = null   // 开发模式下同时写入 %APPDATA%
+  private secondaryLogFile: string | null = null // 开发模式下同时写入 %APPDATA%
 
   // 隐藏模式 (降噪)
   // 优化: 组合正则以获得更好的性能
@@ -100,7 +100,7 @@ class Logger {
       // 动态获取路径，避免循环依赖
       // 注意: logger 在 env.ts 之前被加载，不能直接 import paths，需自行检测模式
       let primaryDir = ''
-      let systemDir = ''   // %APPDATA% 路径（用于开发模式双写）
+      let systemDir = '' // %APPDATA% 路径（用于开发模式双写）
 
       try {
         const { app } = require('electron')
@@ -115,7 +115,7 @@ class Logger {
             // 开发模式：主日志在 backend/data/logs/，同时写 %APPDATA% 副本
             const projectRoot = path.resolve(__dirname, '../../..')
             primaryDir = path.join(projectRoot, 'backend')
-            systemDir = app.getPath('userData')   // %APPDATA%/...
+            systemDir = app.getPath('userData') // %APPDATA%/...
           } else {
             // 发行模式
             primaryDir = app.getPath('userData')
@@ -143,7 +143,10 @@ class Logger {
           fs.mkdirSync(sysLogDir, { recursive: true })
         }
         this.secondaryLogFile = path.join(sysLogDir, 'main.log')
-        fs.writeFileSync(this.secondaryLogFile, `--- Log started at ${new Date().toISOString()} (dev secondary) ---\n`)
+        fs.writeFileSync(
+          this.secondaryLogFile,
+          `--- Log started at ${new Date().toISOString()} (dev secondary) ---\n`
+        )
       }
     } catch (e) {
       console.error('[Logger] 初始化日志文件失败:', e)

electron/main/windows/manager.ts

@@ -162,7 +162,10 @@ export class WindowManager {
   }
 
   public hideLauncherWindow() {
-    logger.info('Main', `hideLauncherWindow 被调用, 当前窗口状态: ${this.launcherWin ? '存在' : '不存在'}, 销毁状态: ${this.launcherWin?.isDestroyed()}`)
+    logger.info(
+      'Main',
+      `hideLauncherWindow 被调用, 当前窗口状态: ${this.launcherWin ? '存在' : '不存在'}, 销毁状态: ${this.launcherWin?.isDestroyed()}`
+    )
     if (this.launcherWin && !this.launcherWin.isDestroyed()) {
       this.launcherWin.hide()
       logger.info('Main', '已执行 launcherWin.hide()')

package.json

@@ -1,7 +1,7 @@
 {
   "name": "peropero-chat",
   "private": true,
-  "version": "0.8.3",
+  "version": "0.8.4",
   "description": "萌动链接：PeroperoChat！- 一个充满活力的 3D 桌面宠物应用",
   "author": "YoKONCy",
   "license": "Apache-2.0",
@@ -11,6 +11,11 @@
   },
   "main": "dist-electron/main/index.js",
   "scripts": {
+    "sync-version": "node scripts/sync-version.js",
+    "predev:electron": "npm run sync-version",
+    "prebuild:electron": "npm run sync-version",
+    "prebuild:steam": "npm run sync-version",
+    "prebuild:portable": "npm run sync-version",
     "dev:electron": "concurrently -k \"tsc -p electron/tsconfig.json -w\" \"vite\" \"wait-on tcp:127.0.0.1:5173 && cross-env VITE_DEV_SERVER_URL=http://127.0.0.1:5173 electron .\"",
     "build:backend": "node scripts/build-backend.js",
     "build:docker": "vite build --mode docker",
@@ -175,6 +180,10 @@
           "!**/*.pdb",
           "!**/nit_core/plugins/social_adapter/NapCat"
         ]
+      },
+      {
+        "from": "public/Logo.png",
+        "to": "Logo.png"
       }
     ],
     "win": {

scripts/sync-version.js

@@ -0,0 +1,54 @@
+const fs = require('fs')
+const path = require('path')
+
+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.3' // Default fallback
+
+// 1. Read version from .env
+if (fs.existsSync(envPath)) {
+  const envContent = fs.readFileSync(envPath, 'utf-8')
+  // Match PERO_VERSION=x.y.z
+  const match = envContent.match(/^PERO_VERSION\s*=\s*(.+)$/m)
+  if (match) {
+    version = match[1].replace(/['"]/g, '').trim()
+  } else {
+    console.log('[Version Sync] PERO_VERSION not found in .env, using default version:', version)
+  }
+} else {
+  console.log('[Version Sync] .env not found, using default version:', version)
+}
+
+function updateVersion() {
+  let updated = false
+
+  // 2. Update package.json
+  if (fs.existsSync(pkgPath)) {
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'))
+    if (pkg.version !== version) {
+      pkg.version = version
+      fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n')
+      console.log(`[Version Sync] package.json updated to ${version}`)
+      updated = true
+    }
+  }
+
+  // 3. Update backend/pyproject.toml
+  if (fs.existsSync(pyTomlPath)) {
+    let pyToml = fs.readFileSync(pyTomlPath, 'utf8')
+    const replaced = pyToml.replace(/^version\s*=\s*".*"/m, `version = "${version}"`)
+    if (pyToml !== replaced) {
+      fs.writeFileSync(pyTomlPath, replaced)
+      console.log(`[Version Sync] backend/pyproject.toml updated to ${version}`)
+      updated = true
+    }
+  }
+
+  if (!updated) {
+    console.log(`[Version Sync] All versions are already up-to-date (${version})`)
+  }
+}
+
+updateVersion()