# miofun

**Repository Path**: dullwolf/miofun

## Basic Information

- **Project Name**: miofun
- **Description**: 一个MIO二次元平台
- **Primary Language**: HTML
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-01
- **Last Updated**: 2026-02-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Mio-Fun

#### 介绍
一个MIO二次元平台，集成了多种功能的Electron应用程序。

#### 环境配置

本项目支持开发环境和生产环境的配置切换，方便本地开发和部署使用。

### 配置文件

配置信息存储在 `resources/config.json` 文件中：

```json
{
  "environments": {
    "development": {
      "apiBaseUrl": "http://127.0.0.1:8081/mio3",
      "name": "开发环境"
    },
    "production": {
      "apiBaseUrl": "http://43.132.146.198:8081/mio3",
      "name": "生产环境"
    }
  },
  "defaultEnvironment": "production"
}
```

您可以直接编辑此文件来修改各环境的URL设置。

## 运行脚本

### 开发环境

```bash
# 方法1：使用命令行参数
npm run start:dev

# 方法2：使用环境变量
npm run start:development
```

### 生产环境

```bash
# 方法1：默认启动
npm run start

# 方法2：明确指定生产环境
npm run start:prod
npm run start:production
```

## 构建打包

### 开发环境打包

```bash
# 仅打包目录
npm run pack:dev

# 完整打包（生成安装包）
npm run dist:dev
```

### 生产环境打包

```bash
# 仅打包目录
npm run pack

# 完整打包（生成安装包）
npm run dist
```

## 环境切换说明

应用程序会根据以下优先级确定使用的环境：

1. 命令行参数（`--dev` 或 `-d`）
2. 环境变量（`NODE_ENV=development`）
3. 配置文件中的默认设置

在应用程序底部的状态栏中，会显示当前使用的环境和URL信息。

## 快捷键

- `Ctrl+R`：刷新页面
- `F11`：全屏切换
- `Ctrl+Shift+D`：开发模式切换（预留功能）

## 本地开源多语种识别（实验）

已新增本地 Python 服务（`resources/mio/asr_service.py`），用于基于 `faster-whisper` 做音频转文本，并在本地链路返回翻译结果。

首次使用请安装依赖：

```bash
pip install -r resources/mio/requirements.txt
```

默认由 Electron 主进程自动启动本地服务（`127.0.0.1:24679`）。

离线翻译使用 Argos。请提前安装对应语言包（例如日文->中文）后可完全离线翻译；若未安装语言包，系统会返回原文。

### 预置本地识别模型（推荐）

为避免用户弱网导致首次下载失败，可将 whisper 模型直接放入项目并随安装包分发。

- 默认本地模型目录：`resources/mio/models/faster-whisper-tiny`
- 必需文件：`config.json`、`tokenizer.json`、`vocabulary.txt`、`model.bin`
- 启动策略：优先加载本地目录；本地目录无效时自动回退到在线下载

可先执行下载脚本，把模型拉到项目目录：

```bash
python resources/mio/download_whisper_model.py --model-size tiny
```

也可通过环境变量覆盖模型目录：

```bash
LOCAL_ASR_MODEL_DIR=/absolute/path/to/faster-whisper-tiny npm run start
```

### 打包说明（已配置）

构建配置已将以下内容写入 `extraResources`，安装包可直接携带本地识别资源：

- `resources/mio/asr_service.py` -> `resources/mio/asr_service.py`
- `resources/mio/requirements.txt` -> `resources/mio/requirements.txt`
- `resources/mio/models/**` -> `resources/mio/models/**`

安装版运行时会优先从 `process.resourcesPath/mio/...` 读取这些文件。

#### 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request

## 作者

dullwolf蠢狼