InkOS

项目简介

InkOS 是开源的故事创作 AI Agent 系统，面向长短篇小说、剧本剧作、互动影游、IP 内容与多语言翻译。它通过 Studio、TUI 和 CLI 提供统一工作台，由智能体管理创意、设定、角色、记忆、审稿、修订、封面、互动状态和跨语言交付。

核心功能

• 统一创作工作台：Studio Chat、TUI、CLI 与外部 Agent 入口共享同一套执行内核，覆盖建书、短篇、封面、互动世界与持久化文本编辑。
• 长篇生产管线：按规划、上下文编排、写作、审稿记录和原子提交推进章节，并维护角色、伏笔、章节摘要等结构化状态。
• 多形态创作：支持长篇小说、独立短篇、剧本、分镜、同人番外、仿写续写、互动影游、开放世界与翻译。
• 专业 Skills 与检索：内置 19 个专业 Skills，故事记忆、材料库和 Skill 参考资料共用 SQLite FTS5/BM25 检索投影。
• 多模型服务与路由：支持 Google Gemini、Moonshot、MiniMax、DeepSeek、OpenRouter、Ollama 等服务，并可按 Agent 配置不同模型。
• 可靠性机制：章节工作区先校验后原子提交，自动状态快照、文件锁、Action 队列和 Zod schema 校验降低半完成或坏数据风险。

适用场景

• 连载长篇小说创作：从创作简报到世界观、角色、卷纲和章节意图，持续写作、审稿与修订。
• 独立短篇与封面制作：通过 Studio Chat 或 CLI 生成完整短篇包，包括正文、大纲、审稿记录、简介卖点与封面提示词。
• 互动叙事与开放世界：用自然语言定义世界契约、时间推进、角色与物品规则，生成可继续游玩的互动内容。
• 多语言内容与翻译交付：支持英文小说写作设置以及长文翻译等跨语言创作任务。

快速开始

• 安装需要 Node.js 22.16 或更高版本，然后运行 npm i -g @actalk/inkos 全局安装。
• 初始化项目并启动 Studio：运行 inkos init my-novel，进入目录后运行 inkos，从启动日志中的本机地址打开 Studio。
• 在 Studio 的模型配置中选择服务商、协议，粘贴 API Key 并测试连接，选择可用模型后保存。
• 创建书籍并写作：运行 inkos book create --title "吞天魔帝" --genre xuanhuan，再运行 inkos write next 吞天魔帝。

部署与要求

• 运行环境需要 Node.js 22.16 或更高版本。
• 需要配置可用的 LLM 服务与 API Key；Studio 使用可视化服务配置，CLI、daemon 和部署环境支持 env 覆盖。
• Studio 默认本地服务只接受同源浏览器请求，自定义嵌入或反向代理需通过 allowedOrigins 配置可信来源。

采用前须知

• 许可证：AGPL-3.0。在使用、修改或分发项目前，请确认其具体条款。
• 2.0 分支为开发版本，需使用本地构建进行验证。
• kkaiapi 是本地开发与真实生产验收所依赖的外部服务。
• Studio 默认本地服务只接受同源浏览器请求。