yuanbw2025/storyforge

故事熔炉 StoryForge — AI 小说创作工作台 / AI novel writing workshop

StoryForge – AI 기반 내러티브 제작 스위트

정의 – StoryForge("스토리 퍼니스")는 오픈 소스, 로컬 우선 웹 애플리케이션으로, 내러티브 작품(소설, 단편, 각본, 만화, 모션 드라마 팩, 세계관 구축 엔진, 테이블탑 RPG 경험)을 작성, 각색, 출판할 수 있습니다. React + TypeScript로 구축된 통합 UI를 제공하며 모든 데이터를 IndexedDB를 통해 브라우저에 저장하므로 완전히 오프라인으로 작업할 수 있습니다. AI 생성은 선택 사항입니다. 모든 LLM API(OpenAI 호환, Ollama, LM Studio 등)를 연결하거나 또는 로그인된 ChatGPT 세션을 재사용하는 로컬 "Codex" 브리지를 사용할 수 있습니다.


핵심 기능(README 설명 기준)

영역 할 수 있는 일 작동 방식
장편 소설 작성 모든 길이의 소설을 만들고, 설정, 캐릭터, 개요, 장별 작성, 그리고 사실, 복선, 캐릭터 상태를 추적하고 검색 가능한 컨텍스트를 제공하는 메모리 시스템을 관리합니다. 계층적 데이터 모델(원시 텍스트 → 구조화된 사실 → 요약 → 검색 인덱스). 컨텍스트 게이트웨이는 사용된 모든 소스를 기록하고, Harness는 AI 생성 텍스트를 채택하기 전에 작업 계약, 입력, 후보, 버전 검사를 기록합니다.
노드 기반 워크플로우(미리보기) 캔버스에서 데이터 소스, 프롬프트, 생성 단계를 시각적으로 연결하고 필요한 업스트림 노드만 실행하며 초안을 채택된 콘텐츠와 분리합니다. 노드는 동일한 장편 스킬 계약을 공유하므로 클래식 편집기나 노드 보기에서 동일한 AI 호출을 재사용할 수 있습니다.
단편 스토리 길이 목표, 장별 검토, 감사 로그, 모든 문제가 해결될 때까지 게시를 차단하는 최종 완료 검사를 갖춘 5~25천 단어 분량의 작품을 작성합니다.
각본 변환 원본 소설을 고정하고 사실과 인과 관계를 매핑한 다음 버전 관리된 각색 결정과 함께 구조화된 각본 장면(Fountain/FDX)을 생성합니다.
만화 제작 스토리를 스토리보드로 변환합니다: 페이지 → 패널 → 시각적 자산 → 타이프셋 말풍선. 시각적 자산은 출처가 추적되며 최종 내보내기는 PNG, WebP, CBZ 또는 PDF가 될 수 있습니다.
모션 드라마 팩 스토리에서 에피소드 수준의 바이블, 캐릭터/소품 목록, 비트 시트, 스토리보드를 생성하고 Seedance, Runway, LTX 등의 도구용 내보내기 패키지를 만듭니다.
세계관 엔진 재사용 가능한 세계 정의(설정, 캐릭터, 규칙)를 구축하고 불변 버전으로 봉인할 수 있습니다. 다른 제품(RPG, 챗봇, AI 타운)은 SourcePlan을 통해 특정 세계 버전을 읽고 읽은 내용을 정확히 기록합니다.
인터랙티브 제품(미리보기) • AI KP, 주사위 굴림, 비밀 처리를 갖춘 테이블탑 RPG.
• 지속적인 캐릭터 메모리를 갖춘 롤플레이 채팅.
• AI 타운 시뮬레이션(일일 일정, 관계).
• 텍스트 어드벤처, AVG, 오픈 월드 탐험가. 모두 동일한 Harness 기반 작업 로깅 및 버전 관리된 세계 읽기를 사용합니다.
플러그인 워크숍 .sfplugin 확장(함수 플러그인, 노코드 콘텐츠 팩, 종속성 잠금 번들)을 발견, 설치, 개발합니다.
모델 구성 클라우드 API(키/URL 입력) 또는 로그인된 ChatGPT 계정을 자동 감지하는 로컬 Codex 브리지를 선택합니다. UI에는 연결 테스트, 온도, 토큰 제한 등이 표시됩니다.
데이터 지속성 모든 작품, 백업, 미디어, 버전 테이블은 IndexedDB(Dexie 경유)에 저장됩니다. 내보내기 옵션: 텍스트는 Markdown, TXT, JSON; 만화는 PNG/WebP/CBZ/PDF; 각본은 구조화된 각본 파일.
문서 및 커뮤니티 다국어 README, 공식 웹사이트, 지식 베이스, B-스테이션 비디오 튜토리얼, Zhihu 칼럼, QQ 그룹, 플러그인 마켓플레이스.

누가 사용할까요?

사용 사례 관련 제품
소설(1만~10만+ 단어)을 쓰고 플롯 실을 추적 장편 편집기(메모리 및 검색 포함)
잡지용 단편을 제작 단편 편집기(길이 가드 포함)
소설을 제작용 각본으로 각색 각본 변환
스토리에서 만화책을 만들기 만화 파이프라인
모션 드라마 비디오용 전체 에피소드 스토리보드 생성 모션 드라마 팩
여러 게임을 구동하는 재사용 가능한 판타지 세계 구축 세계관 엔진 + 플러그인 워크숍
AI 게임 마스터로 테이블탑 캠페인 실행 RPG(AI KP) 미리보기
가상 타운에 지속적인 NPC 챗봇 배치 AI 타운 미리보기
사용자 정의 도구나 콘텐츠 팩으로 플랫폼 확장 플러그인 시스템

기술 하이라이트(README에서)

  • 프론트엔드 스택 – React, TypeScript, Vite, 상태 관리를 위한 Zustand, 리치 텍스트 편집을 위한 TipTap, 내장 3D 장면을 위한 Three.js.
  • 로컬 우선 스토리지 – Dexie / IndexedDB와 백업, 가져오기, 마이그레이션, 참조 재매핑을 처리하는 통합 PROJECT_TABLES 스키마.
  • Harness – 스킬 계약, 실행 계약(예산, 버전, 체크포인트)을 만들고 전체 요청/응답 주기를 기록하며 작성자 확인 후에만 다시 쓰는 중앙 실행 계층.
  • 컨텍스트 게이트웨이 – 모든 소스(CONTEXT_SOURCES)를 등록하고, 요청 시 컨텍스트를 조립하며, 감사 가능한 컨텍스트 매니페스트를 생성합니다.
  • 버전 보호 – AdoptionSchema 및 adopt()는 현재 소스 버전과 일치하는 후보만 수락되도록 보장합니다. 오래된 후보는 차단됩니다.
  • 플러그인 API – 미리보기 SDK 0.1, 플러그인은 .sfplugin으로 패키징됩니다. 데이터를 보존하면서 검사, 설치/제거할 수 있습니다.
  • 모델 어댑터 – OpenAI 호환 엔드포인트, Ollama, LM Studio, 그리고 API 키 없이 로그인된 ChatGPT 세션을 재사용하는 특수 "Codex" 브리지를 지원합니다.
  • 다국어 UI – README 및 UI 문자열은 9개 언어로 제공됩니다.
  • 오픈 소스 라이선스 – MIT.

시작하기(빠른 요약)

  1. 저장소를 클론 / 다운로드합니다.
  2. npm ci && npm run dev를 실행합니다(Node 24 권장) – 앱은 http://localhost:5173/storyforge/에서 제공됩니다.
  3. 또는 최신 GitHub 릴리스의 휴대용 ZIP을 사용합니다(npm 불필요).
  4. 웹 UI를 열고 새 장편(또는 다른) 프로젝트를 만듭니다.
  5. 설정 → 모델 및 로컬에서 모델을 구성합니다 – API 키/URL을 붙여넣거나 Codex 옵션을 선택합니다.
  6. 쓰기 시작합니다. AI 생성을 호출하면 Harness가 작업을 기록합니다. 후보를 검토한 다음 채택을 클릭하여 원고에 씁니다.
  7. 플러그인 워크숍을 사용하여 커뮤니티 제작 확장을 추가하거나 직접 개발합니다.

현재 상태

README에는 많은 인터랙티브 제품(RPG, AI 타운, AVG, 오픈 월드)이 미리보기 – 기능은 있지만 아직 검증 중이라고 명시되어 있습니다. 핵심 작성 도구(장편, 단편, 각본, 만화, 모션 드라마)에는 공식 진입점과 완전한 엔지니어링 "harness" 파이프라인이 있습니다.


요약: StoryForge는 AI 지원 내러티브 제작을 위한 풀스택, 브라우저 기반 플랫폼으로, 소설, 각본, 만화, 모션 드라마 자산, 재사용 가능한 세계 구축을 위한 엔드투엔드 파이프라인을 제공하며, 모두 선택적 로컬 우선 운영과 플러그인 생태계를 갖추고 있습니다. AI 증강 창작 분야의 진정한 오픈 소스 프로젝트입니다.

관련

  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트