AI 短剧项目资产工程化管理方案：素材溯源、版本管控与云端交付体系落地

drama_001_都市逆袭_v2/
├─ 01_raw_asset                # 原始资产区｜只读，禁止写入修改
│   ├─ character_source        # 角色原图、人设立绘、参考图
│   ├─ audio_original          # 原始配音、背景音乐干声、音效源文件
│   ├─ prompt_lib              # 角色提示词、风格LORA参数、正向反向提示词
│   └─ story_script            # 原始剧本、台词文档
├─ 02_workspace                # 工作迭代区｜所有编辑、渲染、调试在这里操作
│   ├─ storyboard              # 分镜工程、镜头序列
│   ├─ render_temp             # 渲染缓存、片段输出、临时合成文件
│   └─ draft_project           # ComfyUI、剪映、Animate工程文件
├─ 03_release                  # 交付成品区｜冻结版本，对外输出
│   ├─ official_output         # 正片成片、字幕版
│   └─ preview_snippet          # 引流预告切片、封面图
├─ 04_meta_docs                # 元数据与说明文档
│   ├─ readme.md               # 版本日志、交付说明、文件说明
│   ├─ file_manifest.json      # 资产清单（脚本自动生成）
│   └─ hash_checksum.csv       # 文件哈希校验表
└─ 05_archive                  # 历史归档区｜废弃版本、旧成片、作废素材

import os
import json
import hashlib
import csv
from datetime import datetime
def calculate_sha256(file_path: str) -> str:
    """计算文件SHA256哈希，用于完整性校验"""
    sha256_hash = hashlib.sha256()
    try:
        with open(file_path, "rb") as f:
            for byte_block in iter(lambda: f.read(65536), b""):
                sha256_hash.update(byte_block)
        return sha256_hash.hexdigest()
    except Exception as e:
        return f"ERROR:{str(e)}"
def scan_drama_asset(project_root: str):
    asset_manifest = {
        "project_root": os.path.basename(project_root),
        "scan_datetime": datetime.now().strftime("%Y-%m-%d %H:%M:%S"),
        "total_file_count": 0,
        "total_size_bytes": 0,
        "asset_list": []
    }
    for root, _, files in os.walk(project_root):
        for fname in files:
            full_path = os.path.join(root, fname)
            rel_path = os.path.relpath(full_path, project_root)
            # 跳过脚本自身，避免参与校验
            if fname.endswith(".py"):
                continue
            try:
                f_size = os.path.getsize(full_path)
                f_hash = calculate_sha256(full_path)
            except Exception:
                continue
            asset_manifest["total_file_count"] += 1
            asset_manifest["total_size_bytes"] += f_size
            asset_manifest["asset_list"].append({
                "relative_path": rel_path,
                "size_bytes": f_size,
                "sha256": f_hash
            })
    return asset_manifest
def save_manifest(project_root: str):
    meta_dir = os.path.join(project_root, "04_meta_docs")
    os.makedirs(meta_dir, exist_ok=True)
    manifest = scan_drama_asset(project_root)
    json_path = os.path.join(meta_dir, "file_manifest.json")
    csv_path = os.path.join(meta_dir, "hash_checksum.csv")
    # 写入json清单
    with open(json_path, "w", encoding="utf-8") as fj:
        json.dump(manifest, fj, ensure_ascii=False, indent=2)
    # 写入csv哈希表，方便Excel查看对比
    with open(csv_path, "w", encoding="utf-8", newline="") as fc:
        writer = csv.DictWriter(fc, fieldnames=["relative_path", "size_bytes", "sha256"])
        writer.writeheader()
        writer.writerows(manifest["asset_list"])
    total_mb = round(manifest["total_size_bytes"] / 1024 / 1024, 2)
    print("✅ 短剧资产清单生成完成")
    print(f"文件总数：{manifest['total_file_count']}")
    print(f"总容量：{total_mb} MB")
    print(f"清单文件：{json_path}")
    print(f"校验表：{csv_path}")
if __name__ == "__main__":
    # 修改此处为你的短剧项目本地根目录
    PROJECT_DIR = r"./drama_001_都市逆袭_v2"
    if os.path.isdir(PROJECT_DIR):
        save_manifest(PROJECT_DIR)
    else:
        print(f"❌ 项目目录不存在，请检查路径：{PROJECT_DIR}")