# AI-DREAM-OS

**Repository Path**: GhostMask/ai-dream-os

## Basic Information

- **Project Name**: AI-DREAM-OS
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-17
- **Last Updated**: 2026-08-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI Drama Production OS

AI 漫剧生产管理系统的本地磁盘优先实现。当前已完成总控协议“阶段 6”（生成中心）：在冻结快照之上，实现批量视频任务派生（幂等）、Mock 全链路（.part 下载/哈希校验/journal/原子入库/DRAFT Take）、取消/重试、重启恢复与中文生成中心台，并提供一键演示数据种子脚本；最终只读闸门 P0 = 0，允许进入阶段 7（声音与交付）。

## 当前范围

- 第一次启动与工作区初始化
- 中文工作区/项目目录
- SQLite + WAL + Alembic（`0001`–`0013`）
- 稳定内部 ID 与统一帧时间服务
- 受控本地文件服务、Hash、`.part`、原子移动与恢复日志
- 基础生产对象的最小创建/读取链路
- Mock 异步任务
- Project、Episode、Scene、Shot、Character、Location、Prop、Outfit、Voice、Asset、AssetVersion、GenerationJob、Take 的管理 API
- 乐观并发、审核/驳回/锁定、软删除与结构化引用阻断
- 资产版本显式激活、人物身份版本锁定与镜头最终 Take 选择
- ScriptVersion 不可变正文、双文件镜像、审核锁定与显式 current
- 文本 Provider/Model、PromptVersion、Schema Catalog 与无密钥安全边界
- AI Task/Attempt/Event、原始输出留档、JSON Schema/Pydantic 校验与 Repair
- Suggestion 稳定 ID 匹配、冲突/过期、分批选择与单批原子应用
- 世界事实、人物知识、伏笔、剧情摘要和资产需求
- AssetPackage/PackageVersion/Item 聚合与固定槽位词表、显式 current 与锁定替换
- 从资产需求显式建包、CONFIRMED→FULFILLED 原子履约
- 资产生成请求（手动上传/外部任务卡/MOCK 图片/API 图片）、参考图包与多文件导入失败关闭
- TECHNICAL/IDENTITY_CONSISTENCY/PACKAGE_CONSISTENCY 三类 append-only 质检与来源记录
- 图片 Provider 抽象（Mock/GLM-Image/CogView）、ModelCapabilityVersion 与付费默认关闭边界
- 资产版本影响分析、损坏文件恢复拒绝与工作区换根可读
- ShotSpec 结构化版本与固定镜头语言词表、首帧/尾帧/中间帧精确引用、入场/出场状态
- 镜头规格状态机与显式 current、开拍准备度派生（复用锁定资产包）与轴线提示
- 提示词编译器（SHOT_PROMPT 模板版本固定、五种方言、确定性哈希）
- 中文剧本智能工作台、任务审计与长期记忆视图
- 中文资产生产台（需求/对象树、包与槽位、生产抽屉）
- 中文分镜导演台（场次/镜头树、规格版本、镜头语言表单、准备度、编译抽屉）
- 七类开拍检查（资源/连戏/镜头语言/时长/模型能力/预算/磁盘）与 append-only 运行记录
- 生产快照：精确依赖登记、manifest 文件日志原子冻结、冻结后不可变、Drift 修改影响分析
- 中文开拍检查台（剧集、检查报告、快照版本、依赖表、Drift）
- 生成中心：冻结快照批量派生视频任务（幂等）、Mock 全链路入库与 DRAFT Take、取消/重试、重启恢复
- 演示数据种子脚本 `scripts/seed_demo_data.py`（一键构造完整可测试项目）
- 中文生成中心台（快照树、批量生成、任务表、事件流、Take 概览）

尚未接入真实图片、视频或语音付费模型；真实 Provider 只在 `allow_paid_generation` 显式开启、密钥可用且费用确认后启用（Mock 全链路开箱可用）。声音与交付属于最后的阶段 7。GLM/DeepSeek 文本适配器已实现，但真实调用只在明确配置 OS 密钥引用后启用。

## 开发环境

完整的安装、启动、环境变量、数据位置与常见问题见 **`docs/getting-started.md`（启动与运行指南）**。

快速开始（PowerShell）：

```powershell
.\scripts\setup.ps1      # 首次安装依赖
.\scripts\dev.ps1        # 一键启动前后端（Ctrl+C 同时停止）
```

也可分开启动：`.\scripts\dev-api.ps1`（后端 8000）与 `.\scripts\dev-web.ps1`（前端 3000）。

默认地址：前端 `http://127.0.0.1:3000`，后端 `http://127.0.0.1:8000`。后端不应监听 `0.0.0.0`。

## 文档

- 原始业务设计与模型总控文档保留在仓库根目录，不做修改。
- 编码前架构基线见 `docs/architecture/00-architecture-baseline.md`。
- 阶段 1 设计基线见 `docs/architecture/01-stage1-core-production-design.md`。
- 阶段 2 设计基线见 `docs/architecture/02-stage2-script-intelligence-design.md`。
- 阶段 3 设计基线见 `docs/architecture/03-stage3-asset-production-design.md`。
- 阶段 4 设计基线见 `docs/architecture/04-stage4-storyboard-director-design.md`。
- 阶段 0 强制验收报告见 `docs/acceptance/stage-0-report.md`。
- 阶段 1 强制验收报告见 `docs/acceptance/stage-1-report.md`。
- 阶段 2 强制验收报告见 `docs/acceptance/stage-2-report.md`。
- 阶段 3 强制验收报告见 `docs/acceptance/stage-3-report.md`（第 11 项为“是”，允许进入阶段 4）。
- 阶段 4 强制验收报告见 `docs/acceptance/stage-4-report.md`（第 11 项为“是”，允许进入阶段 5）。
- 阶段 5 设计基线见 `docs/architecture/05-stage5-preflight-snapshot-design.md`。
- 阶段 5 强制验收报告见 `docs/acceptance/stage-5-report.md`（第 11 项为“是”，允许进入阶段 6）。
- 阶段 6 设计基线见 `docs/architecture/06-stage6-generation-center-design.md`。
- 阶段 6 强制验收报告见 `docs/acceptance/stage-6-report.md`（第 11 项为“是”，允许进入阶段 7）。
- 启动与运行指南见 `docs/getting-started.md`。
- 总实现进度见 `docs/progress/implementation-progress.md`。