Deng-m1/MaliangAINovalWriter

马良写作 AINoval — AI novel writer for Chinese webnovels（网文）| 多智能体AI小说创作平台：三级大纲、知识图谱一致性、30万字连载

📚 Maliang AI Novel Writer (AINoval)

무엇인가요 – 중국 웹소설 작가(또는 이러한 플랫폼 운영자)가 대규모 언어 모델(LLM)의 도움을 받아 장편 소설을 쓸 수 있도록 도와주는 오픈소스 웹 플랫폼입니다. 풍부한 텍스트 편집기, AI 기반 개요/장면 생성, 세계관 구축 도구, 사용자, 모델, 비용, 콘텐츠 모니터링을 관리할 수 있는 완전한 관리 콘솔을 통합하고 있습니다.

🎯 핵심 기능

기능	제공되는 기능
AI 기반 작문 보조기	한 번의 클릭으로 이어쓰기, 확장, 다듬기, 번역, 캐릭터 및 플롯 생성. OpenAI, Anthropic Claude, Google Gemini 및 개인 API 키를 통해 OpenRouter 호환 모델을 지원합니다.
계층적 콘텐츠 모델	4단계 계층 구조(작품 → 권 → 장 → 장면)를 지원하여 수십만 단어에 이르는 소설을 쉽게 정리할 수 있습니다.
세계관 구축 엔진	캐릭터, 장소, 아이템, 세력 등이 포함된 구조화된 '세계 설정 트리'를 AI로 생성하거나 편집 가능. 스냅샷으로 버전 관리하고 관계 그래프로 시각화할 수 있습니다.
프롬프트 및 프리셋 관리	사용자는 시스템 수준 및 개인 프롬프트를 저장하고, 모델 파라미터와 함께 재사용 가능한 프리셋으로 묶어 에디터 도구 모음에 표시합니다.
LLM 가시성 및 비용 추적	모든 모델 호출은 로그에 기록됩니다(프롬프트, 응답, 지연 시간, 토큰 사용량). 관리자는 로그를 쿼리하고 사용자/모델별 통계 및 비용 감사를 확인할 수 있습니다.
관리 대시보드	사용자/RBAC 관리, 공개 모델 풀 설정, 가격표, 구독/크레딧 처리, 콘텐츠 검토 워크플로우, 지식 추출 작업을 위한 별도의 Flutter Web 관리 UI.
AI 기반 플롯 개요 생성기 (Next Outline)	현재 장면에 대한 여러 가능한 이어짐을 생성하고, 개별 옵션을 다시 생성하며, 선택한 개요를 직접 원고에 적용할 수 있습니다.
지식 추출 / "책 분할"	기존 소설(업로드 또는 제3자 "Tomato Novel" 서비스를 통해)을 AI로 분석하여 스타일, 플롯, 캐릭터, 세계관 등 메타 지식을 개인 지식 기반으로 추출합니다.
분석 및 대시보드	실시간 문자 수, 작문 스타일, 토큰 소비 추세, 기능 사용 차트를 통해 작가가 생산성과 예산을 모니터링할 수 있습니다.

🛠️ 기술 스택

계층	기술
프론트엔드 (작가 UI)	Flutter Web, Flutter Quill 풍부한 텍스트 편집기, flutter_bloc / Provider 상태 관리, fl_chart 그래프, Dio HTTP, Hive & shared_preferences 로컬 캐시
프론트엔드 (관리 UI)	별도의 Flutter Web 앱 (`lib/admin_main.dart`)으로 동일한 스택을 사용하며, 테이블, 차트, 다이얼로그용 커스텀 위젯 추가
백엔드	Spring Boot 3 (WebFlux, 반응형), Java 21, Spring Security + JWT, 비동기 작업용 RabbitMQ
AI 오케스트레이션	LangChain4j (LLM 체인용 Java 래퍼), OpenAI, Anthropic, Gemini, OpenRouter 및 커스텀 엔드포인트 지원
데이터베이스	핵심 데이터용 MongoDB (반응형), 임베딩 기반 지식 추출용 Chroma 벡터 저장소
스토리지 / 서비스	Alibaba Cloud OSS & SMS (설정 가능), Docker-compose 배포, 선택적 벡터 저장소, RabbitMQ
컨테이너화	Docker 이미지에는 컴파일된 Spring-Boot JAR와 사전 빌드된 Flutter 웹 자산이 포함되며, `docker-compose.yml`은 MongoDB도 함께 시작합니다.

🚀 시작하기 (Docker 한 번 클릭)

리포지토리 복제 후 프로젝트 루트로 이동합니다.
예시 환경 파일 복사:
```
cp deploy/open/production.env.example deploy/open/production.env
```
파일을 편집 – MongoDB URI, JWT 시크릿, 사용할 LLM API 키를 설정합니다.
서버 JAR 파일 배치 (릴리스 페이지에서 다운로드) – deploy/dist/ainoval-server.jar에 배치합니다.

빌드 및 실행:

docker compose -f deploy/open/docker-compose.yml build
docker compose -f deploy/open/docker-compose.yml up -d

관리자 계정 생성 (컨테이너가 실행된 후 한 번만 실행):
```
# Windows
.\deploy\init-admin.bat
# Linux/macOS
chmod +x deploy/init-admin.sh && ./deploy/init-admin.sh
```
기본 자격 증명 – admin / 123456 – 즉시 변경해야 합니다.
저자 UI는 http://localhost:18080/ 또는 관리 콘솔은 http://localhost:18080/admin에서 열 수 있습니다.

👥 누구에게 적합한가요?

대상	왜 도움이 되는가
개인 작가	AI 지원 하에 초안 작성, 다듬기, 개요 생성이 빨라지고 장기적인 이야기 일관성이 유지됩니다.
작가 팀 / 스튜디오	공유된 세계 설정 트리와 지식 기반, RBAC를 통해 여러 작가가 하나의 시리즈에 공동 작업할 수 있습니다.
플랫폼 운영자	관리 패널을 통해 모델 풀, 비용 추적, 구독/크레딧 시스템, 콘텐츠 모니터링을 완전히 제어할 수 있습니다.
연구자 / 애호가	오픈소스 코드, Docker 배포, Java 중심의 AI 스택(LangChain4j)으로 LLM 기반 창작 도구 실험에 적합한 사전 환경입니다.

🤝 기여 방법

프로젝트는 일반적인 fork-branch-PR 워크플로우를 따릅니다. 이슈는 GitHub에서 추적되며, 커뮤니티 채팅용 QQ 그룹(ID 1062403092)이 안내되어 있습니다. 코드는 Apache 2.0 라이선스 하에 제공됩니다.

📌 결론

Maliang AINoval은 현대적인 Flutter Web 에디터와 Spring-Boot 백엔드를 결합한, 프로덕션 준비된 AI 소설 작문 플랫폼입니다. 다중 모델 LLM 오케스트레이션, 구조화된 세계관 구축, 그리고 광범위한 관리/가시성 도구를 갖추고 있습니다. 이는 AI 지원 콘텐츠 생성 분야에 진지하게 임한 실제 소프트웨어 프로젝트입니다.