剧云离线版是在本地局域网部署的私有化实例，需Docker 24.0+和docker-compose v2.23+，通过创建独立schema、配置子域名及hosts实现单机多项目隔离，支持离线导入剧本与版本快照回溯。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
剧云离线版不提供独立安装包，所谓“离线版”实为在本地网络环境（断外网但通局域网）中部署剧云私有化实例，实现单机多项目协同管理。该方案需绕过云端依赖，直接操作容器化服务与本地存储卷，避免账号绑定、在线校验和自动更新干扰，确保编剧团队在无公网条件下持续开展剧本开发、版本回溯与多人分场协作。
准备本地运行环境
确认宿主机已安装 Docker 24.0+ 和 docker-compose v2.23+，禁用系统自带防火墙或开放 8080、5432、6379 端口。若使用 macOS 或 Windows，必须启用 WSL2 或 Docker Desktop 的 Linux 容器模式——Windows Subsystem for Linux 启用失败会导致 PostgreSQL 初始化中断，项目数据写入失败。
新建目录 【/opt/jucloud-local】，所有配置文件、数据库卷、剧本附件均存放于此路径下，不可更改。该路径将被硬编码进 compose 文件，移动后服务无法挂载历史项目数据。
初始化多项目基础服务
下载官方私有化部署包 jucloud-offline-v3.2.1.tar.gz（SHA256 校验值：a7f9e3d2b8c1...），解压后进入 docker-compose.yml 目录，执行：
docker-compose up -d --build
等待 90 秒后运行 docker-compose ps，确认 postgres、redis、web、worker 四个服务状态均为 healthy。若 redis 显示 restarting，说明宿主机内存不足 4GB，需关闭其他应用或修改 docker-compose.yml 中 redis 的 memory_limit: 512m → 384m。
配置单机多项目隔离机制
剧云离线版默认只建一个数据库 schema（jucloud_main），要支持多个独立项目并行运作，必须手动创建项目专属 schema 并映射到不同子域名：
第一步：进入 postgres 容器：
docker exec -it jucloud-postgres psql -U jucloud
第二步：依次执行建库命令（示例建三个项目）：
CREATE SCHEMA project_alpha AUTHORIZATION jucloud;
CREATE SCHEMA project_bravo AUTHORIZATION jucloud;
CREATE SCHEMA project_charlie AUTHORIZATION jucloud;
Qwen 视频智能分析基础客户端（免费版），基于 Qwen 3.5 Plus 多模态模型对本地视频进行内容分析，支持场景描述与基础内容理解，采用默认抽帧频率和提示词，适合快速概览视频，API Key 读取自 ~/.skill-platform/skill-platform.json 的 skills 配置。
第三步：编辑 /opt/jucloud-local/nginx/conf.d/default.conf，在 server 块内新增三段 location 配置，分别将 alpha.jucloud.local、bravo.jucloud.local、charlie.jucloud.local 的请求头 X-Project-ID 改写为对应 schema 名。这一步漏配会导致所有项目共用同一套人物关系图与节拍卡片，数据彻底混杂。
第四步：重启 nginx 与 web 服务：
docker-compose restart nginx web
为每个项目分配独立工作区
方法一：通过 hosts 绑定访问
在宿主机 /etc/hosts（macOS/Linux）或 C:\Windows\System32\drivers\etc\hosts（Windows）末尾追加：
127.0.0.1 alpha.jucloud.local
127.0.0.1 bravo.jucloud.local
127.0.0.1 charlie.jucloud.local
保存后无需重启，立即生效。浏览器访问任一域名即进入对应项目空间，登录统一账号即可开始分场写作。
方法二：使用反向代理统一入口
若需从一个页面跳转多项目，可启用内置的 project-router 服务：在 docker-compose.yml 中取消注释 router 服务块，再执行 docker-compose up -d router。该服务监听 8081 端口，打开 http://localhost:8081 即显示可点击的项目列表，点击即跳转对应子域名——此方式适合教学演示或临时评审，但会略微增加首屏加载延迟。
注意：所有项目共享同一套 AI 助理模型缓存，首次调用“生成人物小传”时会触发本地 LLM 模型加载（约占用 3.2GB 显存），后续项目调用无需重复加载。若显卡显存低于 6GB，请在 .env 中将 【AI_MODEL_NAME=Qwen2.5-1.5B-Instruct】 替换为 Phi-3-mini-4k-instruct。
导入已有剧本并启用版本快照
登录 alpha.jucloud.local → 点击右上角「+ 新建项目」→ 选择「从 Word 导入」→ 上传 .docx 文件。系统自动解析场景标题、角色名、对白段落，并生成初始分场大纲。导入过程不依赖外网，但要求文档严格遵循标准剧本格式（如 Scene Heading 必须以 INT./EXT. 开头，角色名独占一行且全大写）。
导入完成后，立即点击左侧面板「版本管理」→「创建快照」，输入标签如「初稿-20261022-张编剧」。此后每次点击「保存并提交」，系统都会在本地 PostgreSQL 的 project_alpha.schema_version 表中记录差异快照，支持按时间戳一键回退——该功能仅在 schema 隔离后生效，未建独立 schema 的项目无法启用。
