支持角色id与性格配置

2025-08-11 14:29:39 +08:00
parent 0f8902405d
commit 1c33f4345b
11 changed files with 773 additions and 81 deletions
@@ -0,0 +1,97 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+This is a Cocos Creator 3.8.4 game project called "XiangQin" (相亲/Dating). It's a dating simulation/chat game with AI integration using Google's Gemini API.
+
+## Technology Stack
+
+- **Engine**: Cocos Creator 3.8.4
+- **Language**: TypeScript
+- **AI Integration**: Google Generative AI (Gemini)
+- **Build Target**: Multi-platform (Web, WeChat Mini Game, Kuaishou, Baidu)
+
+## Project Structure
+
+```
+assets/
+├── Scripts/
+│   ├── Main/           # Core game framework
+│   │   ├── Channel/    # Platform SDK integrations (WeChat, Baidu, Kuaishou, Web)
+│   │   ├── Common/     # Common utilities and base components
+│   │   ├── Config/     # Game configuration and resources
+│   │   └── Manager/    # Game managers (Audio, View, Resource, Player data)
+│   ├── Sub/            # Game-specific logic
+│   │   ├── UI/         # UI components and screens
+│   │   ├── Item/       # UI items and dialogs
+│   │   └── Compo/      # Additional components
+│   └── test/           # Chat AI implementation
+│       ├── ChatAIService.ts    # Gemini AI integration
+│       ├── ChatPanel.ts         # Chat UI panel
+│       └── index.ts             # System instructions/prompts
+├── Scenes/             # Game scenes
+├── resources/          # Static resources
+└── bundles/           # Asset bundles
+```
+
+## Key Components
+
+### AI Chat System
+- **ChatAIService.ts**: Handles Google Gemini API integration for chat functionality
+- **ChatPanel.ts**: Main chat interface implementation
+- **index.ts**: Contains system prompts and character definitions
+
+### Platform SDKs
+- **SDKManager.ts**: Manages platform-specific SDK initialization
+- **wxSDK.ts**: WeChat Mini Game SDK integration
+- **bdSDK.ts**: Baidu SDK integration
+- **ksSDK.ts**: Kuaishou SDK integration
+- **webSDK.ts**: Web platform SDK
+
+### Game Flow
+- **GameEntry.ts**: Game initialization and configuration
+- **MainScene.ts**: Main menu scene
+- **GameScene.ts**: Core game scene
+- **ViewManager.ts**: Manages UI view navigation
+
+## Development Commands
+
+Since this is a Cocos Creator project, development is primarily done through the Cocos Creator IDE. Common tasks:
+
+### Build & Run
+- Open project in Cocos Creator 3.8.4
+- Use Creator's built-in preview: Menu → Project → Preview
+- Build for platforms: Menu → Project → Build
+
+### TypeScript Compilation
+TypeScript compilation is handled automatically by Cocos Creator. Manual compilation isn't typically needed.
+
+## Important Considerations
+
+### API Keys
+The project contains API keys in the code (Google Gemini API). These should be moved to environment variables or a secure configuration file.
+
+### Character System
+The game uses configurable character profiles defined in `index.ts` with different personality settings (Role_1, Role_2, Role_3).
+
+### Multi-Platform Support
+The codebase includes platform-specific code branches. When modifying core functionality, ensure compatibility across all supported platforms (Web, WeChat, Baidu, Kuaishou).
+
+### Asset Management
+- Assets are organized in bundles for dynamic loading
+- Resource management is handled through ResManager
+- Audio assets are managed separately through AudioManager
+
+### UI System
+- Uses Cocos Creator's UI system with custom components
+- Base view class: `li_BaseView.ts`
+- View navigation managed by ViewManager
+
+## Code Conventions
+
+- TypeScript with non-strict mode (`"strict": false` in tsconfig)
+- Component-based architecture following Cocos Creator patterns
+- Singleton pattern for managers (e.g., `SDKManager.I`, `PlayerDataManager.I`)
+- Event system using `li_EventManager` for decoupled communication