inkos

InkOS 创作 Harness

InkOS 是一个文本创作 Harness。主 Pi Agent 理解请求、启用专业技能、调用类型化能力操作，并且只报告已持久化的结果。

核心约定

• 讨论就是讨论。只有通过能力操作才能进行创作和修改。
• 操作成功与否由其 ActionResult 和产物版本证明，绝不由助手的文字说明证明。
• 用户意图、当前 Work 的约束、已确立的事实和明确禁令优先于模型默认行为。
• 技能提供专业方法，但绝不授予写入权限。
• 评审返回有证据支撑的观察，不会给文字打分、否决章节或授权自动改写。
• 修订是显式操作。保留源版本，并报告新的产物版本。
• 按任务组装上下文：在确定性候选项发现之后，由大模型语义选择相关源章节。受保护的意图和选中的当前事实不会被压缩；只有预算溢出时，才对优先级较低的上下文进行语义编译。

创作配置

• longform-novel：基础设定、章节规划、写作、评审、修订、状态投影、预测、封面。
• short-fiction：完整短篇故事、规划、评审笔记、销售资料包、封面。
• script：电影剧本、竖屏短剧、广播剧、互动剧本。
• storyboard：可编辑分镜、类型化图像提示词资源、图像生成。
• interactive-film：故事树、标记、剧本、分镜、图像资源、可玩图谱、导出。
• play-world：开放世界或引导式互动，包含持久实体、关系、时间、证据、物品栏、场景和图像。
• fanfic、spinoff、imitation、continuation：带有明确谱系和源正典的衍生创作。
• translation：带有术语管理和可续作产物的多语言长文档翻译。

自然语言用法

通过日常对话讨论或请求工作。Agent 会选择相关配置和技能。创作提案可能需要确认；当前 Work 中可恢复的编辑可以直接执行。

需要时强制启用某项技能：

@inkos-story-review review chapter 8 against the current reader promise
@inkos-imitation-writing keep the reference cadence but create a new story

通过 Agent 工具检查可用技能和 Work，而不是猜测存储路径。

显式 CLI 操作

inkos studio
inkos tui
inkos book create --title "My Story" --genre other --lang en
inkos write next <book-id> --count 3
inkos revise <book-id> <chapter> --mode rewrite
inkos review <book-id>
inkos short run --title "A Short Story"
inkos fanfic init --title "Derived Story" --from source.txt --mode canon
inkos export <book-id> --format epub

内部规划、语义上下文选择、写作、状态投影和评审属于同一条 Harness 执行流程。review 会显示已持久化的定性观察。

修订模式

• spot-fix：由宿主应用精确应用局部文本补丁。
• polish：仅修改文字表层。
• rewrite：在保留权威内容的同时，重写受影响的段落或章节。
• rework：仅在用户明确要求进行结构性修改时，重组场景。
• anti-detect：使用已启用的去冗余技能进行显式文字清理。

上下文与持久化

• 人类可读的故事资源保留为 Markdown。
• 宿主使用的状态和操作结果采用类型化 JSON／工具架构。
• 规划器、写作器、评审器、修订器、结算器、Play、翻译和制作文档编译器通过 Pi 工具提交类型化结果。
• 对话压缩和故事上下文压缩相互独立。两者都会保留受保护的当前意图，且只有在预算溢出后才使用语义编译。
• Work 清单、产物版本、剧集事件和模型调用轨迹提供可观测的谱系。

故障处理

• 模型／提供方故障仍属于操作错误，绝不会被转化为虚构的世界结果或内容判定。
• 可选资源创建失败时，应作为观察结果报告，不影响已成功持久化的手稿。
• 操作中断时会保留最后一次已提交的产物，并可从持久化状态重试。
• 如果操作结果中没有产物引用，绝不可声称文件已创建或更改。