# ymirva

**Repository Path**: ysbwsx/ymirva

## Basic Information

- **Project Name**: ymirva
- **Description**: 弥尔瓦·影像资产
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-07
- **Last Updated**: 2026-08-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 弥尔瓦 Ymirva

**弥尔瓦影像资产** — 角色形象锚定与人物定型素材核心管理。

基于 [app-scaffold](../app-scaffold)（Vite + React + TypeScript + Capacitor）骨架搭建。

## 核心能力

- **角色库**：人物档案、形象锚定、定型素材（挂在角色下）
- **场景库**：短剧场景档案（办公室、公司楼下、餐厅等），文字描述 + 参考图
- **服装库**：造型服装档案（职场/约会/居家等），挂接角色 + 参考图
- **道具库**：拍摄道具档案（车辆 / 手持 / 陈设等），可挂视频镜头；车辆支持车身色与车型锁定
- **视频库**：AI 生成成片 / 镜头资产，挂接角色·场景·服装·道具，支持外链与本地上传
- **词汇库**：脸型提示词 + 锚定 / 发型 / 服装 / 姿态 / 表情 / 风格描述词
- **资产总览**：锚定进度、场景与服装参考图、道具（含车辆）、视频资产、置顶跟进与工作台备注

## 技术栈

- Vite 8 + React 19 + TypeScript
- React Router
- Capacitor 8（Android）
- 简易 PWA（`public/sw.js`）

## 本地运行

```bash
cd ~/Desktop/ymirva
npm install
npm run dev
```

## Web 打包

```bash
npm run build
```

产物在 `dist/`。

## 安卓 APK

### 环境

- Node.js / npm
- JDK 21（或兼容版本）
- Android SDK（`android/local.properties` 中配置 `sdk.dir`）

> **外置盘注意**：Gradle 缓存已软链到本机  
> `~/Library/Caches/ymirva-android-gradle`、`~/Library/Caches/ymirva-android-build`。  
> 若出现锁超时，先执行 `cd android && ./gradlew --stop` 再打包。

### Debug

```bash
npm run android:apk
```

APK：`android/app/build/outputs/apk/debug/app-debug.apk`

### Release

```bash
cp android/keystore.properties.example android/keystore.properties
# 填写签名信息后
npm run android:apk:release
```

## 标识

| 项 | 值 |
| --- | --- |
| 仓库 / npm name | `ymirva` |
| 产品名 | 弥尔瓦影像资产 |
| 应用短名 | 弥尔瓦 |
| appId | `app.ymirva.mid` |