uu201/character-arc

CharacterArc(弧光) AI 小说创作应用，集项目设定、角色关系、剧情大纲、章节写作与多模型 AI 协作于一体

📚 CharacterArc 는 무엇인가요?

CharacterArc (弧光)는 소설 작가들이 프로젝트를 조직하고 대규모 언어 모델(LLM) 서비스와 협업할 수 있도록 도와주는 Windows/macOS 데스크톱 애플리케이션입니다. 단순한 채팅 창이 아니라, 세계관 데이터 저장, 플롯 개요 작성, 장 편집, AI 기반 보조 도구(Skills라고 함)를 통해 텍스트 생성, 정제, 분석이 가능한 완전한 작문 작업 공간을 제공합니다. 모든 데이터는 로컬 SQLite 데이터베이스에 저장되므로 원고에 대한 완전한 통제권을 유지할 수 있습니다.

✨ 핵심 기능

영역	제공 기능
프로젝트 관리	개별 소설 프로젝트를 생성할 수 있으며, 각각 고유한 설정, 지식 기반, AI 실행 로그를 갖습니다.
세계관 구축 및 관계	등장인물, 조직, 설정을 위한 구조화된 테이블; 시각적 관계 그래프(Cytoscape).
플롯 개요	이중 열 타임라인 뷰, 드래그 앤 드롭 정렬, AI 지원을 통한 개요 노드 확장.
장 작업 공간	세 개의 패널 레이아웃 – 파일 트리, 리치 텍스트 에디터(TipTap), AI 사이드패널. 자동 저장, 버전 스냅샷, 단어 수 목표, 집중/읽기 모드, `.txt` 또는 `.docx`로 내보내기 지원.
AI 보조 기능	• 초안 생성, 연속 작성, 재작성, 정제, 페이스 조정.
• 요약, 힌트 탐지, 다음 장 제안.
• 다단계 "초안 → 검토 → 수리" 파이프라인.
• 에이전트 루프: 모델이 작업에 따라 적절한 Skill을 자동으로 선택하고 실행.
Skill 시스템	내장된 28개의 Skills 패키지(예: 장편 작문, 스타일 지문 추출, AI 탐지 회피). 프로젝트별로 사용자 정의 Skill 패키지를 가져올 수 있습니다.
커버 디자이너	플랫폼별 커버 프롬프트 생성, 이미지 모델 호출, 버전별 미리보기 비교.
로컬 우선 및 다중 공급자	OpenAI 호환 API(OpenAI, DeepSeek, Anthropic, Kimi 등) 및 Anthropic 전용 엔드포인트와 호환. 모든 요청은 설정 패널에서 설정한 구성 가능한 기본 URL과 API 키를 통해 전달됩니다.
데이터 프라이버시	모든 데이터는 로컬에 저장됩니다(`workspace.db`는 Electron 사용자 데이터 폴더 내). 클라우드 동기화는 직접 추가해야 합니다.

🛠️ 기술 스택

프레임워크: Electron + Vue 3 (TypeScript) – 네이티브 느낌의 데스크톱 UI 제공.
상태 관리: Pinia.
UI 라이브러리: Naive UI.
리치 텍스트 에디터: TipTap(검색/치환, 서식, 선택 액션 지원).
지속성: SQLite(Electron 메인 프로세스에서 처리).
그래프 시각화: Cytoscape.
AI SDK: Vercel AI SDK (@ai-sdk/openai, @ai-sdk/anthropic).
빌드: electron-vite (Vite 7).
문서 파싱: mammoth(.docx), marked (Markdown).

🚀 시작하기 (Windows/macOS)

# 1. 사전 요구 사항 설치
#    Node 18+ 및 pnpm 10+

# 2. 종속성 설치
pnpm install

# 3. 개발 모드로 실행 (Electron + Vite 핫 리로드)
pnpm run dev

# 4. 프로덕션 빌드
pnpm run build

# 5. 설치 파일 패키징
pnpm run dist:win   # Windows NSIS 설치 파일
pnpm run dist:mac   # macOS DMG/ZIP (macOS에서 실행 필요)

최초 실행 후 설정 → AI로 이동하여 하나 이상의 API 설정(기본 URL, API 키, 모델 이름)을 추가하세요. 제목 표시줄에서 전환 가능합니다.

📦 Skill 패키지 (내장)

리포지토리는 resources/skills/ 아래에 세 그룹의 Skill(총 28개)을 포함하고 있습니다:

소스	예시 Skill	목적
`oh-story-claudecode`	`story-long-write`, `story-chapter-exec`	핵심 소설 작문 워크플로우(장편/단편, 장 실행, 커버 생성, AI 탐지 회피 등).
`community-skills`	`humanizer-zh`, `style-fingerprint`	중국어 자연스러운 표현, 스타일 추출 및 융합.
`Distilled-Novel-Toolbox`	`novel-pacing`, `novel-worldbuilding`, `novel-commercialization`	종합 소설 도구 상자 – 페이스 조절, 세계관 구축, 플랫폼별 상업적 조언, 준수, 감정 곡선 등.

각 Skill은 SKILL.md 설명과 프롬프트/템플릿 파일을 포함한 폴더입니다. 앱 시작 시 스캔됩니다. 프로젝트의 project-skills/ 디렉터리에 추가 Skill 폴더를 넣어 기능을 확장할 수 있습니다.

📄 라이선스

MIT 라이선스 – 자유롭게 사용, 수정, 배포 가능.

결론: CharacterArc는 모듈식 Skill 시스템을 통해 LLM을 밀접하게 통합한 로컬 실행형 Electron 기반 작문 환경으로, 중국어 소설 작가들에게 강력하고 프라이버시를 보호하는 AI 공동 작가를 제공합니다.