PlotPilot(墨枢)

这是什么

内核架构

1. 叙事状态机(Narrative State Machine)

2. 向量语义检索层(Vector Retrieval Layer)

3. 剧情引擎运行时(Engine Runtime)

宏观规划(部 / 卷 / 幕结构)
 └─▶ 幕级节拍规划(Beat Sheet 生成)
 └─▶ 章节生成循环
 ├─▶ 叙事治理预算
 ├─▶ 章节执行剧本准备
 ├─▶ 上下文装配(人物 / 世界观 / 记忆 / 伏笔)
 ├─▶ LLM 调用
 ├─▶ 内容策略验证
 ├─▶ 文风漂移检测
 ├─▶ 章末管线(摘要 / 事件 / 三元组 / 伏笔)
 ├─▶ 向量索引更新
 ├─▶ 张力评分
 └─▶ 状态落库 → 继续 / 重写 / 暂停

4. 提示词策略层(Prompt Strategy Layer)

5. 质量监控子系统(Quality Monitor)

内核与生态

PlotPilot 内核(本仓库)
 │
 ├── 叙事状态机
 ├── 向量语义检索层
 ├── 剧情引擎运行时
 ├── 提示词策略层(20+ 接点)
 └── 质量监控子系统
 │
 ▼
 REST API(FastAPI · v1 · 版本化)
 │
 ┌───────┴──────────────────────┐
 │ │
 官方工作台前端 生态扩展层(基于内核)
 Vue 3 · TypeScript ├── 垂直领域工具
 Naive UI · ECharts │ (剧本/游戏剧情/IP 衍生......)
 Tauri 桌面客户端 ├── 第三方前端 / 编辑器插件
 ├── 自定义提示词包
 └── 云服务 / SaaS(需遵守许可证)

技术选型说明

快速开始

方式一:一键启动(Windows,无需安装 Python)

方式二:桌面安装版(Windows · Tauri)

开发者文档

# 后端 — Windows
py -3.14 -m venv .venv && .venv\Scripts\activate
pip install -r requirements.txt
copy .env.example .env # 填写 LLM 凭证
uvicorn interfaces.main:app --host 127.0.0.1 --port 8005 --reload

# 后端 — Linux / macOS
python3.14 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
uvicorn interfaces.main:app --host 127.0.0.1 --port 8005 --reload

# 前端(另开终端)
cd frontend && npm install && npm run dev

环境变量

架构目录

(项目根目录)/
├── domain/ # 领域层 — 纯业务模型和值对象
│ ├── novel/ # 小说、章节、故事线、伏笔、因果、张力
│ ├── bible/ # 设定库、人物档案、地点、时间线
│ ├── character/ # 人物实体、人物状态、关系能力
│ ├── cast/ # 卡司与人物关系图
│ ├── knowledge/ # 知识三元组、故事知识图
│ ├── memory/ # 长期记忆与上下文状态
│ ├── prop/ # 道具生命周期与道具事件
│ ├── worldbuilding/ # 世界观领域模型
│ ├── structure/ # 故事结构节点
│ ├── evolution/ # 世界线 / 演化相关模型
│ ├── ai/ # AI 领域契约与值对象
│ └── shared/ # 共享基类、异常、事件、ID
│
├── application/ # 应用层 — 用例编排,协调领域、引擎与基础设施
│ ├── core/ # 小说 / 章节 / 导出等基础用例
│ ├── onboarding/ # 新书向导、前置设定生成
│ ├── blueprint/ # 宏观规划、连续规划、Beat Sheet、故事结构
│ ├── engine/ # 上下文构建、章后管线、治理预算、AI 调用编排
│ ├── governance/ # 叙事治理、质量约束、章节预算
│ ├── audit/ # 章节审阅、宏观重构、章节元素分析
│ ├── analyst/ # 文风、张力、伏笔账本、叙事状态分析
│ ├── world/ # Bible、知识图谱、世界观与人物关系服务
│ ├── ai/ # LLM / embedding 应用服务
│ ├── ai_invocation/ # AI 调用记录与审阅
│ ├── checkpoint/ # 检查点与快照用例
│ ├── memory/ # 记忆编排用例
│ ├── narrative/ # 叙事投影与状态同步
│ ├── narrative_engine/ # 叙事引擎应用服务
│ ├── manuscript/ # 正文实体索引与手稿服务
│ ├── prop/ # 道具应用服务
│ ├── reader/ # 读者模拟 / 阅读侧能力
│ ├── snapshot/ # 快照应用服务
│ ├── workbench/ # 工作台编排
│ └── workflows/ # 自动生成工作流、兼容编排与后台任务
│
├── engine/ # 剧情引擎内核 — 生产运行时、章节写作管线与题材扩展
│ ├── runtime/ # EngineDaemon、StoryPipelineRunner、守护进程委托、质量守门
│ ├── pipeline/ # BaseStoryPipeline 十步章节生成管线
│ ├── pipelines/ # 题材 Pipeline 注册与扩展(如武侠、通用题材桥接)
│ ├── core/ # 引擎侧实体、端口、服务契约
│ └── infrastructure/ # 引擎事件、记忆编排、checkpoint 适配
│
├── infrastructure/ # 基础设施层 — 技术实现,可替换
│ ├── ai/ # LLM Provider、Prompt Packages、向量存储、嵌入服务
│ ├── persistence/ # SQLite 仓储、迁移、Write Dispatch 单写者调度器
│ ├── export/ # DOCX / EPUB / PDF 导出
│ └── runtime/ # 数据目录、日志环境与进程级运行配置
│
├── interfaces/ # 接口层 — FastAPI、依赖注入、运行状态与外部边界
│ ├── main.py # FastAPI 应用入口
│ ├── daemon_manager.py # 后端内自动驾驶进程管理
│ └── api/v1/ # REST API(core / world / blueprint / engine / audit / analyst 等)
│
├── frontend/ # 官方工作台 — Vue 3 + TypeScript + Tauri 桌面壳
│ ├── src/ # 工作台、自动驾驶、知识图谱、设置、API client
│ └── src-tauri/ # Tauri 桌面客户端与后端 sidecar
│
├── shared/ # 跨端共享配置与分类体系资源
├── config/ # 本地配置与默认配置
├── scripts/ # 启动、安装、迁移、评估与维护脚本
├── tests/ # 单元、集成、E2E 与 DAG 测试
└── tools/ # Windows 启动器与内嵌 Python 包

测试

pytest tests/ -v
# 含覆盖率报告
pytest tests/ --cov=. --cov-report=term-missing

贡献指南

提交安全边界

加入我们

许可证

Star History