Narcooo /inkos

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

★ 11,218⑂ 2,027👁 40⑃ 130● 278▤ 39
TypeScriptAGPL-3.0Created 2026-03-12
Download: v1.8.0v1.8.0 ↓1.8.02026-08-17
+21
Daily
11,218
stars
2,027
forks
40
watchers
130
prs
278
issues
39
releases

README

Story Creation AI Agent面向长短篇小说、剧本剧作、互动影游、IP 内容与多语言翻译的创作智能体系统


  
  
  
  
  



  English | 中文 | 日本語



  InkOS 网页版上线!
  立刻体验


---

InkOS 是一个面向故事创作与多语言翻译的 AI Agent 系统:长篇连载、独立短篇、剧本剧作、同人番外、仿写续写、互动影游、开放世界和长文翻译,都可以从同一个工作台开始。支持 Studio、TUI、CLI 交互形式,把创意、设定、角色、记忆、审稿、修订、封面、互动状态和跨语言交付交给智能体统一管理。


  
    
    
  
  
  🎉🎉 InkOS 入选首批 KIMI 开源合作伙伴 🎉🎉



  


感谢 Kimi 赞助本项目!Kimi K3 是 Moonshot AI 迄今能力最强的模型,也是全球首个开源 3T 级模型,拥有原生视觉能力与 100 万 Token 上下文。搭配 InkOS,K3 可以参与长短篇小说、剧本、互动影游与多语言内容的规划、写作、审稿和修订;InkOS 则持续管理角色、设定、伏笔与故事状态,让长篇创作更连贯、更可控。


  


kkaiapi|一个 Key 调模型,一个 MCP 接数据与工具。
支持 Claude、GPT、Gemini、DeepSeek 等主流模型,按量付费、共用余额,用于 InkOS 写作、审稿与封面生成。
查看模型与价格 → · InkOS 接入指南 → · MCP 接入 →

 💡 写小说,先给 Agent 接一层专业数据 —— 写小说不只缺模型,更缺素材。推荐搭配 火花数据API(huohuaapi):按调用计费的小说 / 网文创作数据,让 Agent 动笔前先查小说正文、章节结构、人物设定、文风和创作方法等带来源素材,而不是只靠 Prompt 硬凑一份“剧情提纲”。

 v2.0.0 - 统一 Pi Agent Harness 与专业创作内核

本分支为 2.0 开发版本,使用本地构建进行验证。旧项目先运行 inkos work migrate --json 查看升级清单,再运行 inkos work migrate --apply 导入统一创作库;原目录与早期版本清单备份会保留,冲突不会覆盖已有作品。

迁移会转换 1.x 的书籍默认配置、规则和状态快照,保留正文、原始目录及未填写的历史信息。旧写作控制字段保留在原件中,2.0 使用 Profile 的操作策略。缺少运行时状态的项目以草稿进入创作库,需完成状态重建后再继续生产。

本地开发与真实生产验收统一使用 kkaiapi(https://api.kkaiapi.com/v1):文字按 DeepSeek V4 Flash / Pro 分工,封面使用 gpt-image-2。在项目 llm.cover 中配置服务和模型,CLI 与 Studio 读取同一配置,封面可复用 kkaiapi 服务密钥。

已有短篇可以在作品对话中要求按审稿意见整篇修订,或运行 inkos short revise  --instruction "修复审稿指出的时间线与证据链问题"。系统会更新相关章节、大纲和销售包,再次审稿,并保留原稿版本。

InkOS 2.0 把“Chat Agent 调工具”和“各类作品管线”收敛成一套围绕 pi-agent 的生产 harness。模型负责理解、提议和调用能力;InkOS 负责确认、上下文、状态、原子落盘和产物真实性。长篇、短篇、剧本、分镜、互动影游、Play 与翻译继续保留各自的专业方法,但共享同一套执行、检索、观测和恢复基础设施。

- 模型配置:Studio 内置多服务配置、模型路由和封面服务配置;支持 kkaiapi / OpenRouter 等全球主流模型聚合入口,以及自定义 OpenAI Chat Completions、OpenAI Responses 和 Anthropic Messages 服务。
- 单一生产 Harness:Studio Chat、TUI、inkos interact 与生产 worker 共用 pi-agent 工具循环和结构化 action/result;既有 pipeline 降为可直接调用、可中断、可观测的确定性能力,不再维护平行的自然语言决策内核。
- 19 个内置专业 Skills:长篇写作 / 审稿、商业短篇、Play、剧本、分镜、互动影游、翻译、拆稿、市场研究、导入、封面与去 AI 味都拥有独立 SKILL.md;各作品类型复用 Skill 架构,不复用不适合自己的长篇提示词。
- 统一本地检索:故事记忆、材料库和 Skill 参考资料共用 SQLite FTS5 / BM25 检索投影;原始文件仍是权威来源,索引可重建,检索结果保留来源与位置。
- 书籍参考资料绑定:导入材料可以显式绑定到某本书并声明用途,写作时按当前任务检索相关段落,而不是把所有文件全文塞进上下文。
- 安全章节工作区:正文、状态、伏笔和运行快照先在章节工作区内校验,再原子提交;失败不会出现“状态已推进、正文未落盘”。Studio 可查看改写工作区和真实审稿问题。
- 跨作品生产一致性:Short、剧本、分镜、互动影游、Play 与翻译接入统一 run snapshot、Skill 绑定、字数观测、取消信号和失败恢复,同时保留各自的状态模型与创作规则。
- 长任务与模型调用更稳:多章写作按一个可恢复任务顺序执行;首 Token / 流式空闲超时、过期状态修复和原子文件集降低被动卡住或半完成的概率。
- TUI 对齐 Studio:新增 /new、/short、/play、/cover、/write 明确入口,结构化 /confirm / /cancel,会话级 /model 切换和明暗终端自适应配色;普通自由文本仍交给 Agent 理解。
- 模型与工作台补齐:新增 LM Studio 本地服务,动态模型目录和外部母本导入可持久化;Studio 支持自定义封面 Base URL、宽屏章节预览和安全章节重写。


  
  


 主要创作形态

长篇小说 — 从创作简报建书,生成世界观、角色、卷纲和章节意图;写作、审稿、修订、状态结算都是可独立调用、可追溯的 Harness action。上下文按 protected / compressible 分层组织,避免长书越写越乱。

剧情多线推演 — 在写下一章前,基于当前正史生成 2-5 条彼此隔离的未来分支,并在 Studio Chat 中横向比较章节节拍、人物决定、预计变化、风险和作者意图匹配度。采用分支只会保存 selected-branch-plan.md 候选计划,不会修改正文、大纲或正史状态;正史变化后旧推演会标记为过期。

InkOS Short — Studio Chat 和 CLI 可以直接产出独立短篇:完整正文、大纲记录、审稿记录、简介卖点、封面提示词,并在配置封面服务后生成封面图。

InkOS Play — 新增开放世界与分支互动。你可以用自然语言指定世界契约、时间推进方式、角色 

Top issues

Latest release

v1.8.0 v1.8.0 2026-08-17
- fix(core): normalize persisted paths across platforms (52075bb9)
- fix(build): keep overrides compatible with pnpm 9 (de4e9fa5)
- chore(release): prepare v1.8.0 documentation (b673c500)
- fix(ci): align test matrix with node requirements (8922e3ab)
- feat(tui): unify agent surfaces and confirmations (7c98a1eb)
- refactor(core): unify production harness and context flow (e7c04465)
- refactor: center creation workflows on pi harness (d1d6d8ec)
- refactor(core): run production workers through pi harness (35bb2efd)
- feat(skills): bind production modes to dedicated expertise (6651fa7e)
- refacto

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON