sigpanic/goink

解决的问题

Goink 是一个专为长篇小说写作设计的桌面 AI 写作系统。它解决了通用大模型中的「记忆丢失」问题——在数十章的写作过程中，AI 会忘记角色姓名、情节要点和伏笔。它取代了手动追踪故事元素和手动翻阅前文以保持一致性的繁琐工作。

工作原理

Goink 采用基于 Agent 的架构，配备自定义 ReAct 循环和 31 个结构化工具。与线性流程不同，AI 代理会自主决定使用哪些工具来查询角色档案、更新情节弧线，或读写文本。

关键技术组件包括：

• 结构化记忆：专门追踪角色关系（以有向图形式）、伏笔状态、叙事弧线、世界观构建（地点层级结构）以及读者知识。
• 本地语义搜索：使用 ONNX Runtime 和 sqlite-vec 的本地引擎，无需互联网连接即可对全文进行基于语义的搜索。
• 技能系统：模块化系统，写作方法论以 Markdown 文件定义，支持三级覆盖（小说 > 用户 > 内置）和三种触发模式（自动、手动、始终）。
• 审批工作流：为防止意外更改，系统在编辑文本时生成 Diff 预览，需用户确认后才写入磁盘。
• ListNode：内置 Git 集成，支持自动提交和版本历史记录。

适用人群

需要 AI 助手在数十万字的长篇作品中保持严格叙事一致性的小说家和文学创作者。

核心亮点

• 自主维护：章节写完后自动触发角色与情节更新，可选独立「审查代理」确保一致性。
• 风格提炼：可分析样本文本提取写作风格模式（句式结构、语气等），生成 AI 可遵循的定制「模仿技能」。
• 零配置启动：以独立桌面应用（Wails/Go）形式分发，无需 Python 或 GPU。
• 沙箱安全：使用正则表达式白名单和 SafePath，确保 AI 无法访问或修改系统中未经授权的文件。