sigpanic/goink

解决的问题

Goink 是一款专为长篇小说创作设计的桌面 AI 写作系统。它解决了通用 LLM 常见的“记忆丧失”问题，即 AI 在数十个章节后会忘记角色名称、剧情点与伏笔。它取代了手动提醒 AI 关于故事状态的繁琐工作，并确保庞大文本内容的一致性。

运作原理

Goink 采用基于 Agent 的架构而非简单的流水线。一个拥有 31 种结构化工具的 AI Agent，让 LLM 能够自主决定如何查询角色档案、更新剧情线以及管理世界观数据。

关键技术组件包括：

• 结构化记忆：针对角色关系（以有向图表示）、伏笔状态、叙事弧线与读者已知信息进行专门追踪。
• 本地语义搜索：使用 BGE 中文语义模型 (ONNX Runtime) 与 sqlite-vec 进行向量索引的本地引擎，让 AI 能根据语义而非关键词找到相关段落。
• 技能系统：一个模块化系统，写作方法论定义于 Markdown 文件中，允许用户通过三层覆盖（小说 > 用户 > 内置）来应用特定风格或工作流。
• 基于 Diff 的编辑：为防止 AI 盲目覆写内容，它会产生 Diff 预览，用户必须批准后变更才会写入文本。
• 版本控制：整合 Git 以进行自动提交与轻松回溯。

适用对象

需要 AI 助理在长期项目中维持严格叙事一致性与结构完整性的小说家与创作者。

特色亮点

• Agentic 维护：在每个章节后自动触发角色更新与剧情线进度检查。
• 风格萃取：可分析范本文本以提取作者风格（句式结构、语气等）并产生自定义的“模仿技能”。
• 状态可视化：提供故事弧线与地点关系图的可视化地图。
• 零配置本地搜索：本地向量搜索完全在机器上执行，无需 GPU 或外部 API。
• 沙盒安全性：使用白名单与 SafePath 机制，确保 AI 无法访问或修改未经授权的文件。