Merge branch 'dev'

Author: t41372

.eslintignore

@@ -0,0 +1,3 @@
+src/renderer/WebSDK/**/*.ts
+src/renderer/MotionSync/**/*.js
+src/renderer/MotionSync/**/*.ts 

.gitattributes

@@ -0,0 +1,2 @@
+# Auto detect text files and perform LF normalization
+* text=auto

.github/workflows/build.yml

@@ -67,13 +67,6 @@ jobs:
           VERSION=$(node -e "console.log(require('./package.json').version)")
           echo "build-version=$VERSION" >> $GITHUB_OUTPUT
 
-      - name: Waiting on All checks
-        uses: lewagon/wait-on-check-action@v0.2
-        with:
-          ref: ${{ github.ref }}
-          repo-token: ${{ secrets.GITHUB_TOKEN }}
-          running-workflow-name: 'draft'
-
       - name: Delete outdated drafts
         uses: hugo19941994/delete-draft-releases@v1.0.0
         env:
@@ -142,17 +135,27 @@ jobs:
       - name: Compile & release Electron app
         uses: samuelmeuli/action-electron-builder@v1
         env:
+          # AWS Credentials for S3 publishing
+          AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
+          AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
+          AWS_REGION: ${{ secrets.AWS_REGION }} # Use the region secret
+          # GitHub Token for creating GitHub releases (if still needed)
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           VITE_APP_VERSION: ${{ needs.draft.outputs.version }}
         with:
-          build_script_name: build
-          args: --config electron-builder.yml
           github_token: ${{ secrets.GITHUB_TOKEN }}
-          release: true
+          build_script_name: build
+          args: --config electron-builder.yml --publish always # Ensure publishing is triggered
+          # release: true # Set to false if you ONLY want to publish to S3 and not create a GitHub Release artifact
           max_attempts: 3
 
   build_web:
     needs: [draft]
     runs-on: ubuntu-latest
+    env:
+      AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
+      AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
+      AWS_REGION: ${{ secrets.AWS_REGION }}
 
     steps:
       - uses: actions/checkout@v3
@@ -168,6 +171,28 @@ jobs:
       - name: Build web target
         run: npm run build:web
 
+      - name: Create Web App Zip Archive
+        run: |
+          cd ./dist/web
+          zip -r ../../open-llm-vtuber-web-${{ needs.draft.outputs.version }}.zip .
+          cd ../.. # Go back to the workspace root
+
+      - name: Upload Web App Zip to S3
+        run: |
+          aws s3 cp ./open-llm-vtuber-web-${{ needs.draft.outputs.version }}.zip s3://open-llm-vtuber-frontend/open-llm-vtuber-web-${{ needs.draft.outputs.version }}.zip
+          echo "Web app zip uploaded. Public access depends on S3 bucket policy/settings."
+
+      - name: Configure AWS Credentials
+        uses: aws-actions/configure-aws-credentials@v4
+        with:
+          aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
+          aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
+          aws-region: ${{ secrets.AWS_REGION }}
+
+      - name: Upload web build to S3
+        run: |
+          aws s3 sync ./dist/web s3://open-llm-vtuber-frontend/web --delete
+
       - name: Deploy to GitHub Pages
         uses: JamesIves/github-pages-deploy-action@v4
         with:

.gitignore

@@ -58,4 +58,4 @@ packages/react-devtools-extensions/.tempUserDataDir
 out
 
 # Cursor files
-.cursorrules
+.cursorrules

LICENSE

@@ -0,0 +1,29 @@
+Open-LLM-VTuber License 1.0
+
+Copyright © 2025 Open LLM Vtuber. All rights reserved.
+
+This software is licensed under the Apache License Version 2.0 (the "Apache License"), subject to the following Additional Conditions.
+
+Additional Conditions
+
+1. Definitions
+
+"Software" refers to the Open-LLM-VTuber project and all of its associated components, including but not limited to source code, executable files, web applications, desktop clients, documentation, and accompanying assets.
+
+2. Permitted Uses (No Additional License Required)
+
+You are granted permission to use the software freely, without requiring a commercial license, under the following circumstances:
+
+Non-commercial Uses: Any non-commercial activity including, but not limited to, personal projects, educational purposes, academic research, and non-profit initiatives.
+
+VTuber Streaming and Content Creation: Activities involving VTuber streaming, content creation, broadcasting, and monetization on platforms such as YouTube, Twitch, Bilibili, or other streaming services, provided revenue primarily derives from content creation and not from direct sale, distribution, or subscription to the software itself.
+
+3. Uses Requiring a Commercial License
+
+You must obtain a separate commercial license from Open LLM Vtuber for any of the following uses:
+
+Monetized Access or Hosting Services: Providing paid access to or hosting of the software—whether original, modified, or derivative—including SaaS, subscription models, pay-per-use, or paid downloads and installations.
+
+Commercial Redistribution or Rebranding: Redistributing, repackaging, renaming, or otherwise commercially providing the software (original or modified versions) under any alternative brand, identity, or project name in exchange for payment or other commercial benefits.
+
+Commercial Embedding or Integration: Incorporating this software, wholly or partially, into any commercial software, hardware, or physical product that is sold, licensed, or otherwise distributed for a fee.

README.md

@@ -1,4 +1,4 @@
-# open-llm-vtuber-electron
+# Open LLM Vtuber
 
 An Electron application with React and TypeScript
 

dev-app-update.yml

@@ -0,0 +1,77 @@
+# i18n (国际化) 使用指南
+
+本项目使用 i18next 实现多语言支持，目前支持英语和中文。
+
+## 目录结构
+
+```
+src/renderer/src/
+├── i18n.ts                   # i18next 配置文件
+├── locales/                  # 翻译文件目录
+│   ├── en/                   # 英语翻译
+│   │   └── translation.json  # 英语翻译文件
+│   └── zh/                   # 中文翻译
+│       └── translation.json  # 中文翻译文件
+```
+
+## 使用方法
+
+### 在组件中使用
+
+```tsx
+import { useTranslation } from 'react-i18next';
+
+function MyComponent() {
+  // 获取翻译函数和其他国际化工具
+  const { t, i18n } = useTranslation();
+  
+  // 使用 t 函数翻译文本
+  return (
+    <div>
+      <h1>{t('common.settings')}</h1>
+      <p>{t('settings.general.language')}</p>
+      
+      {/* 改变语言 */}
+      <button onClick={() => i18n.changeLanguage('en')}>English</button>
+      <button onClick={() => i18n.changeLanguage('zh')}>中文</button>
+    </div>
+  );
+}
+```
+
+### 添加新的翻译
+
+1. 在代码中使用 `t('your.translation.key')` 添加新的翻译键
+2. 运行扫描命令提取翻译键：
+
+```bash
+npm run extract-translations
+```
+
+3. 添加的翻译键会更新到 `src/renderer/src/locales/en/translation.json` 和 `src/renderer/src/locales/zh/translation.json` 文件中
+4. 编辑中文翻译文件，为每个键添加对应的中文翻译
+
+## 翻译键命名规则
+
+我们使用点号分隔的命名空间来组织翻译键，例如：
+
+- `common.save` - 通用的"保存"按钮文本
+- `settings.general.language` - 设置页面中的语言设置项
+
+## 嵌套翻译
+
+对于包含变量的文本，可以使用插值：
+
+```tsx
+// 在翻译文件中
+{
+  "welcome": "欢迎, {{name}}!"
+}
+
+// 在组件中
+t('welcome', { name: 'John' }) // "欢迎, John!"
+```
+
+## 自动检测语言
+
+系统会自动检测用户的浏览器语言设置，并使用最接近的可用语言。用户也可以手动切换语言，选择会被保存在 localStorage 中。 

docs/i18n-usage.md

@@ -1,5 +1,5 @@
 appId: com.electron.app
-productName: open-llm-vtuber-electron
+productName: "Open LLM Vtuber"
 directories:
   buildResources: resources
   output: release/${version}
@@ -16,7 +16,7 @@ files:
 asarUnpack:
   - resources/**
 win:
-  executableName: open-llm-vtuber-electron
+  executableName: Open LLM Vtuber
   icon: resources/icon.ico
 nsis:
   artifactName: ${name}-${version}-setup.${ext}
@@ -45,7 +45,9 @@ appImage:
   artifactName: ${name}-${version}.${ext}
 npmRebuild: false
 publish:
-  provider: github
-  releaseType: release
+  provider: s3
+  bucket: open-llm-vtuber-frontend
+  region: ap-northeast-1
+  acl: null
 electronDownload:
   mirror: https://npmmirror.com/mirrors/electron/

electron-builder.yml

@@ -15,6 +15,13 @@ export default defineConfig({
     resolve: {
       alias: {
         '@': resolve('src/renderer/src'),
+        "@framework": resolve("src/renderer/WebSDK/Framework/src"),
+        "@cubismsdksamples": resolve("src/renderer/WebSDK/src"),
+        "@motionsyncframework": resolve(
+          "src/renderer/MotionSync/Framework/src",
+        ),
+        "@motionsync": resolve("src/renderer/MotionSync/src"),
+        "/src": resolve("src/renderer/src"),
       },
     },
     plugins: [
@@ -36,6 +43,10 @@ export default defineConfig({
             src: normalizePath(resolve(__dirname, 'node_modules/onnxruntime-web/dist/*.wasm')),
             dest: './libs/',
           },
+          {
+            src: normalizePath(resolve(__dirname, 'src/renderer/WebSDK/Core/live2dcubismcore.js')),
+            dest: './libs/'
+          }
         ],
       }),
       react(),