ZOYKUHot Board

zenstory-ai/zenstoryDocumentation

对话即创作 · 面向网文与故事作者的 AI 写作工作台(大纲、人设、正文、设定与伏笔追踪一站式管理)| Chat-to-create AI novel-writing workbench

Avis de repli linguistique :La documentation localisée n'est pas disponible. Affichage de la version originale officielle en anglais.
Installation rapide
pip install zenstory

ZenStory 工作台

对话即创作:在浏览器里写小说与短剧,AI 直接新建、改写你的大纲、正文和角色卡。

项目主页  ·  开始使用  ·  核心功能  ·  English

Stars Skills 14 app.zenstory.ai License AGPL-3.0

打开工作台 GitHub Issues

在线使用:app.zenstory.ai,注册或登录后即可创作。

ZenStory 三栏工作台

工作区从左到右依次是文件树、编辑器和 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(Claude Code / Codex / OpenClaw)

在工作台「设置 → 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。

工作台核心功能

打开章节,在右侧对话框写请求 长篇项目的文件树
打开章节,在右边写请求 长篇项目默认五个文件夹:设定、角色、素材、大纲、正文

多 Agent 分工

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
Loading
流程 谁来做 什么时候走
quick 内容创作者直接写 续写、扩写等日常请求,路由拿不准时也走这条
standard 先规划;同时要求正文时再写 要大纲、规划、梗概、章节结构
full 规划 → 爽点设计 → 写作 明确要完整流程、重要章节或高潮戏
hook_focus 先设计爽点、反转或节奏;要求改稿时再写 觉得不够爽、太平淡、要加反转
review_only 只审稿,不改文件 要检查问题、评估质量或看追更指数
  • 「快速」与「高质量」模式:两者使用同一模型。「快速」模式直接写作,省去按字数自动送审;「高质量」模式在写入正文满 500 字时自动交给审稿人核对作者要求、前后连贯性与因果逻辑,并把过程说明收拢为一份最终总结。
  • 边写边追回、长任务接着写:AI 生成途中可以继续在输入框发补充要求,当前 Agent 写完手头这一步后就会按新要求调整,不会打断正在写的正文。长任务接近单次运行上限时会自动收尾并给出「继续」卡片,点一下就能从停下的地方接着写;回复末尾给出的改稿方向也会直接变成输入框上方的快捷按钮。

AI 记忆与项目上下文

  • 自动带上相关稿件:每轮对话除了保留最近约 32,000 token 的聊天记录和刚读写过的几章全文外,还会用独立的 32,000 token 预算按重要度带上当前打开的章节、选区引用、角色卡、核心设定、上一章以及关键词命中的片段。常用的稳定资料固定在提示词前缀,翻章续写时更快也更省 token。
  • AI 记忆与写作约定:面板分为「项目简介、写作风格、当前阶段、写作约定」四栏。需要长期遵守的设定(比如「记住:女主第五章才出场」),直接在对话里告诉 AI,它就会追加到「写作约定」里并在对话卡片中列出,不会擅自删改你写好的备注。

14 个内置技能与自定义技能包

分类 技能
写作 续写正文 · 开头生成 · 短篇写作 · 短剧剧本正文生成
情节 创建大纲 · 钩子设计 · 短剧改编分析 · 短剧故事概要生成 · 短剧分集集纲生成
文风 润色修改 · 节奏控制 · 去AI味
角色 创建角色
世界观 世界观设定

在「技能 → 发现技能」启用后,AI 每轮先看到已启用技能的名称与用途,匹配你的请求时再读取完整方法;你也可以在输入框打 / 或从侧栏点选技能,直接附在当前消息上(最多 3 个)。自定义技能采用开放 Agent Skills 的 SKILL.md 格式,可附带 references/ 参考资料,支持以 .zip 或 .md 导入导出。

参考小说拆解(素材库)

上传一本 30 万字以内的 TXT 参考小说,后台自动拆出每章摘要、全书概要、角色档案、世界观和金手指。要用时在项目的「参考小说库」面板把条目附加到对话,或直接导入项目变成可检索的文件。

延伸阅读

参与贡献

项目结构与技术栈
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 AI 项目

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(本仓库)
Miroir archivé depuis le dépôt GitHub officiel · Voir sur GitHub
Date du snapshot : 2026-11-16