# AiLeaf

**Repository Path**: httpxiaohou/ai-leaf

## Basic Information

- **Project Name**: AiLeaf
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI Leaf 漫剧制作工作台

AI Leaf 是一个本地运行的 AI 漫剧制作工具原型。它把小说或章节正文转换成可恢复的制作流程，并在 LeaferJS 画布上展示原文、改编规划、资产分析、分镜表、分镜图墙和视频包节点。

## 环境准备

```bash
npm install
```

## 本地开发

```bash
npm run dev
```

启动后默认地址：

- Web：`http://127.0.0.1:5173`
- API：`http://127.0.0.1:3001`

Web 开发服务器会把 `/api` 请求代理到本地 API 服务。

## SQLite 数据库

默认 SQLite 文件位置：

```text
data/aileaf.sqlite
```

可以通过环境变量覆盖：

```bash
SQLITE_PATH=data/aileaf-dev.sqlite npm run dev
```

## AI 供应方模式

默认使用 `mock` 模式，适合本地开发和端到端流程验证，不需要外部 AI 服务。

`http` 模式会调用外部 AI 网关，需要设置：

```bash
AI_GATEWAY_URL=https://example.com
AI_API_KEY=your-api-key
npm run dev
```

缺少 `AI_GATEWAY_URL` 或 `AI_API_KEY` 时，`http` 模式会快速失败并返回 `PROVIDER_CONFIG_MISSING`。

## 常用检查

```bash
npm run typecheck
npm run test
```