Arboris：用AI辅助小说家构建世界和生成草稿的工具

Arboris是一个AI工具。它帮助小说家从想法开始构建完整故事。用户输入简单概念，AI生成世界观、角色和关系网。工具还扩展灵感成故事大纲，并写出章节草稿。每个小说作为一个项目管理，所有内容整理清楚。用户可以和AI对话，实时编辑文本。工具保存草稿版本，让用户对比和标记满意部分。AI学习用户风格，生成更匹配的内容。部署用Docker，一键启动在服务器上。需要OpenAI API密钥支持AI功能。默认用SQLite数据库，也支持MySQL。管理员初始账号是admin，部署后改密码。工具高度可定制，调整提示词和模型。开源在GitHub，适合个人使用。在线测试版用Gemini模型，但自部署版用OpenAI。工具保留人工确认，避免纯AI输出缺乏创意。

功能列表

• 孕育世界：用户给基本想法，AI生成世界观细节，包括派系、地点和背景设定。
• 塑造角色：创建角色描述，生成关系网，连接人物关系，便于管理复杂互动。
• 规划蓝图：从灵感扩展成完整大纲，覆盖故事开端、发展和高潮，确保情节逻辑。
• 挥洒文墨：AI根据用户指导写章节草稿，提供多个版本，用户挑选和修改。
• 交互式写作台：用户与AI对话，下指令，实时生成和优化文本。
• 版本与评估：保存草稿版本，支持对比，标记满意部分，AI调整风格。
• 项目式管理：每个小说独立项目，存放设定、大纲和章节，便于查找。
• 高度可定制：调整提示词、模型API，匹配用户习惯。
• 一键部署：用Docker Compose启动，配置环境变量。
• 助手角色升级：包括概念师收集脑洞、蓝图师整理蓝图、大纲师补充概要、小说家写章节、提取师压缩内容、评价师点评质量。
• 响应式布局：支持手机使用。
• 模型选择：自部署用OpenAI模型，在线版用Gemini-2.5-flash。

使用帮助

Arboris的安装基于Docker。用户先安装Docker和Docker Compose。这是基本环境。安装后，从GitHub克隆仓库。命令是git clone https://github.com/t59688/arboris-docker.git。进入目录。用cp .env.example .env复制环境变量文件。打开.env编辑。

核心变量先设置。SECRET_KEY是JWT加密密钥。必须随机复杂。用工具生成字符串。OPENAI_API_KEY是OpenAI密钥。必填。没有它，AI无法工作。OPENAI_API_BASE_URL默认https://api.openai.com/v1。如果用其他服务，改这里。OPENAI_MODEL_NAME默认gpt-3.5-turbo。可换gpt-4或其他。

数据库设置。默认DB_PROVIDER=sqlite。简单，无需额外容器。想映射数据库文件到主机，设SQLITE_STORAGE_SOURCE=./storage。这是相对路径。也可用绝对路径如/path/to/storage。

用MySQL时，设DB_PROVIDER=mysql。填MYSQL_HOST、MYSQL_PORT、MYSQL_USER、MYSQL_PASSWORD、MYSQL_DATABASE。内置MySQL需MYSQL_ROOT_PASSWORD。主机是db。

邮件配置。如果开注册，填SMTP。SMTP_SERVER是地址。SMTP_PORT默认465。SMTP_USERNAME和SMTP_PASSWORD是登录信息。EMAIL_FROM默认“拯救小说家”。

注册和登录。ALLOW_USER_REGISTRATION默认false。设true，用户自注册。需SMTP发验证邮件。ENABLE_LINUXDO_LOGIN默认false。设true，用Linux.do OAuth。填LINUXDO_CLIENT_ID、LINUXDO_CLIENT_SECRET、LINUXDO_REDIRECT_URI等。回调URI是/api/auth/linuxdo/register。

管理员。ADMIN_DEFAULT_USERNAME默认admin。ADMIN_DEFAULT_PASSWORD是初始密码。启动后改。ADMIN_DEFAULT_EMAIL是邮箱。

其他。APP_PORT默认80。ENVIRONMENT默认production。DEBUG默认false。调试设true。LOGGING_LEVEL默认INFO。WRITER_CHAPTER_VERSION_COUNT默认2，控制版本数。

配置好，用默认SQLite运行docker compose up -d。后台启动。日志用docker compose logs -f查。

内置MySQL，设DB_PROVIDER=mysql，运行DB_PROVIDER=mysql docker compose --profile mysql up -d。启动MySQL容器。

外部MySQL，设DB_PROVIDER=mysql，填变量，不用profile。运行docker compose up -d。

镜像用tiechui251/arboris-app:latest。先拉docker pull tiechui251/arboris-app:latest。docker-compose.yml已配置。

启动后，访问http://localhost:80或服务器IP。登录用admin和初始密码。马上改密码。

现在用功能。创建项目。填名字和描述。每个小说一个项目。

孕育世界。输入想法，如“魔法世界有龙”。AI生成派系、地点。编辑保存。

塑造角色。输入名字、背景。AI扩展。生成关系网。添加连接，如A是B的敌人。图表显示。

规划蓝图。输入灵感，如“英雄冒险”。AI生成大纲。分章节。调整顺序，加子情节。

挥洒文墨。选章节。指令如“写开头，英雄出发”。AI生成草稿。多个版本。挑选编辑。

交互式写作台。聊天输入“加战斗场景”。AI回应。复制到文档。

版本与评估。草稿自动存。查看历史。恢复旧版。标记好部分。AI学习风格。

项目管理。菜单切换项目。所有文件有序。导出大纲或章节。

助手角色。概念师收集脑洞。用户输入想法，它引导扩展。蓝图师整理成蓝图。包括整体结构。大纲师加章节概要。小说家写新章节，提供2个版本。提取师压缩章节，便于传上下文。评价师点评质量，指出问题。

自定义。设置改提示词，如“用中文写，像武侠风格”。换模型。

响应式布局。手机上正常用。布局适应屏幕。

模型选择。自部署用OpenAI。在线版https://arboris.aozhiai.com用Gemini-2.5-flash。公益API，人多可能慢。

为什么不自动化。因为人+AI合作更有趣。人工确认加创意。纯AI易成流水账。

bug。创建蓝图或章节失败，但可能已成。刷新试试。

更新。拉新镜像，重启docker compose restart。

备份。SQLite文件在storage。复制。MySQL导出数据库。

安全。SECRET_KEY保密。密码强。防火墙开80端口。

在线体验https://arboris.aozhiai.com。测试后自部署。私有数据安全。

环境变量表：

更多在.env.example。跟着这些，用户上手快。工具让创作简单。

应用场景

1. 灵感枯竭时
   用户面对空白文档，用Arboris输入模糊想法。AI生成世界观和角色。用户快速启动创作。
2. 处理复杂关系
   长篇小说中，人物多。用关系网管理连接。避免混淆。
3. 快速写草稿
   有大纲但写慢。用AI生成章节版本。用户修改完善。
4. 学习个人风格
   新手标记满意句子。AI调整生成。提升写作技能。
5. 团队协作
   多人编辑项目。分享设定和大纲。适合写作小组。
6. 手机创作
   响应式布局。随时用手机对话AI，优化文本。

QA

1. Arboris怎么安装？
   用Docker Compose。克隆仓库，复制.env，编辑变量。运行docker compose up -d。
2. 需要什么API？
   OpenAI API key必填。用于AI生成。
3. 支持什么数据库？
   默认SQLite。可换MySQL，内置或外部。
4. 如何自定义模型？
   在.env改OPENAI_MODEL_NAME，如gpt-4。
5. 注册怎么开？
   设ALLOW_USER_REGISTRATION=true。配置SMTP发邮件。
6. 版本怎么管理？
   草稿自动存。用户查看历史对比恢复。
7. 在线版和自部署区别？
   在线版https://arboris.aozhiai.com用Gemini测试。自部署用OpenAI，数据私有。
8. 镜像怎么更新？
   运行docker pull tiechui251/arboris-app:latest。然后重启。
9. 已知bug？
   创建蓝图或章节失败时，刷新网页试试。可能已成功。