Narcooo/inkos

Story Creation AI Agent for novel, scripts, translation, interactive games, and IP content

InkOS – AI 驱动的故事创作代理

它是什么 – InkOS 是一个基于 Node 的 AI 代理系统，用于创作小说及相关内容。它让你可以在一个工作区中创建长篇小说、短篇故事、剧本、互动“游戏”世界和多语言翻译。核心思想是 pi-agent 框架：语言模型（例如 Moonshot Kimi、Claude、Gemini、DeepSeek 等）提出操作，InkOS 确定性地执行这些操作，管理上下文、状态和文件持久化。

关键能力

统一工作台 – Studio（网页界面）、TUI（终端界面）和 CLI 共享相同的操作引擎。
多类型流水线 – 内置“技能”，用于小说写作、短篇故事生成、剧本/场景起草、互动电影/游戏世界和翻译。
状态感知写作 – 整个故事的记忆（SQLite FTS5/BM25）、章节级快照和结构化 JSON 状态文件保持情节线索、角色弧线和伏笔的一致性。
模型无关 – 通过 kkaiapi 聚合层支持 Moonshot Kimi、Claude、Gemini、DeepSeek、OpenRouter、Ollama 等；你可以将不同的代理（作家、审阅者、雷达）路由到不同的模型。
专业工作流程 – 规划 → 撰写 → 写作 → 审阅 → 原子提交，带有明确的确认对话框和观察日志，便于审计。
封面图像生成 – 可选图像服务（gpt-image-2 或其他）根据提示创建书籍封面。
OpenClaw 技能 – 可以从任何兼容代理调用（inkos interact --json --message "…"）。
导出 – 生成 Markdown、EPUB 和其他格式；短篇故事包包括大纲、销售包和封面资源。

安装

# 需要 Node 22.16+
npm i -g @actalk/inkos

你也可以使用 clawhub install inkos 安装 OpenClaw 技能。

典型工作流程

创建书籍 – inkos book create --title "My Epic" --genre fantasy。
写一章 – inkos write next My\ Epic（或使用 Studio 聊天界面）。
审阅与修订 – inkos review My\ Epic 显示观察结果；inkos revise My\ Epic 12 --instruction "fix timeline" 应用有针对性的编辑。
生成封面 – 在 Studio 中配置封面服务，然后 inkos cover generate "My Epic"。
导出 – inkos export My\ Epic --format epub。

配置

Studio 界面 – 在视觉设置中设置提供商、模型和 API 密钥；密钥存储在 .inkos/secrets.json 中。
CLI / 环境变量 – 全局或项目级环境变量（INKOS_LLM_PROVIDER、INKOS_LLM_BASE_URL、INKOS_LLM_API_KEY、INKOS_LLM_MODEL 等）覆盖 Studio 设置。
多模型路由 – inkos config set-model writer <model> --provider <provider> 让不同的代理使用不同的模型。

可扩展性

添加自定义技能文件（skills/SKILL.md）以定义新的专业方法（例如，侦探游戏技能）。技能是静态描述符；代理决定何时调用它们。
通过 SQLite 记忆数据库插入额外的检索源。
为长时间运行的任务连接通知渠道（Telegram、飞书、Webhook）。

为什么重要 InkOS 解决了 AI 辅助小说创作中最大的痛点：在多个章节中保持叙事连贯性。通过将规划（结构化状态）与生成（LLM 输出）分离，并原子化地持久化所有内容，它减少了困扰朴素提示方法的“情节丢失”和“角色不一致”错误。

底线 – InkOS 是一个全栈、开源的 AI 创作平台，结合了网页工作室、终端界面和命令行工具，以及强大的代理驱动流水线，使大规模故事创作、互动世界构建和多语言翻译更加可控和可复现。