InkWell AI
AI writing workspace.
personal ai exploration
一个公开运行的长篇中文网文 AI 工作台，围绕 Story Bible、章节管线、多模型 provider、WebSocket 生成事件和生产安全构建完整创作流程。 它覆盖从选题、规划、写作、审查、修复到导出的连续创作流程。
Screens
Scope
项目配置、Brainstorm、Story Bible、章节规划、初稿、审查、修复和导出形成连续流程。
多 LLM provider、OpenAI-compatible 路由、模型探针、采样配置和 API key 加密存储。
Next.js 工作台、FastAPI API、Redis Streams 任务队列、Generator worker 和 PostgreSQL 记忆层。
OAuth/JWT、httpOnly cookie、Redis 限流、SSRF 防护、CSP nonce、安全头和 watchdog。
Architecture
公开页和登录边界
Next.js 承载公开介绍页、登录注册和认证后的创作工作台，生产截图只展示公开 About 页面。
项目、章节和生成控制台
前端管理项目仪表盘、章节编辑、provider 配置、Story Playbook 和实时生成进度。
FastAPI 处理项目资源
后端路由覆盖认证、项目、章节、生成、provider、世界记忆、Narrative Board、导出、监控和管理。
Redis Streams 拆出生成任务
API 写入生成任务后立即返回会话；独立 Generator worker 消费任务并执行章节管线。
Story Bible 持久化长文本状态
角色、关系、世界事实、人物状态、伏笔、章节记忆和卷摘要都作为结构化数据存入 PostgreSQL。
Plan / Write / Review / Fix
章节生成带上 contract、beat graph、上下文快照和 gatekeeper 检查，必要时进入修复阶段。
本地规则和检测引导改写
InkTrace、本地统计特征、采样 profile、FastDetect 选项和 detector-guided rewrite 处理可识别 AI 质感。
公开运行的工程边界
Docker Compose、Nginx SSL、Let's Encrypt、PgBouncer、Redis、限流、SSRF 防护和 watchdog 共同支撑生产运行。
Workflow
用户创建项目，配置题材、provider、故事工作流、设定、角色和可选 Story Playbook。
前端调用生成接口并订阅 WebSocket 生成事件，后端校验登录态、项目权限、模型配置和生成参数。
FastAPI 把生成任务写入 Redis Stream，返回 generation session，避免 HTTP 请求长时间阻塞。
Generator worker 消费任务，组合大纲、Story Bible 和章节上下文，执行 Plan -> Write -> Review -> Fix。
中间事件写入 Redis event stream，再由 WebSocket Gateway 回放和转发给浏览器，用户能看到计划和生成进度。
章节正文、抽取出的角色状态、世界事实、伏笔和记忆摘要写回 PostgreSQL。
Narrative Board 和 Story Bible 读取更新后的状态，辅助一致性审查、情绪/剧情分析和后续章节。
导出接口从持久化章节生成 TXT/DOCX，输出基于已保存内容，避免依赖临时生成流。
Timeline
横向滚轮、拖动或点击里程碑；选择项会更新下方详情和进度。
early exploration
公开 AI 写作工作台成形
项目从个人能力探索开始，形态包含公开页面、注册登录、生产环境和完整创作工作台。
01 / 07 · 运行形态
时间线整理自本地 README、部署手册、Trellis 任务、git log、FastAPI/Next.js 结构和生成 worker 代码，不展示用户作品、账号或 provider 密钥。
Notes
- 架构描述来自本地 Next.js 前端、FastAPI 后端、模型层、服务层和生成 worker 结构。
- 展示口径限定为个人探索、公开运行、真实生产架构和 900+ 用户。
- 页面只使用公开 About 截图和虚拟作品开发截图，不展示用户稿件、管理员数据、生产主机或 API key。