开源 AI 桌面写作系统 goink | 芋道源码 —

阅读全文

⭐⭐⭐ Spring Boot 项目实战	⭐⭐⭐ Spring Cloud 项目实战
《Dubbo 实现原理与源码解析 —— 精品合集》	《Netty 实现原理与源码解析 —— 精品合集》
《Spring 实现原理与源码解析 —— 精品合集》	《MyBatis 实现原理与源码解析 —— 精品合集》
《Spring MVC 实现原理与源码解析 —— 精品合集》	《数据库实体设计合集》
《Spring Boot 实现原理与源码解析 —— 精品合集》	《Java 面试题 + Java 学习指南》

摘要: 原创出处 http://www.iocoder.cn/Fight/goink-ai-writing-system/ 「芋道源码」欢迎转载，保留摘要，谢谢！

🙂🙂🙂关注微信公众号：【芋道源码】有福利：

RocketMQ / MyCAT / Sharding-JDBC 所有源码分析文章列表

RocketMQ / MyCAT / Sharding-JDBC 中文注释源码 GitHub 地址

您对于源码的疑问每条留言都将得到认真回复。甚至不知道如何读源码也可以请教噢。

新的源码解析文章实时收到通知。每周更新一篇左右。

认真的源码交流微信群。

写长篇的人都碰过这件事，写到第五章模型就忘了主角叫什么。goink 是个装在桌面的小说写作应用，四百多 Star，AGPL-3.0。

仓库首页

官方把内核写成三个短语，Agent 实时决策、结构化记忆、写完自检状态。三句说的是同一个动作，把长篇的状态搬出对话，交给工具和状态表。

它跟通用 AI 聊天差在哪

通用 AI 换个话题就得重新交代设定，改完正文也不知道动了几处。

goink 把这三件换掉了。改动先生成 Diff，点确认才写进文件；找前文走本地语义搜索；版本历史是内置 Git，每次对话自动 commit。

七行对照表

官方 README 那张七行对照表把默认差异并排摆着。

写完一章，它自己回来检查

它给模型配了 31 个结构化工具，调哪个、传什么参数由模型自己定，查角色、查伏笔、读写正文都在同一段对话里。

正文落地后自动注入检查清单，逐项问角色有没有变化、伏笔收了没有、弧线要不要推进、读者认知要不要更新。

维护分三层，提示词写死流程，写完注入检查项，最后由审稿子 Agent 审读章节与状态。

长篇的六个状态，它替你记着

角色档案存性格、能力、背景，关系是有向图两边各算一条，旧记录保留。伏笔记目标回收章节与重要程度，快到点提醒，超时标异常，章节计划分三档。

弧线是一串节点，各挂目标章节，写完一章自动推进，通常三五条并行。

弧线看板

世界观的地点画成图，层级包含与空间连通都记，详情与子地点与地图都能查。

地点图谱

读者认知记读者已知什么、在等哪个答案、误认了什么；创作偏好分全局与单书两层，说一次就够。

翻前文不用逐章翻

第五十章要找主角第一次见到吊坠在哪一章，不必逐章翻，问一句就能在整本书里捞出来。

它比的不是字面，你没写「吊坠」却暗示它的段落也能被翻出来。

整套引擎都在本机跑，中文模型走 ONNX 推理，向量索引放进 sqlite-vec，重排用 MMR 去重。

贴一段样文，学会一种笔法

贴一段样文，它从句式结构、用词习惯、修辞手法、节奏控制、叙事距离、氛围语调六个维度拆开，生成一个仿写 Skill。

风格蒸馏

生成的 Skill 进列表，斜杠命令加载一次就生效。

技能能加，卷能拖，改动都留痕

一个 Skill 是带头部元数据的 md 文件，同名按小说、用户、内置三层覆盖；长篇要分卷，卷序能拖，章节能跨卷搬或同卷内重排；两层沙箱只放行 chapters 与 outlines 与 goink.md。

装之前要知道的三件事

一是装法。GitHub Releases 按平台给包，Windows 跑安装程序，macOS 拖进 Applications，Linux 跑 AppImage；包不到 60MB，不要 Python 与 Node 与数据库与显卡，Windows 包没签名，SmartScreen 会拦一下。

二是钥匙。它不带模型，要自备 LLM API Key，内置 DeepSeek、GLM、MiMo 模板，也兼容 OpenAI 格式。自己编译就先装 GTK 与 WebKit 开发包，再走这几步。

git clone https://github.com/sigpanic/goink
cd goink
make deps
make build

三是许可。它是 AGPL-3.0，不是 MIT，要改一版拿去商用，先把条款读完。

项目才四百多 Star，挂着十几个没关的 issue。但它把写作工具的难题从「让模型更聪明」挪到了「让模型自己回来检查」。