Narcooo/inkos · 上手攻略

  • 仓库：Narcooo/inkos
  • 链接：https://github.com/Narcooo/inkos
  • 分类：ai
  • 作者：Jay
  • 更新：2026-07-12

是什么

InkOS 是一个面向故事创作与多语言翻译的 AI Agent 系统（当前版本 1.7.0），应用于小说、剧本、互动影游、开放世界和 IP 内容创作。它由多个专业 Agent 协同完成创作，支持 Studio（网页可视化）、TUI（全屏终端）和 CLI 三种交互形态。

核心定位：让 AI Agent 真正理解创作意图，通过规划 → 写作 → 审稿 → 修订的完整管线，产出有连续性、可控性、风格统一的商业级内容。

特色功能： - 完整翻译工作台（EPUB / PDF / TXT / Markdown 全支持） - 长篇连载的生产线模式（写手 + 审计员 + 修订者多 Agent 协作） - InkOS Play 开放世界与分支互动（支持变量/旗标、结局、HUD） - Skill 系统（可插拔专业能力包） - 去 AI 味规则（内置词汇疲劳词表、禁用句式、文风指纹注入） - 跨语言创作（支持英文创作链路）

解决什么问题

AI 小说创作领域两个核心痛点：上下文失控（长篇写到后面忘了前面的设定、人物关系、伏笔）和 AI 味太重（输出千篇一律的高频词和模板句式）。

InkOS 通过三层记忆体系（结构化 JSON 状态 + Markdown 可读投影 + SQLite 时序记忆库）和多 Agent 流水线（规划师 → 编排师 → 写手 → 审计员 → 修订者）从根本上解决这两个问题：

  • 连续性审计员对照结构化状态检查每一章草稿，捕捉"角色使用了从未获得过的道具"这类逻辑漏洞
  • 去 AI 味规则内置于写手 Agent 的 prompt 层，从源头减少 LLM 痕迹
  • 支持导入已有小说文本，自动逆向重建结构化状态，接续创作

快速安装

通过 npm 全局安装（推荐）

npm i -g @actalk/inkos

安装后可直接运行 inkos 命令。

克隆仓库（含内置 Skill）

git clone https://github.com/Narcooo/inkos.git
cd inkos
npm install

skill 文件（skills/SKILL.md）已包含在内，无需额外配置。

OpenClaw Skill 安装（可选）

InkOS 也已发布为 OpenClaw Skill，可通过 ClawHub 安装：

clawhub install inkos

安装后在 OpenClaw 中调用：

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

核心用法

Studio 可视化界面（推荐新手）

inkos init my-novel      # 在当前目录初始化项目
cd my-novel
inkos                     # 启动 Studio（自动打开浏览器）

Studio 启动后，在「模型配置」页面选择服务商（如 Google Gemini、Moonshot、MiniMax、智谱等），粘贴 API Key，开始创作。

CLI 创建长篇小说

# 创建新书
inkos book create --title "吞天魔帝" --genre xuanhuan

# 写下一章（自动执行 写作 → 审计 → 修订 流水线）
inkos write next 吞天魔帝

# 查看状态
inkos status

# 审阅草稿
inkos review list 吞天魔帝

# 批量通过审稿
inkos review approve-all 吞天魔帝

# 导出全书
inkos export 吞天魔帝

# 导出 EPUB 格式（Kindle 阅读）
inkos export 吞天魔帝 --format epub

CLI 写短篇

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

生成物落在 shorts/<故事名>/final/，包含 full.md（正文）、sales-package.md（销售包）、cover-prompt.md（封面提示词）。

InkOS Play 开放世界

在 Studio Chat 里选择「开放世界」或「分支互动」，直接用自然语言创建：

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

系统自动生成世界、角色、物品、证据、关系、当前场景和可选动作。配置图片服务后，角色和场景还可自动生成配图。

模型配置（CLI 环境变量）

# 设置全局配置
inkos config set-global \
  --provider custom \
  --base-url https://api.moonshot.cn/v1 \
  --api-key sk-... \
  --model kimi-k2.5

# 一次性指定
inkos write next --service google --model gemini-2.5-flash

# 查看当前配置
inkos doctor

doctor 命令显示当前 effective config、service/API Key 来源，并测试连接。

多 Agent 模型分配

不同 Agent 可以跑不同模型，平衡质量与成本：

# 写手用 Claude，审计用 GPT-4o，雷达用本地模型
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

Skill 系统使用

Skill 是 InkOS Chat/Play/长篇写作内部可用的专业能力包。在项目目录放置 .inkos/skills/<skill-id>/SKILL.md，Studio Chat 运行时自动加载：

---
id: detective-play
name: Detective Play
description: Detective evidence and suspect-board play.
whenToUse: Use for open-world detective play and evidence ledgers.
triggers: [侦探, evidence]
sessionKinds: [play]
contextNeeds:
  - id: evidence-ledger
    purpose: Preserve suspect, clue, and evidence chain state.
    sources: [world/evidence.md]
    tier: protected
    appliesTo: [play_step]
    retrieval: semantic
---
Use evidence chains; do not turn clues into generic atmosphere.

在 Chat 中强制使用某个 skill：@detective-play 做一个证据链驱动的开放世界

翻译工作台

# 初始化翻译项目
inkos translate init my-novel-en

# 运行翻译
inkos translate run my-novel-en

# 导出翻译结果
inkos translate export my-novel-en

支持 EPUB、文本型 PDF、TXT、Markdown 导入，按章节和语义段翻译，维护术语表，生成审校报告。

后台自动写章

inkos up  # 启动后台循环

支持 Telegram / 飞书 / 企业微信 / Webhook 通知推送。

典型适用场景

  1. 长篇网文创作：玄幻、都市、悬疑等长篇连载，作者只需提供创意和大纲，AI 负责写作和审稿
  2. 剧本 / 分镜创作：InkOS Play 支持剧本和分镜工作台，适合互动剧和游戏脚本
  3. 同人小说：从原作素材导入，自动维护设定边界和文风
  4. 小说本地化翻译：完整翻译管线（EPUB 入 → 语义分章 → 术语维护 → 审校 → EPUB 出）
  5. 互动影游开发：开放世界 + 分支剧情 + 变量/旗标，适合制作文字冒险类游戏
  6. OpenClaw Agent 工具：作为 Skill 被 Claude Code / OpenClaw 等 Agent 调用，扩展创作能力

坑与注意

API Key 配置隔离

Studio 和 CLI 配置完全隔离：Studio 固定使用服务页配置 + .inkos/secrets.json；CLI 和 daemon 支持 env 覆盖。即使存在 ~/.inkos/.env 或项目 .env，Studio 也不会用 env 覆盖已配置的 service、model、baseUrl、API Key。

API Key 存储在项目内 .inkos/secrets.json（不提交到 Git），不会写进 inkos.json。

旧项目兼容

旧 env 写法（INKOS_LLM_BASE_URL + INKOS_LLM_MODEL + INKOS_LLM_API_KEY）仍可用于 CLI；没有 INKOS_LLM_SERVICE 时 InkOS 会从 baseUrl 反推服务商。

MiniMax 特殊处理

MiniMax 默认走官方 OpenAI-compatible /v1/chat/completions，并优先使用可工作的非流式 transport（避免流式返回有 usage 但正文为空的问题）。MiniMax-M3* 默认关闭 thinking 返回；M2.x thinking 由上游限制无法关闭。

弱模型稳定性

弱模型（如某些小参数模型）输出格式不稳定时，InkOS 有一定容错能力，但建议生产环境使用 GPT-4o / Claude / Gemini 等主流模型以获得稳定管线体验。

版权与内容责任

InkOS 生成的同人内容涉及原作版权问题，请自行评估法律风险；原创内容不受此限制。

长任务中断与写锁恢复

停止操作会传递到 Agent、写作管线和模型请求；异常退出留下的写锁可以自动恢复；真实并发冲突会明确返回 BOOK_BUSY 而非静默覆盖。

OpenClaw Skill ≠ 内置 Skill

InkOS 有两套"Skill"概念： - OpenClaw Skill（clawhub install inkos 安装）：给 OpenClaw 调用的工具接口 - 内置 Skill（.inkos/skills/<id>/SKILL.md）：给 InkOS 内部的 Writer/Auditor 等 Agent 提供专业规则和上下文

两者完全独立，内置 Skill 不会给模型额外执行权限。

与同类对比

维度 InkOS 笔尖AI 写作猫 ChatGPT 写作 Claude 写作
开源 ✅ AGPL-3.0 ❌ ❌ ❌ ❌
长篇支持 ✅ 完整管线 ⚠️ 有限 ⚠️ 有限 ❌ ⚠️
连续性审计 ✅ 多维审计 ❌ ❌ ❌ ❌
去 AI 味 ✅ 内置规则 ❌ ⚠️ 简单检测 ❌ ⚠️
互动影游 ✅ Play 模式 ❌ ❌ ❌ ❌
翻译工作台 ✅ 完整管线 ⚠️ ❌ ❌ ⚠️
OpenClaw 集成 ✅ ❌ ❌ ❌ ❌
开放平台 CLI/Skill Web Web API API

一句话推荐结论

InkOS 是目前中文 AI 内容创作生态里功能最完整的长篇写作 Agent 系统——多 Agent 流水线保障连续性、内置去 AI 味规则解决文风问题、翻译和互动影游覆盖出版级需求，配合 OpenClaw Skill 生态可直接嵌入 AI 工作流。如果你有小说创作、剧本写作或互动内容开发需求，InkOS 是值得优先尝试的开源方案。

来源：GitHub README (Narcooo/inkos)、HuggingFace @actalk/inkos、ClawHub InkOS

不确定处：inkos short run 的 --chars 参数实际指中文字符数还是总字符数，以项目 README 最新版本为准；InkOS Play 导出的"互动影游"具体是哪种格式（Twee / Ink / Ren'Py 等），需进一步确认。