AI_NovelWriter

mcp
Guvenlik Denetimi
Gecti
Health Gecti
  • License — License: NOASSERTION
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 14 GitHub stars
Code Gecti
  • Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Gecti
  • Permissions — No dangerous permissions requested

Bu listing icin henuz AI raporu yok.

SUMMARY

AI 长篇小说创作工坊 v3.3.3 —— 135 类题材、5 Agent 协作、20 面板工作台、世界线分支与世代传承、插件/MCP/SKILL.md 技能库扩展、多 AI 服务适配与用量统计

README.md

AI小说创作工坊 v3.3.3

CI
Release
Python
License
Tests

基于 AI 的长篇小说创作工坊 —— 135 类内置题材(可自定义)、5 Agent 协作、
20 面板工作台、世界线分支与世代传承、多 AI 服务适配与用量成本统计、
插件扩展 / MCP 接入 / SKILL.md 技能库。

桌面端为 Windows 单文件 EXE;另有 Android 应用、FastAPI 后端集群与 React Web 前端。

创作工具页

下载

平台 版本 大小 链接
Windows v3.3.3 ~28 MB AI_NovelWriter.exe
Android v4.0.1(沿用上一次构建) ~10.9 MB AI_NovelWriter_v4.0.1.apk

单文件免安装:下载后直接双击运行。首次启动需在 设置 里配置 AI 服务。

快速开始

  1. 下载并运行 AI_NovelWriter.exe
  2. 打开 设置 → AI 服务,选择服务商并填入 API Key(或使用本地 Ollama,无需密钥)
  3. 点击 新建小说,输入标题、题材、核心概念
  4. 点击 自动创作:大纲 → 角色 → 章节全自动生成
  5. 在 创作工具 页用 20 个面板精修设定、时间线、角色传记与世代传承

功能特性

创作引擎

  • 一键自动生成:大纲 → 角色 → 章节全流程自动化
  • 5 Agent 协作:PlotDesigner → WorldBuilder → Writer → Reviewer → Editor
  • 多轮迭代修订:AI 审校反馈自动回流修订,质量阈值判定
  • 135 类内置题材 + 自定义:男频 78 条 / 女频 57 条(玄幻 / 仙侠 / 都市 / 历史 / 科幻 /
    悬疑 / 游戏 / 军事 / 武侠 / 轻小说 / 无限流 / 系统流 / 末日 / 克苏鲁 / 赛博朋克 /
    古代言情 / 现代言情 / 幻想言情 / 纯爱 / 年代文 / 穿书 / 重生 …),
    并配 204 条创作标签(8 大类)。可在「管理题材…」里任意增删,配置存于本地 genres.json。
  • 续写:已完成的作品可续写新章,上下文无缝衔接

面板化工作台(20 个面板 / 5 个分组)

分组 面板
创作素材(8) 元素库 · 桥段库 · 描写库 · 对话推演 · 风格转换 · 智能改编 · 热点改编 · 插图工坊
结构分析(2) 故事流 · 章节分析
记忆与摘要(2) 记忆可视化 · 摘要管理
世界与世代(3) 世界线与时间线 · 角色传记 · 世代传承
运维(5) 批量操作 · 插件中心 · MCP 服务器 · 技能库 · 回炉重造
  • 技能库:导入 / 登记 SKILL.md 技能包,自动解析出规则分级、适用场景、
    触发词与调用参数;按当前稿件自动匹配技能,一键应用后把规则注入写作提示词
    (X 级「已否决」与 H 级「人审」规则永不注入)。详见 docs/SKILL_LIBRARY.md。

  • 回炉重造:扫描存量低质量章节(质检阻断 / 评审低分 / 标题占位),
    先把原文快照归档再送进重写队列;状态走「待重写 → 重写中 → 待审核 →
    已通过 → 已定稿」,也可直接废弃。归档只增不删,随时可回看历史版本。
    同一面板还有 整书重写:真正调模型按章重写正文(保留情节骨架、统一文风),
    支持进度条、暂停/取消、断点续跑,结果写到 chapters_rewritten/ 不覆盖原文。
    详见 docs/REWORK.md。

  • 面板框架统一提供面包屑 + 刷新按钮 + 状态栏 + F5 / Ctrl+F / Esc,
    新增面板只需在注册表加一行。

  • 分栏与停靠记忆:选择器末行可切「单栏 / 分栏」并指定右栏面板,
    两个面板并排工作;布局(含分隔条比例、已脱出的面板)下次启动自动恢复。

  • 任何面板都能脱离为独立窗口(面包屑右上角「独立窗口」),可与主窗口并排摆放;
    关掉窗口即自动收回,换书时窗口里的内容同步重建。

  • 基于线程感知事件总线联动:某处写入成功后,相关面板自动刷新。

题材与标签(可扩展)

  • 题材清单不再写死在界面里,而是三层分离:纯数据 app/genres_data.py →
    注册表 app/genres.py → 界面只读注册表。新增题材不需要改代码。
  • 管理题材…(新建小说对话框内):直接在最终清单上增删。
    删除自定义题材即移除;删除内置题材只是隐藏(不动源码),
    再次添加同名即可恢复。
  • 配置唯一来源 ~/.ai_novel_writer/genres.json:损坏时自动降级为内置清单(不会启动失败),
    写入走原子替换。
  • 作品在用的题材即使被删也仍会出现在选择器里 —— 避免界面空白后一保存就把作品题材改掉。

插件与 MCP(v3.2 新增)

  • 插件中心(运维分组):支持从目录 / ZIP / 直链 URL 安装,
    可启用 / 停用 / 卸载(状态持久化)。插件可提供写作技能包、素材库扩充、导出格式等。
  • 🔒 安全默认:插件默认不启用;启用前做静态体检(AST 扫描,列出它会 import 什么、
    是否触碰 os.system / subprocess / eval / socket 等 14 类高危符号)并按
    低 / 中 / 高分级展示;解压做 Zip Slip 防护。
    仓库自带示例插件 examples/plugins/demo_writing_skill/ 可直接试用。
  • MCP 服务器(运维分组):支持 stdio(本地进程)与 http 两种传输,
    可连通性测试、发现工具、启用/停用。本应用既能作为客户端调用外部 MCP 工具,
    也能作为服务端把自己的工具(detect_scenes / get_characters 等)按 MCP 规范暴露出去。
    配置存于 ~/.ai_novel_writer/mcp_servers.json。

稳定性(v3.2 加固)

  • 可中断的生成:点「停止」现在能中断正在生成的那一章(此前只在两章之间生效,
    表现为"点了停止没反应")。取消是协作式的,不会留下半写文件。
  • 重要数据原子写:章节、meta.json、记忆索引、摘要等一律"先写临时文件再原子替换",
    中途崩溃不会留下截断的半截文件。
  • 不静默失败:所有"吞掉异常"的位置都改为记日志或显式登记理由 ——
    避免"某个功能悄悄失灵、而用户只看到 AI 写错"这类查不出来的问题。

面板分栏

面板独立窗口

世界线 · 分支 · 世代

  • 每章自动检测决策点;主线完结后可生成分支世界线
  • 分支子项目是可打开的作品:进代际树、双击即可切换创作
  • 分支与父代属同一代(另一条世界线),但只读父代:
    写入分支内部允许,逃逸到父代被拒(路径护栏 + 测试断言)
  • 世代传承:代际树、继承计划(年龄推进 / 死亡状态 / 未解伏笔继承报告)

世界线与时间线

角色系统

  • 角色五维档案(属性 / 武器 / 技能 / 性格 / 背景)
  • 结构化传记:分段、故事线、来源与 token 归因,可导出
  • 桥段库(10 种类别、6 种基调)、角色活动轨迹与重要性追踪
  • 角色成长自动追踪;传记面板无删除角色入口,数据保护有三道防线

多 AI 服务与成本

  • Provider 注册表 + 适配器:Ollama(本地)/ OpenAI 兼容接口 / Anthropic / DeepSeek /
    智谱 GLM / Qwen / Kimi 等
  • 多套 API Profile:按服务商独立保存地址与密钥,随时切换
  • 用量与成本:token 归因与持久化、分档价目表(含缓存价与币种差异)、成本估算
  • 余额查询:DeepSeek 支持官方余额接口;无公开余额 API 的服务商如实标注

创作工具

  • 元素库(10 类别)、情景对话推演、故事流推演(正向 / 反向 / 插值 / 分支)
  • 风格转换(7 种模板)、AI 封面生成器、文生图提示词(电影级镜头语言)

导出与阅读

  • 多格式导出:TXT / EPUB / PDF / DOCX / Markdown
  • 阅读管理器支持多种电子书格式

系统要求

  • Windows 10/11(64 位)
  • 至少 4 GB 内存
  • AI 服务二选一:本地 Ollama(推荐 14B+ 模型)或云端 API Key

项目结构

ai-novel-writer/
├── novel_app.py              # 桌面端薄编排层
├── app/                      # 桌面端应用包(唯一需要安装的发行包)
│   ├── panels/               #   ├─ 面板框架:registry / host / base / legacy / ui_kit + 20 个面板
│   ├── providers/            #   ├─ 多 AI 服务:注册表 / 适配器 / 价目表 / 余额 / 推理模型
│   ├── events/               #   ├─ 线程感知事件总线
│   ├── ai_client.py          #   ├─ 统一 AI 客户端与路由
│   ├── novel_agent.py        #   ├─ 5 Agent 协作引擎
│   ├── agent_orchestrator.py #   ├─ 智能体编排
│   ├── memory_manager.py     #   ├─ 分层记忆(全局/卷/弧线/章节)+ 角色数据护栏
│   ├── timeline_store.py     #   ├─ 时间线统一存储(指纹缓存 / 一次取数)
│   ├── lineage.py            #   ├─ 世代传承与"只读父代"护栏
│   ├── biography.py          #   ├─ 结构化传记
│   ├── usage_tracker.py      #   ├─ 用量与成本统计
│   ├── *_ui.py               #   └─ 12 个功能域界面 Mixin
│   └── ...
├── backend/                  # FastAPI 后端集群
│   ├── ai-service/           #   AI 模型服务(:8001)
│   ├── novel-service/        #   小说生成服务(:8002)
│   └── shared/               #   共享中间件
├── frontend-react/           # React Web 前端
├── mobile-app/novel-app/     # Android 应用(Kotlin + Compose)
├── installer/                # PyInstaller 打包配置(novel_app.spec 等)
├── tests/                    # 测试(71 个文件,含界面质量度量与门禁)
├── docs/                     # 项目文档(索引见 docs/README.md)
├── monitoring/               # Prometheus / Grafana / Alertmanager / Loki
├── nginx/ · scripts/         # 反向代理配置 · 运维与备份脚本
├── docker-compose.yml        # 本地编排(生产用 docker-compose.prod.yml)
├── CHANGELOG.md              # 更新日志
└── CONTRIBUTING.md           # 贡献指南

开发

# 安装(含开发依赖)
pip install -e ".[dev]"

# 运行桌面端
python novel_app.py

# 运行测试(testpaths 覆盖 tests 与 backend/tests)
python -m pytest -v

# 代码质量
ruff check app/ tests/
ruff format --check app/ tests/

⚠️ 全量测试请按文件分块执行:约 2250 个用例,单次全量运行在受限环境中可能被
临时文件清理策略打断。

构建 Windows EXE

cd installer
python -m PyInstaller novel_app.spec --noconfirm
# 产物:installer/dist/AI_NovelWriter.exe

或直接运行仓库根的 build.bat(自动探测可用的 Python 解释器)。

Docker 部署

cp .env.example .env         # 配置数据库密码等
docker-compose up -d
docker-compose ps            # 查看状态
服务 地址
Web 前端 http://localhost:3000
AI 服务 http://localhost:8001
小说服务 http://localhost:8002
Prometheus / Grafana http://localhost:9090 / http://localhost:3001

版本与发布

  • 版本号单一权威源:pyproject.toml 的 version(app.__version__ 与 README 均与之一致,
    由 tests/test_version_consistency.py 守护)
  • 更新日志:CHANGELOG.md
  • 发布规范:docs/VERSION_RELEASE_SPEC.md
  • 发布产物:二进制不入库(见 .gitignore),统一通过
    GitHub Releases 分发

文档

完整文档索引见 docs/README.md,常用入口:

文档 说明
QUICKSTART.md 快速上手
USAGE.md 使用说明
docs/GENRE_SYSTEM.md 题材系统:自定义题材 / 标签 / 配置格式
docs/PLUGIN_SYSTEM.md 插件系统:插件类型、接口约定、安装与安全边界
docs/MCP_SUPPORT.md MCP 支持:客户端/服务端、配置、安全边界
docs/MODULE_DEPENDENCY_MAP.md 模块依赖关系图(由脚本从源码生成)
docs/BACKLOG_REGISTER.md 待办 / 遗留问题 / 已知缺陷总登记册
docs/PACKAGING_AND_PANEL_PLAYBOOK.md 打包与新增面板的操作手册
docs/ROADMAP_V3_PANELS_AND_PROVIDERS.md v3 改造方案与实施进度
docs/NEXT_STEPS.md 下一步行动计划
docs/API.md 后端 API
docs/ui_review/ 界面改造前后对照截图

贡献

欢迎提交 Issue 与 PR!请先阅读 CONTRIBUTING.md。

许可证

MIT Modified License —— 可自由使用与修改,商用需注明来源
(项目名称 + GitHub 链接)。

Yorumlar (0)

Sonuc bulunamadi