PlotCat · 原点编剧系统

本地运行的 AI 辅助编剧工作台。从一句话概念到成稿剧本的完整创作链路：

项目向导 → 意图锚点 → 故事圣经 → 结构/剧情板 → 场景 → 剧本生成 → 规则体检 → 专家面板 → 版本快照

功能

• 五种作品形态：电影长片、试播集、连续剧（季/集结构 + 跨集支线）、短片、微短剧
• 新建项目向导：AI 补全概念候选、蓝图字段，可逐字段重写
• 故事圣经：角色、关系、时间线、世界规则、伏笔
• 剧情板与场景室：结构模板（三幕/四幕/自定义）、剧情卡、场景展开、写本
• 规则体检：一致性、弧光追踪、视觉母题等自动检查
• 专家面板：结构、对白、潜台词、节奏等 10 个专家视角
• 多项目管理 + 版本快照：本地 SQLite 存储，可回滚历史版本
• 多模型接入：默认智谱 GLM（glm-5.2），支持 Claude（CLI 订阅 / API）、OpenAI（gpt-5.4）、Gemini 及任意 OpenAI 兼容端点（DeepSeek/Kimi/Qwen/Ollama…）；未配置模型时自动回退到本地策略建议

快速开始（零基础三步走）

第一步：安装 Node.js（只需装一次）

1. 打开 Node.js 官网 https://nodejs.org/ ，下载并安装最新版（需要 24 或更高版本，安装时一路点"下一步"即可）
2. 装好后按 Win + R 输入 cmd 回车，在黑色窗口里输入 node -v 回车——显示 v24.x.x 之类的版本号就说明装好了

第二步：启动应用

在本项目文件夹里打开终端（Windows：在文件夹空白处右键 →"在终端中打开"），输入：

node server.js

看到"已启动"提示后，用浏览器打开 http://127.0.0.1:4173 就能用了。关掉这个终端窗口应用就停止，数据都在本地不会丢。

第三步：连接 AI 模型（见下一节）

不连接模型也能用，但 AI 生成功能会退化成本地固定建议——要发挥全部能力，请照下面的教程拿一个智谱 API Key。

获取智谱 API Key（新手教程）

本应用默认使用智谱 AI 的 GLM-5.2 模型（国内可直连，无需梯子）。API Key 相当于你在智谱平台的"付费通行证"，获取步骤：

1. 注册：打开智谱 AI 开放平台 https://open.bigmodel.cn/ ，用手机号注册并登录
2. 实名认证：按平台提示完成个人实名认证（国内平台的合规要求；新用户通常会赠送免费体验额度）
3. 创建 Key：登录后进入控制台，找到「API 密钥」/「API Keys」页面，点「创建新的 API Key」，把生成的 Key 复制下来（一长串字符，中间带一个点，形如 xxxxxxxx.xxxxxxxx）
4. 充值（可选）：免费额度用完后在平台「财务」页充值。GLM-5.2 价格约为输入 8 元 / 输出 28 元每百万 tokens——写一整集剧本的成本通常在几元以内；预算敏感可以在应用里改选免费的 GLM-4.7-Flash 先体验
5. 连接：回到本应用 → 打开「设置」→ 服务商选「智谱 GLM」→ 粘贴刚复制的 Key → 模型保持 GLM-5.2 → 点「连接」。连接时会自动做一次真实生成验证，Key 无效或余额不足会当场报错

Key 会保存在你自己电脑的本地数据库里，重启不用重新粘贴。不要把 Key 发给任何人，也不要截图外传。

其他模型服务商

设置面板同样支持：Claude（本机 claude CLI 订阅 / Anthropic API）、OpenAI（gpt-5.4）、Gemini，以及任意 OpenAI 兼容端点（DeepSeek / Kimi / Qwen / 本地 Ollama 等）。可以保存多套连接一键切换。

进阶用法：也可以用环境变量配置——启动前设置 LLM_PROVIDER（zhipu/claude_cli/anthropic/openai/gemini/custom）及对应的 key：ZHIPU_API_KEY / ANTHROPIC_API_KEY / OPENAI_API_KEY / GEMINI_API_KEY / LLM_API_KEY（配 LLM_BASE_URL）。

关于 API Key 的存储（请务必了解）

• 通过界面输入的 API Key 会明文保存在本地 SQLite 数据库（data/yuandian.db）中，重启后无需重新粘贴。这是单机本地工具的有意设计：数据库就在你自己的磁盘上。
• 环境变量来源的 key 不落库。
• 服务只监听 127.0.0.1，不对局域网/公网开放。
• 不要把 data/ 目录（尤其是 .db 文件）分享或上传——.gitignore 已默认排除。

数据存储

首次启动自动在 data/yuandian.db 创建本地 SQLite 数据库，所有项目数据、版本快照、模型连接配置都在这一个文件里。

测试与质量门禁

npm test          # 单元测试
npm run check     # 后端模块加载检查
npm run smoke     # API 冒烟测试（需服务未启动，脚本自起）
npm run gates     # 三道架构门禁：形态条件 / 形态边界 / action 基线

作者与许可证

本系统（PlotCat / 原点编剧系统）由云一工作室主理人 猫叔 独立开发。仓库地址：https://github.com/mmlong818/plotcat

许可证：PolyForm Noncommercial 1.0.0——允许个人使用、学习、修改和非商业分发；不允许任何商业用途，包括商业性的二次创作与分发。

Required Notice: Copyright © 2026 猫叔 (https://github.com/mmlong818/plotcat)