剧情工作台 · Story Editor

源码运行需要 Node.js 24.14 或以上版本与 npm；首次安装依赖和获取 Electron 需要网络。Windows 便携包无需单独安装 Node.js。自托管协作服务需要配置作者邮箱、至少 12 位密码和 SQLite 数据目录；公网部署需要 HTTPS。

从源码运行需要 Node.js 24.14 或以上版本与 npm。Windows 桌面版：在仓库根目录执行 npm ci、npm run build、npm start。自托管浏览器协作版：复制 .env.example 为 .env，设置 STORY_ADMIN_EMAIL、至少 12 个字符的 STORY_ADMIN_PASSWORD，以及本机体验用的 STORY_ORIGIN=http://localhost:8787；执行 npm ci、npm run build:cloud、npm run cloud:start，然后在浏览器打开 http://localhost:8787 并使用所设账号登录。公网访问需按 docs/CloudGuide.md 配置 HTTPS。

桌面端首次启动可连接云端项目，也可从“本地文件与备份”打开独立 JSON 工作稿。浏览器协作版启动后登录，可新建项目或导入 .story.json / Markdown。通过左侧章节与场景目录组织内容，在正文中添加对白、动作等段落并关联人物；“灵感库”用于记录和筛选文字或剧本片段。云端项目可通过“邀请与成员”添加可编辑或只读成员，并使用批注、版本存档和协作者定位。

内容按顺序编辑和预览；条件与语气仅作标记，不执行分支或任务变量；应用不提供 AI 生成。云端服务面向单实例 SQLite 小团队部署；尚无跨实例协作转发，未进行公网负载或渗透测试。

2026-10-26 在 Windows 本机以 Node.js 24.14.0、npm 11.9.0 执行 npm.cmd run build:cloud，TypeScript 检查及 Vite 浏览器版构建完成。随后用隔离的临时 SQLite 数据目录启动 Node 服务 http://localhost:8787，以仓库通用示例 examples/Starter.story.json 导入项目，并通过 Microsoft Edge 与 Playwright 1.63.0 手动查看编辑器和灵感库，保存两张实际界面截图；编辑器截图期间 pageerror 事件为 0。没有运行完整测试套件；本记录仅描述本次构建、启动和界面检查。临时服务已关闭，临时数据库已删除。