oh-story-claudecode
zenstory-ai/oh-story-claudecode加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
微信扫码咨询客服
POMOAI — 让开源 AI 即刻运行
加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
想象这样一个场景：你在起点中文网追了三个月的一本玄幻小说突然断更，作者人间蒸发。你不甘心，花了一晚上扒完了所有能找到的伏笔和设定，决定自己续写——然后发现，几百章的人物关系、势力格局、世界观设定，全在脑子里乱成一团麻。
这就是专业网文作者每天面对的挑战：长篇写作不是一次性创作，而是几十甚至上百次创作的连续追踪。人物在成长、伏笔在埋设、势力格局在变化，写到后期，单靠人脑记忆几乎不可能保证一致性。
Oh Story 正是为解决这个问题而生。它不是让你对 AI 说"帮我写一章"，而是把 AI 编程工具（Claude Code、Codex CLI、OpenCode 等）变成一个完整的网文创作团队：有人负责扫榜分析市场，有人负责拆解爆款结构，有人负责正文写作，有人负责检查一致性——全部通过文件系统来管理上下文记忆，让 AI 专注于创作本身，而不是记忆。
2023-2024 年，AI 写作工具层出不穷，但大多数产品的逻辑都是"给 AI 一句话，AI 给你一篇文章"。这种方式对写短文、邮件、摘要有效，但对网文创作几乎是致命的：
ZenStory AI 团队在运营 app.zenstory.ai（对话式 AI 小说写作工作台）的过程中，积累了大量的网文创作方法论。他们将这些方法论产品化，以 skill 包的形式开源发布，让用户可以免费部署到任何支持 skill 的 AI 编程 Agent 中使用。
Oh Story 的架构哲学可以概括为一句话：记忆归文件系统，创作归 AI。
传统 AI 写作工具把一切都塞进对话上下文中，但上下文窗口是有限的。当你的小说写到 50 万字、300 章时，AI 的上下文早就被塞满了，要么截断丢失信息，要么产生前后矛盾。
Oh Story 的解决方案是用真实的文件系统来管理小说的所有状态：
.story/
├── 设定/ # 世界观、角色、势力——每本书独立维护
├── 大纲/ # 全书结构、卷纲、细纲——每章一个文件
├── 正文/ # 章节正文——每章一个 .md 文件
├── 追踪/ # 伏笔、角色状态、时间线——派生状态快照
└── 对标/ # 拆解的爆款参考——素材模块化复用
这相当于给小说建立了一个外部化的数据库。写作时，AI 先读取相关状态文件，然后专注写作；写完后，更新状态文件。不依赖对话记忆，上下文压缩也不丢失伏笔。
Oh Story 提供了 13 个专业 skill，覆盖网文创作的全生命周期：
这两个 skill 让 AI 帮你分析当前网文平台的热销榜单。它不只是机械地列出排行榜，而是分析：
对于长篇作者来说，选题直接决定了书籍的命运。扫榜 skill 帮助作者在动笔前做充分的市场调研，降低扑街风险。
找到对标爆款后，analyze skill 会帮你深度拆解它的结构：
拆解结果自动存入 对标/ 目录，形成你的个人素材库。未来写书时，可以直接从库中调用模块，而不需要每次重新拆解。
大纲 skill 是整个流水线最核心的一环。它强制执行一个规则：没有细纲，不许写正文。
这听起来有点"反直觉"，但这是 Oh Story 质量门禁的核心设计。guard-outline-before-prose.sh hook 会在你尝试写正文前检查是否已有对应细纲，如果没有，直接阻止写入。这个 hook 是 8 个自动化 hook 中唯一一个阻断性的——其余 7 个都只提醒，不阻断。
细纲不是简单的一句话概括，而是包含：章节核心事件、多线情节走向、人物出场顺序、情绪节奏设计、本章钩子。这一步做扎实了，正文写作才能又快又稳。
正文的写作由 7 个专业 Agent 协作完成，分工明确：
| Agent | 模型 | 职责 |
|---|---|---|
| story-architect | Opus | 故事架构、大纲设计、钩子/反转 |
| character-designer | Sonnet | 角色档案、语言风格、动机链 |
| narrative-writer | Sonnet | 正文写作、去 AI 味、格式合规 |
| consistency-checker | Haiku | 事实冲突扫描、伏笔追踪 |
| story-researcher | Sonnet | 资料搜索、多源交叉验证 |
| story-explorer | Haiku | 状态查询、快速上下文加载 |
| chapter-extractor | Haiku | 章节块归一、情节点提取 |
值得注意的是，这 7 个 Agent 的模型选择是经过精心设计的：Opus 负责高复杂度推理任务（架构），Sonnet 负责中等复杂度创作任务（角色、正文），Haiku 负责高频轻量任务（检查、查询）。这确保了质量的同时控制了成本。
这是 Oh Story 最受欢迎的功能之一。当前的 AI 写作有一个普遍问题：文字太"圆滑"、太工整、太有"解释感"。读者一眼就能看出这是 AI 写的，缺乏真实写作的那种粗糙感和跳跃感。
story-deslop skill 专门解决这一问题。它的核心信念是：AI 味不是语法错误，而是一种风格问题。改写目标是保留剧情功能，同时增加口语感、停顿感、跳跃感和具体动作描写。
官方给出的对照示例非常有说服力：同一段"改前"文字（充满 AI 味的抽象判词），经过 story-deslop 改写后，变成了具体的动作和物件描写，读起来完全不像 AI 写的。更关键的是，这个过程是可验证的——用 AI 味检测器扫描改前文本会命中大量规则，扫描改后文本则几乎零命中。
对于长篇网文来说，封面是读者点击的第一入口。story-cover skill 可以根据书名和题材自动分析风格，调用 GPT-Image-2 生成专业级封面图，包含书名标题和作者署名。Codex CLI 用户还可以利用内置的 ImageGen 额度，无需额外 API 费用。
/story dashboard 命令可以在本机启动一个本地 Web 界面，浏览拆文库和项目文件树。这个工作台的所有数据都在本地，小说内容不会上传到任何服务器，保护创作者的隐私。
深入看 Oh Story 的技术架构，有三个值得关注的亮点：
第一，文件系统作为外部记忆层。 传统的 AI Agent 依赖对话上下文来维持状态，但上下文是有限的。Oh Story 将小说的所有状态外化到文件系统，让 AI 可以按需读取，不受上下文窗口限制。这种设计对于超长篇（50 万字以上）特别有价值。
第二，按需加载的知识库。 skill 内部的 references/ 目录包含了 100+ 份写作方法论文件，涵盖角色设计、对话技法、反转工具箱等主题。这些文件不是全部塞进 prompt，而是按需加载，只在需要时才被引用，大幅降低了每次交互的 token 消耗。
第三，8 个 Git hooks 守护质量。 /story-setup 命令会自动部署 8 个 Git hooks，覆盖会话开始/结束、上下文压缩前后、正文写入前后等关键节点。其中 7 个是提醒性的（会话快照、伏笔断线检测、字数检查），1 个是阻断性的（无细纲不写正文）。这种设计让质量保障自动化，不需要作者手动检查。
坦白说，Oh Story 不是"下载安装就能用"的傻瓜式工具。它需要你：
对于完全没有用过命令行工具的用户来说，门槛确实存在。但好在项目文档非常详尽，涵盖了 Windows ENOENT 问题、Antigravity 部署差异、目录残留清理等常见坑的解决方案。
安装流程分两步：先用 npx skills add 安装 skill 包到本地，然后在写作项目目录运行 /story-setup 部署 hooks 和 agents。部署完成后，所有 skill 就在 Agent 中可用了。
必须承认，Oh Story 也有一些局限性：
它依赖 AI 编程工具本身的能力上限。 如果你的 Agent 模型能力有限，生成的小说质量也会受限。项目推荐使用 Opus/Sonnet/Haiku 的组合，但如果你只有免费额度或低级模型，体验会大打折扣。
方法论高度适配网文套路。 如果你想写纯文学作品，Oh Story 的"爽感公式"和"情绪节奏设计"可能反而是一种束缚。它的目标是商业化成功，不是文学价值。
国内用户访问门槛。 Claude Code 在国内访问需要特殊网络环境，这对很多中文网文作者来说是一个现实障碍。虽然项目也支持 Codex CLI（可以白嫖），但部署差异和排查文档的阅读也需要一定耐心。
Oh Story 的出现代表了 AI 写作工具的一个发展方向：不追求"完全替代人类"，而是专注于"把人类不擅长的事情自动化"——长篇一致性追踪、扫榜数据分析、格式规范化检查。
它的成功也验证了一个观点：AI 辅助创作的最佳形态，不是通用 AI，而是垂直领域的 AI Agent 系统。通用 AI 写小说容易"四不像"，而 Oh Story 通过 13 个 skill 和 7 个专业 Agent 的组合，实现了从选材到完稿的完整闭环，每个环节都针对网文创作的具体痛点。
截至 2026 年，oh-story-claudecode 在 GitHub 上已获得超过 7000 颗星，证明了市场对这类工具的强烈需求。它不仅是 ZenStory 团队的产品矩阵之一，也成为了 AI 编程 Agent skill 生态中，网文创作垂直领域的标杆项目。