InkOS 故事创作工作台
为小说、剧本、互动叙事与多语言翻译提供持续状态管理的创作智能体。
- Star 数
- ★ 11k
- 最近更新
- 14 天前
- License
- AGPL-3.0
- 主语言
- TypeScript
- FA 评分
- 50/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Claude Code · OpenAI API · Claude API
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 连载小说作者希望在每章生成后检查人物记忆、资源、伏笔和剧情连续性，并保留可回滚的本地状态。
- 不适合
- 仍在使用 Node.js 22 以下版本、又依赖 SQLite 时序记忆的用户
- 期望自动修订闭环、无需人工介入审稿的团队
- 源码审查
- 50/100 · 缺口较多
这个 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？
全局安装：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 "继续当前书，但把节奏再收紧一点"。
这个 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 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| InkOS 故事创作工作台 当前 | 50 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 11k | 14 天前 | TypeScript | Claude Code · OpenAI API · Claude API |
| OH Story — 网文写作全流程 Skill 包 | 75 · 表现良好 | Agent 插件 / 技能免费 + 模型费 | ★ 8.4k | 今天 | Python | Codex · Claude Code |
| AIWriteX 智能内容创作平台 | 43 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 2.2k | 11 天前 | Python | — |
| Story Skills | 80 · 表现良好 | Agent 插件 / 技能免费 | ★ 393 | 2 天前 | JavaScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示：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 中的功能声明缺乏可追溯性，建议查看代码和测试验证。
你是这个项目的维护者？把 FARS 徽章加到 README
[](https://followagents.com/zh/agents/inkos)<a href="https://followagents.com/zh/agents/inkos"><img src="https://followagents.com/badge/inkos.svg?lang=zh" alt="FARS 评测"></a>最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
- fix(core): normalize persisted paths across platforms (52075bb9) - fix(build): keep overrides compatible with pnpm 9 (de4e9fa5) - chore(release): prepare v1.8.0 documentation (b673c500) - fix(ci): align test matrix with node requirements (8922e3ab) - feat(tui): unify agent surfaces and confirmations (7c98a1eb) - refactor(core): unify production harness and context flow (e7c04465) - refactor: center creation workflows on pi harness (d1d6d8ec) - refactor(core): run production workers through pi harness (35bb2efd) - feat(skills): bind production modes to dedicated expertise (6651fa7e) …在 GitHub 查看 ↗ -
发布说明摘录
- chore(release): prepare v1.7.2 (c7851b94) - refactor(skills): replace legacy capability system (6e4ce005) - docs: document AgentSkills compatibility (d674c214) - feat(studio): import external skill folders (41a1138f) - feat(core): add intent-driven AgentSkills runtime (4b81fbba) - chore: remove internal planning documents (1a2fd09b) - docs: lead v1.7 with model configuration (f19f428a) Full Changelog: https://github.com/Narcooo/inkos/compare/v1.7.1...v1.7.2在 GitHub 查看 ↗ -
发布说明摘录
- docs: consolidate v1.7 highlights (a713a2e8) - chore(release): prepare v1.7.1 (6a16a619) - docs: keep product intro above sponsorship (9f194592) - docs: retain Kimi open source partner banners (ac776428) - docs: add Kimi sponsorship banners (6c6574ff) - test(core): use shared timeout for root import (d3f6ae7e) - fix(core): restore direct terminal tool cards (eb6c8f88) - docs: document narrative forecast workflow (6ac708a9) - feat(studio): compare narrative forecasts in book chat (b98252bb) - docs: design Studio narrative forecast comparison (b38f6039) …在 GitHub 查看 ↗
常见问题
它会把我的作品上传到固定的云服务吗？
.inkos/secrets.json，而 CLI 可使用环境变量；生成和联网研究会调用用户配置的模型或网络服务。是否向某服务发送内容取决于所选提供商。能否使用自己的模型服务？
--provider custom 和 OpenAI-compatible 接口；inkos doctor 可显示有效配置并尝试连通性。自动写作会直接覆盖正史吗？
write next 会推进章节生产和状态同步。剧情推演的 forecast create/show/select 则只保存候选计划，不会修改正文、大纲或正史状态。能否先试用而不让模型写正文？
inkos compose chapter [id]；材料说明该命令只编译本地文档和状态，不要求在线 LLM。如何处理并发写作冲突？
BOOK_BUSY，并提供整书备份/恢复、最新章节删除和状态回滚能力。