赋灵 | Enspirit

一款基于角色独立人格、自主演化剧情的 AI 小说创作工具。

你不再是操控木偶的作者，只是世界的构建者，故事的旁观者与记录者。

---

灵感

源自《三体 2：黑暗森林》中罗辑与白蓉关于文学创作的经典对话：

"她好像是一个提线木偶，每个动作和每一句话都来自于我的设想，缺少一种生命感。"

"你的方法不对，你是在作文，不是在创造文学形象。要知道，一个文学人物十分钟的行为，可能是她十年的经历的反映。你不要局限于小说的情节，要去想象她的整个生命，而真正写成文字的，只是冰山的一角。"

"文学形象的塑造过程有一个最高状态，在那种状态下，小说中的人物在文学家的思想中拥有了生命，文学家无法控制这些人物，甚至无法预测他们下一步的行为，只是好奇地跟着他们，像偷窥狂一般观察他们生活中最细微的部分，记录下来，就成为了经典。"

本项目将这段创作思想落地实现：无需手动编写剧情大纲，不用强行操控人物走向。只需完善角色性格、过往人生与底层三观，将人物放入自定义世界观中，角色便会自主思考、自主抉择、自行产生矛盾与羁绊，自然而然推动整个故事生长延续。

---

功能

• 世界构建向导 — AI 世界建筑师通过自然对话帮你构建世界观：时代背景、核心规则、初始事件、角色建议
• 角色灵魂铸造 — AI 灵魂铸造师深入挖掘角色的人格特质（OCEAN 五因素）、核心价值观、人生经历、潜意识
• 事件驱动因果链引擎 v2.0 — Director LLM 编排事件步骤 → 角色自主决策行动 → Narrator 合成为叙事
• Event Planner（事件编排器） — 用户注入事件后，LLM 自动编排为结构化引导步骤，支持无事件自动推演
• 世界事实库（WorldFacts） — 从叙事中自动抽取硬事实，跨回合检测事实矛盾并触发重写，确保世界观一致性
• 角色记忆系统 — LLM 从第一人称视角生成经历记忆，recency × importance 粗筛 + LLM 相关性检索
• 观察剧场 — 双面板实时观测叙事流和世界状态，支持事件注入、回合回溯、世界分支、推演暂停/继续/终止
• 世界备份与分支 — 自动 checkpoint + 一键重置世界 + 从当前状态或任意回合复制出平行世界
• NPC 激活系统 — 自动从叙事中识别 NPC，LLM 多步提取经历/心理/记忆，一键激活为正式角色
• QA 质量分析 — 四角色 LLM 评审团（叙事评论家、架构师、Prompt 工程师、一致性审计），多维度评估推演质量
• LLM 场景管理 — 22 个场景统一解析，支持多模型灵活分配
• Prompt 工程系统 — 模板存文件系统，可在后台编辑，版本管理由 Git 负责

---

技术栈

层	技术
框架	Next.js 16 (App Router)
语言	TypeScript
数据库	PostgreSQL + Prisma 7
认证	NextAuth v5 (Credentials + JWT)
AI	Vercel AI SDK (generateText + generateObject)
样式	Tailwind CSS + 墨韵 (Ink Rhythm) 设计系统
字体	Noto Serif SC / LXGW WenKai TC

---

快速部署

提供两种安装方式，按需选择：

方式一：Docker 安装（推荐）

需要：Docker 和 Docker Compose。

# 下载部署文件
curl -O https://raw.githubusercontent.com/ai-dev-dot/enspirit/main/docker-compose.yml

# 启动
docker compose up -d

访问 http://localhost:8080，第一个注册的用户自动成为管理员。

方式二：一键脚本安装

需要：PostgreSQL（脚本会自动检测，已有则跳过安装）。

# macOS / Linux
curl -sSL https://raw.githubusercontent.com/ai-dev-dot/enspirit/main/install.sh | bash

# Windows (PowerShell)
irm https://raw.githubusercontent.com/ai-dev-dot/enspirit/main/install.ps1 | iex

脚本会自动：

1. 检测/安装 Node.js 22+
2. 检测/安装 PostgreSQL（如已有则跳过）
3. 下载预编译包（不含源码）
4. 配置数据库
5. 启动服务

访问 http://localhost:8080，第一个注册的用户自动成为管理员。

管理命令：

# 启动
~/.enspirit/start.sh

# 停止
kill $(cat ~/.enspirit/enspirit.pid)

# 日志
tail -f ~/.enspirit/enspirit.log

注意：脚本安装下载的是预编译产物（.next/、public/、prisma/），不包含 TypeScript 源码。

---

启动后登录管理员账号，在 /admin/models 中配置 LLM Provider 即可开始使用。

自定义配置

数据库密码和密钥已预设默认值，如需修改，编辑 docker-compose.yml 中的环境变量：

变量	默认值	说明
POSTGRES_PASSWORD	enspirit123	数据库密码
DATABASE_URL	对应上述密码	PostgreSQL 连接串
AUTH_SECRET	空	会话密钥，空则容器启动时自动生成

修改后执行 docker compose up -d 重新部署。

升级

docker compose pull
docker compose up -d

配置 LLM

支持的 LLM 协议：

• OpenAI 兼容（OpenAI、DeepSeek、通义千问、GLM 等）
• Anthropic 兼容（Claude 系列）

系统要求

• Docker 20.10+
• 至少 2GB 可用内存