# 剧本工作台使用教程

## 1. 登录与注册

剧本工作台与 AI Chat 共用账号审核和余额，但剧本数据保存在独立服务中。

1. 已有账号可直接输入用户名和密码登录。
2. 管理员开放注册时，从带 `?zc` 的工作台链接进入注册页。
3. 新账号需要通过审核后才能使用模型生成。
4. 退出登录会清除当前浏览器中的会话，不会删除已经保存的剧本。

请勿在共享电脑上保存密码，也不要把登录令牌复制到聊天或文档里。

## 2. 建立剧本

进入工作台后，先填写项目标题，再按“集”组织内容。

- 每集标题建议写成可快速定位的剧情节点，例如“第12集 潜入仓库”。
- 正文使用明确的场景、动作、角色和对白格式，方便后续审查和导出。
- 长项目建议一集一集完成，避免一次生成过多内容后难以校对。
- 浏览器关闭前确认页面的保存状态已经完成。

同一个账号在多个页面同时编辑时，较早打开的页面可能出现版本冲突。遇到冲突时先复制未保存内容，再刷新读取服务器上的最新版本，不要连续覆盖。

## 3. 使用 AI 生成与审查

工作台的 AI 请求通过 AI Chat 服务结算，消耗和余额以 AI Chat 返回的实际结果为准。

1. 选择需要处理的剧集或文本范围。
2. 选择“生成”“审查”或“修复”等适合当前任务的提示词。
3. 发送前检查上下文，避免把无关剧集一起提交。
4. 等待流式输出结束后再继续编辑。
5. AI 输出是草稿，必须人工核对人物、连续性、称呼、道具和集尾钩子。

如果提示余额不足、账号未审核或上游服务暂时不可用，工作台不会绕过 AI Chat 的权限或计费规则。

## 4. 默认提示词

普通用户可以使用管理员发布的默认提示词。管理员可在工作台中调整默认提示词；修改会影响之后发起的新任务，不会改写已经生成的内容。

编写提示词时建议明确：

- 输入材料和允许使用的资料范围。
- 输出格式，例如集数、场次、动作和对白格式。
- 禁止改动的设定与必须逐字保留的台词。
- 需要检查或修复的具体问题。

不要把密码、SSH 私钥、API Key 或其他凭据写入提示词。

## 5. DOCX 导入与导出

工作台直接通过 Node.js 解析和生成 DOCX，不需要安装桌面 Office 软件。

导入前：

- 建议用“第1集”“第一集”等清晰标题分隔剧集。
- 保留一份原始文件，首次导入后检查集数、标题和正文是否完整。
- 超大文件应先拆分，单个 DOCX 的默认上限为 20 MB。

导出后：

- 打开 DOCX 检查集序、段落和特殊字符。
- 导出文件是交付副本；后续编辑仍应回到工作台保存，避免形成两个互相覆盖的版本。

## 6. 常见问题

**页面能打开，但 AI 不回复**

先确认账号已审核且余额可用，再重新登录。如果仍失败，记录发生时间和页面错误提示，不要反复连续提交同一任务。

**页面在维护后打不开**

先访问 `https://server.moyk.top/scriptwriter/api/health`。如果返回 `ok: true`，说明公共入口和数据存储可用，可重新登录后再试；如果无法访问或返回错误，请记录发生时间、HTTP 状态和页面提示交给管理员，不要连续刷新或重复提交生成任务。

**提示工作区版本冲突**

说明另一个页面或设备已经保存了更新。复制当前未保存文本，刷新页面，再把确实需要的内容合并进去。

**导入后没有正确分集**

检查原文是否使用“第12集”或“第十二集”一类独立标题。修正标题后重新导入，不要在错误分集结果上继续批量生成。

**如何保护剧本数据**

退出共享设备上的账号；不要通过带令牌的 URL 分享页面；定期导出阶段性 DOCX 作为可读备份。