ZenStory

对话即创作 — AI Agent 驱动的商业级小说写作工作台

ZenStory 让 AI Agent 直接操作你的创作文件——建角色卡、拆参考素材、规划大纲、逐章写作——全部在一次对话里完成，而不是把生成的文字复制粘贴回编辑器。

2000+ 创作者 · 1200 万字生成 · 4.9 分好评

zenstory.ai · 快速开始 · 项目架构 · English

三栏工作台 — 文件树 · 编辑器 · AI 对话，AI 直接读写你的创作文件

目录

• 为什么是 ZenStory — 与传统 AI 写作工具的差异
• 核心能力 — 8 大能力详解（对话操作文件 · 多 Agent · 素材库 · 技能 · Agent API …）
• 技术栈 — 前后端 / AI / 检索 / 部署一览
• 快速开始 — Docker 一行启动或本地开发
• 项目架构 — Monorepo 目录结构
• 路线图 — 已交付能力与后续计划
• 参与贡献 — 提交 Bug / 功能建议 / PR

为什么是 ZenStory

市面上的 AI 写作工具大多停留在"聊天框 + 复制粘贴"。ZenStory 把 AI 变成真正动手的创作搭档：

核心能力

1. 对话 × 文件系统 — 全新创作范式

AI 不只停留在对话框里，它通过一套完整工具链直接操作你的创作文件：

AI 对话驱动创作	智能文件树管理

• 对话即操作 — "帮我创建一个反派角色，性格阴沉但有悲情过往"，Agent 自动新建角色卡并填充设定
• 上下文感知 — AI 理解角色关系、世界观规则、已有章节内容，写出连贯不穿帮的文字；长对话自动压缩上下文，不丢主线
• Diff 审阅模式 — AI 的修改先以差异对比呈现，确认后再应用，掌控权始终在你手里
• 流式生成 + 实时介入 — 实时看到 AI 逐字创作，生成过程中也能随时插话调整方向
• 9 种 Agent 工具 — 创建 / 编辑 / 删除文件、检索文件、混合检索素材、更新项目状态、Agent 交接、请求澄清、并行执行，覆盖创作全流程

2. 多 Agent 协作写作引擎

一个意图路由器 + 四个专职 Agent，组成一支完整的 AI 写作团队（自研编排，非黑盒）：

┌─────────┐    ┌─────────┐    ┌──────────┐    ┌─────────┐    ┌──────────────────┐
│ Router  │───►│ Planner │───►│  Hook    │───►│ Writer  │───►│ Quality Reviewer │
│ 意图路由 │    │ 大纲规划 │    │ Designer │    │ 内容创作 │    │   质量审稿        │
└─────────┘    └─────────┘    │ 爽点设计 │    └─────────┘    └──────────────────┘
                              └──────────┘

Router 自动判断任务复杂度，在 五种工作流——快速直写 · 标准流程 · 完整协作 · 转折专攻 · 纯审稿——之间匹配最优路径。Agent 之间支持智能交接（handoff），实现真正的多轮协作。

3. 素材库 — AI 拆解参考作品

上传你欣赏的参考小说，AI 自动拆解为 8 类结构化创作元素：

拆解后的素材通过 混合检索（RAG） 精准定位——向量语义 + 关键词双引擎按 RRF 融合排序，在海量素材中秒级找到相关片段。AI 写作时自动引用相关素材，确保风格和设定的一致性。

4. 灵感库 — 打破创作瓶颈

基于项目上下文的智能灵感卡片，一键复制到项目启动创作

• 上下文感知 — 基于你的项目类型（长篇 / 短篇 / 短剧）和已有内容生成精准灵感
• 精选推荐 — 编辑精选的高质量灵感模板，覆盖各类型创作场景
• 一键复用 — 看中灵感直接复制到项目，立即开始创作
• 素材联动 — 你的素材库越丰富，灵感推荐越精准

5. 技能系统 & 市场

13 个内置专业写作技能，开箱即用：

技能市场 — Markdown 定义技能，一键分享，社区共建

技能以 Markdown 定义，支持自定义创建与一键分享到市场；配合管理审核机制，社区共建、越用越强。

6. Agent API — 让外部 AI 工具直连创作空间

生成 API Key，粘贴到 Claude Code 或 OpenClaw，外部 AI Agent 即可直接读写你的小说项目：

# 在 Claude Code 或 OpenClaw 中，Agent 可以：
# - 读取项目文件和角色设定
# - 创建新章节和角色
# - 检索素材库
# - 编辑已有内容

API Key 支持哈希存储与按项目授权——这不再是"AI 辅助写作"，而是 AI 生态互联：你喜欢的任何 AI 工具都能成为 ZenStory 的创作引擎。

7. 专业写作工作台

Tiptap 富文本编辑器	版本对比与回滚

• 六种文件类型 — 大纲、草稿、剧本、角色、世界观、片段，各类型独立编辑界面
• 智能排序 — 自动识别中英文章节编号（"第一章" / "Chapter 1"），按序排列
• 版本快照 — 每次编辑自动保存，一键对比任意两个版本的差异，支持回滚
• 多格式导出 — 一键导出纯文本（TXT），章节自动按序合并
• 语音输入 — 语音转文字（腾讯云 ASR），长按录音，移动端友好
• 全局搜索 — Cmd+K 快速搜索项目内所有文件
• 深色模式 — 护眼写作，自动跟随系统偏好
• 中英双语 — 界面全面国际化

8. 商业级运营能力

ZenStory 不只是 demo，而是一套可运营的完整产品：

• 订阅体系 — Free / Pro 多档套餐，套餐目录可动态配置
• 配额管理 — 写作字数、Agent 任务数、项目数、素材上传量精细控制
• 积分系统 — 每日签到、邀请奖励、兑换码，积分可兑换订阅时长
• 写作连续 — 追踪每日写作，连续打卡，冻断保护
• 数据统计 — 字数趋势、章节完成度、AI 协作分析、项目健康度
• 管理后台 — 用户管理、订阅管理、技能审核、Prompt 编辑、数据看板
• 项目类型 — 长篇小说、短篇小说、短剧剧本三种创作路径，各有专属引导

技术栈

快速开始

环境要求

• Node.js >= 18
• Python >= 3.12
• pnpm

方式一：Docker Compose（推荐）

只需一个 API Key，一行命令启动：

export DEEPSEEK_API_KEY=your-key
docker compose up -d --build

访问：

• 前端：http://localhost:5173
• API 文档：http://localhost:8000/docs

数据持久化在 Docker volume 中，开箱即用 SQLite。

方式二：本地开发

# 1. 后端
cd apps/server
python3 -m venv venv && source venv/bin/activate
pip install -r requirements.txt
cp .env.example .env          # 编辑 .env 填入 API Key
python3 main.py

# 2. 前端（新终端）
cd apps/web
pnpm install
cp .env.example .env.local
pnpm dev

只需一个 LLM API Key 即可运行（支持 DeepSeek / Anthropic）。生产部署（PostgreSQL + Redis）请参考 docs/docker-compose.md。

项目架构

Monorepo：React 前端（apps/web）+ FastAPI 后端（apps/server），文件是核心创作单元，AI 对话驱动内容生成。

zenstory/
├── apps/
│   ├── web/                    # React 前端
│   │   ├── src/components/     # 组件（Layout/FileTree/Editor/ChatPanel/Skills/...）
│   │   ├── src/hooks/          # Hooks（useAgentStream/useVoiceInput/useMaterialLibrary/...）
│   │   ├── src/contexts/       # Context（Auth/Project/Theme）
│   │   └── src/pages/          # 页面（Dashboard/Project/Pricing/Materials/...）
│   └── server/                 # FastAPI 后端
│       ├── api/                # API 路由（auth/projects/files/agent/chat/export/voice）
│       ├── agent/              # AI Agent 系统 ★
│       │   ├── graph/          #   多 Agent 编排（自研 asyncio 工作流）
│       │   ├── tools/          #   9 种 Agent 工具（create_file/edit_file/hybrid_search/...）
│       │   ├── context/        #   上下文组装 + Token 预算 + 长对话压缩
│       │   ├── prompts/        #   项目类型提示 + Agent 专用提示
│       │   └── skills/         #   技能加载 / 匹配 / 注入（含 13 个内置技能）
│       ├── models/             # 数据模型（File/Material/Subscription/Skill/...）
│       ├── services/           # 业务逻辑层
│       │   ├── material/       #   素材拆解服务（15 个细分模块）
│       │   └── features/       #   导出 / 快照 / 验证等服务
│       └── config/             # 配置（Logger/Settings/AgentRuntime）
└── docs/                       # 文档和截图

Agent 系统的详细架构（多 Agent 工作流、工具、SSE 事件）见 apps/server/agent/CLAUDE.md。

路线图

• 多 Agent 协作写作引擎（Router / Planner / Hook Designer / Writer / Quality Reviewer）
• 素材库 AI 拆解（8 类结构化元素 + 混合 RAG 检索）
• 灵感库（上下文感知 + 一键复用）
• 技能系统 & 市场（13 个内置 + 自定义 + 社区分享）
• Agent API（Claude Code / OpenClaw 直连）
• 版本快照 & Diff 对比
• 语音输入
• 商业化（订阅 / 配额 / 积分 / 管理后台）
• 更多导出格式（Word / Markdown）
• 移动端原生 App

参与贡献

欢迎通过以下方式参与：

• 提交 Bug
• 功能建议
• 提交 Pull Request

请阅读 CONTRIBUTING.md 了解贡献流程。

许可证

MIT License © 2024-2026 ZenStory