services

type AggregateOptions struct {
	IncludeConversations bool
	ConversationLimit    int
	IncludeStoryData     bool
	IncludeUIState       bool
	IncludeProgress      bool
	UserPreferences      *models.UserPreferences
}

type AggregateStats struct {
	TotalCharacters    int     `json:"total_characters"`
	TotalConversations int     `json:"total_conversations"`
	StoryProgress      float64 `json:"story_progress"`
	ActiveNodes        int     `json:"active_nodes"`
	AvailableChoices   int     `json:"available_choices"`
}

type AnalysisCache struct {
	// contains filtered or unexported fields
}

type AnalyzerService struct {
	LLMService *LLMService
	// contains filtered or unexported fields
}

type CacheEntry struct {
	Response  interface{}
	CreatedAt time.Time
}

type CachedAggregateData struct {
	Data      *SceneAggregateData
	Timestamp time.Time
}

type CachedAnalysis struct {
	Result    *models.AnalysisResult
	Timestamp time.Time
}

type CachedExportData struct {
	SceneData     *SceneData
	Conversations []models.Conversation
	StoryData     *models.StoryData
	Timestamp     time.Time
}

type CachedInteractionData struct {
	SceneData  *SceneData
	StoryData  *models.StoryData
	Characters map[string]*models.Character
	Timestamp  time.Time
}

type CachedItemData struct {
	Items     map[string]*models.Item // itemID -> Item
	Timestamp time.Time
}

type CachedSceneData struct {
	SceneData  *SceneData
	Characters map[string]*models.Character // characterID -> Character
	Timestamp  time.Time
}

type CachedSceneList struct {
	Scenes    []models.Scene
	Timestamp time.Time
}

type CachedStoryData struct {
	Data      *models.StoryData
	Timestamp time.Time
	Loading   *sync.Once // 用于确保只加载一次
}

type CachedUserData struct {
	User      *models.User
	Timestamp time.Time
}

type CharacterInfo struct {
	Name          string            `json:"name"`
	Role          string            `json:"role"`
	Description   string            `json:"description"`
	Personality   string            `json:"personality"`
	Background    string            `json:"background"`
	SpeechStyle   string            `json:"speech_style"`
	Relationships map[string]string `json:"relationships"`
	Knowledge     []string          `json:"knowledge"`
}

type CharacterInteraction struct {
	Conversation []struct {
		Speaker  string `json:"speaker"`
		Dialogue string `json:"dialogue"`
		Emotion  string `json:"emotion,omitempty"`
		Action   string `json:"action,omitempty"`
	} `json:"conversation"`

	RelationshipDynamics string `json:"relationship_dynamics"`

	PotentialOutcomes []struct {
		Description string `json:"description"`
		Impact      string `json:"impact,omitempty"`
	} `json:"potential_outcomes,omitempty"`
}

type CharacterMessage struct {
	CharacterID   string                 `json:"character_id"`
	CharacterName string                 `json:"character_name"`
	Content       string                 `json:"content"`
	EmotionData   *EmotionData           `json:"emotion_data"`
	Timestamp     time.Time              `json:"timestamp"`
	MessageType   string                 `json:"message_type"` // response, action, thought
	Metadata      map[string]interface{} `json:"metadata,omitempty"`
}

type CharacterService struct {
	// 依赖服务
	LLMService     *LLMService
	ContextService *ContextService
	// contains filtered or unexported fields
}

type CharacterState struct {
	CharacterID     string                 `json:"character_id"`
	Mood            string                 `json:"mood"`
	Energy          float64                `json:"energy"`
	Relationship    map[string]float64     `json:"relationship"` // 与其他角色的关系值
	CurrentActivity string                 `json:"current_activity"`
	StatusEffects   []string               `json:"status_effects"`
	LastUpdated     time.Time              `json:"last_updated"`
	Metadata        map[string]interface{} `json:"metadata"`
}

type ChatCompletionChoice struct {
	Message      ChatCompletionMessage
	FinishReason string
}

type ChatCompletionMessage struct {
	Role    string
	Content string
}

type ChatCompletionRequest struct {
	Model       string                  `json:"model"`
	Messages    []ChatCompletionMessage `json:"messages"`
	Temperature float64                 `json:"temperature"`
	MaxTokens   int                     `json:"max_tokens"`
	ExtraParams map[string]interface{}  `json:"extra_params,omitempty"`
}

type ChatCompletionResponse struct {
	ID      string
	Choices []ChatCompletionChoice
	Usage   Usage
}

type ChatResponseWithEmotion struct {
	CharacterID string `json:"character_id"`
	Message     string `json:"message"`
	Emotion     string `json:"emotion"`            // 情绪标识
	Action      string `json:"action"`             // 行为描述
	Original    string `json:"original,omitempty"` // 原始回复（调试用）
}

type ConfigAuditEntry struct {
	Timestamp time.Time
	Action    string // "read", "write"
	Section   string
	User      string // 可用于记录谁访问了配置
}

type ConfigChange struct {
	Type     string // "llm_config", "debug_mode", etc.
	OldValue interface{}
	NewValue interface{}
}

type ConfigChangeRecord struct {
	Timestamp time.Time
	ChangedBy string
	Section   string
	OldValue  interface{}
	NewValue  interface{}
}

type ConfigChangeSubscriber interface {
	OnConfigChanged(oldConfig, newConfig *config.AppConfig)
}

type ConfigHealthCheck struct {
	// contains filtered or unexported fields
}

type ConfigService struct {
	// contains filtered or unexported fields
}

type ConfigTransaction struct {
	// contains filtered or unexported fields
}

type ContentAnalysis struct {
	Characters []struct {
		Name        string            `json:"name"`
		Description string            `json:"description"`
		Traits      []string          `json:"traits"`
		Relations   map[string]string `json:"relations,omitempty"`
	} `json:"characters"`

	Scenes []struct {
		Name        string   `json:"name"`
		Description string   `json:"description"`
		Atmosphere  string   `json:"atmosphere"`
		Items       []string `json:"items,omitempty"`
	} `json:"scenes"`

	Props []struct {
		Name        string   `json:"name"`
		Description string   `json:"description"`
		Function    string   `json:"function,omitempty"`
		Connections []string `json:"connections,omitempty"`
	} `json:"props"`

	Plotpoints []struct {
		Description string   `json:"description"`
		Importance  string   `json:"importance"`
		Characters  []string `json:"characters,omitempty"`
	} `json:"plotpoints"`

	Themes []string `json:"themes"`
}

type ContextService struct {
	SceneService SceneServiceInterface
	// contains filtered or unexported fields
}

type EmotionData struct {
	Text              string   `json:"text"`
	Emotion           string   `json:"emotion"`
	Action            string   `json:"action"`
	Intensity         int      `json:"intensity"`
	BodyLanguage      string   `json:"body_language"`
	FacialExpression  string   `json:"facial_expression"`
	VoiceTone         string   `json:"voice_tone"`
	SecondaryEmotions []string `json:"secondary_emotions"`
}

type ExplorationResult struct {
	DiscoveredItem *struct {
		Name        string `json:"name"`
		Description string `json:"description"`
		Type        string `json:"type"`
	} `json:"discovered_item,omitempty"`
	StoryEvent *struct {
		Content string `json:"content"`
		Type    string `json:"type"`
		Choices []struct {
			Text        string `json:"text"`
			Consequence string `json:"consequence"`
		} `json:"choices,omitempty"`
	} `json:"story_event,omitempty"`
	NewClue string `json:"new_clue,omitempty"`
}

type ExportService struct {
	ContextService *ContextService
	StoryService   *StoryService
	SceneService   *SceneService
	// contains filtered or unexported fields
}

type GameEvent struct {
	EventType string                 `json:"event_type"`
	EventData map[string]interface{} `json:"event_data"`
	Triggers  []string               `json:"triggers"` // 触发条件
	Effects   []string               `json:"effects"`  // 效果
	Timestamp time.Time              `json:"timestamp"`
}

type InteractionAggregateService struct {
	CharacterService *CharacterService
	ContextService   *ContextService
	SceneService     *SceneService
	StatsService     *StatsService
	StoryService     *StoryService
	ExportService    *ExportService
	// contains filtered or unexported fields
}

type InteractionOptions struct {
	GenerateFollowUps   bool `json:"generate_follow_ups"`
	UpdateStoryProgress bool `json:"update_story_progress"`
	SaveToHistory       bool `json:"save_to_history"`
	TriggerEvents       bool `json:"trigger_events"`
}

type InteractionRequest struct {
	SceneID      string                 `json:"scene_id"`
	CharacterIDs []string               `json:"character_ids"`
	Message      string                 `json:"message"`
	NodeID       string                 `json:"node_id,omitempty"`
	EmotionData  *EmotionData           `json:"emotion_data,omitempty"`
	Context      map[string]interface{} `json:"context,omitempty"`
	Options      *InteractionOptions    `json:"options,omitempty"`
}

type InteractionResult struct {
	// 角色响应
	Messages []CharacterMessage `json:"messages"`

	// 故事更新
	StoryUpdates *StoryUpdate `json:"story_updates,omitempty"`

	// 角色状态变化
	CharacterStates map[string]CharacterState `json:"character_states"`

	// 新的选择项
	NewChoices []*models.StoryChoice `json:"new_choices,omitempty"`

	// UI更新指令
	UIUpdates *UIUpdateCommands `json:"ui_updates"`

	// 通知消息
	Notifications []Notification `json:"notifications"`

	// 事件触发
	Events []GameEvent `json:"events,omitempty"`

	// 统计信息
	Stats *InteractionStats `json:"stats"`
}

type InteractionStats struct {
	TokensUsed          int       `json:"tokens_used"`
	ProcessingTime      int64     `json:"processing_time_ms"`
	CharactersInvolved  int       `json:"characters_involved"`
	MessagesGenerated   int       `json:"messages_generated"`
	EventsTriggered     int       `json:"events_triggered"`
	TotalInteractions   int       `json:"total_interactions"`
	TotalMessages       int       `json:"total_messages"`
	TotalTokensUsed     int       `json:"total_tokens_used"`
	TotalProcessingTime int64     `json:"total_processing_time"`
	TotalTasksCompleted int       `json:"total_tasks_completed"`
	TotalProgressChange float64   `json:"total_progress_change"`
	LastUpdated         time.Time `json:"last_updated"`
}

type ItemService struct {
	ScenesPath string
	// contains filtered or unexported fields
}

type KeywordAnalysis struct {
	ProgressMultiplier float64
	Events             []string
	UnlockTriggers     []string
}

type LLMCache struct {
	// contains filtered or unexported fields
}

type LLMService struct {
	// contains filtered or unexported fields
}

type LLMServicer interface {
	AnalyzeText(text, title string) (*models.AnalysisResult, error)
	AnalyzeContent(text string) (*ContentAnalysis, error)
}

type LanguageContext struct {
	IsEnglish bool
	MainText  string
}

type LocationAnalysis struct {
	SpatialRelations []struct {
		Location1   string `json:"location1"`
		Location2   string `json:"location2"`
		Relation    string `json:"relation"`
		PathDetails string `json:"path_details,omitempty"`
	} `json:"spatial_relations"`

	LocationFunctions map[string]string `json:"location_functions"`

	RecommendedPaths []struct {
		Path           []string `json:"path"`
		Description    string   `json:"description"`
		StoryPotential string   `json:"story_potential"`
	} `json:"recommended_paths"`

	StoryFlowSuggestions []string `json:"story_flow_suggestions"`
}

type LocationInfo struct {
	Name        string   `json:"name"`
	Description string   `json:"description"`
	Items       []string `json:"items,omitempty"`
	Connections []string `json:"connections,omitempty"`
}

type LockInfo struct {
	Mutex          *sync.RWMutex
	LastUsed       time.Time
	ReferenceCount int32 // 当前锁被引用的次数，用于防止在使用时被清理
}

type LockManager struct {
	// contains filtered or unexported fields
}

type Notification struct {
	ID       string                 `json:"id"`
	Type     string                 `json:"type"` // info, success, warning, error, achievement
	Title    string                 `json:"title"`
	Message  string                 `json:"message"`
	Duration int                    `json:"duration"` // 显示时间（毫秒）
	Actions  []NotificationAction   `json:"actions,omitempty"`
	Metadata map[string]interface{} `json:"metadata,omitempty"`
}

type NotificationAction struct {
	Label  string                 `json:"label"`
	Action string                 `json:"action"`
	Style  string                 `json:"style"` // primary, secondary, danger
	Params map[string]interface{} `json:"params,omitempty"`
}

type ProgressService struct {
	// contains filtered or unexported fields
}

type ProgressTracker struct {
	TaskID      string                       // 任务唯一标识符
	Progress    int                          // 进度百分比 (0-100)
	Message     string                       // 当前状态描述
	Status      string                       // 状态：running, completed, failed
	StartTime   time.Time                    // 开始时间
	UpdateTime  time.Time                    // 最后更新时间
	Subscribers map[chan ProgressUpdate]bool // 订阅进度更新的通道
	Done        chan struct{}                // 任务完成信号
	// contains filtered or unexported fields
}

type ProgressUpdate struct {
	Progress int    `json:"progress"` // 进度百分比 (0-100)
	Message  string `json:"message"`  // 描述性消息
	Status   string `json:"status"`   // 状态：running, completed, failed
}

type ScenarioIdeas struct {
	Ideas []struct {
		Title      string `json:"title"`
		Setting    string `json:"setting"`
		Premise    string `json:"premise"`
		Characters []struct {
			Role        string   `json:"role"`
			Description string   `json:"description"`
			Goals       []string `json:"goals,omitempty"`
		} `json:"characters"`
		Conflicts []string `json:"conflicts"`
		Branches  []struct {
			Description string   `json:"description"`
			Options     []string `json:"options,omitempty"`
		} `json:"branches,omitempty"`
	} `json:"ideas"`
}

type SceneAggregateData struct {
	// 基础信息
	Scene      *models.Scene       `json:"scene"`
	Characters []*models.Character `json:"characters"`

	// 故事相关
	Story            *models.StoryData     `json:"story"`
	CurrentNode      *models.StoryNode     `json:"current_node"`
	AvailableChoices []*models.StoryChoice `json:"available_choices"`

	// 交互历史
	RecentConversations []models.Conversation `json:"recent_conversations"`

	// UI状态
	UIState *SceneUIState `json:"ui_state"`

	// 进度和统计
	Progress *SceneProgress `json:"progress"`

	// 元数据
	LastUpdated time.Time `json:"last_updated"`
	Version     string    `json:"version"`
}

type SceneAggregateService struct {
	SceneService     *SceneService
	CharacterService *CharacterService
	ContextService   *ContextService
	StoryService     *StoryService
	ProgressService  *ProgressService
	// contains filtered or unexported fields
}

type SceneData struct {
	Scene            models.Scene             `json:"scene"`
	Context          models.SceneContext      `json:"context"`
	Settings         models.SceneSettings     `json:"settings"`
	Characters       []*models.Character      `json:"characters"`
	Items            []*models.Item           `json:"items"`
	OriginalText     string                   `json:"original_text,omitempty"`
	OriginalSegments []models.OriginalSegment `json:"original_segments,omitempty"`
}

type SceneInfo struct {
	Name        string   `json:"name"`
	Description string   `json:"description"`
	Atmosphere  string   `json:"atmosphere"`
	Era         string   `json:"era"`
	Themes      []string `json:"themes"`
	Items       []string `json:"items"`
	Importance  string   `json:"importance"`
}

type SceneProgress struct {
	StoryCompletion       float64  `json:"story_completion"`
	CharacterInteractions int      `json:"character_interactions"`
	UnlockedContent       []string `json:"unlocked_content"`
	Achievements          []string `json:"achievements"`
}

type SceneService struct {
	BasePath    string
	FileCache   *storage.FileStorage
	ItemService *ItemService
	// contains filtered or unexported fields
}

type SceneServiceInterface interface {
	LoadScene(sceneID string) (*SceneData, error)
	LoadSceneNoCache(sceneID string) (*SceneData, error)
	UpdateContext(sceneID string, context *models.SceneContext) error
}

type SceneUIState struct {
	SelectedCharacterIds []string         `json:"selected_character_ids"`
	CurrentTab           string           `json:"current_tab"`
	StoryTreeExpanded    bool             `json:"story_tree_expanded"`
	ChatViewMode         string           `json:"chat_view_mode"`
	Notifications        []UINotification `json:"notifications"`
}

type ScriptService struct {
	BasePath    string
	FileStorage *storage.FileStorage
	LLM         *LLMService
}

type StatsService struct {
	BasePath string // 统计数据存储路径
	// contains filtered or unexported fields
}

type StoryImpact struct {
	ProgressChange          float64
	ShouldCreateNode        bool
	ShouldUpdateCurrentNode bool
	SignificanceLevel       int                // 1-10，交互的重要程度
	EmotionalImpact         float64            // 情绪影响强度
	RelationshipChanges     map[string]float64 // 角色关系变化
	KeyEvents               []string           // 关键事件
	UnlockTriggers          []string           // 解锁触发器
}

type StoryService struct {
	SceneService     *SceneService
	ContextService   *ContextService
	LLMService       *LLMService
	FileStorage      *storage.FileStorage
	ItemService      *ItemService
	CharacterService *CharacterService
	BasePath         string
	// contains filtered or unexported fields
}

type StoryServiceMetrics struct {
	// contains filtered or unexported fields
}

type StoryUpdate struct {
	NewNodes        []*models.StoryNode `json:"new_nodes,omitempty"`
	UpdatedNodes    []*models.StoryNode `json:"updated_nodes,omitempty"`
	ProgressChange  float64             `json:"progress_change"`
	UnlockedContent []string            `json:"unlocked_content,omitempty"`
	UpdatedTasks    []*models.Task      `json:"updated_tasks,omitempty"`   // 添加任务更新
	CompletedTasks  []*models.Task      `json:"completed_tasks,omitempty"` // 添加已完成任务
	TaskChanges     []TaskChange        `json:"task_changes,omitempty"`
}

type TabUpdate struct {
	TabID      string `json:"tab_id"`
	BadgeCount int    `json:"badge_count"`
	IsActive   bool   `json:"is_active"`
	Title      string `json:"title,omitempty"`
}

type TaskChange struct {
	TaskID    string    `json:"task_id"`
	Type      string    `json:"type"`       // "completed", "updated", "new"
	OldStatus bool      `json:"old_status"` // 原状态
	NewStatus bool      `json:"new_status"` // 新状态
	ChangedAt time.Time `json:"changed_at"`
	Reason    string    `json:"reason"` // 变化原因
}

type TaskCompletionInfo struct {
	Task            *models.Task
	MatchedKeywords []string
	CompletionHints int
}

type UIAnimation struct {
	Target   string                 `json:"target"`   // CSS选择器或元素ID
	Type     string                 `json:"type"`     // fade, slide, bounce, etc.
	Duration int                    `json:"duration"` // 毫秒
	Params   map[string]interface{} `json:"params"`
}

type UINotification struct {
	ID        string    `json:"id"`
	Type      string    `json:"type"` // info, warning, error, success
	Message   string    `json:"message"`
	Actions   []string  `json:"actions"`
	Timestamp time.Time `json:"timestamp"`
}

type UIUpdateCommands struct {
	ScrollToBottom      bool           `json:"scroll_to_bottom"`
	HighlightCharacters []string       `json:"highlight_characters"`
	UpdateChatBadges    map[string]int `json:"update_chat_badges"`
	TriggerAnimations   []UIAnimation  `json:"trigger_animations"`
	UpdateTabs          []TabUpdate    `json:"update_tabs"`
}

type Usage struct {
	PromptTokens     int
	CompletionTokens int
	TotalTokens      int
}

type UsageStats struct {
	TodayRequests int            `json:"today_requests"`
	MonthlyTokens int            `json:"monthly_tokens"`
	DailyStats    map[string]int `json:"daily_stats"`
	MonthlyStats  map[string]int `json:"monthly_stats"`
	LastUpdated   time.Time      `json:"last_updated"`
}

type UserService struct {
	BasePath    string
	FileStorage *storage.FileStorage
	// contains filtered or unexported fields
}