对话即创作:在浏览器里写小说与短剧,AI 直接新建、改写你的大纲、正文和角色卡。
在线使用:app.zenstory.ai,注册或登录后即可创作。
工作区从左到右依次是文件树、编辑器和 AI 对话。
ZenStory 工作台是一个在浏览器里写长篇小说、短篇小说和短剧剧本的地方。大纲、正文、角色卡、世界观设定和参考素材都是项目里的文件;你在右边和 AI 说话,AI 直接新建或改写这些文件,不用在聊天窗口和文档软件之间来回复制粘贴。可以在 app.zenstory.ai 在线使用,也可以按 AGPL-3.0 许可自己部署。
- 对话直接改稿,也认得你的手改:在右边提要求,Agent 直接在左边新建角色卡、大纲或续写章节,边写边显示在编辑器里,对话卡片可一键撤销。你在编辑器里亲手改过的内容也会同步给 AI,续写时顺着你的改稿往下接,不会在对话里误删或覆盖你写好的稿子。
- 四个专职 Agent 按需接力:大纲规划师、爽点设计师、内容创作者、质量审稿人按你的要求分工——只要细纲就停在规划,要求写正文才动笔;「高质量」模式下写完正文会自动送审,最后只给出一份干净的总结。
- 懂网文与短剧节奏:开篇直接进冲突,爽点当场兑现,对白推着剧情走,章末留钩子;选中编辑器里的文字点「去AI味」,会按段落对比改写前后,逐段选择采用或保留原稿。
- 长篇连载不断片:每轮自动带上「AI 记忆」、刚读写过的章节全文、上一章以及相关的角色卡和世界观设定,不靠翻长聊天记录记设定。
- 自带 14 个技能,也能接外部 Agent:内置续写、钩子设计、短篇写作、短剧分集和去 AI 味等 14 个技能,支持导入导出
SKILL.md技能包;通过npx zenstory命令行,Claude Code、Codex、OpenClaw 等外部工具也能直接读写你的项目。
打开 app.zenstory.ai 注册即可创作。新建一个「长篇小说」项目后,第一条请求可以先让 AI 规划「黄金三章」细纲,确认节奏后再动笔写正文:
我想写一本玄幻爽文,先规划黄金三章细纲,暂不写正文。男主萧无涯是诸天万界最大的商会之主,十年来倾尽灵石、极品丹药和护山大阵把青云女帝洛清寒捧上神坛。开篇女帝证道大典,她为了刚入门的剑道白月光叶尘,当众嘲讽萧无涯满身铜臭、不配与她并肩,直接将他逐出宗门。萧无涯当场笑纳,一键切断宗门所有灵石、丹药和阵法供应。请按黄金三章给出每章的核心冲突、打脸爽点和章末卡点钩子。
细纲敲定后,再让 AI 落盘并写正文(第三行的「钩子设计:」需先在「技能 → 发现技能」里启用该技能):
把刚才的黄金三章细纲存进「大纲」文件夹,命名为「黄金三章细纲」。
按「黄金三章细纲」写第一章,存进「正文」文件夹里的「第1章 铜臭味?那就断了你的成仙路」,写完这一章就停。
钩子设计:只改「第1章 铜臭味?那就断了你的成仙路」最后两段,卡在护山大阵灵力归零、全宗长老傻眼的瞬间。
更多用法见使用文档。
export DEEPSEEK_API_KEY=your-key # 也可以写进仓库根目录的 .env
docker compose up -d --build
# 创建首个管理员账号(无需邀请码和邮箱验证,密码至少 12 位)
docker compose exec -e [email protected] \
-e ZENSTORY_ADMIN_PASSWORD='CHANGE-ME-12CHARS' server python scripts/create_admin.py打开 http://localhost:5173 登录,API 文档在 http://localhost:8000/docs。默认使用 SQLite,数据库与上传文件保存在 Docker 卷中,docker compose down 和重新构建不会丢失数据。
- 写作配置:项目系统提示词(
novel、short、screenplay)和官方技能保存在数据库中,首次启动后请在管理后台配置并重新加载,维护方式见 docs/agent-writing-guidance.md。 - 套餐初始化:运行
docker compose exec server python scripts/seed_subscription_plans.py初始化套餐,即可在管理后台「订阅管理」给账号开通 Pro。 - 更换模型:可通过环境变量配置 DeepSeek 或 MiniMax 模型(
LLM_PRIMARY_PROVIDER/LLM_PRIMARY_MODEL,对应DEEPSEEK_API_KEY或MINIMAX_API_KEY),详见apps/server/agent/core/llm_providers.py。 - 开放注册与可选功能:自托管默认要求邀请码注册,设
AUTH_REGISTER_INVITE_CODE_OPTIONAL=true可改为免邀请码注册;PostgreSQL + Redis 完整部署、邮箱验证与密码重置(Resend)、Google 登录、腾讯云语音输入、素材拆解(Prefect Worker)、灵感库以及支付宝 Zpay 收款等配置,详见 docs/docker-compose.md。
不用 Docker,本地开发
需要 Node.js 20.19+、Python 3.12 和 pnpm:
# 终端 1:后端(端口 8000)
cd apps/server
python3 -m venv venv && source venv/bin/activate
pip install -r requirements.txt
cp .env.example .env # 填上 DEEPSEEK_API_KEY
python3 main.py
# 终端 2:前端(端口 5173)
cd apps/web
pnpm install
cp .env.example .env.local
pnpm dev首个账号同样在 apps/server 下带上 ZENSTORY_ADMIN_EMAIL 和 ZENSTORY_ADMIN_PASSWORD 运行 python scripts/create_admin.py 创建。
在工作台「设置 → Agent」里创建 API Key,然后在终端运行(需要 Node.js 20+):
npx zenstory login # 按提示粘贴 Key;自托管加 --api-base https://你的服务器/api/v1
npx zenstory skill install # 默认装到 Claude Code;Codex、OpenClaw 加 --target codex / --target openclaw
npx zenstory whoami # 确认登录状态和读写权限装好技能后,外部 Agent 使用自己的模型写作,通过 zenstory CLI 读取项目上下文并写回章节:
dir=$(mktemp -d)
zenstory files list <项目ID> --type draft --fields id,title --json # 列出草稿
zenstory context <项目ID> --file <章节ID> --query "接下来写什么" --json # 获取项目上下文
zenstory files get <章节ID> --fields updated_at --json # 记录当前版本时间戳
zenstory files get <章节ID> -o "$dir/<章节ID>.md" # 导出到本地临时文件
zenstory files put <章节ID> --content-file "$dir/<章节ID>.md" --if-updated-at <updated_at> # 写回章节完整命令与 HTTP 接口说明见 apps/cli/README.md 及 https://api.zenstory.ai/skill.md。
![]() |
![]() |
| 打开章节,在右边写请求 | 长篇项目默认五个文件夹:设定、角色、素材、大纲、正文 |
flowchart LR
R["路由<br/>结合本轮请求与上一轮上下文"] -->|quick| W["内容创作者"]
R -->|standard| P["大纲规划师"] -->|要求正文时| W
R -->|full| P2["大纲规划师"] --> H["爽点设计师"] -->|要求正文时| W
R -->|hook_focus| H2["爽点设计师"] -->|要求正文时| W
R -->|review_only| Q["质量审稿人"]
W -. 高质量模式:写入正文满 500 字自动送审 .-> Q
Q -. 有问题 .-> W
| 流程 | 谁来做 | 什么时候走 |
|---|---|---|
quick |
内容创作者直接写 | 续写、扩写等日常请求,路由拿不准时也走这条 |
standard |
先规划;同时要求正文时再写 | 要大纲、规划、梗概、章节结构 |
full |
规划 → 爽点设计 → 写作 | 明确要完整流程、重要章节或高潮戏 |
hook_focus |
先设计爽点、反转或节奏;要求改稿时再写 | 觉得不够爽、太平淡、要加反转 |
review_only |
只审稿,不改文件 | 要检查问题、评估质量或看追更指数 |
- 「快速」与「高质量」模式:两者使用同一模型。「快速」模式直接写作,省去按字数自动送审;「高质量」模式在写入正文满 500 字时自动交给审稿人核对作者要求、前后连贯性与因果逻辑,并把过程说明收拢为一份最终总结。
- 边写边追回、长任务接着写:AI 生成途中可以继续在输入框发补充要求,当前 Agent 写完手头这一步后就会按新要求调整,不会打断正在写的正文。长任务接近单次运行上限时会自动收尾并给出「继续」卡片,点一下就能从停下的地方接着写;回复末尾给出的改稿方向也会直接变成输入框上方的快捷按钮。
- 自动带上相关稿件:每轮对话除了保留最近约 32,000 token 的聊天记录和刚读写过的几章全文外,还会用独立的 32,000 token 预算按重要度带上当前打开的章节、选区引用、角色卡、核心设定、上一章以及关键词命中的片段。常用的稳定资料固定在提示词前缀,翻章续写时更快也更省 token。
- AI 记忆与写作约定:面板分为「项目简介、写作风格、当前阶段、写作约定」四栏。需要长期遵守的设定(比如「记住:女主第五章才出场」),直接在对话里告诉 AI,它就会追加到「写作约定」里并在对话卡片中列出,不会擅自删改你写好的备注。
| 分类 | 技能 |
|---|---|
| 写作 | 续写正文 · 开头生成 · 短篇写作 · 短剧剧本正文生成 |
| 情节 | 创建大纲 · 钩子设计 · 短剧改编分析 · 短剧故事概要生成 · 短剧分集集纲生成 |
| 文风 | 润色修改 · 节奏控制 · 去AI味 |
| 角色 | 创建角色 |
| 世界观 | 世界观设定 |
在「技能 → 发现技能」启用后,AI 每轮先看到已启用技能的名称与用途,匹配你的请求时再读取完整方法;你也可以在输入框打 / 或从侧栏点选技能,直接附在当前消息上(最多 3 个)。自定义技能采用开放 Agent Skills 的 SKILL.md 格式,可附带 references/ 参考资料,支持以 .zip 或 .md 导入导出。
上传一本 30 万字以内的 TXT 参考小说,后台自动拆出每章摘要、全书概要、角色档案、世界观和金手指。要用时在项目的「参考小说库」面板把条目附加到对话,或直接导入项目变成可检索的文件。
- 快速开始:从空项目到第一份能改的提纲。
- 第一篇短篇:一个原创短篇的文件安排和三段范围明确的请求。
- AI 创作助手:焦点文件、引用文字,以及中断后怎么接着写。
- AI 记忆:四栏怎么填,写错了怎么改。
- 版本历史:查看、比较和恢复单个文件的版本。
- 从参考片段写到自己的场景:拆完参考小说,怎样写出自己的戏。
- 写作环境对比:普通聊天、Oh Story skill 包、DSH 插件和 ZenStory 工作台各适合什么。
- AI 续写怎么保持文风:把文风拆成说得清的几点,附一段自己的样本。
- GitHub Issues:提交 Bug · 功能建议。在线版也可以从项目页右上角「…」→「问题反馈」提交并附截图。
- 改代码前请先阅读 CONTRIBUTING.md 与仓库文档索引 docs/README.md。写作 Agent 的工作流、工具和 SSE 事件说明见
apps/server/agent/AGENTS.md。
项目结构与技术栈
zenstory/
├── apps/web/ # React 前端
│ ├── src/components/ # Layout、sidebar/FileTreePane、Editor、ChatPanel、skills …
│ ├── src/pages/ # Dashboard、项目、素材库、定价 …
│ └── docs/ # 使用文档源文件,发布到 zenstory.ai/docs
├── apps/cli/ # zenstory 命令行工具与外部 Agent 技能包
└── apps/server/ # FastAPI 后端
├── api/ # 路由:auth、projects、files、agent、agent_api、materials、admin …
├── agent/ # 写作 Agent
│ ├── graph/ # 路由、交接、自动审稿的调度循环
│ ├── tools/ # 文件、项目、技能和交接工具
│ ├── context/ # 每轮上下文组装、预算和重要度排序
│ ├── prompts/ # 共享协议、题材规范与角色提示
│ └── skills/ # 技能加载与注入
├── flows/ # 素材拆解流水线(Prefect)
├── services/ # 业务逻辑
└── models/ # 数据模型
| 层 | 技术 |
|---|---|
| 前端 | React 19 · TypeScript · Vite 7 · Tailwind CSS 4 · Zustand · TanStack Query |
| 后端 | FastAPI · SQLModel · Server-Sent Events |
| AI | DeepSeek / MiniMax(OpenAI 兼容接口)· openai-agents-python |
| 检索 | 数据库关键词匹配、相关片段与行号;文件编辑后立即可搜,无索引任务 |
| 数据 | SQLite(默认)/ PostgreSQL · Redis · Alembic |
| 部署 | Docker Compose;在线版前端在 Vercel,后端与 Prefect 在 Railway |
GNU AGPL-3.0 © 2024-2026 ZenStory
本仓库采用 GNU Affero General Public License v3.0。你可以自由使用、修改和自部署;如果把修改后的版本作为网络服务提供给他人,需要按 AGPL 向这些用户公开对应的源代码。
ZenStory 名称与标识不在许可范围内:fork 或自部署的服务请使用自己的名称。需要商业授权(不受 AGPL 义务约束)请联系维护者。
apps/cli 命令行客户端仍按 MIT 许可提供,见 apps/cli/LICENSE。
ZenStory 工作台由 ZenStory AI 维护——一套可在 AI Agent 中使用的开源故事创作、改编与制作工具(GitHub 组织:zenstory-ai)。同组织项目:
| 项目 | 用途 |
|---|---|
| oh-story-claudecode | 网文写作 skill 包:扫榜、拆文、写作、去AI味、封面图 |
| drama-skills | AI 短剧 / 漫剧创作 skill 合集:剧本、资产、分镜、图片/视频提示词、独立审查 |
| novel-to-game | 小说改编游戏 skill 合集:原著拆解、目标运行环境构建与实机运行验收 |
| video-recap-skills | 将支持的视频文件制作成中文解说,可选导出可编辑的剪映/CapCut 草稿 |
| oh-story-dsh | DeepSeek Harness 社区插件,提供小说、短剧、游戏和视频解说工作台 |
| zenstory | 对话即创作的 AI 小说写作工作台,在线版 app.zenstory.ai(本仓库) |


