核心功能
openstoryline-install 是一套面向 FireRed-OpenStoryline 项目的完整本地部署方案，涵盖从源码克隆到服务启动的全生命周期管理。该工具专为 AI 驱动的叙事内容生成场景设计，支持 MCP（Model Context Protocol）服务端与 Web 前端的双服务架构一键启动。
显著优点
1. 环境自适应智能检测：内置多层级解释器选择策略，优先复用现有 Python 3.11+ 环境，自动降级至 conda 创建隔离环境，避免版本冲突
2. 确定性安装流程：严格遵循"检测→虚拟环境→依赖→资源→配置→验证"六阶段流水线，每个节点都有明确的退出条件和状态报告
3. 生产级资源管理：集成 download.sh 断点续传能力，妥善处理 GB 级模型权重与资源包下载，支持网络中断后的自动恢复
4. 配置安全注入：通过专用脚本 update_config.py 完成 API 密钥的程序化写入，避免手动编辑 TOML 的格式风险
5. 双轨启动模式：既支持手动分步调试（MCP + Uvicorn 分离启动），也支持 run.sh 单命令组合启动，适应开发调试与生产部署两种场景
潜在局限与风险
- 平台约束：仅支持 macOS、Linux 及 WSL 环境，原生 Windows 未经测试
- 前置依赖刚性：强制要求
ffmpeg、wget、unzip系统级工具，无包管理器环境需人工介入 - 资源消耗显著：完整运行需下载多 GB 模型文件（TransNetV2、Sentence-Transformers 等），低配机器可能触发存储或内存瓶颈
- 网络依赖集中：
download.sh拉取的外部资源若源站失效，将导致安装流程阻塞 - 服务端口冲突：MCP 与 Web 服务默认占用 8001/8005 端口，若被占用需手动调整环境变量
适合人群
- AI 视频创作研究者，需本地化部署叙事生成管线
- MCP 协议集成开发者，需要将 OpenStoryline 接入 Claude Desktop 等客户端
- 对数据隐私敏感的内容团队，倾向私有部署而非云服务调用
常规风险提示
配置阶段的 API 密钥（OpenAI/Anthropic/Pexels 等）以明文形式写入 config.toml，建议文件系统权限设置为 600 并纳入版本控制忽略列表。资源下载阶段的大文件 IO 可能触发杀毒软件误报，属正常现象。