1. 项目定位与用途
InkOS 是一个开源的自主小说写作 CLI AI 代理，定位为覆盖写、审、改全流程的自动化创作工具。它通过 10 智能体协作管线自主完成小说章节的生成、审计与修订，同时提供 InkOS Studio 本地 Web 工作台实现可视化操作，包括书籍管理、章节审阅编辑、实时进度监控等功能。支持玄幻、仙侠、都市、科幻等 12+ 题材，以及续写、番外、同人、仿写等创作形式，并已发布为 OpenClaw Skill 供外部 Agent 调用。
项目档案命令行工具
InkOS 自主小说写作 CLI AI 代理 | 10 智能体自动化写审改流程支持多题材多语言
Narcooo/inkos：InkOS 是一个开源的自主小说写作 CLI AI 代理，采用 10 智能体协作管线自动化完成写、审、改全流程，支持多题材多语言，并提供本地 W本页整理它解决什么问题、适用场景、安装方式和使用方法。
AI 总结
InkOS 是一个开源的自主小说写作 CLI AI 代理，采用 10 智能体协作管线自动化完成写、审、改全流程，支持多题材多语言，并提供本地 Web 工作台实现可视化创作管理。
中文项目介绍
InkOS 旨在解决小说创作中从构思、写作、审核到修订的全流程自动化问题。它通过多智能体协作显著提升写作效率与内容质量，同时保留人工审核门控以确保创作者始终掌控全局。
项目适用于网络小说作者快速生成和迭代章节、同人及番外创作、中英文双语写作，以及需要 AI 辅助进行内容审计和质量控制的场景。已发布为 OpenClaw Skill，可被各类 AI Agent 直接调用集成。
技术层面，InkOS 基于 pnpm monorepo 架构，使用 TypeScript 开发，核心包含 10 智能体协作管线、状态管理、LLM 接口抽象，并内置 12+ 题材的专属写作规则与审计维度。提供 CLI 和本地 Web 工作台（Studio）双界面，支持全局或项目级 LLM 配置及多模型路由。
详细信息与使用说明
2. 解决的问题
InkOS 解决了传统小说创作中流程割裂、效率低下的问题。它将构思、撰写、审核、修订等环节通过多智能体管线自动化衔接，减少人工重复劳动；同时通过人工审核门控确保关键节点由创作者决策，避免 AI 完全失控。此外，项目通过题材专用规则、连续性跟踪、状态快照与恢复机制，提升了长篇小说创作的连贯性与内容质量。
3. 适用场景
主要适用场景包括：网络小说作者快速生成和迭代章节内容；同人创作、番外写作及特定风格仿写；中英文双语小说创作（通过 `--lang en` 切换）；需要 AI 辅助进行内容审计、修订和质量控制（如情绪/节奏检测、AI 痕迹分析）；以及通过 OpenClaw 生态将自主写作能力集成到现有 Agent 工作流中。项目对个人创作者和小型团队均友好。
4. 安装方式
安装方式有三种：全局安装使用 `npm i -g @actalk/inkos`；通过 OpenClaw 生态安装使用 `clawhub install inkos`；或克隆仓库后使用 `inkos init <项目名>` 初始化。项目要求 Node.js >=20.0.0 和 pnpm >=9.0.0。若通过 npm 或克隆安装，`skills/SKILL.md` 已包含在内，OpenClaw 可直接读取无需额外安装。
5. 使用方式
基本使用流程：首先配置 LLM，可通过 `inkos config set-global` 设置全局配置（提供商、API 地址、密钥、模型），或编辑项目级 `.env` 文件；然后使用 `inkos book create --title "书名" --genre <题材>` 创建书籍；接着 `inkos write next <书名>` 触发完整写作管线（草稿→审计→修订）；通过 `inkos review list <书名>` 查看草稿，`inkos review approve-all <书名>` 批量通过；最后 `inkos export <书名>` 导出全书。也可运行 `inkos studio` 启动本地 Web 工作台进行可视化操作。
6. 补充说明与实现特点
项目采用 pnpm monorepo 管理，包含 CLI（`packages/cli`）、Core（`packages/core`）和 Studio（`packages/studio`）三个主要包。核心实现为 10 智能体协作管线，包含状态管理、LLM 接口抽象和题材规则引擎。支持多模型路由，可为不同 Agent 分配不同模型以平衡质量与成本。已发布 OpenClaw Skill，Claw 可通过 `exec` 调用原子命令（如 `plan chapter`、`compose chapter`、`draft`、`audit`、`revise`）并解析 `--json` 输出。技术栈为 TypeScript，编译目标 ES2022，严格类型检查。
思维导图
InkOS 项目结构
CLI 命令层
用户交互命令
本地运行时
配置管理
核心引擎
10 智能体管线
状态管理
LLM 接口抽象
题材规则引擎
Studio 工作台
Vite+React 应用
书籍管理界面
审阅编辑界面
数据分析面板
题材配置系统
12+ 题材规则
审计维度
疲劳词列表
工具与脚本
构建脚本
发布验证
版本管理
常见问题
如何安装 InkOS？
可通过三种方式安装：1) 全局安装：执行 `npm i -g @actalk/inkos`；2) OpenClaw 安装：执行 `clawhub install inkos`；3) 克隆仓库后使用 `inkos init <项目名>` 初始化。项目要求 Node.js >=20 和 pnpm >=9。
如何配置 LLM 提供商？
支持两种配置方式：全局配置使用 `inkos config set-global --provider <openai|anthropic|custom> --base-url <URL> --api-key <KEY> --model <模型>`，配置保存在 `~/.inkos/.env`；项目级配置则直接编辑项目目录下的 `.env` 文件，设置 `INKOS_LLM_*` 环境变量。项目级配置会覆盖全局配置。
如何开始写一本新书？
首先使用 `inkos book create --title "书名" --genre <题材>` 创建书籍（题材如 xuanhuan、xianxia 等）；然后执行 `inkos write next <书名>` 触发完整写作管线，该管线会自动完成草稿生成、审计和修订；审阅时使用 `inkos review list <书名>` 查看草稿，`inkos review approve-all <书名>` 批量通过；最后 `inkos export <书名>` 导出全书。
InkOS Studio 是什么？如何启动？
InkOS Studio 是本地 Web 工作台，提供书籍管理、章节审阅编辑、实时写作进度、市场雷达、数据分析、AI 检测、文风分析等可视化功能，覆盖 CLI 全部能力。启动方式为在项目目录执行 `inkos studio`，它将基于 Vite + React + Hono 启动本地服务。
如何通过 OpenClaw 调用 InkOS？
InkOS 已发布为 OpenClaw Skill，任何兼容 Agent（如 Claude Code、OpenClaw）可通过 `exec` 调用其原子命令和控制面操作，如 `plan chapter`、`compose chapter`、`draft`、`audit`、`revise`、`write next` 等，并添加 `--json` 参数输出结构化数据供 Agent 解析决策。推荐流程是先更新 `author_intent.md` 或 `current_focus.md`，再执行计划与写作命令。