doc: aotai hike game

Author: CaralHsi

demos/AOTAI_Hike/PR_DESCRIPTION.md

@@ -0,0 +1,73 @@
+# Integrate AoTai Hike Demo with MemOS Multi-View Memory System
+
+## Summary
+
+This PR integrates the AoTai Hike game demo with MemOS's multi-view memory capabilities, demonstrating how multiple game roles can maintain independent memory spaces and extract memories from their own first-person perspectives.
+
+## Key Features
+
+### 1. Multi-View Memory Integration
+- **World Memory**: Stores global game events accessible to all roles (`cube_{user_id}_world`)
+- **Role Memory**: Each role has an independent memory space (`cube_{role_id}_{role_id}`)
+- **Automatic Mode Detection**: MemOS automatically enables `multi_view` mode when messages contain `role_id` or `role_name` fields
+
+### 2. Memory Flow
+```
+GameService.act
+  ├─ add_event (world memory write with role_id/role_name)
+  ├─ search (world memory retrieval)
+  └─ CompanionBrain.generate
+        ├─ search_memory (role memory retrieval)
+        ├─ chat_complete (LLM generation)
+        └─ add_memory (role memory write-back with multi-view extraction)
+```
+
+### 3. Core Implementation
+
+**MemoryAdapter** (`adapters/memory.py`):
+- Wraps MemOS API calls (`/product/add`, `/product/search`, `/product/chat/complete`)
+- Supports multi-view memory writing and retrieval
+- Handles world memory and role memory isolation
+
+**CompanionBrain** (`adapters/companion.py`):
+- Generates NPC dialogue based on role memory
+- Uses MemOS `chat_complete` API with role-specific context
+- Writes dialogue back to role memory with multi-view extraction
+
+**GameService** (`services/game_service.py`):
+- Coordinates game logic with memory system
+- Formats and writes game events to memory
+- Retrieves world memory for NPC dialogue context
+
+## Technical Details
+
+### Multi-View Memory Detection
+When messages contain `role_id` or `role_name`, MemOS automatically:
+1. Switches to `multi_view` mode
+2. Extracts memories from the role's first-person perspective
+3. Filters irrelevant information
+4. Maintains role memory isolation
+
+### Memory Namespace
+- Role memory: `cube_{role_id}_{role_id}`
+- World memory: `cube_{user_id}_world`
+
+## Files Changed
+
+- `demos/AOTAI_Hike/backend/aotai_hike/adapters/memory.py` - MemOS memory adapter
+- `demos/AOTAI_Hike/backend/aotai_hike/adapters/companion.py` - NPC dialogue generation
+- `demos/AOTAI_Hike/backend/aotai_hike/services/game_service.py` - Game service with memory integration
+- `demos/AOTAI_Hike/backend/aotai_hike/router.py` - API routes
+- `demos/AOTAI_Hike/README.md` - Updated documentation
+- `demos/AOTAI_Hike/INTRODUCTION_ZH.md` - Chinese documentation
+- `demos/AOTAI_Hike/INTRODUCTION_EN.md` - English documentation
+
+## Related Issue
+
+Closes #[ISSUE_NUMBER]
+
+## Documentation
+
+- [Memory Integration Guide](./backend/MEMORY_INTEGRATION.md)
+- [Complete Introduction (中文)](./INTRODUCTION_ZH.md)
+- [Complete Introduction (English)](./INTRODUCTION_EN.md)

demos/AOTAI_Hike/backend/MEMORY_INTEGRATION.md

@@ -102,10 +102,6 @@ GameService.act
 
 本游戏完整集成了 MemOS 的多视角记忆系统，实现了每个角色拥有独立记忆空间、从角色视角提取记忆的功能。
 
-**详细文档**：
-- [多视角记忆集成 PR 文档](../PR_MULTI_VIEW_MEMORY_INTEGRATION.md) - 完整的技术实现说明
-- [PR 摘要](../PR_SUMMARY.md) - 快速概览
-
 **核心特性**：
 - ✅ 自动多视角模式检测（通过 `role_id` 和 `role_name` 字段）
 - ✅ 角色记忆隔离（每个角色独立的记忆空间）