dsh-plugin-vrmpet3d 0.1.0 → 0.1.2

package/README.md

@@ -42,6 +42,7 @@ no runtime dependencies · works offline
 | 互动 | 点击与长按部位触发表情和碎碎念；拖动、缩放、旋转视角、视线跟随和弹簧骨物理 |
 | 碎碎念 | 内置台词、自定义台词，或使用 DSH 模型 / OpenAI 兼容接口生成 AI 台词 |
 | 导入 | 模型以文件导入、动作包以文件夹导入，复制到插件存储后不依赖原路径 |
+| 界面语言 | 全部界面中英双语，默认跟随系统 / DSH 自动识别；「通用设置 → 显示与外观」和初次引导欢迎页各有一个语言选择（自动 / 中文 / English） |
 
 ## 运行要求
 
@@ -155,6 +156,7 @@ The marketplace screenshot order is declared in the root [screenshots.json](scre
 | Interaction | Click or hold body parts for expressions and chatter; drag, resize, rotate the view, follow the pointer and use spring-bone physics |
 | Chatter | Built-in or custom lines, or AI-generated lines using a DSH model or an OpenAI-compatible service |
 | Import | Import models as files and motion packs as folders. Imported files are copied into plugin storage and no longer depend on their original paths |
+| Language | The whole interface is Chinese and English, auto-detected from the system or DSH by default; a chooser (Auto / 中文 / English) sits in General settings → Display, and on the first-run guide's welcome screen |
 
 ### Requirements
 

package/desktop/main.js

@@ -8,7 +8,7 @@
 // Everything here was measured before it was written (see HANDOFF §12): a transparent
 // always-on-top window renders WebGL with a real alpha channel, can be resized to the whole
 // screen, and `capturePage()` returns pixels that are mostly fully transparent.
-const { app, BrowserWindow, dialog, ipcMain, screen } = require('electron');
+const { app, BrowserWindow, dialog, ipcMain, screen, shell } = require('electron');
 const fs = require('node:fs');
 const path = require('node:path');
 
@@ -37,6 +37,47 @@ const DEFAULT_PET_WINDOW = { width: 240, height: 320 };
  */
 const VRMPET3D_STATUS_PREFIX = 'vrmpet3d-desktop: ';
 
+/**
+ * The words THIS process puts on screen itself: the two native dialog titles and the model filter's name.
+ *
+ * Nothing else here is a string a user reads — every other sentence in this file is a log line or a self-test
+ * report — and these three are the exception because Electron, not a page, draws them. The window title is
+ * deliberately NOT in this table: it names the launcher's own window (`vrmpet3d - model settings`) and is the same
+ * ASCII wherever the user is, so a translated one would add a second name for a window the user finds by that one.
+ *
+ * The launcher is a SEPARATE PROCESS with no access to `lib/core.js`, so it keeps its own copy of the repository's
+ * two-language shape (`{ zh: {...}, en: {...} }`, identical key sets) rather than importing the host's rules.
+ */
+const DIALOG_TEXT = {
+  zh: { motionTitle: '导入动作目录', modelTitle: '导入模型文件', modelFilter: 'VRM / glTF 模型' },
+  en: { motionTitle: 'Import motion folder', modelTitle: 'Import model file', modelFilter: 'VRM / glTF model' },
+};
+
+/**
+ * Which of the two this process draws in, for one request.
+ *
+ * The PAGE wins whenever it says something this process understands. The settings page knows the user's
+ * `preferences.language`, which may be a deliberate 中文 on an English machine or the reverse, so it is the better
+ * authority when it speaks; it may pass that as `{ kind, language }`, and `'auto'` (or nothing at all) is not a
+ * language, so the fallback is `app.getLocale()` — the machine's own locale, which is exactly what `'auto'` means
+ * for a surface with no DSH locale to consult.
+ *
+ * The field is OPTIONAL and nothing here requires it: an older page that sends only `{ kind }` (without a language argument) gets the locale, and a page that sends a value neither of the two languages
+ * ignores it rather than having it guessed at.
+ */
+function dialogLanguage(options) {
+  const wanted = options && typeof options === 'object' ? options.language : null;
+  if (wanted === 'zh' || wanted === 'en') return wanted;
+  let locale = '';
+  try {
+    // After `ready`, which every handler here is; a locale that cannot be read is not a reason to fail a dialog.
+    locale = app.getLocale() || '';
+  } catch (_error) {
+    locale = '';
+  }
+  return /^(zh|cn|chinese)/i.test(String(locale).trim()) ? 'zh' : 'en';
+}
+
 /**
  * The payload the page expects for a cursor sample.
  *
@@ -563,6 +604,7 @@ app.whenReady().then(async () => {
       if (!probing) sendCursor(lastCursor);
     };
 
+    ipcMain.on('vrmpet3d:focus-host', () => { shell.openExternal('dsh://open').catch(() => {}); });
     ipcMain.handle('vrmpet3d:config', () => ({
       modelId: options.modelId,
       assetBase: '/vrmpet3d/asset',
@@ -590,15 +632,16 @@ app.whenReady().then(async () => {
      */
     ipcMain.handle('vrmpet3d:pick-path', async (_event, options) => {
       const kind = options && typeof options === 'object' && options.kind === 'motion' ? 'motion' : 'model';
+      const text = DIALOG_TEXT[dialogLanguage(options)] || DIALOG_TEXT.en;
       try {
         const result = await dialog.showOpenDialog(win, kind === 'motion' ? {
-          title: '导入动作目录',
+          title: text.motionTitle,
           properties: ['openDirectory'],
           defaultPath: app.getPath('home'),
         } : {
-          title: '导入模型文件',
+          title: text.modelTitle,
           properties: ['openFile'],
-          filters: [{ name: 'VRM / glTF 模型', extensions: ['vrm', 'glb', 'gltf'] }],
+          filters: [{ name: text.modelFilter, extensions: ['vrm', 'glb', 'gltf'] }],
           defaultPath: app.getPath('home'),
         });
         if (result.canceled || !Array.isArray(result.filePaths) || !result.filePaths.length) return null;

package/desktop/preload.js

@@ -13,6 +13,7 @@ contextBridge.exposeInMainWorld('vrmpet3dDesktop', {
    * Sent as an invoke so the page can await it before mounting anything.
    */
   config: () => ipcRenderer.invoke('vrmpet3d:config'),
+  focusHost: () => ipcRenderer.send('vrmpet3d:focus-host'),
 
   /** The global cursor position, pushed by the main process at frame rate. */
   onCursor: (callback) => {
@@ -39,7 +40,9 @@ contextBridge.exposeInMainWorld('vrmpet3dDesktop', {
    * plugin's own storage. The host stays the only writer of that list, and the `VRMPET3D_MODEL_FILES_FILE` /
    * `VRMPET3D_IMPORT_DIR` overrides the suites rely on are not bypassed.
    */
-  pickModelFile: () => ipcRenderer.invoke('vrmpet3d:pick-path', { kind: 'model' }),
+  pickModelFile: (language) => ipcRenderer.invoke('vrmpet3d:pick-path', {
+    kind: 'model', language: language === 'zh' || language === 'en' ? language : undefined,
+  }),
 
   /**
    * The same dialog for an imported MOTION folder (`/vrmpet3d/motions`), which stays a DIRECTORY: a motion pack is
@@ -47,7 +50,9 @@ contextBridge.exposeInMainWorld('vrmpet3dDesktop', {
    *
    * One channel for both, with `kind` deciding a FILE dialog from a folder one and the title each shows.
    */
-  pickMotionDir: () => ipcRenderer.invoke('vrmpet3d:pick-path', { kind: 'motion' }),
+  pickMotionDir: (language) => ipcRenderer.invoke('vrmpet3d:pick-path', {
+    kind: 'motion', language: language === 'zh' || language === 'en' ? language : undefined,
+  }),
 
   /**
    * Tell the launcher that a VIEW ORBIT is starting or ending — and let IT take the pointer lock.