Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

ย 
ย 

Repository files navigation

My Murder Mystery

์ƒ์„ฑ๋ชจ๋ธ๋กœ ๋งค ํŒ ์ƒˆ๋กœ ์“ฐ์ด๋Š” AI ์ธํ„ฐ๋ž™ํ‹ฐ๋ธŒ ์ถ”๋ฆฌ๊ฒŒ์ž„ DSL 26-2 Modeling โ€” Generative Model Team

15๊ธฐ ๋ฐฑ๊ฐ€์€ ยท ์•ˆ์žฌ๋ฏผ ใ€€|ใ€€ 16๊ธฐ ๊น€์šฉ์ง„ ยท ์ด์ค€ํฌ ยท ํ•œ์„œํ˜„

์ด ์ €์žฅ์†Œ๋Š” ์ค‘๊ฐ„๋ฐœํ‘œ ์‹œ์ (2026-09-02) ์˜ ์ฝ”๋“œ์ž…๋‹ˆ๋‹ค. ๋ฐœํ‘œ์ž๋ฃŒ๋Š” My_Murder_Mystery_์ค‘๊ฐ„๋ฐœํ‘œ.pdf.


Project Overview

๋จธ๋”๋ฏธ์Šคํ„ฐ๋ฆฌ๋Š” ์‚ฌ๋žŒ์ด ์‹œ๋‚˜๋ฆฌ์˜ค ํ•˜๋‚˜๋ฅผ ์“ฐ๋Š” ๋ฐ ์ˆ˜์‹ญ ์‹œ๊ฐ„์ด ๋“ ๋‹ค. ๊ทธ๋ ‡๊ฒŒ ์จ๋„ ํ•œ ๋ฒˆ ํ’€๋ฉด ๋๋‚œ๋‹ค โ€” ๋ฒ”์ธ์„ ์•„๋Š” ์ˆœ๊ฐ„ ์žฌํ”Œ๋ ˆ์ด ๊ฐ€์น˜๊ฐ€ ์‚ฌ๋ผ์ง„๋‹ค. ๊ทธ๋ž˜์„œ ์ด ์žฅ๋ฅด๋Š” ์ฝ˜ํ…์ธ  ๊ณต๊ธ‰์ด ์ˆ˜์š”๋ฅผ ๋ชป ๋”ฐ๋ผ๊ฐ„๋‹ค.

์šฐ๋ฆฌ๋Š” ์‚ฌ๊ฑดยท์šฉ์˜์žยท๋‹จ์„œยทํŠธ๋ฆญ์„ ์ƒ์„ฑ๋ชจ๋ธ์ด ๋งค ํŒ ์ƒˆ๋กœ ๊ตฌ์„ฑํ•˜๊ฒŒ ํ–ˆ๋‹ค. ๋ฌธ์ œ๋Š” "๊ทธ๋Ÿด๋“ฏํ•œ ์ด์•ผ๊ธฐ"๋ฅผ ๋งŒ๋“œ๋Š” ๊ฒŒ ์•„๋‹ˆ๋ผ ํ’€ ์ˆ˜ ์žˆ๋Š” ์‚ฌ๊ฑด์„ ๋งŒ๋“œ๋Š” ๊ฒƒ์ด๋‹ค. ์ถ”๋ฆฌ๊ฐ€ ์„ฑ๋ฆฝํ•˜๋ ค๋ฉด ๋‹จ์„œ๋“ค์ด ๋…ผ๋ฆฌ์ ์œผ๋กœ ํ•œ ์‚ฌ๋žŒ๋งŒ ๊ฐ€๋ฆฌ์ผœ์•ผ ํ•˜๊ณ , ๋‚˜๋จธ์ง€ ๋„ท์€ ์˜์‹ฌ์Šค๋Ÿฝ๋˜ ๊ฒฐ๊ตญ ํ˜์˜๋ฅผ ๋ฒ—์–ด์•ผ ํ•œ๋‹ค. ์†Œ์„ค์€ ํ‹€๋ ค๋„ ์ฝํžˆ์ง€๋งŒ ์ถ”๋ฆฌ๋Š” ํ‹€๋ฆฌ๋ฉด ๊ฒŒ์ž„์ด ๊นจ์ง„๋‹ค.

๊ทธ๋ž˜์„œ ์ด ํ”„๋กœ์ ํŠธ์˜ ์ค‘์‹ฌ์€ ์ƒ์„ฑ๊ณผ ๊ฒ€์ฆ์„ ๋ถ„๋ฆฌํ•œ ํŒŒ์ดํ”„๋ผ์ธ์ด๋‹ค.

์ƒ์„ฑ ์›์ž‘ ํ•œ ์ค„ โ†’ ์‚ฌ๊ฑด 1๊ฐœ. ์ธ๋ฌผยท๋‹จ์„œยทํŠธ๋ฆญยท์—”๋”ฉ์„ LM์ด ์“ด๋‹ค
๊ตฌ์กฐ MMO(์ˆ˜๋‹จยท๋™๊ธฐยท๊ธฐํšŒ)๋ฅผ ๋‹จ์„œ ๊ทธ๋ž˜ํ”„๋กœ ์˜ฎ๊ฒจ, ๊ฐ ๋‹จ์„œ๊ฐ€ ๋ˆ„๊ตฌ๋ฅผ ๊ฐ€๋ฆฌํ‚ค๊ณ  ๋ˆ„๊ตฌ๋ฅผ ํ˜์˜์—์„œ ๋ฒ—๊ธฐ๋Š”์ง€ ๋ช…์‹œ
๊ฒ€์ฆ ํƒ€์ž„๋ผ์ธ ๋ชจ์ˆœ ยท ํ•ด์˜ ์œ ์ผ์„ฑ ยท ์˜์‹ฌ๋„ ๊ท ๋“ฑ ยท ๋‚œ์ด๋„๋ฅผ ์ฝ”๋“œ๊ฐ€ ํŒ์ •
ํ”Œ๋ ˆ์ด ์šฉ์˜์ž 5์ธ์„ ๋‹ค์ค‘ ์—์ด์ „ํŠธ๋กœ ์„ธ์šฐ๊ณ , ๋งํˆฌ๋Š” LM์ด ์“ฐ๋˜ ๋ฌด์—‡์„ ๋งํ• ์ง€๋Š” ์ฝ”๋“œ๊ฐ€ ์ •ํ•œ๋‹ค

Pipeline

INPUT                SCENARIO             ENGINE                CLIENT
์ „๋ž˜๋™ํ™”ยท์›์ž‘ ๋ฐฐ๊ฒฝ  โ†’  ๊ฐ์ƒ‰ํ•œ ์‚ด์ธ์‚ฌ๊ฑด  โ†’  FastAPI           โ†’  React ยท Vercel
๋ฒ”์ฃ„ ํ†ต๊ณ„ ๋ฐ์ดํ„ฐ       cast ยท clue_graph    ์„ธ์…˜ = ํ•œ ํŒ          ํ™”๋ฉด 24๊ฐœ
                       trick ยท secrets      REST 19๊ฐˆ๋ž˜
       โ†“                     โ†“                   โ†“
   ์‚ฌ๊ฑด์˜ ๊ธฐ๋ณธ ๊ตฌ์กฐ      MMO ๋‹จ์„œ ๊ทธ๋ž˜ํ”„      ๋ผ์šด๋“œยทํ„ด์ˆ˜ยท๊ณต๊ฐœ
   (ํ”ผํ•ด์ž, ์šฉ์˜์ž 5,    + ๊ฒ€์ฆ ํ†ต๊ณผ๋ณธ        ๋Œ€์งˆยท์กฐํ•ฉยทํŒ์ •
    ํŠธ๋ฆญ, ๋™๊ธฐ)
                             โ†“
                   IMAGE (FLUX 2) ยท BGM (Stable Audio 3)

1. Dataset

๋‚ด์šฉ ๋ฐ์ดํ„ฐ์…‹ ์ถœ์ฒ˜
์ถ”๋ก  ๊ตฌ์กฐ MuSR โ€” ์‚ฌ์‹ค ํŠธ๋ฆฌ๋ฅผ ๋‹จ์„œ ๊ทธ๋ž˜ํ”„ ์„ค๊ณ„์— ๊ทธ๋Œ€๋กœ ์˜ฎ๊น€ Zayne-sprague/MuSR ยท TAUR-Lab/MuSR
์‚ฌ๊ฑด ์ฝ”ํผ์Šค WhoDunIt ยท DetectiveQA ยท True Detective โ€” ์ƒ์„ฑ ์‹œ๋“œ ๊ฒธ ํ‰๊ฐ€ ๋ฒค์น˜๋งˆํฌ kjgpta/WhoDunIt ยท Phospheneser/DetectiveQA ยท TartuNLP/true-detective
๋‹ค์ธ ์šฉ์˜์ž PLAYER โ€” ๅ‰งๆœฌๆ€ ๊ทน๋ณธ. ๋‹ค์ธ ์šฉ์˜์ž๊ฐ€ ๊ฐ์ž ๋น„๋ฐ€์„ ๊ฐ–๋Š” ์‹ค๋ฌผ ๊ตฌ์กฐ alickzhu/PLAYER
ํŠธ๋ฆญ ยท ๋™๊ธฐ ์‚ฌ๊ฑด ์•„์นด์ด๋ธŒ ยท ๊ฐ•๋ ฅ๋ฒ”์ฃ„ ํ†ต๊ณ„ โ€” ํŠธ๋ฆญ ๋ถ„๋ฅ˜์™€ ๋™๊ธฐ์˜ ํ˜„์‹ค ๋ถ„ํฌ ์œ„ํ‚ค ์•„์นด์ด๋ธŒ ยท murderdata.org
๋ฐฐ๊ฒฝ ยท ์‹ฌ๋ฌธ FairytaleQA ยท Gutenberg ยท ํ•œ๊ตญ ๊ณ ์ „ ยท RoleBench โ€” ์›์ž‘ ์„ธ๊ณ„๊ด€๊ณผ ์ธ๋ฌผ ๋งํˆฌ uci-soe/FairytaleQAData ยท ZenMoore/RoleBench
ํ˜„์žฅ ์กฐ์‚ฌ ๋ณด๋“œ๊ฒŒ์ž„ ์นดํŽ˜ ๋จธ๋”๋ฏธ์Šคํ„ฐ๋ฆฌ ํ”Œ๋ ˆ์ด โ€” ๋ผ์šด๋“œ ๊ตฌ์„ฑยทํ–‰๋™ ์ œํ•œยท๋Œ€์งˆ ๊ทœ์น™ ํ˜„์žฅ ๋‹ต์‚ฌ ยท ์ˆ˜์ž‘์—…

2. MMO Structure โ€” ๋‹จ์„œ ๊ทธ๋ž˜ํ”„

์ถ”๋ฆฌ๊ฐ€ ์„ฑ๋ฆฝํ•˜๋Š” ์ตœ์†Œ ์กฐ๊ฑด์„ ์ž๋ฃŒ ๊ตฌ์กฐ๋กœ ๊ณ ์ •ํ–ˆ๋‹ค. ๋‹จ์„œ๋งˆ๋‹ค ๋„ค ๊ฐ€์ง€๋ฅผ ๋ช…์‹œํ•œ๋‹ค.

MEANS      ์ˆ˜๋‹จ    ํ‰๊ธฐ ยท ์ ‘๊ทผ๊ถŒ
MOTIVE     ๋™๊ธฐ    ์ดํ•ด๊ด€๊ณ„ ยท ๋น„๋ฐ€          โ†’   ์„ธ ์ถ•์„ ๋ชจ๋‘ ๋งŒ์กฑํ•˜๋Š” ์ธ๋ฌผ = ๋ฒ”์ธ
OPPORTUNITY ๊ธฐํšŒ   ๋™์„  ยท ์•Œ๋ฆฌ๋ฐ”์ด
ํ•„๋“œ ๋œป
points_to ์ด ๋‹จ์„œ๊ฐ€ ๊ฐ€๋ฆฌํ‚ค๋Š” ์ธ๋ฌผ
exculpates ์ด ๋‹จ์„œ๋กœ ํ˜์˜๋ฅผ ๋ฒ—๋Š” ์ธ๋ฌผ
decisive ์Šน๋ถ€๋ฅผ ๊ฐ€๋ฅด๋Š” ๋‹จ์„œ์ธ๊ฐ€
forced_by ์–ด๋–ค ๋‹จ์„œ๊ฐ€ ์ด ๋น„๋ฐ€์„ ์—ด๊ฒŒ ํ•˜๋Š”๊ฐ€
channel ์–ป๋Š” ๊ฒฝ๋กœ (ํ˜„์žฅยท์กฐ์‚ฌยท์‹ฌ๋ฌธยท๋Œ€์งˆยท์กฐํ•ฉ)
reveal_round ๋ช‡ ๋ผ์šด๋“œ๋ถ€ํ„ฐ ๋‹ฟ์„ ์ˆ˜ ์žˆ๋Š”๊ฐ€

์ „์ฒด ์Šคํ‚ค๋งˆ๋Š” docs/์Šคํ‚ค๋งˆ.md.

3. ์‹ฌ๋ฌธ โ€” ์ฝ”๋“œ๊ฐ€ ํŒ์ •ํ•˜๊ณ  LM์ด ์“ด๋‹ค

์šฉ์˜์ž 5์ธ์€ ๊ฐ์ž ํŽ˜๋ฅด์†Œ๋‚˜์™€ ์žฅ๊ธฐ๊ธฐ์–ต์„ ๊ฐ–๋Š” ์—์ด์ „ํŠธ๋‹ค. ๋‹ค๋งŒ "๋ฌด์—‡์„ ๋งํ• ์ง€"๋ฅผ LM์— ๋งก๊ธฐ์ง€ ์•Š๋Š”๋‹ค. ํ”Œ๋ ˆ์ด์–ด๊ฐ€ ๋“ค์ด๋Œ„ ์ฆ๊ฑฐ์™€ ์••๋ฐ• ๊ฒŒ์ด์ง€๋กœ ์ฝ”๋“œ๊ฐ€ ํƒœ๋„๋ฅผ ๋จผ์ € ์ •ํ•˜๊ณ , LM์€ ๊ทธ ํƒœ๋„๋Œ€๋กœ ๋ฌธ์žฅ๋งŒ ์“ด๋‹ค.

ANSWER โ†’ DEFLECT โ†’ FLINCH โ†’ ADMIT โ†’ BREAK
๋‹ตํ•œ๋‹ค   ํ”ผํ•œ๋‹ค    ํ”๋“ค๋ ธ๋‹ค  ์‹คํ† ํ–ˆ๋‹ค  ๋ฌด๋„ˆ์กŒ๋‹ค

์‹คํ† ํ•˜์ง€ ์•Š์•„์•ผ ํ•  ๊ฒƒ์„ ํ˜๋ ธ๋Š”์ง€, ์งˆ๋ฌธ์— ์—‰๋šฑํ•œ ๋‹ต์„ ํ–ˆ๋Š”์ง€, ์•Œ๋งน์ด ์—†์ด ๋‘˜๋Ÿฌ๋Œ”๋Š”์ง€๋ฅผ ์ฝ”๋“œ๊ฐ€ ์‚ฌํ›„ ๊ฒ€์‚ฌํ•ด์„œ ๊ฑธ๋ฆฌ๋ฉด ๋‹ค์‹œ ์“ฐ๊ฒŒ ํ•œ๋‹ค. (src/stance.py, src/play_agents.py, src/guard.py)

4. Agent-based Validation

์‚ฌ๋žŒ์ด 50ํŽธ์„ ๋‹ค ํ’€์–ด ๋ณผ ์ˆ˜ ์—†์œผ๋ฏ€๋กœ ์—์ด์ „ํŠธ๊ฐ€ ๋Œ€์‹  ํ‘ผ๋‹ค.

๋ชฌํ…Œ์นด๋ฅผ๋กœ 50ํŽธ ร— ๊ฐ 600ํšŒ ์‹œ๋ฎฌ๋ ˆ์ด์…˜์œผ๋กœ ๋‚œ์ด๋„ ์ธก์ •
์ „๋žต ์—์ด์ „ํŠธ 5์ข… ์ฒด๊ณ„์  ํƒ์ƒ‰ ยท ์กฐ๊ธฐ ์ง€๋ชฉ ยท ๋ฏธ๋ผ ์ถ”์ข… ยท ์†Œ๊ฑฐ๋ฒ• ยท ๋ฌด์ž‘์œ„
LLM ํŒ์ •์ž 6์ข… ํ˜•์‚ฌ ยท ๊ธฐ์ž ยท ๊ณผํ•™์ˆ˜์‚ฌ ยท ์‹ฌ๋ฆฌ ยท ๋ณ€ํ˜ธ์‚ฌ ยท ์ดˆ์‹ฌ์ž ํŽ˜๋ฅด์†Œ๋‚˜๊ฐ€ ์‹ค์ œ ํ”Œ๋ ˆ์ด ๋กœ๊ทธ๋ฅผ ์ฝ๊ณ  ๊ต์ •

src/simulate.py ยท src/eval_policies.py ยท src/measure_difficulty.py ยท src/stress_agent.py

5. Image / BGM

๋ชจ๋ธ ํ๋ฆ„
IMAGE FLUX 2 (Text-to-Image) Text/Reference โ†’ Mistral Text Encoder + VAE Encoder โ†’ Noise โ†’ Diffusion Transformer โ†’ VAE Decoder
BGM Stable Audio 3 (Text-to-Music) Text Prompt โ†’ Gemma Text Encoder โ†’ Noise โ†’ Diffusion Transformer โ†’ Audio Decoder

์‹œ๋‚˜๋ฆฌ์˜ค JSON์˜ ui.place_screens[].art.prompt_*, bgm.cues.*.prompt_en ์ด ๊ทธ๋Œ€๋กœ ํ”„๋กฌํ”„ํŠธ๋กœ ๋“ค์–ด๊ฐ„๋‹ค. ๋…ธํŠธ๋ถ์€ media/.

6. Custom Scenario Generator

ํ”Œ๋ ˆ์ด์–ด๊ฐ€ ์ปจ์…‰์„ ์ ์–ด ๋„ฃ์œผ๋ฉด ๊ทธ ์ž๋ฆฌ์—์„œ ํ•œ ํŽธ์„ ๋งŒ๋“ ๋‹ค. LLM API๋Š” CLOVA Studio.

์‚ฌ์šฉ์ž ์ปจ์…‰ ์ž…๋ ฅ โ†’ ์žฌ๋ฃŒ ์ƒ์„ฑ โ†’ ์กฐ๋ฆฝ assemble() โ†’ UI ํ…์ŠคํŠธยทBGM ๋ฐฐ์ •ยทnovel โ†’ ๊ฒ€์ฆ โ†’ ์ตœ์ข… ์ถœ๋ ฅ
์žฌ๋ฃŒ ์ƒ์„ฑ 4๋‹จ๊ณ„ ๋ชจ๋ธ ํ•˜๋Š” ์ผ
1 ๋ผˆ๋Œ€ HCX-007 (์ถ”๋ก ) ๋ฒ”์ธ ยท MMO ยท ๊ฑฐ์ง“๋ง ๋“ฑ ๋…ผ๋ฆฌ ๋ผˆ๋Œ€
2 ์ธ๋ฌผ ์„œ์‚ฌ HCX-005 ์ธ๋ฌผ ์„ฑ๊ฒฉ, ๋ฐฐ๊ฒฝ๊ณผ ์„œ์‚ฌ
3 ๋„์ž… ๋‚˜๋ ˆ์ด์…˜ HCX-005 ์‚ฌ๊ฑด ๊ฐœ์š” ๋ฐ ์š”์•ฝ
4 ๋‹จ์„œ ยท ์ •๋‹ต generate.py synthesize_mystery() ๊ฐ€ ์‚ฌ์‹ค๊ด€๊ณ„๋ฅผ ๋‹จ์„œ ๋ฐ์ดํ„ฐ๋กœ ๋ณ€ํ™˜

src/generate.py ยท src/llm_custom.py ยท src/build_custom.py


Output / Evaluation

ํ–‰๋™ ์˜ˆ์‚ฐ๋ณ„ ๋ฒ”์ธ ์ ์ค‘๋ฅ 

๋ผ์šด๋“œ๋‹น ํ–‰๋™ ํšŸ์ˆ˜๋ฅผ ๋ฐ”๊ฟ” ๊ฐ€๋ฉฐ 250ํŒ(5์ „๋žต ร— 50ํŽธ)์„ ๋Œ๋ ธ๋‹ค. ๋ชฉํ‘œ๋Š” ์ ˆ๋ฐ˜ โ€” ๋„ˆ๋ฌด ์‰ฌ์šฐ๋ฉด ์ถ”๋ฆฌ๊ฐ€ ์•„๋‹ˆ๊ณ  ๋„ˆ๋ฌด ์–ด๋ ค์šฐ๋ฉด ๊ฒŒ์ž„์ด ์•„๋‹ˆ๋‹ค.

๋ผ์šด๋“œ๋‹น ํ–‰๋™ ๋ฒ”์ธ ์ ์ค‘๋ฅ  ํŒ์ •
10ํšŒ 66% ์—ฌ์œ ๋กญ๋‹ค
9ํšŒ 59%
8ํšŒ (์ฑ„ํƒ) 44% ๋ชฉํ‘œ์— ๊ฐ€์žฅ ๊ฐ€๊น๋‹ค

์‹œ๋‚˜๋ฆฌ์˜ค ๊ฒ€์ฆ

์ „ ํŽธ์ด src/verify.py ๋ฅผ ํ†ต๊ณผํ•ด์•ผ ํ”Œ๋ ˆ์ด ๊ฐ€๋Šฅ์œผ๋กœ ์นœ๋‹ค.

ํ•ญ๋ชฉ ๊ธฐ์ค€
๊ตฌ์กฐ ์šฉ์˜์ž 5์ธ ยท ๋ฒ”์ธ 1์ธ ยท ๋ผ์šด๋“œ/ํ„ด ์„ค์ •
ํƒ€์ž„๋ผ์ธ ์ธ๋ฌผ ๋™์„ ์— ๋ชจ์ˆœ์ด ์—†๋Š”๊ฐ€
ํ•ด ์†Œ๊ฑฐ ํ›„ ๋‚จ๋Š” ์šฉ์˜์ž๊ฐ€ 2~3์ธ์ด๊ณ , ๊ฒฐ์ •ํƒ€๊ฐ€ ๊ทธ ์‚ฌ์ด๋ฅผ ๊ฐ€๋ฅด๋Š”๊ฐ€
์˜์‹ฌ๋„ ํŠน์ • ์ธ๋ฌผ์—๊ฒŒ ํ˜์˜๊ฐ€ ์ ๋ ค ์žˆ์ง€ ์•Š์€๊ฐ€
์Šคํฌ์ผ๋Ÿฌ ๊ณต๊ฐœ ์ „ ์‘๋‹ต์— ์ •๋‹ต์ด ์ƒˆ์ง€ ์•Š๋Š”๊ฐ€

์‚ฐ์ถœ๋ฌผ

์‹œ๋‚˜๋ฆฌ์˜ค ์›์ž‘ ๊ธฐ๋ฐ˜ 50ํŽธ + ์ปค์Šคํ…€ ์ƒ์„ฑ (์ด ์ €์žฅ์†Œ์—๋Š” ์‹œ์—ฐ์šฉ 1ํŽธ๋งŒ ํฌํ•จ โ€” ์•„๋ž˜ ์ฐธ๊ณ )
์—”์ง„ FastAPI ยท ์„ธ์…˜ = ํ•œ ํŒ ยท REST 19๊ฐˆ๋ž˜
ํ™”๋ฉด React + Vite + Tailwind + Zustand, 24๊ฐœ ํŽ˜์ด์ง€
์—์…‹ ํŽธ๋‹น ์ด๋ฏธ์ง€ 72์žฅ ๊ทœ๊ฒฉ ยท BGM ํ ์„ธํŠธ

Repository Structure

26-2_DSL_Modeling_GenerativeModel/
โ”œโ”€โ”€ README.md
โ”œโ”€โ”€ My_Murder_Mystery_์ค‘๊ฐ„๋ฐœํ‘œ.pdf
โ”‚
โ”œโ”€โ”€ engine/                     # ๋ฐฑ์—”๋“œ โ€” ์ƒ์„ฑ ยท ๊ฒ€์ฆ ยท ํ”Œ๋ ˆ์ด
โ”‚   โ”œโ”€โ”€ server.py               #   FastAPI, REST 19๊ฐˆ๋ž˜
โ”‚   โ”œโ”€โ”€ ui_wire.py              #   ํ™”๋ฉด์ด ์ฝ๋Š” ๋ชจ์–‘์œผ๋กœ (์ •๋‹ต์€ ๋—€๋‹ค)
โ”‚   โ”œโ”€โ”€ ui_view.py  ui_assets.py
โ”‚   โ”œโ”€โ”€ requirements.txt  render.yaml  Procfile
โ”‚   โ”œโ”€โ”€ scenarios/
โ”‚   โ”‚   โ””โ”€โ”€ 91_dsl_demo.json    #   ์‹œ์—ฐ์šฉ 1ํŽธ
โ”‚   โ””โ”€โ”€ src/
โ”‚       โ”œโ”€โ”€ game_engine_v2.py   #   ํ•œ ํŒ์˜ ๋ชจ๋“  ๊ทœ์น™ โ€” ๋ผ์šด๋“œยทํ„ดยท์กฐ์‚ฌยท์‹ฌ๋ฌธยท๋Œ€์งˆยท์กฐํ•ฉยทํŒ์ •
โ”‚       โ”œโ”€โ”€ stance.py           #   ํƒœ๋„ ํŒ์ • (ANSWER/DEFLECT/FLINCH/ADMIT/BREAK)
โ”‚       โ”œโ”€โ”€ pressure.py         #   ์••๋ฐ• ๊ฒŒ์ด์ง€
โ”‚       โ”œโ”€โ”€ play_agents.py      #   ์šฉ์˜์ž ์—์ด์ „ํŠธ โ€” ํŽ˜๋ฅด์†Œ๋‚˜ยท๊ธฐ์–ตยท๋ฐœํ™”
โ”‚       โ”œโ”€โ”€ guard.py            #   ์‹คํ†  ๊ธˆ์ง€ยท์Šคํฌ์ผ๋Ÿฌ ์ฐจ๋‹จ ์‚ฌํ›„ ๊ฒ€์‚ฌ
โ”‚       โ”œโ”€โ”€ verify.py           #   ์‹œ๋‚˜๋ฆฌ์˜ค ๊ฒ€์ฆ
โ”‚       โ”œโ”€โ”€ generate.py         #   ์ปค์Šคํ…€ ์‹œ๋‚˜๋ฆฌ์˜ค ์ƒ์„ฑ (CLOVA Studio)
โ”‚       โ”œโ”€โ”€ llm_custom.py  build_custom.py
โ”‚       โ”œโ”€โ”€ build_91_dsl.py     #   ์‹œ์—ฐ ํŽธ ๋นŒ๋”
โ”‚       โ”œโ”€โ”€ simulate.py  eval_policies.py  measure_difficulty.py  stress_agent.py
โ”‚       โ”œโ”€โ”€ llm_api.py  llm.py  #   LLM ํ˜ธ์ถœ (ํ‚ค๋Š” ํ™˜๊ฒฝ๋ณ€์ˆ˜)
โ”‚       โ””โ”€โ”€ โ€ฆ (์ „์ฒ˜๋ฆฌยท๋ณด์ •ยท๋ฆฐํŠธ ์Šคํฌ๋ฆฝํŠธ)
โ”‚
โ”œโ”€โ”€ web/                        # ํ”„๋ก ํŠธ์—”๋“œ โ€” React + Vite
โ”‚   โ”œโ”€โ”€ src/pages/              #   ํ™”๋ฉด 24๊ฐœ
โ”‚   โ”œโ”€โ”€ src/components/         #   19๊ฐœ ๋ฌถ์Œ
โ”‚   โ”œโ”€โ”€ public/assets/
โ”‚   โ””โ”€โ”€ .env.example
โ”‚
โ”œโ”€โ”€ media/                      # ์ด๋ฏธ์ง€ ยท BGM ์ƒ์„ฑ ๋…ธํŠธ๋ถ
โ”‚   โ”œโ”€โ”€ image_fluxdev*.ipynb  image_qwen*.ipynb  image_hidream*.ipynb
โ”‚   โ”œโ”€โ”€ bgm_stable_audio*.ipynb  bgm_ace_step*.ipynb
โ”‚   โ”œโ”€โ”€ build_scenario_en.py  validate_scenarios_en.py
โ”‚   โ””โ”€โ”€ slurm/
โ”‚
โ””โ”€โ”€ docs/
    โ”œโ”€โ”€ ์Šคํ‚ค๋งˆ.md                #   ์‹œ๋‚˜๋ฆฌ์˜ค JSON ์ „์ฒด ์Šคํ‚ค๋งˆ
    โ”œโ”€โ”€ API๋ช…์„ธ.md               #   REST ๋ช…์„ธ
    โ”œโ”€โ”€ ๋‹จ์„œ์ „๋‹ฌ_๋ช…์„ธ.md
    โ”œโ”€โ”€ ๊ฒŒ์ž„๊ทœ์น™_ํ”Œ๋ ˆ์ด์–ด์šฉ.md
    โ”œโ”€โ”€ ํŒŒ์ดํ”„๋ผ์ธ.md
    โ”œโ”€โ”€ GAME_FLOW_SPEC.md
    โ””โ”€โ”€ data_kit/               #   ๋ฐ์ดํ„ฐ ์นดํƒˆ๋กœ๊ทธ ยท ํฌ๋งท

Usage

๋ฐฑ์—”๋“œ

cd engine
pip install -r requirements.txt
python3 server.py                      # http://127.0.0.1:8000

์‹ฌ๋ฌธ์€ LLM์„ ๋ถ€๋ฅธ๋‹ค. ํ‚ค๋Š” ์ฝ”๋“œ์— ๋„ฃ์ง€ ๋ง๊ณ  ํ™˜๊ฒฝ๋ณ€์ˆ˜๋กœ ์ค€๋‹ค.

export MM_API_KEY=...                  # OpenAI ํ˜ธํ™˜ ์—”๋“œํฌ์ธํŠธ๋ฉด ์–ด๋””๋“ 
export MM_API_BASE=https://...         # ์ƒ๋žต ์‹œ OpenAI ๊ธฐ๋ณธ
export MM_API_MODEL=gpt-4o-mini

ํ‚ค๊ฐ€ ์—†์–ด๋„ ์„œ๋ฒ„๋Š” ๋œฌ๋‹ค โ€” ์‹ฌ๋ฌธ ๋‹ต๋ณ€๋งŒ ๋ชป ๋ฐ›๋Š”๋‹ค. ์กฐ์‚ฌยท๋Œ€์งˆยท์ง€๋ชฉยท์—”๋”ฉ์€ ๊ทธ๋Œ€๋กœ ๋Œ์•„๊ฐ„๋‹ค.

ํ”„๋ก ํŠธ์—”๋“œ

cd web
npm install
cp .env.example .env                   # VITE_API_BASE_URL=http://127.0.0.1:8000
npm run dev                            # http://127.0.0.1:5173

์‹œ๋‚˜๋ฆฌ์˜ค ๊ฒ€์ฆ

cd engine
python3 src/verify.py scenarios/91_dsl_demo.json

์ปค์Šคํ…€ ์‹œ๋‚˜๋ฆฌ์˜ค ์ƒ์„ฑ

cd engine
export CLOVA_API_KEY=...
python3 src/generate.py --concept "๋ˆˆ ๋‚ด๋ฆฐ ์‚ฐ์žฅ, ๋‹ค์„ฏ ์‚ฌ๋žŒ, ๋Š๊ธด ์ „ํ™”์„ "

๋‚œ์ด๋„ ์ธก์ •

cd engine
python3 src/measure_difficulty.py      # ๋ชฌํ…Œ์นด๋ฅผ๋กœ
python3 src/eval_policies.py           # ์ „๋žต ์—์ด์ „ํŠธ 5์ข…

Requirements

๋ฐฑ์—”๋“œ

Python 3.11+
fastapi>=0.110
uvicorn[standard]>=0.29

ํ”„๋ก ํŠธ์—”๋“œ

Node 20+
react 19 ยท react-router-dom 7 ยท zustand 5 ยท tailwindcss 4 ยท vite

์ด๋ฏธ์ง€ ยท BGM ๋…ธํŠธ๋ถ โ€” GPU ํ™˜๊ฒฝ(slurm ์Šคํฌ๋ฆฝํŠธ ๋™๋ด‰). diffusers, transformers, torch, stable-audio-tools


๊ณต๊ฐœ ๋ฒ”์œ„์— ๊ด€ํ•˜์—ฌ

์ด ์ €์žฅ์†Œ๋Š” ์ค‘๊ฐ„๋ฐœํ‘œ ์‹œ์ ์˜ ์ฝ”๋“œ์ด๋ฉฐ, ์•„๋ž˜ ๋‘˜์€ ์˜๋„์ ์œผ๋กœ ๋บ์Šต๋‹ˆ๋‹ค.

  • ์›์ž‘ ๊ธฐ๋ฐ˜ ์‹œ๋‚˜๋ฆฌ์˜ค 50ํŽธ โ€” ํŒ€์ด ์ด์–ด์„œ ์„œ๋น„์Šค๋กœ ๋งŒ๋“ค๊ณ  ์žˆ๋Š” ์ž‘์—…๋ฌผ์ด๋ผ ์‹œ์—ฐ์šฉ 1ํŽธ(91_dsl_demo.json)๋งŒ ๋„ฃ์—ˆ์Šต๋‹ˆ๋‹ค. ํŒŒ์ดํ”„๋ผ์ธยท์—”์ง„ยท๊ฒ€์ฆ ์ฝ”๋“œ๋Š” ์ „๋ถ€ ๋“ค์–ด ์žˆ์–ด ์ƒ์„ฑ๋ถ€ํ„ฐ ํ”Œ๋ ˆ์ด๊นŒ์ง€ ๊ทธ๋Œ€๋กœ ์žฌํ˜„๋ฉ๋‹ˆ๋‹ค.
  • ์‹œ์—ฐ ํŽธ์˜ ๋“ฑ์žฅ์ธ๋ฌผ ์ด๋ฆ„ โ€” ๋ฐœํ‘œ ๋•Œ๋Š” ํ•™ํšŒ์› ์‹ค๋ช…์œผ๋กœ ์‹œ์—ฐํ–ˆ์ง€๋งŒ, ๊ณต๊ฐœ ์ €์žฅ์†Œ์—๋Š” ๊ฐ€๋ช…์œผ๋กœ ๋ฐ”๊ฟ” ์˜ฌ๋ ธ์Šต๋‹ˆ๋‹ค.

์ค‘๊ฐ„๋ฐœํ‘œ ์ดํ›„์˜ ์ž‘์—…์€ ์ด ์ €์žฅ์†Œ์— ์—†์Šต๋‹ˆ๋‹ค.


References

Datasets

  • Sprague et al., MuSR: Testing the Limits of Chain-of-thought with Multistep Soft Reasoning, ICLR 2024 โ€” github
  • WhoDunIt โ€” huggingface
  • Xiao et al., DetectiveQA: Evaluating Long-Context Reasoning on Detective Novels โ€” huggingface
  • Del & Fishel, True Detective: A Deep Abductive Reasoning Benchmark โ€” github
  • Zhu et al., PLAYER: Multi-Agent Script Murder Mystery โ€” github
  • Xu et al., FairytaleQA โ€” github
  • Wang et al., RoleLLM / RoleBench โ€” huggingface

Models

  • Claude (Anthropic) โ€” ์‹œ๋‚˜๋ฆฌ์˜ค ์ƒ์„ฑ
  • GPT-4o mini (OpenAI) โ€” ์šฉ์˜์ž ์‹ฌ๋ฌธ ์—์ด์ „ํŠธ
  • FLUX 2 โ€” ์žฅ๋ฉดยท์ธ๋ฌผยท๋‹จ์„œ ์ด๋ฏธ์ง€
  • Stable Audio 3 โ€” ์žฅ๋ฉด๋ณ„ BGM
  • CLOVA Studio HCX-007 / HCX-005 (NAVER) โ€” ์ปค์Šคํ…€ ์‹œ๋‚˜๋ฆฌ์˜ค ์ƒ์„ฑ๊ธฐ

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages