covel

Covel은 모듈식 에이전틱 AI 롤플레잉 게임 프레임워크이자 플레이 가능한 스튜디오입니다. 아키텍처는 커널(스케줄링, 컨텍스트 조립, 도구, 검증, 지속성, 렌더링), 플러그인 패키지(에이전트 및 함수 런타임, UI, 스키마, 도구, 이벤트, 프로젝션, 라이프사이클 훅과 같은 게임플레이 동작), 휴대형 월드 팩(세계관, 캐릭터, 규칙, 플러그인 기본값, 메모리 블록, 퀘스트, 아이템, 초상화, 장면)으로 분리됩니다. 두 가지 플레이 모드가 포함되어 있습니다. Stage 모드는 장면 배경, 캐릭터 스프라이트, 타자기 대화, 선택지 오버레이, 새 장소에 대한 필요 시 배경 생성을 갖춘 전체 화면 비주얼 노벨입니다. Story 모드는 내레이션 턴, 제안된 행동, 인라인 폼, 턴별 에이전트 타임라인을 갖춘 텍스트 기반 모드입니다. 플러그인은 고정된 역할이 아니라 기능 패키지입니다. 번들된 예시에는 narrator, codex, core-quest 같은 에이전트 런타임, pregame, dice-check/roller, scene-cast 같은 함수 런타임, npc-graph 및 이미지 생성 같은 혼합 패키지, cost-gate, story-guard, director 같은 라이프사이클 훅, memory, character-blueprint, character-presence 같은 UI 또는 데이터 계약이 포함됩니다. 커널은 구체적인 플러그인 ID에 분기하지 않고 기능과 outputKind를 탐색하므로 구성 요소를 계속 교체할 수 있습니다. 내장 RPG 메커니즘에는 사전 굴림 주사위 체크와 보이는 산술 영수증, 자동 추적 퀘스트 로그, 플레이어 관리 인벤토리, NPC별 호감도 게이지가 포함됩니다. 이 모두는 선택적 플러그인이며, 월드가 시작 퀘스트, 초기 장비, 초기 호감도를 설정할 수 있습니다. 각 턴 후에는 공유 WorldIR 사실 프로젝션을 통해 퀘스트, 인벤토리, 호감도, codex, 관계 플러그인이 동일한 증거를 재사용할 수 있습니다. 월드 팩은 world.yaml, WORLD.md, WorldData 임포트를 통해 선언됩니다. pluginPolicy는 플러그인을 필수, 권장 또는 제외로 표시할 수 있으며, memoryBlocks는 단서나 신호 로그 같은 장르별 메모리를 추가할 수 있습니다. 이 프레임워크는 zh-CN, en-US, ru-RU UI 카탈로그를 제공하며, 플러그인 지침, 월드 파일, 캐릭터 데이터, 규칙의 현지화와 정식 소스로의 폴백을 지원합니다. Trace Inspector는 실행을 세션과 턴별로 그룹화하여 런타임, 플로우, LLM 요청, 도구, 메시지, 상태, 훅 이벤트와 함께 Session Data 및 Cost 뷰를 노출합니다. 저장은 디스크의 SQLite를 사용한 로컬 우선 방식입니다. Web 모드는 API 키를 브라우저 localStorage에 보관하고, 데스크톱 모드는 ~/.covel/keys.env에 평문으로 저장합니다. 이 프로젝트는 macOS Apple Silicon과 Windows x64용 데스크톱 빌드를 제공하며, 소스는 pnpm을 통해 웹 및 서버 대상으로 실행됩니다. 번들된 월드 팩에는 Mistport Chronicles, Haruka Academy, Emberback Relay가 포함됩니다. 작성자는 AI Create World 플로우로 월드 팩을 생성하거나 create-plugin으로 플러그인을 스캐폴딩할 수 있습니다. 현재 릴리스 v0.0.32는 얼리 액세스이며, API, 월드 데이터, 플러그인 매니페스트는 버전 간에 변경될 수 있습니다. 이 프로젝트는 MIT 라이선스이며 커뮤니티 허브와 마켓플레이스 기능은 로드맵에 있습니다.