Skills — 技能

InkOS - 自主小说写作代理 InkOS 是一个使用 LLM 代理的自主小说写作 CLI 工具。它编排了一个多代理管道（Radar → Planner → Composer → Architect → Writer → Observer → Reflector → Normalizer → Auditor → Reviser）来生成、审核和修改小说内容，且每章无需人工干预。该管道分为三个阶段：

第 1 阶段（创作写作，temp 0.7）：Planner 生成章节意图和钩子议程，Composer 选择相关上下文，Writer 生成带有长度控制、首屏钩子、语义密度、钩子账本回报和移动段落节奏指导的散文。 第 2 阶段（状态结算，temp 0.3）：Observer 过度提取 9 类事实，Reflector 输出 JSON 差异（非完整 markdown），代码层应用 Zod 模式验证和不可变状态更新。钩子操作使用 upsert/mention/resolve/defer 语义。 第 3 阶段（质量循环）：Normalizer 调整章节长度，Auditor 运行 33 维检查，包括钩子健康分析，Reviser 自动修复关键问题。自我纠正循环运行，直到所有关键问题清除。真实文件以 schema 验证的 JSON（story/state/*.json）形式持久化，并具有 markdown 投影以便于人类阅读。SQLite 时态内存数据库（story/memory.db）在 Node 22+ 上启用了基于相关性的检索。

何时使用 InkOS： 英语小说写作：本土英语支持，具有 10 个类型配置文件（LitRPG、Progression Fantasy、Isekai 等）。 中文网络小说写作：内置 5 个中文类型（xuanhuan、xianxia、urban、horror、other）。 同人小说：从源材料创建同人小说，具有 4 种模式（canon、au、ooc、cp）。 批量章节生成：生成多个章节，具有一致的质量。 导入和继续：从文本文件导入现有章节，反向工程真实文件，并继续写作。 风格模仿：分析和采用参考文本的写作风格。 衍生写作：在保持父级正典的同时，写作前传/续集/衍生作品。 质量审核：检测 AI 生成的内容，并执行 33 维质量检查。 类型探索：探索趋势并创建自定义类型规则。 分析：跟踪每本书的字数、审核通过率和问题分布。

初始设置： 首次设置 # 初始化项目目录（创建配置结构） inkos init my-writing-project # 配置您的 LLM 提供商（OpenAI、Anthropic 或任何 OpenAI 兼容的 API） # 更喜欢 --api-key-env，因此密钥永远不会出现在 shell 历史记录中： export OPENAI_API_KEY=sk-xxx inkos config set-global --provider openai --base-url https://api.openai.com/v1 --api-key-env OPENAI_API_KEY --model gpt-4o # 对于兼容/代理端点，使用 --provider custom 并仅指向受信任的端点： # inkos config set-global --provider custom --base-url https://your-trusted-proxy.com/v1 --api-key-env OPENAI_API_KEY --model gpt-4o

多模型路由（可选）# 将不同模型分配给不同代理 - 平衡质量和成本 inkos config set-model writer claude-sonnet-4-20250514 --provider anthropic --base-url https://api.anthropic.com --api-key-env ANTHROPIC_API_KEY inkos config set-model auditor gpt-4o --provider openai inkos config show-models 没有显式覆盖的代理将回退到全局模型。

查看系统状态 # 检查安装和配置 inkos doctor # 查看当前配置 inkos status

常见工作流： 工作流 1：创建新小说 初始化和创建书籍：inkos book create --title "我的小说标题" --genre xuanhuan --chapter-words 3000 # 或带有创意简报（你的世界构建文档/想法）： inkos book create --title "我的小说标题" --genre xuanhuan --chapter-words 3000 --brief my-ideas.md 类型：xuanhuan（修炼）、xianxia（仙侠）、urban（都市）、horror、other 返回书籍 ID 以进行所有后续操作 生成初始章节（例如 5 章）：inkos write next book-id --count 5 --words 3000 --context "年轻主角发现力量" write next 命令运行完整管道：草稿 → 审核 → 修订 --context 提供指导给 Architect 和 Writer 代理 返回带有章节详细信息和质量指标的 JSON 查看和批准章节：inkos review list book-id inkos review approve-all book-id 导出书籍（支持 txt、md、epub）：inkos export book-id inkos export book-id --format epub

工作流 2：继续写作现有小说 列出您的书籍：inkos book list 从最后一章继续：inkos write next book-id --count 3 --words 2500 --context "主角面临关键选择" InkOS 维护 7 个真实文件（世界状态、角色矩阵、情感弧线等）以保持一致性 如果只有一个书籍存在，则省略 book-id 以进行自动检测 查看和批准：inkos review approve-all

工作流 2.5：共享自然语言控制（推荐用于 OpenClaw） 当 InkOS 由 OpenClaw 或其他外部代理驱动时，建议使用共享交互执行器而不是拼接许多