InkOS 故事创作工作台
为小说、剧本、互动叙事与多语言翻译提供持续状态管理的创作智能体。
按维度查看评分与理由
证据显示：README 提到重操作需确认（如生成、审查、修订），并提到备份/恢复、回滚、并发控制（BOOK_BUSY）。但未提供权限模型细节，API 密钥存储于 .inkos/secrets.json 和 .env，未说明加密或最小权限。依赖安全方面有 pnpm overrides 固定版本，但未提供漏洞扫描证据。外部效果方面有网络请求（LLM API、图片生成），但未说明数据流向。因此扣分：权限细节缺失、密钥存储未加密、依赖安全证据不足。
证据显示：README 描述了一致的架构（Studio/CLI/TUI 共享执行面），CI 在多个 Node 版本上运行测试，但未提供测试结果或覆盖率。依赖可用性方面，npm 包发布流程存在，但未提供依赖可用性保证。失败消息方面，提到错误码如 BOOK_BUSY，但未提供详细的失败处理文档。因此扣分：测试证据不足、失败消息文档不完整。
证据显示：README 描述了多种场景（长篇小说、短篇、剧本、互动电影、翻译），并提供了 10 种英文类型和 5 种中文类型，能力边界清晰（如技能不自动执行脚本）。触发精度方面，技能通过 @skill-id 强制或意图触发，不再使用关键词匹配。环境适配方面，支持多种操作系统和 Node 版本，但未提供详细的系统要求。因此扣分：环境适配细节不足。
证据显示：README 提供了安装、配置、使用示例，信息架构清晰（分章节）。命名稳定性方面，CLI 命令和配置项命名一致。已知限制方面，README 提到一些限制（如 MiniMax M2.x 思考无法禁用），但未全面列出。许可证为 AGPL-3.0，版本号 1.7.2，有 CI 和发布流程，但未提供 CHANGELOG 文件。维护责任方面，有 GitHub 仓库和发布流程，但未明确维护者。因此扣分：已知限制不全面、无 CHANGELOG、维护责任不明确。
证据显示：README 描述了输出格式（如 EPUB、Markdown、TXT），并提供了使用示例，输出可用性较好。边际价值方面，提供了多种功能（如叙事预测、翻译工作台），但未与其他工具对比。成本效益方面，提到多模型路由以平衡成本，但未提供具体成本数据。因此扣分：边际价值对比不足、成本数据缺失。
证据显示：README 中的功能描述未提供具体实现细节或测试证据，声明多为断言。跨来源验证方面，有 CI 和发布流程，但未提供独立验证。事实与推断分离方面，README 区分了功能描述和推荐（如 kkaiapi），但未明确标注哪些是事实哪些是推断。因此扣分：声明缺乏可追溯性、跨来源验证不足、事实与推断分离不明确。
- API 密钥存储于 .inkos/secrets.json 和 .env，未说明加密或最小权限，建议审查密钥管理。
- 依赖安全仅依赖 pnpm overrides，未提供漏洞扫描证据，建议检查依赖漏洞。
- README 中的功能声明缺乏可追溯性，建议查看代码和测试验证。
这个 Agent 能做什么，适合哪些场景？
InkOS 是一个面向长篇连载、短篇、剧本、互动影游及长文翻译的本地项目式创作系统。它提供 Studio Web 工作台、终端 TUI、CLI，以及面向外部 Agent 的 `inkos interact --json` 入口。长篇创作默认按规划、编排、写作、审计、必要修订和状态同步推进，并将结构化状态、Markdown 投影与可选 SQLite 时序记忆保存在项目中。它还能生成独立短篇包、封面提示词和可选封面图，或创建带角色、物品、证据和关系状态的开放世界与分支互动项目。模型配置可在 Studio 中管理，也可由 CLI 的环境变量和参数覆盖，支持多个服务商及 OpenAI-compatible 服务。
用户可用 inkos book create 建书并传入 --brief，由 Architect 生成故事设定、规则和长期控制文件。inkos write next 默认运行 plan -> compose -> write，随后执行审计、按配置修订并同步故事状态；原子命令 plan chapter、compose chapter、draft、audit、revise 可分别调用。系统把权威状态写入 story/state/*.json，将可读投影写入 story/*.md，并在 Node.js 22+ 环境使用 story/memory.db 检索相关事实、伏笔和章节摘要。它可通过 inkos import chapters 导入已有章节并重建状态，通过 inkos translate init / run / export 翻译 EPUB、文本型 PDF、TXT 或 Markdown，并导出 TXT、Markdown 或 EPUB。Studio Chat、inkos agent 和 inkos interact 共享动作入口，可创建短篇、封面、Play 世界、编辑持久化文本，并对重动作先请求确认。
- 连载小说作者希望在每章生成后检查人物记忆、资源、伏笔和剧情连续性，并保留可回滚的本地状态。
- 编剧或互动叙事设计者需要创建分支剧情、变量、角色关系、结局、场景与可点击选择的互动项目。
- 已有小说作者要用
inkos import chapters导入旧稿、逆向生成设定和章节状态后继续续写。 - 出版或内容团队需要按章节与语义段翻译 EPUB、文本型 PDF、TXT 或 Markdown，并输出术语表和对照审校报告。
- 使用 Claude Code 或 OpenClaw 的创作工作流需要通过
inkos interact --json --message "..."调用结构化交互入口。
这个 Agent 有哪些优点和局限？
- 将章节生产、连续性审计、修订与状态结算串成明确管线，并保留原子 CLI 命令供脚本或外部 Agent 编排。
- 以结构化 JSON 状态、可读 Markdown 投影和 Node.js 22+ 的 SQLite 时序记忆共同维护长篇事实与伏笔，而非只依赖聊天上下文。
- 同时覆盖长篇、短篇、剧本、开放世界互动、封面和整书翻译，且 Studio、TUI、CLI 共用交互执行面。
- 支持 Studio 服务配置、CLI 环境覆盖、按 Agent 的模型路由，以及多家服务和 OpenAI-compatible 端点。
- 创作质量、可用性与费用取决于用户配置的模型服务和 API Key；仓库未承诺任何特定模型的输出质量或成本。
- SQLite 时序记忆仅在 Node.js 22+ 环境自动启用，较低版本的运行行为在提供材料中未说明。
- 长篇自动修订默认最多一次；未解决的问题会保留给人工或后续命令处理。
- 翻译输入仅明确支持 EPUB、文本型 PDF、TXT 和 Markdown；扫描版 PDF 的处理能力没有证据。
如何安装或部署这个 Agent？
全局安装：npm i -g @actalk/inkos。创建并进入项目：inkos init my-novel && cd my-novel。启动 Studio：inkos，然后在“模型配置”中选择服务商、填入 API Key、测试连接并选择模型。CLI/部署环境也可用 inkos config set-global --provider <openai|anthropic|custom> --base-url <API地址> --api-key <你的API Key> --model <模型名> 配置；Node.js 22+ 会自动启用 SQLite 时序记忆。
如何使用这个 Agent？
建书并写首章：inkos book create --title "吞天魔帝" --genre xuanhuan，然后执行 inkos write next 吞天魔帝，用 inkos status 查看进度，最后可用 inkos export 吞天魔帝 --format epub 导出。若要先检查控制输入，可依次执行 inkos plan chapter 吞天魔帝 --context "本章重点写师徒矛盾" 和 inkos compose chapter 吞天魔帝。生成独立短篇可运行 inkos short run --direction "都市短篇 婚姻反转 女主证据反杀" --chapters 12 --chars 1000；外部 Agent 可调用 inkos interact --json --message "继续当前书，但把节奏再收紧一点"。
常见问题
它会把我的作品上传到固定的云服务吗？
.inkos/secrets.json，而 CLI 可使用环境变量；生成和联网研究会调用用户配置的模型或网络服务。是否向某服务发送内容取决于所选提供商。能否使用自己的模型服务？
--provider custom 和 OpenAI-compatible 接口；inkos doctor 可显示有效配置并尝试连通性。自动写作会直接覆盖正史吗？
write next 会推进章节生产和状态同步。剧情推演的 forecast create/show/select 则只保存候选计划，不会修改正文、大纲或正史状态。能否先试用而不让模型写正文？
inkos compose chapter [id]；材料说明该命令只编译本地文档和状态，不要求在线 LLM。如何处理并发写作冲突？
BOOK_BUSY，并提供整书备份/恢复、最新章节删除和状态回滚能力。