notnotype/neuro-book

NeuroBook – AI 보조 집필 환경

소개 – NeuroBook은 AI 에이전트의 도움을 받아 장편 소설(또는 구조화된 서사)을 집필하면서 이야기 세계의 일관성을 유지할 수 있도록 돕는 데스크톱 우선 애플리케이션입니다. 소설을 하나의 소프트웨어 프로젝트로 취급하여 세계 상태, 플롯 개요, 원고를 일반 텍스트 Markdown과 로컬 SQLite 데이터베이스로 저장하며, World Engine을 통해 타임라인상의 어느 시점에서든 캐릭터, 장소, 자원의 정확한 상태를 재계산할 수 있습니다.

중요성 – 대규모 언어 모델은 짧은 문장을 생성하는 데는 능숙하지만, 긴 작품에서는 일관성이 흐려지거나, 심어둔 복선을 잊어버리거나, 산문에 기계적인 "AI 느낌"을 남기는 경향이 있습니다. NeuroBook은 다음과 같은 방법으로 이러한 문제를 해결합니다:

• 대화 메모리에 의존하는 대신 시간이 지남에 따라 진화하는 world state를 영구적으로 저장합니다.
• 복선의 배치부터 회수까지 모든 요소를 추적하는 commit-style의 "약속 원장"(promise ledger)을 제공합니다.
• 360개의 규칙을 가진 린팅 도구(llmlint)를 실행하여 전형적인 AI 생성 글쓰기의 결함을 감지하고 자동으로 수정합니다.
• AI 에이전트(리더, 작가, 연구원)에 대한 세밀한 제어 권한과, AI가 변경 사항을 적용하기 전에 명시적인 승인을 요구하는 3단계 워크플로우(토론 → 계획 → 적용)를 작가에게 제공합니다.

핵심 구성 요소

구성 요소	역할
World Engine	타임스탬프가 찍힌 스냅샷과 함께 주체(캐릭터, 왕국 등)를 저장합니다. 이벤트 소싱 로그를 통해 어느 시점의 상태든 재계산할 수 있습니다.
Plot Workbench	챕터, 장면, 인과 관계의 사슬을 정리하기 위한 시각적 "承载树"(스토리 구조 트리) 및 "因果树"(인과 관계 트리).
Multi-Agent Studio	구성 가능한 권한과 프롬프트를 가진 개별 AI 에이전트(리더, 작가, 연구원)를 실행하는 프레임워크.
llmlint	불필요한 단어, 기계적인 전환, 공식적인 문구 등을 표시하는 린터입니다. 많은 문제를 자동으로 복구할 수 있습니다.
Profile & Workflow editor	코드를 작성하지 않고도 에이전트의 컨텍스트, 도구, 단계별 작업을 정의할 수 있는 TSX 기반의 시각적 편집기.

설치 방법

• Windows – Releases 페이지에서 포터블 zip을 다운로드하고 Start Neuro Book.cmd를 실행합니다.
• Linux / macOS – 제공된 설치 스크립트 (curl … | sh)를 실행합니다.
• Docker / 다중 인스턴스 – NeuroBook Manager (bunx @notnotype/neuro-book-manager@canary)를 사용하면 격리된 인스턴스를 실행하고, 업데이트를 관리하며, 웹 UI를 통해 앱을 노출할 수 있습니다.
• 모든 설치 과정에서 환경 검사가 수행되며, 선호하는 LLM 제공업체와 API 키를 선택할 수 있습니다.

일반적인 워크플로우

1. 초기화 – 새로운 "책"을 생성하면 Markdown/TS 파일이 포함된 lorebook/, manuscript/, world-engine/ 폴더가 생성됩니다.
2. 세계 정의 – World Engine UI에서 캐릭터, 진영, 달력 등을 추가합니다. 각 변경 사항은 타임스탬프와 함께 기록됩니다.
3. 플롯 계획 – Plot Workbench를 사용하여 챕터 → 장면을 매핑하고 복선을 첨부합니다.
4. AI 에이전트 초대 – leader(플롯 계획), writer(초안 생성), researcher(사실 확인)를 구성합니다. UI에 인라인 제안이 표시되며, 작성 전에 승인 절차를 거칩니다.
5. 집필 – Markdown 원고를 직접 편집합니다. 통합된 AI가 선택한 텍스트를 다시 쓰거나, 이어 쓰기를 제안하거나, 린트 과정을 수행할 수 있습니다.
6. 감사 – 언제든지 과거의 세계 상태를 조회하거나, 약속 원장을 확인하거나, llmlint를 실행하여 산문을 정리할 수 있습니다.
7. 내보내기 – 완성된 책은 일반 Markdown으로 저장되며 PDF, ePub 또는 원하는 형식으로 컴파일할 수 있습니다.

대상 사용자

• 서사적 통제권을 잃지 않으면서 AI의 도움을 받고 싶은 소설가 및 세계관 구축가.
• 일관된 설정과 추적 가능한 플롯 복선이 필요한 게임 디자이너 또는 TRPG 제작자.
• 이야기를 소프트웨어 프로젝트처럼 다루는 방식(버전 관리, 린팅, 자동화된 검사)을 선호하는 사람.

커뮤니티 및 기여

• 공식 Discord, QQ 그룹 및 공개 문서 사이트(중국어 및 영어).
• 저장소는 약 15개의 워크스페이스(핵심 앱, 관리자, 다양한 라이브러리, llmlint 패키지 등)를 포함하는 모노레포입니다.
• 프롬프트 엔지니어링, UI 재설계, 문서화, 테스트 또는 비기술적인 커뮤니티 활동 등 기여를 환영합니다.

라이선스 – AGPL-3.0-only. 작성한 작품은 본인의 소유이며, NeuroBook 자체에 대한 수정 사항만 카피레프트 조항의 적용을 받습니다.

---

위의 모든 세부 정보는 저장소의 README에서 직접 가져온 것이며, 추가적인 기능은 추론되지 않았습니다.