本地优先的漫剧创作工作站 —— 从剧本到成片，素材自己管、模型自己选，零依赖第三方 SaaS。
漫剧（竖屏短剧/条漫视频）正在成为内容赛道的新形态，但创作者面临三个结构性痛点：
- 工具链断裂 —— 脚本、分镜、AI 生图、视频剪辑、配音散落在 5–8 个不同工具里，每次切换都是上下文丢失
- 素材失控 —— AI 生成的图/视频动辄数百张，散落在下载目录和云端，版本混乱、角色不一致，靠人肉管理
- 被平台锁定 —— 现有 AI 创作工具大多是 SaaS，数据存在别人服务器上，换平台 = 从零开始；模型只能用平台绑定的那一个
Mango 的回答：把从剧本到成片的全流程收敛到一个本地桌面应用里。
- 本地优先（Local-first） —— 项目数据、素材、数据库全部在用户自己的磁盘上。仅在调用 AI 模型 API 时联网，断网也能编辑和导出。不做账号体系，不做云同步，不碰用户数据。
- 模型无关（Model-agnostic） —— 不绑定任何单一 AI 供应商。通过 Provider 抽象层接入任意 HTTP API 模型，今天用百炼、明天换 Replicate、后天接本地 ComfyUI，只需实现一个 trait。
- 创作者视角（Creator-first） —— 不做通用视频编辑器，只做漫剧需要的东西。分镜→生图→选图→配音→剪辑→导出，每一步都按漫剧工作流设计，而不是堆一堆通用功能让创作者自己拼。
- 可控的自动化 —— AI 负责生成，人负责决策。批量生成 + 抽卡对比 + 一键采纳，而不是"全自动出片"然后修不了。
- 本地优先，数据不上云 —— 所有项目数据存储在本地 SQLite，仅在调用 AI 模型 API 时联网
- AI 生图 / 生视频 —— 已对接百炼 DashScope（
wan2.7-image-pro文生图 +happyhorse-1.0-r2v参考图生视频） - 主体库管理 —— 角色 / 场景 / 道具 / 服装四类实体，支持参考图绑定，解决角色一致性问题
- API 账号安全管理 —— 基于系统 Keychain（keyring）加密存储 API Key，不落盘明文
- CLI + GUI 双模式 —— 桌面应用可视化操作，CLI 适配批量处理与自动化脚本
- 节点画布（规划中） —— 漫剧业务语义的可视化编排，非通用节点编辑器
| 层级 | 技术 |
|---|---|
| 后端核心 | Rust, tokio, rusqlite, reqwest, thiserror |
| 桌面框架 | Tauri 2.x（系统 WebView） |
| 前端 | React 19, TypeScript 6, Vite 8, Tailwind CSS 4, shadcn/ui |
| 状态管理 | Zustand 5 + TanStack Query 5 |
| CLI | clap 4, comfy-table |
| 密钥存储 | keyring 4（macOS Keychain / Windows Credential Manager / Linux Secret Service） |
| 类型对齐 | ts-rs 12 + specta 2 |
mango/
├── crates/
│ ├── core/ # 核心业务库（DB / Provider / 任务引擎 / 素材管理 / 账号）
│ └── cli/ # CLI 二进制（mango 命令行工具）
├── src-tauri/ # Tauri 桌面应用（IPC commands + 窗口管理）
├── src/ # React 前端
│ ├── components/ # UI 组件（layout / subjects / generation / accounts）
│ ├── hooks/ # React Query hooks
│ ├── pages/ # 路由页面
│ ├── stores/ # Zustand stores
│ └── lib/ # 工具函数 + ts-rs 类型绑定
├── docs/ # 项目文档（规划 / 迭代 spec / 工作日志）
├── Cargo.toml # Rust workspace 根配置
├── package.json # 前端依赖
└── vite.config.ts # Vite 构建配置
| 工具 | 版本要求 |
|---|---|
| Rust | 1.94+（见 rust-toolchain.toml） |
| Node.js | 见 .node-version |
| pnpm | 11.x |
| 系统依赖 | macOS: Xcode CLT / Linux: webkit2gtk 等 Tauri 依赖 |
# 克隆项目
git clone https://github.com/mango/mango.git
cd mango
# 安装前端依赖
pnpm install
# 开发模式启动（同时编译 Rust 后端 + 启动前端 dev server）
pnpm tauri dev# 构建 CLI
cargo build --release -p mango-cli
# 运行（二进制位于 target/release/mango-cli）
./target/release/mango-cli project list# 项目管理
mango project create --name "我的漫剧"
mango project list
# 角色管理
mango character create --project <id> --name "小明" --appearance "黑发少年，校服"
mango character list --project <id>
# API 账号管理
mango account add --provider bailian --label "我的百炼账号"
# AI 生成任务
mango task submit --project <id> --model wan2.7-image-pro --prompt "少年站在樱花树下"
mango task status <task-id>
mango task list --project <id>
mango task cancel <task-id>| 里程碑 | 名称 | 状态 | 说明 |
|---|---|---|---|
| MS0 | 工程基座 + 项目管理 | ✅ 已完成 | Tauri + React + SQLite + CLI 全链路 |
| MS1 | 主体库 + 账号管理 | ✅ 已完成 | 角色/场景/道具/服装 CRUD + keyring 账号 |
| MS2 | AI 生图 / 生视频 | ✅ 已完成 | 百炼 Provider + 任务引擎 + 结果下载 |
| MS3 | 节点画布 | 📋 规划中 | React Flow 业务语义画布 |
| MS4 | 单 Provider 下多模型 + 批量 + 版本管理 | 📋 规划中 | 百炼多模型 + 并发控制 + 抽卡对比 + Checkpoint |
| MS5 | 视频后期 | 📋 规划中 | FFmpeg 裁剪/拼接 + 字幕/气泡 |
| MS6 | 配音 + 成片闭环 | 📋 规划中 | TTS 配音 + 音效 + 最终合成导出 |
# Rust lint
cargo clippy --workspace --all-targets
# 前端类型检查
pnpm typecheck# Rust 单元测试
cargo test --workspace
# 前端测试
pnpm test:runRust 结构体变更后，重新生成 TypeScript 类型绑定：
cargo test --workspace # ts-rs 在测试阶段输出 .ts 文件到 src/lib/bindings/# 仅前端开发（不启动 Tauri，用于纯 UI 调试）
pnpm dev
# 完整桌面应用开发
pnpm tauri dev