UniAI: Instructions file for Claude Code

UniAI - AI Assistant Guide

本文档面向参与 UniAI 开发的 AI 助手。它不是用户手册，面向用户的说明见 README.md。修改框架前请先读本文件，避免把模型差异、Editor 行为或生成式路由重新写回错误层级。

包名: com.uniai.core
版本: 0.0.1
Unity: 2022.3+
许可证: Apache 2.0

---

1. 框架定位

UniAI 是 Unity 与 AI Provider 之间的运行时框架，同时提供 Editor 助手能力。核心目标是让 Unity 项目可以通过统一 C# API 使用 Chat、Agent、Tool、MCP、多模态输入、上下文窗口和生成式资产。

当前架构重点：

• 统一请求模型: 上层只接触 AIRequest、AIResponse、AIStreamChunk、AIMessage、AIContent。
• 多协议 Provider: 内置 Claude Messages API 与 OpenAI Chat Completions 兼容协议。
• 模型元数据驱动: ModelEntry 描述能力、端点、上下文窗口、AdapterId、行为标志和行为参数。
• Adapter/Dialect 扩展: Provider 主流程保持通用，模型或厂商差异放进 adapter/dialect。
• Agent Tool Loop: AIAgentRunner 是门面，实际 loop、工具执行和 tool-call history 构造已拆分。
• 生成式路由: 生成图片等资产由 GenerativeProviderRouter 按模型元数据、渠道和 adapter 决定 provider。
• Runtime/Editor 分层: Runtime 不依赖 UnityEditor；Editor 只负责 UI、配置管理和 Unity 上下文采集。

不要把 UniAI 当成单一聊天窗口项目。Runtime API 和 Editor Chat 都是一等使用场景。

2. 当前目录职责

Runtime/
├── Core/
│   ├── AIClient / AIConfig / ChannelEntry / UniAISettings
│   ├── ChannelManager / ChannelRouteSelector / ProviderCache
│   ├── ModelRegistry / ModelEntry / ModelCapability
│   ├── Presets/                         # 内置渠道与模型预设
│   ├── Adapters/                        # AdapterAttribute / Catalog / Registry / Discovery
│   ├── ChatOrchestrator                 # 对话生命周期编排
│   ├── ConversationRuntimeFactory       # Client、Runner、ContextPipeline 生命周期
│   ├── ConversationContextPreparer      # ChatSession -> AIMessage + 上下文注入
│   ├── McpConversationInitializer       # Agent MCP 初始化与 Resource 注入
│   ├── AgentEventSessionApplier         # AgentEvent -> ChatSession
│   └── ChatSessionPolicies              # 保存和标题策略
├── Models/                              # 统一请求、响应、消息、工具、流式块
├── Providers/
│   ├── IAIProvider / IAIProviderFactory
│   ├── JsonSseProviderBase
│   ├── Claude/
│   └── OpenAI/
│       └── Chat/                        # OpenAI Chat dialect 和 request converter
├── Agent/
│   ├── AIAgentRunner                    # Agent 门面
│   ├── AgentLoop                        # stream/non-stream tool loop
│   ├── AgentToolExecutor                # 本地 Tool + MCP Tool 执行
│   ├── AgentMessageFactory              # assistant tool-call history
│   └── UniAIToolRegistry / ToolSchemaGenerator / ToolResponse
├── Chat/                                # ChatSession、历史管理和文件存储
├── Context/                             # ContextPipeline、TokenEstimator、摘要、IContextProvider
├── MCP/                                 # MCP Client、Transport、Resource Provider
├── Generative/
│   ├── GenerativeProviderRouter
│   ├── IGenerativeProviderFactory
│   ├── IGenerativeAssetProvider
│   └── Providers/OpenAI/Images/         # OpenAI Images provider + image dialect
├── Tools/                               # Runtime 可用 [UniAITool]
└── Http/                                # AIHttpClient、SSEDownloadHandler、SSEParser

Editor/
├── Setting/                             # Manager 窗口、配置 Tab、AIConfigManager
├── Chat/                                # AIChatWindow、StreamingController、ContextCollector
├── Agent/                               # Agent 资产扫描、Inspector、EditorAgentGuard
├── MCP/                                 # MCP 配置 UI
└── Tools/                               # Editor 专用 [UniAITool]