Administrator
Administrator
发布于 2026-10-10 / 2 阅读
0
0

用于小说、剧本、翻译、互动游戏和IP内容的叙事创作AI代理

InkOS 标志
InkOS

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

npm 版本
许可证:AGPL-3.0
GitHub 星标
npm 下载
ClawHub 技能

英语| 中文 |日本语

InkOS网页版上线! 立即体验


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

Kimi Open Source Friends

v2.0.0 - 统一Pi Agent Harness与专业创作源码

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

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

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

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

InkOS 2.0把“聊天代理调整工具”和“分工平台”收敛成一套围绕pi-agent的生产工具。模型负责建议、提案和调用能力;InkOS负责确认、上下、状态、原子落盘和产品真实性。篇长、短篇、剖面、分镜、互动影游、游戏与翻译继续保留各自的专业方法,但共享一套同执行、检索、安装和基础设施。

  • 模型配置:Studio内置多服务配置、模型路由和封面服务配置;支持kkaiaapi / OpenRouter等全球主流模型聚合入口,以及自定义OpenAI Chat Completions、OpenAI Responses 和 Anthropic Messages 服务。

  • 生产线束:Studio Chat、TUI、inkos interact与生产工人共享pi-agent工具循环和重构动作/结果;除管道降为可调用直接、可中断、可安装的确定性能力外,不再维护平行的自然语言单一决策内核。

  • 19个内置专业技能:长篇写作/审稿、商业短篇、播放、论证、分镜、互动影游、翻译、拆稿、市场研究、导入、封面与去AI味都拥有独立SKILL.md;各作品类型复用技能架构,不复用不适合自己的长篇提示词。

  • 统一本地检索:故事记忆、资料库和技能参考资料共享 SQLite FTS5 / BM25 检索投影;原始文件仍是权威来源,索引可重建,检索结果保留来源与位置。

  • 书籍参考资料绑定:导入材料可以显式绑定到书籍某并声明用途,写作时按当前任务检索相关段落,而不是将所有文件全文塞进上下文。

  • 安全章节工作区:正文、状态、伏笔和运行快照先在章节工作重新校验,再原子提交;失败不会出现“状态已推进、正文未落盘”。Studio可改写工作区和真实审稿问题。

  • 跨生产工作一致性:短、分镜、互动影游、玩法与翻译接入统一运行快照、技能绑定、字数初始化、取消信号和失败恢复,同时保留各自的状态模型与创作规则。

  • 长任务与模型调用更稳定:多章编写按一个可恢复任务顺序执行;首令牌/流式空闲超时、过期状态修复和原子文件集降低被动卡住或半完成的概率。

  • TUI视觉工作室:新增/new、、、、显式入口,重构/ ,会话级切换和明暗终止/short;普通自由文本仍替代代理理解。/play/cover/write/confirm/cancel/model

  • 模型与工作台补齐:新增LM Studio本地服务,动态模型目录和外部母本导入可持久化;Studio支持自定义封面基本URL、宽屏章节预览和安全章节重写。

InkOS 互动影游剧情树实测截图
InkOS Play Studio 开放世界界面

主要创作形态

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

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

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

InkOS Play — 新增开放世界与分支互动。你可以用自然语言指定世界契约、时间推进方式、角色代理、物品/证据/规则和视觉风格;系统维护世界状态、可点击选择、自由动作、HUD和配自动图。

工作室聊天— 普通聊天、建书、短篇、封面、互动世界都走同一套动作界面。重动作先确认,生成物可修改预览,可通过聊天章节、封面提示词、世界状态和持久化文本产品。

现在支持以英语为母语的小说写作!设置--lang en为用英语写作。详情请参阅英文版README文件。

快速开始

安装

需要Node.js 22.16 或更高版本。

npm i -g @actalk/inkos

通过 OpenClaw 使用 🦞

InkOS 已发布为OpenClaw Skill,可被任何兼容的 Agent(Claude Code、OpenClaw 等)直接调用:

clawhub install inkos          # 从 ClawHub 安装 InkOS Skill

通过 npm 安装或克隆本时,skills/SKILL.md已包含组件,🦞 可直接读取——需要从 ClawHub 安装增加额外项目。

安装后,Claw应优先通过共享交互入口调用InkOS:

inkos interact --json --message "继续当前书,但把节奏再收紧一点"

这条入口直接走和项目 TUI 相同的交互执行大脑,因此 OpenClaw、TUI、Studio 消耗同一套控制。当前 JSON 输出包含助手文本回复和交互会话信息;真正的执行结果以工具结果和落盘文件相同,不从模型真实声明推断完成。

底层规划、上下文构建、写作和审讯均由同一稿稿进行调度,不再作为线索入口。也可以在ClawHub搜索inkos在线查看。

特工技能

InkOS 直接使用标准SKILL.md作为专业能力扩展,不再维护一套 InkOS 内置技能协议。技能仅向聊天代理提供专业说明和静态参考数据,不会增加执行权限;创建、写入、编辑和生成图片仍由 InkOS 工具与确认闸门控制。

可用方式:

  • 放入标准目录:项目skills/、.agents/skills/,或用户目录~/.agents/skills/、~/.openclaw/skills/。Studio也可以导入包含的SKILL.md完整文件夹和静态参考资料;项目导入统一保存到.agents/skills/。

  • 或设置INKOS_SKILL_DIRS=/abs/path/to/skills,可指向单个技能目录,也可指向包含多个技能子目录的目录。多个目录按系统分隔符分隔。

  • 在聊天里用@skill-id强制本轮使用,例如:@detective-play 做一个证据链驱动的开放世界。

  • 不写@skill-id时,聊天代理根据用户当前意愿决定调用use_skill;是否通过会话类型、关键词或字符串包含匹配机械启用。

  • 外部技能仅提供指令和静态参考资料,InkOS 不会自动执行其中的脚本;它也不会超越现有工具权限与确认门。

专业创作方法统一由Skill提供。要调整内置方法,可在Studio导入同ID的项目Skill作为覆盖;Agent文件只保留动态任务、上下文和工具协议。

最小SKILL.md示例:

---
name: Detective Play
description: Detective evidence and suspect-board play.
---
Use evidence chains; do not turn clues into generic atmosphere.

配置

当前 InkOS 将 LLM 布线占用路径:Studio 使用可视化服务配置,CLI / daemon / 配置环境支持 env 覆盖。两者都不会污染。

方式一:Studio服务配置(推荐)

适合本地编写、Web工作台和可视化管理。

inkos init my-novel
cd my-novel
inkos

请从启动日志显示的本机地址打开 Studio 默认。本地服务只接受同源浏览器请求;自定义嵌入或反向代理可通过服务启动参数allowedOrigins显式配置可信源。

打开Studio后进入「模型配置」:

  1. 选择服务商,例如Google Gemini、Moonshot、MiniMax、智谱、百炼或自定义端点。

  2. 选择协议类型:OpenAI Chat Completions、OpenAI Responses 或 Anthropic Messages;自定义端点应按上游实际协议选择。

  3. 粘贴API Key,点击「测试连接」。

  4. 选择可用模型,保存配置。

  5. 返回书籍页面开始编写。

Studio运行时仅使用:

provider bank 默认值
→ inkos.json 里的 services / 当前 service / defaultModel
→ .inkos/secrets.json 里的 service API Key

即使检测到~/.inkos/.env或项目.env,Studio 也只是显示提示,不会用 env 覆盖 service、model、baseUrl 或 API Key。API Key 存在项目内的.inkos/secrets.json,不会写入inkos.json。

方式二:CLI / daemon / 部署环境的env配置

适合终端批处理、服务器部署、CI、Docker、监控进程和分段切模型。

全局环境:

inkos config set-global \
  --provider <openai|anthropic|custom> \
  --base-url <API 地址> \
  --api-key <你的 API Key> \
  --model <模型名>

也可以手动写~/.inkos/.env或项目.env:

INKOS_LLM_PROVIDER=custom
INKOS_LLM_BASE_URL=https://api.moonshot.cn/v1
INKOS_LLM_API_KEY=sk-...
INKOS_LLM_MODEL=kimi-k2.5

# 可选
INKOS_LLM_SERVICE=moonshot                         # 推荐写;不写时会尽量从 baseUrl 自动识别
INKOS_LLM_TEMPERATURE=0.7
INKOS_LLM_THINKING_BUDGET=0
INKOS_DEFAULT_LANGUAGE=zh
INKOS_LLM_EXTRA_top_p=0.9

CLI 合成顺序:

Studio/project service 配置
→ .inkos/secrets.json service key
→ global ~/.inkos/.env
→ project .env
→ 当前进程环境变量
→ CLI 参数

也就是说,CLI 默认可以复用 Studio 配置好的服务和按键;如果 env 里声明了INKOS_LLM_SERVICE、、INKOS_LLM_MODEL或INKOS_LLM_BASE_URL,INKOS_LLM_API_KEY则作为覆盖层生效。旧 env 只写baseUrl + model + apiKey也能继续用,InkOS 会尽量从 baseUrl 反推服务。

一次性指定服务或模型:

inkos write next --service google --model gemini-2.5-flash
inkos write next --service moonshot --model kimi-k2.5 --no-stream
inkos agent "继续写下一章" --api-key-env MOONSHOT_API_KEY
inkos doctor --service minimaxCodingPlan --model MiniMax-M2.7

--service会从提供商银行自动推导baseUrl、协议和兼容策略;--model必须属于最终服务,否则会直接报错,避免把Kimi模型发到Gemini此类错配问题。

方式三:多模型路由(可选)

给不同的代理分配不同的模型,平衡质量与成本:

# 给不同 agent 配不同模型/提供商
inkos config set-model writer <model> --provider <provider> --base-url <url> --api-key-env <ENV_VAR>
inkos config set-model auditor <model> --provider <provider>
inkos config show-models        # 查看当前路由

未单独配置的Agent自动使用全局模型。

配置排查

inkos doctor

doctor会显示当前有效的配置模式、service/model/API Key 来源,并尝试 API 调用性。常见模式:

模式

意义

studio-project

Studio运行时:仅使用Studio/project配置和secrets

cli-project

CLI运行时:以Studio配置为基础,再加载env和CLI参数

environment

CLI / daemon 直接使用当前环境配置

如果服务测试失败,优先检查服务商、模型和协议是否匹配。Google Gemini 的 AI Studio API Key 可用于 Gemini OpenAI 兼容端点;InkOS 会自动禁用 Google 不支持的 OpenAIstore参数。MiniMax 默认走官方 OpenAI 兼容/v1/chat/completions,并优先使用可工作的非流式传输,避免流返回使用但无正文的问题;MiniMax-M3*会默认关闭思维返回,M2.x 思维由上游限制无法关闭。

LLM配置更新

  • Studio / CLI 配置隔离:Studio 固定使用服务页配置和.inkos/secrets.json;CLI、daemon、配置环境支持 env 覆盖和批量命令参数。

  • 提供商银行能力表:内置Google Gemini、Moonshot、MiniMax、智谱、百炼、DeepSeek、硅基流动、火山、腾讯混元、文心、讯飞星火、OpenRouter、kkaiapi、Ollama、CodingPlan等服务的baseUrl、协议、模型和兼容策略。

  • 模型归属校验:--service google --model kimi-k2.5这类错配会直接报错,把避免请求发送到错误服务商。

  • Google Gemini 兼容修复:AI Studio API Key 可直接用于 Gemini OpenAI 兼容端点,InkOS 会自动禁用 Google 不支持的 OpenAIstore参数。

  • MiniMax传输探测:MiniMax / MiniMax CodingPlan使用官方OpenAI兼容/v1入口,并自动使用可工作的非流式传输,规避流式使用正常但正文为空的问题。

  • 环境配置:CLI可使用INKOS_LLM_BASE_URL + INKOS_LLM_MODEL + INKOS_LLM_API_KEY;没有INKOS_LLM_SERVICE时从当前baseUrl识别服务。

当前交互入口

Studio Chat + CLI + TUI 消耗同一套执行面

  • 工作室聊天:讨论、建书、短篇、封面、播放、编辑持久化文件都从同一个对话入口发起;重动作会先展示确认卡。

  • 开始创作入口:长篇小说、短篇小说、同人创作、番外创作、仿写创作、续写创作、分支互动、开放世界都可以从工作室顶部入口进入。

  • TUI 仪表盘:inkos tui进入终端全屏交互;支持/new、/short、/play、/cover、/write、/confirm、/cancel和会话级/model <模型名>。

  • 外部代理入口:inkos interact --json --message "..."仍然是OpenClaw /其他代理的构造入口。

  • 明确:命令write next、、、导入和导出仍可直接调用;内部规划与上下文阶段由Harness统一编排。revisereview

写第一本书

inkos book create --title "吞天魔帝" --genre xuanhuan  # 创建新书
inkos write next 吞天魔帝      # 写下一章并记录审稿 observation
inkos status                   # 查看状态
inkos review 吞天魔帝          # 查看已记录的审稿 observation
inkos export 吞天魔帝          # 导出全书
inkos export 吞天魔帝 --format epub  # 导出 EPUB(手机/Kindle 阅读)

写完整篇短

想直接生成一篇完整短篇,可以在工作室对话里说:

写一篇 12 章短篇,方向是:都市婚姻反转,女主拿到账本证据后反杀。

也可以走CLI:

inkos short run \
  --direction "都市短篇 婚姻反转 女主证据反杀" \
  --chapters 12 \
  --chars 1000

生成物将会生成shorts/<故事名>/final/,包含full.md、、、配置封面sales-package.md服务cover-prompt.md后还会生成cover.png。

单独制作封面

如果给以前的标题或简介做封面,不需要重跑短篇正文,在Studio对话里直接说:

给《她签下离婚协议那天,他悔疯了》生成一张短篇封面,偏现代都市、强反转。

工具会独立生成covers/<标题>/cover-prompt.md和covers/<标题>/cover.png。如果封面还没有配置封面服务,请先在Studio的模型配置里设置封面服务和API Key。

生成后也可以继续通过聊天修改封面提示词,例如“把人物拉近一点、标题字更大、表情更冷笑”。系统会用新的coverPrompt重写cover-prompt.md并重新生成封面,不需要重新写短篇。

启动开放世界 / 分支互动

在Studio Chat里选择「开放世界」或「分支互动」,直接用自然语言描述你想玩的世界:

做一个魔兽风格的边境哨塔开放世界。时间不是固定回合,巡逻是一小时,练功可以跨几天。装备有稀有度,但不要数值面板,用材质和光泽体现。

系统会生成世界、角色、物品、证据、关系、当前场景和任选动作。开放世界支持自由输入动作;分支交互会给出可点击选项。配置封面/图片服务后,角色、物品、证据、场景都可以生成图,并在对话流里滚动显示。


核心特性

工作室聊天 + 操作界面

Studio Chat不再只是问答框。它可以创建长篇、短篇、生成封面、启动播放、编辑持久化文本文件,并运行在需要执行重操作前给出确认才行。一般讨论会直接回答;明确创作操作进入工具执行。

InkOS Play:开放世界与分支互动

玩维护一个可持续推进的世界状态:角色、地点、物品、证据、关系、时间、场景和H​​UD。它不是固定的RPG语言模板,你自然可以用定义世界契约:修仙装备可以有稀有感,恋爱本可以有心动体系,侦探可以有证据生命周期。系统把这些规则写进世界状态,再用于后续叙述和配图。

定性审稿+去AI味

连续性审查会从角色记忆、物资连续性、伏笔恢复、大纲结束、叙述节奏和情感关系线等详细记录具体观察。内置AI痕迹检测会标出高频词、句式单调和过度总结等可修订位置。观察是可回顾的创作反馈,不会把章节修改写成“通过/失败”状态;用户或代理可据此显式发起修订。

去AI味由可替换的inkos-story-deslop技能提供语义稿方法;需要时显式调用revise --mode anti-detect,不会由隐藏词表自动修改。

文风仿写

inkos style analyze按激活的分析与仿写技能,将参考文本编译为有证据的可执行文风指南;inkos style import将指南绑定到指定作品,供后续写作和修订复习使用。

创作简报

inkos book create --brief my-ideas.md确定你的大脑洞、世界观设定或人设文档。架构师基于简报生成outline/story_frame.md、outline/volume_map.md角色卡和book_rules.md/json,并把长期方向保存到story/author_intent.md。

输入治理控制面

每本书现在都有两份长期可编辑的 Markdown 控制文档:

  • story/author_intent.md:这本书长期想成为什么

  • story/current_focus.md:最近1-3章设定焦点拉回哪里

用户可直接在Studio Chat、TUI或inkos agent中调整方向。规划师先通过语义选择得到工作集,再生成story/runtime/chapter-XXXX.intent.md;作曲家持久化context.json与trace.json,真正记录进入模型的来源、保护系统、检索结果和压缩情况。

字数治理

write next与revise共享同一套字数遥测:

  • --words指定目标的字数,系统会自动推导一个允许区间,不保证逐字精确命中

  • 中文默认按zh_chars统计,中文默认按en_words统计

  • 系统不会截断正文,也不会因长度偏差把章节标成失败

  • 超出硬范围时仍保留正文,并在章节索引与 ActionResult 中记录格式化遥测和观察

续写作品

inkos import chapters从已有小说文本导入章节,自动重建状态、章节摘要、伏笔、角色关系和必备Markdown投影,支持第X章和自定义分割模式、断点续导。导入后inkos write next可继续创作。

同人创作

inkos fanfic init --from source.txt --mode canon从原作创意创作同人书。支持四种模式:canon(正典祖先)、au(架空世界)、ooc(角色阶层)、cp(CP向)。内置正典导入器、同人独特审计维度和信息边界管控——确保设定不矛盾。

多模型路由

不同的代理可以走不同的模型和提供商。手写用Claude(创意强),审计用GPT-4o(便宜快速),雷达用本地模型(零成本)。inkos config set-model按代理粒度配置,未配置的自动回退全局模型。

守护进程 + 通知进程

inkos up启动后台循环自动写章。底层会自动推进可处理的非关键问题;需要人工判断的问题会暂停并留下可审结果。通知主动支持Telegram、飞书、企业微信、Webhook(HMAC-SHA256签名+事件过滤)。日志写入inkos.log(JSON Lines),-q静默模式。

局部模型兼容

支持 OpenAI 聊天完成、OpenAI 响应、人类消息和自定义兼容端点。服务测试会验证协议与流式能力;输出格式输出、流中断或输出上限都会明确报错或触发完整续写,不会在成功结果时残缺文本。

保障

每章自动创建状态快照,正文、索引和构造状态以原子文件集提交。文件锁与动作队列防止向量写入;中断会留下事件事件和可恢复状态。审稿只记录有证据的观察结果,由用户或代理显式发起修订。

伏笔系统使用 Zod schema 校验——lastAdvancedChapter必须是整数,status只能是 open/progressing/deferred/resolved。LLM 在写入前输出的 JSON delta 之后applyRuntimeStateDelta做 immutable 更新 +validateRuntimeState结构校验。坏数据直接拒绝,不会滚雪球。

模型输出上限由提供商银行的模型卡管理;llm.extra/INKOS_LLM_EXTRA_*中的保留键(max_tokens、温度、模型、消息、流等)会被自动过滤,防止意外覆盖核心请求参数。


工作原理

InkOS以pi-agentharness作为统一认知与工具调用内核:Agent理解用户意图并生成格式化动作,进行执行确定性工具、确认权限、管理状态并以真实文件和工具结果判定完成。长、短篇、分数、分镜、交互影游、播放和翻译复用丰田,架构但保留各自的专业技能、状态模型与生产步骤。

InkOS整体系统架构

长篇每一章按“语义工作集 → 规划 → 写作 → 状态投影 → 观察 → 原子提交”运行;修订为独立行动:

InkOS 章节生产图表

代理人

职责

雷达 雷达

扫描平台趋势和读者偏好,指导故事方向(可插拔,可跳过)

规划师 规划师

读取作者意图+当前焦点+记忆搜索结果,估算等于意图(必须保留/必须避免)

编排师 作曲家

从文档状态、控制文档和材料中按任务选择上下文、记录保护体系、检索和语义压缩追踪

建筑师 建筑师

建书、导入或番外初始化时生成基础设定:故事框架、规则、角色与长期控制文件

写手作家

基于编排后的下游生成主体(字数治理+对话引导)

状态结算 结算人

通过类型化工具提交正文有证据的增量状态增量,由整数校验并应用

审稿代理

对照用户意图、正典、状态、章节计划和审稿技巧,返回有证据的定性观察

修订者 修订者

接受用户、代理或审查观察给出明确的修改目标,生成并原子落盘新版本

章节正文和故事状态作为同一组产物原子落盘;审稿作为观察保存在章节中,不完成改变正文意见。修改为独立的显式动作,完成后生成新的观察与可追溯版本。

长期记忆

每本书的权威记忆与检索投影分开:

层

用途

story/state/*.json

权威解读状态:当前状态、伏笔、章节摘要等,经过Zod schema校验

story/*.md

人类视觉投影:current_state.md、pending_hooks.md、chapter_summaries.md、character_matrix.md等

story/memory.db

可重建的 SQLite FTS5/BM25 搜索投影;不作为故事事实权威

连续性审计员查阅了这些状态检查每一章草稿。如果角色“记起”发生了从未亲眼见过的事,或者揭露了两章前已经丢失的武器,审计员就会被困到。

Settler 通过类型化工具输出完整增量 delta,代码层做不可变应用和重构。Markdown 只是人类的预测投影;搜索时从规范的 JSON 重建索引,再由 LLM 对 BM25 候选做语义选择。

InkOS 长期记忆与状态

控制面与运行时产物

除了运行时状态外,InkOS 还把“护栏”和“自定义”拆成了可审阅的控制层:

  • story/author_intent.md:长期作者意图

  • story/current_focus.md:当前阶段的关注点

  • story/runtime/chapter-XXXX.intent.md:补充目标、保留项目、避免项目、冲突处理

  • story/runtime/chapter-XXXX.context.json:首先实际选入的上下文

  • story/runtime/chapter-XXXX.trace.json: 计算输入计算

这样brief、卷纲、书级规则、当前任务不再混成一坨提示,而是先编译,再编写。

创作规则体系

专业创作方法由Work Profile绑定的Skill提供,禁止项目中同ID的覆盖。代理SKILL.md代码只保留任务、输入权威和类型化工具协议;每本作品都保持独立的book_rules.md/json、、、和。outline/story_frame.mdoutline/volume_map.mdauthor_intent.mdcurrent_focus.md

使用模式

InkOS 提供 Studio Chat、TUI、CLI Agent 和明确命令,基本上共享相同的 Harness:

1.完整表格(一键式)

inkos write next 吞天魔帝          # 规划 → 编排 → 写作 → 审查记录 → 原子落盘
inkos write next 吞天魔帝 --count 5 # 连续写 5 章

write next使用唯一的plan -> compose -> write -> review -> commit分支。检索产生观察;技术验证决定能否实现原子落盘,输入反馈不会被转换成章节失败状态。

2. 显式能力命令

inkos write next 吞天魔帝 --count 3
inkos revise 吞天魔帝 31 --json
inkos review 吞天魔帝 --json
inkos export 吞天魔帝 --format epub

这些命令表达已经确定的用户动作;自然语言意图仍进入 pi-agent Harness,由当前 Work Profile 的能力面决策。

3. 自然语言Agent模式

inkos agent "帮我写一本都市修仙,主角是个程序员"
inkos agent "写下一章,重点写师徒矛盾"
inkos agent "先扫描市场趋势,然后根据结果创建一本新书"

Agent 允许完成模式只公开当前 Work Profile 的能力。模型可按显示加载 Skill、读取 Work、提出新作品确认、编写、审稿或修订;状态只来自 ActionResult 和真实工件修订。

4.工作室播放模式

工作室里的「开放世界」和「分支互动」是吸引创作入口。它们不要求你先建书,也不要求写死 RPG 数值。你可以“世界怎样运行、时间怎样描述推进、角色是否自主行动、物品和证据是否影响故事”,系统会生成可继续玩的世界,并将每个迷宫状态写回本地。

Studio实测截图与生成结果

InkOS Studio 开始创作入口

InkOS 短手机封面

短篇封面

InkOS Play恋爱互动

恋爱互动

InkOS Play 静态互动

静态互动

InkOS Play 物品配图

物品配图

第一张是当前 Studio 的本地实测截图。后面四张来自 InkOS Short 和 InkOS Play 的真实本地生成结果:短篇封面用于手机端点击,播放图用于开放世界、侦探证据、互动展示场景和视觉能力。

命令参考

命令

说明

inkos init [name]

初始化项目(省略名称在当前目录初始化)

inkos book create

创作新书(--genre、--platform、--chapter-words、--target-chapters、--brief <file>确定创作简报)

inkos book update [id]

修改书籍设置(--chapter-words、--target-chapters、--status)

inkos book list

列出所有书籍

inkos book delete <id>

删除书籍及全部数据(--force跳过确认)

inkos genre list/show/copy/create

查看、复制、创建题材

inkos write next [id]

完整的床垫写下一章(--words覆盖字数,--count连写,-q静默模式)

inkos write rewrite [id] <n>

重写第N章(恢复状态快照,--force跳过确认,--words覆盖字数)

inkos revise [id] [n]

修订指定章节

inkos agent <instruction>

自然语言Agent模式

inkos review [id]

查看已持久化的审稿观察

inkos status [id]

项目状态

inkos export [id]

导出书籍(--format txt/md/epub、--output <path>)

inkos radar scan

扫描平台趋势

inkos fanfic init

由原作创意创作同人书(--from、--mode canon/au/ooc/cp)

inkos short run

生成独立篇短包(正文、简介卖点、封面提示词、任选封面图)

inkos forecast create/show/select

生成、核验并选择长篇的非正史剧情分支;选择只保存候选计划,不修改正史

inkos interact

外部代理 / CLI 自然语言入口(--json、--message、--book)

inkos config set-global

设置 CLI / daemon / 部署环境的全局 LLM env(~/.inkos/.env)

inkos config show-global

查看全局配置

inkos config set/show

查看/更新项目配置

inkos config set-model <agent> <model>

为指定agent设置模型覆盖(--base-url、--provider、--api-key-env支持多Provider路由)

inkos config remove-model <agent>

移除代理模型覆盖(回退到默认)

inkos config show-models

查看当前模型路由

inkos doctor

诊断配置问题(显示有效配置模式、来源、API配置性和设施兼容性提示)

inkos detect [id] [n]

AIGC 检测(--all全部章节,--stats统计)

inkos style analyze <file>

分析参考文本提取文风指纹

inkos style import <file> [id]

导入文风指纹到指定书

inkos import canon [id] --from <parent>

导入正传正典到番外书

inkos import chapters [id] --from <path>

导入已有章节续写(--split、--resume-from)

inkos analytics [id]/inkos stats [id]

书籍数据分析(观察、章节长度、token用量)

inkos update

更新到最新版本

inkos studio/inkos

启动Web工作台(-p指定端口,默认4567;Studio使用服务页配置,不使用env覆盖)

inkos tui

启动终端全屏 TUI

inkos up / down

启动/停止守护进程(-q静默模式,自动写入inkos.log)

[id]项目中的参数只有一本书时可简洁。write next支持--context创建创作指南,--words覆盖每章目标字数;book create支持--brief <file>创建创作简报。内部Planner/Composer产生的意图、上下文和踪迹可在Studio中查看。

CLI 运行时还支持一次性 LLM 覆盖参数:--service、--model、--api-key-env、--base-url、--api-format <chat|responses|anthropic>、--stream、--no-stream。anthropic对应 Anthropic Messages 协议。例如:

inkos write next --service google --model gemini-2.5-flash
inkos up --service moonshot --model kimi-k2.5 --api-key-env MOONSHOT_API_KEY

路线图

  • packages/studioWeb UI 工作台(Vite + React + Hono)— 已发布,inkos或inkos studio启动

  • 交互小说/开放世界(分支叙述+自由动作+自动配图)— Studio Play 已落地

  • 局部干预(重写半章 + 级联更新后续真实文件)

  • 自定义代理插件系统

  • 平台格式返回(起点、番茄等)

参与贡献

欢迎贡献代码。提问题或 PR。

pnpm install
pnpm dev          # 监听模式
pnpm test         # 运行测试
pnpm typecheck    # 类型检查

星际历史

星空历史图表

技能下载历史记录

技能下载历史记录

Repobeats

Repobeats 分析图像

贡献者

贡献者

致谢

InkOS 的代理运行时构建在pi(@mariozechner/pi-ai与@mariozechner/pi-agent-core作者 Mario Zechner)之上。感谢 pi 提供的预览补充。

本开源项目已链接并认可LINUX DO社区,感谢社区成员的反馈、测试和讨论。

许可证

AGPL-3.0

项目地址:https://github.com/Narcooo/inkos

10.2k颗星

观察者

43人观看

叉子

1.9k 个分支


评论