中文 | English
--- AI辅助小说创作工具，帮助作者保持故事连贯性，提升创作效率。 ## v0.4 更新 番外写作 + 文风学习 + 内容校验 + 质量提升。 ### 番外写作（Spinoff） 基于已有故事创建前传、后传或外传。番外和主篇共享世界观和角色，但有独立剧情线。 ```bash inkos import canon 烈焰前传 --from 吞天魔帝 # 导入主篇设定到番外 inkos write next 烈焰前传 # 根据设定继续创作 ``` 导入后生成 `story/parent_canon.md`，包含主篇的世界规则、角色信息、关键事件时间线。系统在创作时自动参考这些设定，确保番外与主篇保持一致。 ### 文风学习 输入参考文本，系统分析写作特点并生成风格指南，后续章节创作时参考这些特点。 ```bash inkos style analyze 参考小说.txt # 分析：句式特点、用词习惯 inkos style import 参考小说.txt 吞天魔帝 --name 某作者 # 学习文风到作品 ``` 产出两个文件： - `style_profile.json` — 写作特点数据（句式分布、段落长度、用词多样性） - `style_guide.md` — 生成的写作风格参考指南 ### 内容校验器 内置多种写作质量检查规则，帮助提升作品质量： | 规则 | 说明 | |------|------| | 句式检查 | 避免特定句式过度使用 | | 用词多样性 | 检查高频词使用频率 | | 段落长度 | 确保段落长度适中 | | 叙述方式 | 优化表达方式 | | 对话自然度 | 检查对话是否符合人物设定 | | 情节连贯性 | 确保前后情节衔接自然 | 校验器发现问题时，可自动进行针对性优化。 ### 质量提升机制 - 采用精准优化模式，只调整需要改进的部分 - 优化后对比文本质量，确保改进有效 - 保持创作风格一致性 - 优化过程遵循创作边界（不增删段落、不改人物名、不加新情节） ### 其他 v0.4 变更 - 审计维度扩展到32个，覆盖更多创作质量检查点 - 支持联网查询：年代题材可查询真实事件/人物/地理信息 - 智能调度：默认15分钟一轮创作周期 - 新增精准优化模式 - 支持用户自定义创作规则 --- ## v0.3 更新 创作规则三层分离 + 记忆管理 + 质量检测 + 通知集成。 ### 记忆管理与写作质量 系统自动生成摘要、追踪情节线索、记录人物关系，确保长篇小说创作不丢失细节。 | 记忆文件 | 用途 | |----------|------| | `chapter_summaries.md` | 各章摘要：出场人物、关键事件、状态变化 | | `subplot_board.md` | 情节线索板：各线索状态追踪 | | `emotional_arcs.md` | 情感变化：按角色追踪情绪发展 | | `character_matrix.md` | 人物关系矩阵：互动记录、信息知晓范围 | ### 质量检测 | 功能 | 说明 | |------|------| | 文本特征检测 | 检测常见AI生成文本特征 | | 外部检测API集成 | 支持接入第三方质量检测服务 | | 写作特点学习 | 从参考文本学习写作风格 | | 质量提升 | 检测→优化→再检测循环 | | 检测记录 | 记录每次检测/优化结果，查看统计报告 | ```bash inkos style analyze reference.txt # 分析参考文本写作特点 inkos style import reference.txt 吞天魔帝 # 学习写作特点到作品 inkos detect 吞天魔帝 --all # 全书质量检测 inkos detect --stats # 查看检测统计 ``` ### 通知 + 智能调度 支持将创作事件通过Webhook推送，可配置签名验证和事件过滤。后台进程可设置质量控制：审计失败自动重试、连续失败暂停创作。 ### 题材自定义 内置5个创作题材，每个题材提供相应的创作参考规则： | 题材 | 参考规则 | |------|----------| | 玄幻 | 修炼体系、战斗系统、成长节奏 | | 仙侠 | 修炼阶段、法宝系统、天道规则 | | 都市 | 时代背景、社会关系、发展逻辑 | | 恐怖 | 氛围营造、悬念设计、克制叙述 | | 通用 | 基础创作规范 | 创建作品时指定题材，对应规则自动生效： ```bash inkos book create --title "吞天魔帝" --genre xuanhuan ``` 题材规则可以查看、复制到项目中修改，或从零创建： ```bash inkos genre list # 查看所有题材 inkos genre show xuanhuan # 查看玄幻的完整规则 inkos genre copy xuanhuan # 复制到项目中自定义修改 inkos genre create wuxia --name 武侠 # 从零创建新题材 ``` 每个题材提供写作风格参考示例： - **玄幻**：侧重感官描写和体验 - **都市**：注重细节和场景还原 - **恐怖**：强调氛围营造和心理暗示 ### 单作品规则 每个作品有独立的 `book_rules.md`，创建时自动生成，也可手动调整： ```yaml protagonist: name: 林烬 personalityLock: ["冷静果断", "有原则", "理性思考"] behavioralConstraints: ["行为逻辑一致", "对盟友真诚"] numericalSystemOverrides: hardCap: 840000000 resourceTypes: ["微粒", "血脉浓度", "灵石"] prohibitions: - 主角行为逻辑矛盾 - 无意义剧情拖沓 - 配角过度抢戏 fatigueWordsOverride: ["瞳孔骤缩", "不可置信"] # 可自定义高频词提醒 ``` 人物设定、数值上限、自定义提醒、高频词提醒——每个作品的规则独立调整，不影响题材模板。 ### 32维度质量检查 包括：人物一致性、时间线、设定冲突、情节合理性、数值检查、伏笔处理、节奏把控、风格统一、信息边界、用词习惯、逻辑连贯、时代考究、配角塑造、对话自然度、叙述方式、视角一致性等。 ### 质量提升 - 高频词提醒：提醒过度使用的词汇 - 叙述者客观化：避免过多主观评价 - 避免分析式叙述 - 场景描写适度 ### 其他 - 支持主流AI模型接口 - 支持多种优化模式 - 非数值题材不生成数值记录 - 所有命令支持结构化输出 - 自动识别当前作品 - 一键更新、快速初始化 - API错误附带中文提示，支持连通性测试 --- ## 为什么需要InkOS？ 用AI辅助小说创作面临诸多挑战：长篇小说容易前后矛盾、角色记忆混乱、物品凭空消失、伏笔断裂。InkOS把这些当作工程问题来解决。 - **长期记忆** — 追踪故事的真实状态 - **信息一致性** — 确保人物只知晓应该知道的信息 - **资源追踪** — 物资会消耗、物品会损坏 - **用词提醒** — 提醒过度使用的词语 - **自动优化** — 在人工审阅前修正逻辑错误 ## 工作原理 每一章由多个模块协作完成： | 模块 | 职责 | |-------|------| | **规划模块** | 分析市场趋势，指导故事方向（可选） | | **架构模块** | 规划章节结构：大纲、场景、节奏 | | **创作模块** | 根据大纲+当前状态生成内容 | | **校验模块** | 对照记忆验证草稿 | | **优化模块** | 优化发现的问题 — 关键问题自动优化，其他标记给人工审阅 | 如果校验不通过，系统自动进入"优化 → 再校验"循环，直到问题解决。 ### 记忆管理 每个作品维护多个记忆文件作为唯一事实来源： | 文件 | 用途 | |------|------| | `current_state.md` | 当前状态：人物位置、关系网络、已知信息 | | `particle_ledger.md` | 资源记录：物品、金钱、物资数量及变化 | | `pending_hooks.md` | 未闭合伏笔：铺垫、未解决冲突 | | `chapter_summaries.md` | 各章摘要：出场人物、关键事件、状态变化 | | `subplot_board.md` | 情节线索板：各线索状态 | | `emotional_arcs.md` | 情感变化：按角色追踪情绪发展 | | `character_matrix.md` | 人物关系矩阵：互动记录 | 校验模块对照这些文件检查每一章草稿。 ### 创作规则体系 创作模块内置创作参考规则，适用于所有题材。 在此基础上，每个题材有专属规则，每个作品有独立的 `book_rules.md`（主角设定、数值上限、自定义提醒）和 `story_bible.md`（世界观设定），在创建作品时自动生成。 详见 [v0.3 更新](#v03-更新-2026-03-13)。 ## 三种使用模式 ### 1. 完整流程（一键式） ```bash inkos write next 吞天魔帝 # 创作 → 校验 → 优化，一步到位 inkos write next 吞天魔帝 --count 5 # 连续创作5章 ``` ### 2. 独立命令（可组合） ```bash inkos draft 吞天魔帝 --context "本章重点写师徒矛盾" --json inkos audit 吞天魔帝 31 --json inkos revise 吞天魔帝 31 --json ``` 每个命令独立执行单一操作，可被脚本调用或集成到其他工具中。 ### 3. 自然语言模式 ```bash inkos agent "帮我写一本都市修仙，主角是个程序员" inkos agent "写下一章，重点写师徒矛盾" inkos agent "先扫描市场趋势，然后根据结果创建一本新书" ``` 内置多个工具，通过自然语言决定调用顺序。 ## 快速开始 ### 安装 ```bash npm i -g @actalk/inkos ``` ### 配置 **方式一：全局配置（推荐，只需一次）** ```bash inkos config set-global \ --provider openai \ --base-url https://api.openai.com/v1 \ --api-key sk-xxx \ --model gpt-4o ``` 配置保存在 `~/.inkos/.env`，所有项目共享。之后新建项目不用再配。 **方式二：项目级 `.env`** ```bash inkos init my-novel # 初始化项目 # 编辑 my-novel/.env ``` ```bash # 必填 INKOS_LLM_PROVIDER=openai # 服务商 INKOS_LLM_BASE_URL=https://api.openai.com/v1 # API地址 INKOS_LLM_API_KEY=sk-xxx # API Key INKOS_LLM_MODEL=gpt-4o # 模型名 # 可选 # INKOS_LLM_TEMPERATURE=0.7 # 温度 # INKOS_LLM_MAX_TOKENS=8192 # 最大输出token ``` 项目 `.env` 会覆盖全局配置。不需要覆盖时可以不写。 ### 使用 ```bash inkos book create --title "吞天魔帝" --genre xuanhuan # 创建新作品 inkos write next 吞天魔帝 # 写下一章 inkos status # 查看状态 inkos review list 吞天魔帝 # 审阅草稿 inkos export 吞天魔帝 # 导出作品 inkos up # 守护进程模式 ``` ## 命令参考 | 命令 | 说明 | |------|------| | `inkos init [name]` | 初始化项目 | | `inkos book create` | 创建新作品 | | `inkos book update [id]` | 修改作品设置 | | `inkos book list` | 列出所有作品 | | `inkos genre list/show/copy/create` | 查看、复制、创建题材 | | `inkos write next [id]` | 完整流程创作下一章 | | `inkos write rewrite [id]