Test step

.gitattributes

@@ -1,4 +1,5 @@
 *.ipynb text eol=lf
-*.bat text eol=crlf
+*.bat text eol=lf
 *.sh  text eol=lf
+*.txt text eol=lf
 *.png filter=lfs diff=lfs merge=lfs -text

npc_social_network/README.txt

@@ -0,0 +1,212 @@
+# 🧠 README - NPC 소셜 네트워크 AI 시뮬레이션
+
+본 문서는 본 프로젝트를 **제로 베이스에서 완전 재현**할 수 있도록 설계되었습니다.
+지금까지의 구조, 설계 철학, 구현 단계, 각 파일 기능을 **단 하나의 문서로 완전하게 정리**한 공식 문서입니다.
+
+---
+
+## 📌 프로젝트 개요 (Overview)
+
+이 프로젝트는 감정, 기억, 성격, 관계, 행동을 기반으로 한 **인간 유사 NPC 시뮬레이션**입니다.
+플레이어와의 대화, NPC 간 상호작용, 시간 흐름에 따른 감정 변화 등을 반영하며,
+LLM과 embedding 기반 기억 시스템을 통해 정교한 NPC 반응을 구성합니다.
+
+---
+
+## 📁 폴더 구조
+
+```
+portfolio/
+├── app.py                         # Flask 진입점
+├── requirements.txt
+├── run_npc_interactions.py
+├── test.ipynb
+└── npc_social_network/
+    ├── README.txt
+    ├── routes/
+    │   └── npc_route.py              # 웹 라우트 (API)
+    ├── maps/
+    │   ├── villages/town_hall.py     # Pygame 메인 실행
+    │   ├── engine/game_engine.py     # 게임 루프, 감정 HUD
+    │   └── manager/
+    │       ├── tile.py               # Tile 클래스
+    │       ├── building.py           # 건물 클래스
+    │       ├── image_loader.py       # 이미지 로딩
+    │       ├── image_registry.py     # 이미지 경로 사전
+    │       └── village_map.py        # Village 전체 구성
+    ├── npc/
+    │   ├── npc_base.py               # NPC 본체 (감정/기억/관계 포함)
+    │   ├── npc_manager.py            # NPC 리스트 관리
+    │   ├── npc_emotion.py            # EmotionManager
+    │   ├── npc_memory.py             # Memory / MemoryStore
+    │   ├── npc_behavior.py           # 감정 → 행동 매핑
+    │   ├── npc_relationship.py       # 관계 점수 관리
+    │   ├── npc_memory_embedder.py   # 기억 임베딩 + FAISS 검색
+    │   ├── emotion_config.py         # 감정 구조 정의
+    │   └── personality_config.py     # 성격 및 나이 프로필
+    ├── models/
+    │   ├── llm_helper.py             # 감정 추론, 응답 생성
+    │   └── llm_prompt_builder.py     # 프롬프트 생성
+    ├── templates/
+    │   ├── chat.html                 # 채팅 UI
+    │   ├── base.html                 # 공통 템플릿
+    │   └── test_memory_tools.html   # 임베딩 테스트용 페이지
+    └── static/
+        ├── css/style.css
+        └── js/npc_chat.js
+
+```
+
+---
+
+## 💡 감정 구조 (고차원 감정 모델)
+
+> ✅ “GoEmotions 기반”이 아님에 주의!
+> ✅ 대신 **GoEmotions에서 영감을 받아 직접 재설계한 4계층 감정 모델 (ComplexEmotions)**
+
+| 계층 (Layer) | 감정 예시 |
+|--------------|------------|
+| `core`       | joy, sadness, anger, fear, disgust, surprise, neutral |
+| `social`     | gratitude, shame, empathy, pride, jealousy, compassion, love, admiration, awe, attachment, comfort |
+| `cognitive`  | anticipation, curiosity, confusion, interest, engagement, boredom, relief, anxiety, calm, skepticism |
+| `complex`    | nostalgia, bittersweet, schadenfreude, resentment, anticipatory_joy, regret, rumination, hope, groundedness |
+
+- 감정은 개성(`sensitive`, `stoic`, `*_bias`)에 따라 감정 반응 및 decay 속도가 달라집니다.
+- 감정은 행동, 기억 생성, 관계 변화, 성격 변화에 직접 반영됩니다.
+
+---
+
+## 🧠 핵심 시스템 설명
+
+### ✅ 감정 시스템
+- `EmotionManager`: 감정 버퍼 관리, decay, 감정 업데이트
+- 감정은 최대 100.0까지 누적되며, decay는 personality와 연계됨
+- 감정은 행동 생성, 기억 저장 강도, 관계 영향, 성격 변화의 기반이 됨
+
+### ✅ 기억 시스템
+- `Memory`: content, timestamp, importance, emotion, type 보유
+- `MemoryStore`: 단기/장기 기억 분리, decay, 승격, 검색 기능 포함
+- decay는 memory_type별로 다르게 적용됨
+
+### ✅ 성격 시스템
+- `PERSONALITY_PROFILE`: stable/emotional/logical
+- `AGE_PROFILE`: 인생 단계별 변화율 (예: 어린이는 빠름)
+- 기억에 기반해 personality gradually drift (ex: 감정적이거나 이성적 성향 강화)
+
+### ✅ 관계 시스템
+- `RelationshipManager`: -100 ~ +100 범위의 관계 점수 관리
+- 감정 표현 및 기억이 관계에 영향을 줌 (`reflect_memory_on_relationship`)
+
+### ✅ 행동 시스템
+- 감정 → 행동 시퀀스로 변환 (`BehaviorManager`)
+- 행동은 기억에 기록되고, 다시 감정에 영향을 줌 (역매핑)
+
+### ✅ LLM 시스템
+- `query_llm_for_emotion`: 감정 추론용 LLM 호출
+- `query_llm_with_prompt`: 대사 생성용 LLM 호출
+- `build_npc_prompt`: 감정/기억 기반 프롬프트 생성
+- `summarize_memories`: 장기 ��억 요약
+
+### ✅ 임베딩 시스템
+- `npc_memory_embedder.py`:
+    - `embed_npc_memories`: FAISS 저장
+    - `search_similar_memories`: 질의 유사도 검색
+    - 모델: `all-MiniLM-L6-v2` 사용 중
+
+---
+
+## 🔁 주요 시퀀스 흐름
+
+### 🗨️ `interact_with_player()` 전체 흐름
+1. LLM으로 감정 추론 (`query_llm_for_emotion`)
+2. 기억 검색 (FAISS + embedding)
+3. LLM 프롬프트 생성 (`build_npc_prompt`)
+4. 응답 생성 + 기억 저장
+5. 감정 업데이트 (`update_emotion`)
+6. 관계 변화 반영 (`reflect_memory_on_relationship`)
+7. 성격 변화 (`update_personality`)
+
+---
+
+## 📦 실행 방법
+
+```bash
+conda activate portfolio
+
+# Flask 웹 서버 실행
+python portfolio/app.py
+# → http://127.0.0.1:5000/npc_social_network/
+
+# 시뮬레이션 Pygame 실행 (웹 라우트로 실행됨)
+GET /run_npc_simulation
+→ 또는 app.py 내 subprocess.Popen으로 실행됨
+```
+
+---
+
+## ✅ 현재까지 구현된 단계 (설계 기반)
+
+| 단계 | 내용 |
+|------|------|
+| 1단계 | 타일/건물/마을 구조 생성 | ✅ 완료 | 마을 구조 생성 및 맵 렌더링
+| 2단계 | NPC 감정 상태 및 감정 HUD 구현 | ✅ 완료 | 감정 상태 및 HUD 표시 (Pygame + 웹)
+| 3단계 | 감정 ↔ 행동 연동 구조 구현 | ✅ 완료 | 감정 ↔ 행동 매핑 구현
+| 4단계 | 감정 ↔ 기억 저장 및 decay 구현 | ✅ 완료 | Memory 감정 및 decay 적용 구조
+| 5단계 | 감정 ↔ 관계 변화 구조 구현 | 🔸 부분 완료 | 구조는 구현됨, 플레이어 대상 반영 보완 중
+| 6단계 | 성격 시스템 도입 | ✅ 완료 | 성격 분리 + 초기 bias 설계
+| 7단계 | NPC 간 상호작용 구조화 | ✅ 완료 | NPC 상호작용 → 감정/관계 반영
+| 8단계 | Memory 임베딩 + FAISS 기반 검색 | ✅ 완료 | FAISS 검색 + 임베딩 저장 구조
+| 9단계 | LLM 기반 프롬프트 대사 생성 | ✅ 완료 | 프롬프트 설계 및 LLM 응답
+| 10단계 | 감정 상태 HUD 시각화 (웹 + 게임 화면) | ✅ 완료 | 감정 상태 HUD (웹/게임 연동)
+
+# 핵심 시스템 고도화
+| 11단계 | 감정/기억/관계 통합 정비 | 🔄 진행중 | 관계 통합, 감정-기억-관계 연결 완성도 향상 중
+| 12단계 | LLM 대사 생성 고도화 | ✅ 완료 | LLM 대사 생성 개선, 프롬프트 완성
+| 13단계 | 기억 decay 정교화 | ⏳ 미진행 | decay 시점별 변화율 조정 등 정교화 미실행
+| 14-1단계 | 기억 임베딩 구조 확장 | ✅ 완료 | Memory 객체 임베딩 구조 도입
+| 14-2단계 | 임베딩 모델 교체 | ✅ 완료 | 벡터 임베딩 모델 교체 예정 상태로 정리
+| 15단계 | 행동 계획 생성기 (LLM Planner 연동) | ⏳ 미진행 | Planner 연동은 시작 전
+| 16단계 | 사회적 프로파일 시스템 도입 | ⏳ 미진행 | 관계 설명 → 시각화 구조로 확장 예정
+| 17단계 | 상징 기억 / 대표 기억 생성 | ⏳ 미진행 | 상징 기억 분류/요약 아직 미실행
+| 18단계 | 기억 체계 확장: 시간 맥락 부여 | ⏳ 미진행 | 기억에 시간 맥락/계절/시기 부여 미완료
+| 19단계 | 감정-성격-행동 일관성 유지 평가 | ⏳ 미진행 | 성격 기반 감정/행동 동기 일관성 확인 설계
+| 20단계 | 	NPC 사회 네트워크 시각화 | ⏳ 미진행 | 
+
+# 고급 인간화 및 자각형 NPC 확장
+| 21단계 | 성격 지속적 변화 설계 완성 |
+| 22단계 | 행동 유도 기반 계획형 NPC |
+| 23단계 | 윤리 시스템 실험 (자각형 구조화) |
+| 24단계 | NPC 자아 형성 시퀀스 테스트 |
+| 25단계 | 플레이어 기억 및 반응 시스템 구축 |
+| 26단계 | 멀티캐릭터 다자 간 상호작용 루프 |
+| 27단계 | 시뮬레이션 UI 시각화 고도화 |
+| 28단계 | 메타기억 시스템 |
+| 29단계 | LLM+RAG+플래너 종합 구조 통합 |
+| 30단계 | 논문/연구 결과 정리 구조화 |
+
+
+---
+
+## 📎 dependency 예시 (requirements 일부)
+
+```txt
+flask
+pygame
+sentence-transformers
+faiss-cpu
+numpy
+```
+→ 실제 모델 사용을 위해 GPU 버전 또는 `transformers`, `openai`, `google-generativeai` 등 추가 가능
+
+---
+
+## 🚨 주의 사항
+
+- 모든 감정, 기억, 행동, 관계는 감정 카테고리 기반 구조를 철저히 따릅니다
+- NPC 내부 상태 변화는 완전히 설계된 순환구조 (감정→기억→관계→성격→감정...)로 구현되어 있습니다
+- 함수명, 변수명은 `npc_base.py`의 규칙에 따라 변경 금지
+- 현재 모든 구조는 **연구 논문 또는 컨퍼런스 목적**으로 설계됨
+
+---
+
+© 2025 NPC Social Network Simulation Project v2

npc_social_network/npc/emotion_config.py

@@ -153,4 +153,23 @@ NEGATIVE_RELATION_EMOTIONS = [
 COGNITIVE_RELATION_EMOTIONS = [
     "compassion", "awe", "attachment", "anticipation", "curiosity",
     "nostalgia", "bittersweet", "rumination", "groundedness", "comfort",
-]
+]
+
+# 감정별 관계 영향도 정의 (관계에 영향 주는 감정만 등록, 정규화된 [-2.0 ~ +2.0] 범위 안에서 정의)
+EMOTION_RELATION_IMPACT = {
+    "joy": +1.0,
+    "gratitude": +1.2,
+    "love": +2.0,
+    "admiration": +0.8,
+    "pride": +0.7,
+    "calm": +0.5,
+    "sadness": -0.8,
+    "anger": -1.5,
+    "disgust": -2.0,
+    "fear": -1.0,
+    "shame": -1.2,
+    "resentment": -1.5,
+    "regret": -0.9,
+    "hope": +0.9,
+    "comfort": +0.6,
+}

npc_social_network/npc/npc_base.py

@@ -2,7 +2,7 @@
 from .npc_memory import Memory, MemoryStore
 from .npc_emotion import EmotionManager
 from .npc_behavior import BehaviorManager
-from .emotion_config import EMOTION_LIST, EMOTION_CATEGORY_MAP, EMOTION_DECAY_RATE, PERSONALITY_TEMPLATE
+from .emotion_config import EMOTION_CATEGORY_MAP, EMOTION_DECAY_RATE, PERSONALITY_TEMPLATE, EMOTION_RELATION_IMPACT
 from .emotion_config import POSITIVE_RELATION_EMOTIONS, NEGATIVE_RELATION_EMOTIONS, COGNITIVE_RELATION_EMOTIONS
 from .personality_config import AGE_PROFILE, PERSONALITY_PROFILE
 from .npc_relationship import RelationshipManager
@@ -313,23 +313,34 @@ class NPC:
             self.update_emotion(emotion, strength=2.0)
 
         # STEP 2: 관련 기억 검색
-        _, _, matched_memories = search_similar_memories(self.name, player_input)
-        # 요약 & 장기 기억화 (3개 이상일 때만)
-        if len(matched_memories) >= 3:
-            self.summarize_and_store_memories(matched_memories)
+        matched_memories = search_similar_memories(self.name, player_input)
 
         # STEP 3: 프롬프트 생성
-        prompt = build_npc_prompt(self, player_input, matched_memories)
+        prompt = build_npc_prompt(cnp=self,
+                                  user_input=player_input,
+                                  matched_memories=matched_memories)
 
         # STEP 4: LLM 응답 생성
         npc_reply = query_llm_with_prompt(prompt)
 
         # STEP 5: 기억 기록
-        self.remember(
+        memory = Memory(
             content=f"[플레이어] '{player_input}' → [NPC:{self.name}] '{npc_reply}'",
             importance=6,
             emotion=emotion
         )
+        self.memory_store.add_memory(memory)
+
+        # STEP 6: 감정 기반 관계 변화 반영
+        if isinstance(emotion, dict):
+            delta = 0.0
+            for emo, strength in emotion.items():
+                if emo in EMOTION_RELATION_IMPACT:
+                    delta += EMOTION_RELATION_IMPACT[emo] * strength
+
+            if abs(delta) > 0.01:   # 영향이 충분히 있을 때만 반영
+                self.relationships.update_relationship("플레이어", delta=delta)
+                print(f"[관계 변화] '{self.name}' → 플레이어: {delta:+.2f}")
 
         return npc_reply