# FuxiLoom Novel Writer Ai

**Repository Path**: baymax2018/ai-writing-tool

## Basic Information

- **Project Name**: FuxiLoom Novel Writer Ai
- **Description**: FuxiLoom Novel Writer Ai：一个专注于提升文本创作质量的开源项目，拥有丰富的AI功能，从检测到写作一条龙打通，两种书写格式均支持对照翻译，搭配高度可自定义的skills，助力创作者提升效率与小说跨境的竞争力。
- **Primary Language**: 其他
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2026-08-22
- **Last Updated**: 2026-08-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FuxiLoom Novel Writer Ai

> 面向长篇小说与网络文学创作的 AI 桌面工作台<br>
> 当前版本：**V5.3**

**FuxiLoom Novel Writer Ai** 是一款基于 Tauri、React、TypeScript 与 Rust 构建的桌面端小说创作工具。项目以完整的“作品工程”为核心，把灵感构思、角色与世界观管理、卷章规划、正文写作、AI 协作、质量分析、审校修改、翻译朗读和稿件导出整合到同一工作区。

它不是一个只负责续写的聊天窗口。系统会围绕作品结构组织上下文，让 AI 在明确的角色、设定、时间线、前文章节、目标平台和创作规则下工作；涉及作品数据的操作则由 Agent 工具和小说执行内核统一校验、落盘并记录结果，减少长篇创作中的人物失真、设定冲突、情节断裂和文风漂移。

## 项目定位

FuxiLoom Novel Writer Ai 主要服务于：

- 需要管理多部作品、多卷多章和大量设定的长篇小说作者。
- 关注开篇钩子、爽点节奏、读者留存与平台适配的网络文学创作者。
- 希望让多个 AI 角色参与起草、审校、复核和整合的创作团队。
- 需要本地保存、版本历史、模型自由配置和桌面文件导出的个人用户。
- 希望建立“规划、创作、检测、修改、复检”闭环的内容生产者。

核心工作流：

```text
灵感与作品定位
  -> 角色 / 世界观 / 时间线 / 思维导图
  -> 卷纲 / 章纲 / 伏笔规划
  -> 编辑器或 Agent 创作
  -> 节奏 / 套路 / 深度 / AI 痕迹 / 错字分析
  -> 定位问题并修改
  -> 复检 / 翻译 / 朗读 / 导出
```

## 功能全景

| 模块 | 主要能力 |
| --- | --- |
| 作品工程 | 多作品、多卷、多章、作品资料、目标平台与创作风格管理 |
| 正文编辑 | 横排/竖排、格式设置、选区处理、续写改写、历史记录与段落级操作 |
| AI 协作 | Chat、Plan、Group、自动全流程、工具调用与上下文压缩 |
| 设定系统 | 角色、关系图、世界观、势力、时间线、卷纲、章纲、思维导图 |
| 知识系统 | 内置类型与平台知识、文档导入、知识卡片、检索与 Agent 引用 |
| 本地 Skills | 按任务注入创作规范，约束连续性、角色、文风、伏笔和内容质量 |
| 内容分析 | 节奏、套路、AI 深度分析、AI 痕迹检测、错字校对与签约评估 |
| 辅助阅读 | 段落朗读、播放段落高亮、自动跟随、语言与声线配置 |
| 翻译对照 | 中英日翻译、原译文段落对应、横排/竖排及分栏显示 |
| 数据与导出 | 本地保存、历史快照、项目导入导出、Markdown/TXT/JSON/DOCX |

## 作品工程与编辑器

- 按作品、卷、章管理长篇内容，保存题材、简介、风格、平台和章节结构。
- 支持新增、编辑、删除、移动和批量组织章节。
- 支持横排与竖排正文、字体字号、对齐、缩进、空行和自动排版设置。
- 支持选区润色、续写、整章改写、仿写辅助和基于分析报告的针对性修改。
- 通过 IndexedDB 保存正文历史快照与操作日志，提供撤销、恢复和历史查看。
- 统计作品字数和专注时长，帮助作者掌握当前创作进度。

## AI 协作工作流

### Chat

围绕当前作品自由交流。AI 可以读取被引用的正文和作品资料，回答创作问题、分析剧情，也可以在获得明确任务后调用工具修改作品。

### Plan

先生成结构化执行计划，等待用户确认后逐步执行。每一步都显示状态和真实结果，适合创建角色、补全设定、规划章节或执行跨模块修改。

### Group

由创作者 Agent 生成草稿，再交给多个审校角色从设定、逻辑、伏笔、风格和角色一致性等维度检查，最后由整合角色汇总修改。各角色可分别配置模型与提示词。

### GroupPro

在 Group 的「创作者 → 多审校师 → 总编」基础上叠加多轮收敛与裁决机制：每轮审校后由裁决者判断是否仍有未解决的硬伤或互相冲突的意见，未收敛则由总编修订再审，直到收敛或达到轮数上限。终稿在写入章节前，还会经过文笔终审师对文笔、用词、句式、节奏和冗余做最后一道复检；存在文笔硬伤时退回总编修订再审，仅剩润色级建议则放行落盘。创作者、审校师、总编、裁决者与文笔终审师均可独立配置模型与提示词。

### 自动全流程

根据一句创作需求，依次完成作品定位、世界观、角色、卷纲、章节规划、细纲和终检，适合快速建立新作品骨架。

### Agent 与小说执行内核

- Agent 工具可读取或修改作品信息、角色、世界观、势力、时间线、大纲、伏笔和章节正文。
- 结构化内容遵循“先展示、再确认、后写入”的交互原则。
- 小说执行内核负责参数整理、目标校验、重复检查、内容验证、结果回执和执行日志。
- 对话上下文支持按预算压缩，并注入章节摘要、人物状态、伏笔和历史反馈。
- Plan 反馈和项目记忆可被后续同类任务复用，降低重复沟通成本。

## 角色、世界观与知识系统

- 维护角色档案、人物关系与角色星图，辅助检查人物立场和互动关系。
- 管理世界规则、背景条目、势力结构和时间线事件。
- 使用卷纲、章纲和思维导图拆分长篇结构。
- 通过章节摘要记录剧情进展、出场人物和待回收伏笔。
- 知识库支持文档导入、知识卡片、分类浏览、关键词检索和对话查询。
- 内置网络文学类型、节奏、常见套路、平台规则及日系轻小说相关知识。

## 本地 Skills

Skills 是可编辑的 Markdown 创作规则，可以全局启用，也可以绑定到单个作品。系统会根据任务类型和触发词选择合适的 Skill，将规则注入 Agent 上下文。

项目内置小说质量与规范 Skill，重点约束：

- 章节与前情连续性。
- 人物行为、知识边界和角色声音一致性。
- 叙事风格、场景具体性与自然节奏。
- 伏笔埋设、推进与回收。
- 平台规范、证据边界和成稿质量。

Skill 不以制造错字、随机噪声或规避检测为目标，而是用于提升文本质量、作者可控性和内容可发表性。

## 分析、检测与审校

### 节奏与套路分析

- 评估章节冲突密度、场景强度、节拍变化、钩子和阅读推进。
- 结合题材与目标平台给出阶段性节奏建议。
- 识别常见类型桥段、标签组合和潜在同质化风险。

### AI 深度分析

从冲突推进、人物能动性、场景表现、对话潜台词、节奏张力、叙述声音、设定一致性和平台适配等维度生成结构化报告。分析结果和历史版本按作品、章节及内容指纹保存，便于修改前后对比。

### AI 痕迹检测

综合本地文本特征、统计指纹、困惑度信号和可选模型复核，输出风险区间、证据、置信度与修改方向。检测结果用于辅助审校，不把单一分数作为文本来源的确定结论。

### 错字与校对

- 本地规则优先识别固定词组误写、重复虚词、连续标点和明确格式问题。
- 可调用 AI 进行语境复核，补充同音字、近形字和上下文用词问题。
- 对问题给出原文、建议、原因、来源和置信度，支持定位与修改。

### 平台与签约评估

根据作品类型、篇幅、开篇、节奏、受众、禁忌项和平台规则进行适配分析。项目包含多个中文网文平台及日系轻小说投稿方向的规则资料，用于自评和修改参考，最终签约或审核结果以平台编辑判断为准。

## 翻译与朗读

- 对正文按段落进行翻译，保留原文与译文对应关系。
- 支持中文、英文和日文，以及默认、左右分栏、上下分栏和竖排对照布局。
- 章节朗读支持语言、声线、语速、音调、段落跳转、暂停与继续。
- 播放时高亮当前正文段落，并自动滚动到正在朗读的位置。
- 桌面端可使用 Edge TTS 在线语音能力。

## 数据、隐私与备份

- 作品、设置、知识库、分析缓存和对话记录主要保存在本机。
- 正文历史使用 IndexedDB；桌面端会定期将历史数据备份到应用数据目录，并保留最近的备份文件。
- 支持导出完整项目数据，也可导出便于人工整理的作品文件夹结构。
- 导入项目会覆盖当前作品和相关资料，操作前应先导出备份。
- 应用不提供默认云同步。调用 AI、翻译或在线语音服务时，相关文本会发送到用户配置的服务提供方，请自行确认其隐私政策。
- Tauri 的持久化标识保持为 `com.novel.writer`，避免产品改名或升级后切换到新的应用数据目录。

## 模型与服务配置

- 使用 OpenAI 兼容接口接入云端或本地模型。
- 支持保存多个服务商账户，并为通用创作、Agent、翻译和检测任务选择不同配置。
- 可连接 OpenAI、DeepSeek、SiliconFlow 等兼容服务，也可连接本机 Ollama 兼容地址。
- Group / GroupPro 模式中的起草者、审校者、整合者、裁决者与文笔终审师可以独立选择账户、模型和提示词。
- 请求支持流式响应、超时处理和兼容性配置。

## 导出能力

导出范围：

- 当前章节。
- 当前卷。
- 指定章节。
- 当前作品。
- 完整项目。

导出内容：

- 原文。
- 译文。
- 双语对照。
- 包含设定与知识资料的完整记录。

导出格式：

- Markdown。
- TXT。
- JSON。
- DOCX。
- 桌面端项目文件夹结构。

## 技术架构

| 层级 | 技术与职责 |
| --- | --- |
| 桌面端 | Tauri 1.x、Rust，负责窗口、文件系统、安装包和桌面能力 |
| 前端 | React 18、TypeScript、Tailwind CSS |
| 构建 | Vite 5、npm、Cargo |
| AI 接入 | OpenAI 兼容接口、本地模型、流式请求 |
| 创作引擎 | Agent、小说执行内核、章节生成、上下文与计划管理 |
| 分析引擎 | 节奏、套路、深度分析、AI 痕迹、错字和签约评估 |
| 数据层 | Local Storage、IndexedDB、Tauri 文件系统 |

主要目录：

```text
src/app/          应用状态、编辑器、Agent、检测、翻译和导出流程
src/components/   编辑器、侧栏、分析面板、设置与业务弹窗
src/engines/      Agent、执行内核、知识库、节奏和检测引擎
src/modules/      写作、知识、翻译、平台与签约模块入口
src/utils/        AI 请求、存储、Skills、校对和导出工具
src-tauri/        Tauri / Rust 桌面端配置与命令
skills/           本地小说创作 Skills
scripts/          自动化回归测试脚本
docs/             设计文档、AI 检测机制与开发记录
tests/            端到端测试
```

## 开发与构建

### 环境要求

- Node.js 18+
- npm
- Rust stable
- Windows WebView2

### 安装依赖

```bash
npm install
```

### 浏览器开发模式

```bash
npm run dev
```

### Tauri 桌面开发模式

```bash
npm run tauri dev
```

### 生产构建

```bash
npm run build
npm run tauri build
```

## 测试

项目包含针对核心业务的脚本化回归测试：

```bash
npm run test:kernel
npm run test:agent-tools
npm run test:agent-collaboration
npm run test:context-compaction
npm run test:author-portrait
npm run test:ai-detection
npm run test:deep-analysis
npm run test:analysis-storage
npm run test:local-skills
npm run test:typo-detection
npm run test:app-identity
npm run test:ui-flows
npm run test:e2e
npm run test:phase2
```

## 推荐使用流程

1. 新建作品，填写题材、简介、风格和目标平台。
2. 建立角色、人物关系、世界观、势力、时间线、卷纲和章纲。
3. 配置 AI 服务账户、任务模型、Group 角色和本地 Skills。
4. 使用编辑器、Chat、Plan、Group 或自动全流程生成和修改内容。
5. 运行节奏、套路、深度、AI 痕迹、错字和平台分析。
6. 根据报告定位问题，完成修改并重新检测。
7. 导出章节、整部稿件或完整项目备份。

> AI 输出和自动分析可能包含事实错误、文风偏差、漏检误判或不符合发布平台要求的内容。正式发布前，应由作者完成审阅、校对、事实核验和版权风险检查。

## 鸣谢

本项目的界面图标使用 [Ant Design Icons](https://github.com/ant-design/ant-design-icons)（MIT License，© 2018-present Ant UED）。在此向其作者与社区表示感谢。

同时感谢 Tauri、React、Vite、ReactFlow、docx 等开源项目，本工具站在这些社区的工作之上构建。各依赖的许可证及完整声明见仓库根目录 [THIRD-PARTY-NOTICES.md](THIRD-PARTY-NOTICES.md)。

## 开源协议与版权

本项目采用 **Apache License 2.0**。完整协议见仓库根目录 [LICENSE](LICENSE)。

The source code in this repository is licensed under the Apache License, Version 2.0.

Copyright [2025] 猫猫大人

## 作者

猫猫大人