Files
AI-cut/docs/ARCHITECTURE.md

14 lines
1.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 轻映 AI 架构与实施边界
2026-10-18,空目录启动。运行环境 Node 24、Windows,无 Rust 和系统 FFmpeg。
选用 Electron + React + TypeScript;以随应用分发的 FFmpeg/FFprobe 执行媒体处理,sql.js SQLite 实现项目持久化。初版无需 Python,避免把没有实现的分析服务作为安装依赖。后续专用跟踪、ASR 可由独立打包服务提供。
模块:renderer(中文工作台)、preload(白名单 IPC)、main(桌面生命周期/文件选择/安全存储)、core/project(SQLite、命令历史)、core/media(探测、代理、分析、导出)、core/providers(真实协议、流式下载、能力检测)、任务队列(取消、进度)。
安全边界:渲染器无 Node 权限;只接受本窗口 IPC;媒体协议只开放用户导入的文件与应用缓存;模型密钥由 Electron safeStorage 调用 Windows DPAPI 加密;项目不含密钥。云端帧上传默认关闭,单独授权后启用,无自动云端回退。
项目文件 .qycut 是 SQLite 数据库;state 表保存素材、分析、轨道、完整命令历史,保存通过临时文件+rename 原子替换,保留上一版本备份。媒体原件只读引用。导出使用独立临时片段并拼接,异常和取消清理半成品。
实施顺序:1 基础媒体链路与 SQLite;2 Provider 与本地管理;3 时间戳场景分析和真实视觉调用;4 可验证的 AI 规划命令及人工修改;5 打包与真实媒体集成测试。全量需求中的专用动作跟踪、说话人分离、专业关键帧与高级适配器等只有实现且实测后才可标记完成。