sigpanic/goink

해결하는 문제

Goink은 장편 소설 작성을 위한 데스크톱 AI 작문 시스템입니다. 일반적인 LLM에서 발생하는 '기억 상실' 문제를 해결합니다. 수십 개의 장을 넘어서도 AI가 등장인물 이름, 플롯 포인트, 서사적 예고를 잊어버리는 문제를 해결합니다. 이야기 요소를 수동으로 추적하거나 이전 장을 수동으로 검색하여 일관성을 유지할 필요가 없습니다.

작동 방식

Goink은 커스텀 ReAct 루프와 31개의 구조화된 도구를 갖춘 에이전트 기반 아키텍처를 사용합니다. 선형 파이프라인 대신 AI 에이전트가 자율적으로 어떤 도구를 사용할지 결정하여 등장인물 프로필을 조회하거나 플롯 아크를 업데이트하거나 텍스트를 읽고 씁니다.

핵심 기술 구성 요소:

• 구조화된 메모리: 등장인물 간 관계(방향 그래프로), 예고 상태, 서사적 아크, 세계관 구축(장소 계층), 독자 지식을 전용으로 추적.
• 로컬 의미 검색: ONNX Runtime과 sqlite-vec를 사용하는 로컬 엔진으로 인터넷 연결 없이 전체 원고를 의미 기반으로 검색 가능.
• 스킬 시스템: 마크다운 파일로 작문 방법론을 정의하는 모듈식 시스템으로, 세 가지 수준의 오버라이드(소설 > 사용자 > 내장)와 세 가지 트리거 모드(자동, 수동, 항상)를 지원.
• 승인 워크플로우: 원하지 않는 변경을 방지하기 위해 텍스트 편집 시 Diff 미리보기를 생성하고, 디스크에 쓰기 전에 사용자 승인이 필요합니다.
• ListNode: 자동 커밋과 버전 기록을 제공하는 내장 Git 통합 기능.

대상 사용자

수십만 단어에 이르는 복잡한 이야기 구조를 유지하고, 엄격한 서사 일관성을 유지해야 하는 소설가 및 픽션 작가를 위한 시스템입니다.

주요 기능

• 자율적 유지보수: 장이 작성된 후 자동으로 등장인물 및 플롯 업데이트를 트리거하며, 일관성을 보장하기 위한 선택적 '리뷰 에이전트'를 별도로 실행 가능.
• 스타일 추출: 샘플 텍스트를 분석해 문장 구조, 톤 등 작문 스타일 패턴을 추출하고, AI가 따를 수 있는 맞춤형 '이미테이션 스킬' 생성 가능.
• 제로 구성 설정: Python이나 GPU가 필요 없는 스탠드얼론 데스크톱 앱(Wails/Go)으로 배포.
• 사전 보안: 정규표현식 화이트리스트와 SafePath를 사용해 AI가 시스템의 허용되지 않은 파일에 접근하거나 수정하는 것을 방지.