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 無法存取或修改系統中未授權的檔案。