EthanYoQ/AI-Novel-Writer

AI 小说创作软件：把灵感、角色、世界观、大纲、章节写作、审稿和修稿组织成可控流程；提供 Windows/macOS 桌面版，支持本地和在线模型。AI Novel Writing Software: Organizes inspirations, characters, worldbuilding, outlines, chapter drafting, review, and revision into a controllable workflow. Features desktop apps for Windows/macOS, Ollama integration, and a DeepSeek Harness (DSH) plugin preview.

AI Novel Writer – 개요

AI Novel Writer (中文名 AI 小说作家)는 대규모 언어 모델 생성기를 활용하여 장편 소설 제작을 돕는 데스크톱 애플리케이션입니다. 이 앱은 자체적으로 모델을 호스팅하지 않으며, OpenAI 호환 엔드포인트(OpenAI, DeepSeek, Ollama, NovelAI 등) 또는 Google Gemini 엔드포인트를 지정하고 프롬프트, 컨텍스트, 수정 주기를 로컬에서 조정합니다.

도구가 하는 일

기능	사용자에게 의미
구조화된 워크플로우	앱은 전제 → 등장인물 → 세계관 구축 → 개요 → 챕터 청사진 → 초고 → 검토 → 수정 → 최종 원고의 선형 파이프라인을 안내합니다. 모든 결과물은 사용자가 제어하는 프로젝트 폴더에 저장됩니다.
챕터 수준 생성	모델에게 챕터 작성을 요청하면 프로그램은 현재 챕터의 청사진, 관련 등장인물 카드, 세계관 정보 및 참고 자료를 포함한 컨텍스트를 구축하여 소설 전체를 한 번에 제공하지 않습니다.
실패 복구	생성 호출이 실패하면 부분적으로 생성된 텍스트는 복구 후보 로 로컬 SQLite 데이터베이스에 저장됩니다. 공식 초고를 손상시키지 않고 검사하거나 폐기할 수 있습니다.
자동 검토 및 수정	초고가 생성된 후 앱은 모델에게 구조화된 검토 보고서 생성을 요청할 수 있습니다. 해당 보고서는 "수정" 단계에 피드백되어 작가의 참여를 유지합니다.
역할/세계관 관리	전용 패널에서 등장인물 카드와 세계관 노트를 생성, 편집, 연결하고 개요와 동기화할 수 있습니다.
배치 챕터 작업	연속된 여러 챕터(1-10)를 작성하는 작업을 시작하고 언제든지 일시 중지하거나 취소할 수 있습니다.
다국어 UI	인터페이스는 중국어와 영어로 제공되며 언어 선택은 세션 간에 유지됩니다.
DeepSeek Harness 플러그인	DeepSeek Harness 플랫폼용 매우 제한적인 웹 기반 플러그인(`@ethanyoq/dsh-ai-novel-writer`)이 존재하지만 최소한의 "제안-검토-적용" 루프만 구현하며 0.1.0에서 동결되었습니다.

내부 작동 방식

모델 어댑터 – 앱은 두 가지 API 제품군을 지원합니다:
- OpenAI 호환 (OpenAI, DeepSeek, Ollama, NovelAI, Azure 등)
- Google Gemini 네이티브 프로토콜 기본 URL, 모델 이름, API 키는 로컬 JSON 파일(~/.vela/models.json)에서 구성합니다.
로컬 저장소 – 프로젝트, 초고, 등장인물 시트, SQLite 데이터베이스(.vela 폴더)는 전적으로 사용자 컴퓨터에 저장됩니다. 개발자 서버로 데이터가 전송되지 않습니다.
프롬프트 템플릿("스킬") – 각 단계(계획, 초고 작성, 검토, 다듬기)에 대해 모델이 사용할 사용자 지정 프롬프트 템플릿을 첨부할 수 있습니다. 이를 통해 특정 스타일이나 구조를 강제할 수 있습니다.
전체 텍스트 검색 – 가져온 참조 텍스트는 SQLite FTS로 인덱싱되어 벡터 스토어 임베딩 없이도 구절을 빠르게 검색할 수 있습니다.

누가 혜택을 볼 수 있나요?

클라우드 전용 SaaS 플랫폼을 거부하고 AI 지원을 원하는 소설가.
개인 또는 독점 데이터로 작업하는 작가 – 모든 것이 기기에서 처리되기 때문입니다.
재현 가능한 프로젝트 트리가 필요한 팀 – 앱은 모든 단계를 기록하여 원고를 백업하거나 인계하기 쉽게 만듭니다.

시작하기(빠른 체크리스트)

다운로드 – GitHub Releases 페이지에서 적절한 설치 프로그램을 받습니다(Windows .exe 또는 macOS .dmg).
설치 – 설치 프로그램은 앱을 업데이트하지만 기존 프로젝트 폴더는 변경하지 않습니다.
모델 구성 – 설정을 열고 OpenAI 호환 또는 Gemini를 선택한 후 엔드포인트 URL, 모델 이름, API 키를 입력합니다.
새 프로젝트 생성 – 전제, 등장인물, 세계관을 정의하고 개요를 생성합니다.
챕터 생성 – "챕터 청사진 → 초고" 단계를 실행하고 AI가 생성한 초고를 검토하며 필요시 자동 검토를 실행하고 만족할 때까지 반복합니다.

유의해야 할 제한 사항

앱은 모델 호스팅을 제공하지 않습니다. 로컬 추론 서버(예: Ollama) 또는 활성 클라우드 API 키가 있어야 합니다.
DeepSeek Harness 플러그인은 미리보기이며 데스크톱 버전 기능의 약 10%만 제공합니다.
내장된 출판 플랫폼이 없습니다 – 최종 원고는 직접 내보냅니다.
Windows 설치 프로그램은 서명되지 않았고 macOS 빌드는 ad-hoc 서명만 되므로 OS 경고를 우회해야 할 수 있습니다.

라이선스 및 커뮤니티

데스크톱 애플리케이션은 GPL-3.0으로 릴리스되었습니다.
DeepSeek Harness 플러그인은 MIT 라이선스이며 npm에 @ethanyoq/dsh-ai-novel-writer로 게시되었습니다.
이슈, 기능 요청, 릴리스 공지는 GitHub 리포지토리를 통해 처리됩니다.

요약: AI Novel Writer는 프롬프트 관리, 챕터 수준 생성, 검토 루프, 프로젝트 수준 구성을 통합하고 모든 데이터를 작가의 통제 하에 유지하는 진정한 로컬 실행 AI 지원 소설 작성 워크스테이션입니다.