docs: add technical answers for AI plugin development questions

- 明确SQL生成与执行的分离（方案A）
- 确认数据库连接不由AI插件管理
- 建议插件内部实现模型降级逻辑
- 提供配置管理方案建议
- 强调保持架构简洁性和单一职责原则

Author: KariHall619

AI_PLUGIN_TECHNICAL_ANSWERS.md

@@ -0,0 +1,136 @@
+# AI插件开发技术问题答复
+
+基于目前的代码实现（`ai_interface.go` 和 `remote_server.go`），以下是对各技术问题的答复：
+
+## 1. SQL生成与执行的实现方式
+
+**推荐方案：方案A - 关注点分离**
+
+根据架构设计原则（AI插件不应该是特殊的），建议采用：
+- AI插件通过 `ai.generate` 方法生成SQL → 返回给主程序 → 主程序执行SQL
+
+**理由：**
+- 符合单一职责原则：AI插件负责生成，主程序或数据库插件负责执行
+- 保持架构一致性：AI插件与其他插件使用相同的Query接口，不涉及数据库操作
+- 代码实现（`remote_server.go:1790-1792`）显示只传递prompt和model，不包含数据库执行逻辑
+
+**实现示例：**
+```go
+// AI插件只负责生成SQL
+query := map[string]string{
+    "method": "ai.generate",
+    "model":  "gpt-4",
+    "prompt": "生成查询所有用户的SQL",
+    "config": `{"output_format": "sql"}`,
+}
+// 返回: {"content": "SELECT * FROM users;", "success": "true"}
+```
+
+## 2. 数据库连接信息传递
+
+**答案：不应该由AI插件管理数据库连接**
+
+根据代码实现和架构原则：
+- AI插件不应该处理数据库连接
+- 数据库连接应由专门的数据库插件或主程序管理
+- AI插件只需要在prompt中包含必要的schema信息来生成准确的SQL
+
+**建议方案：**
+```go
+// 主程序提供schema信息，不传递连接信息
+query := map[string]string{
+    "method": "ai.generate",
+    "model":  "gpt-4",
+    "prompt": "基于以下schema生成SQL: tables: users(id, name, email), orders(id, user_id, amount)",
+    "config": `{"db_dialect": "mysql"}`,  // 只提供方言信息，不提供连接
+}
+```
+
+## 3. 本地模型优先的实现策略
+
+**答案：在插件内部实现降级逻辑**
+
+根据代码实现（`ai_interface.go:33-34`），model参数是简单字符串：
+- 插件内部实现降级逻辑，对主程序透明
+- model参数格式建议直接使用模型名：`"llama2"`、`"gpt-4"`
+
+**实现示例：**
+```go
+func (p *AIPlugin) Generate(model, prompt string, config map[string]interface{}) (string, error) {
+    // 插件内部处理降级逻辑
+    if isLocalModel(model) {
+        result, err := p.callOllama(model, prompt, config)
+        if err == nil {
+            return result, nil
+        }
+        // 本地失败，自动降级到在线服务
+        log.Printf("Local model failed, falling back to online: %v", err)
+    }
+    return p.callOpenAI(mapToOnlineModel(model), prompt, config)
+}
+```
+
+## 4. 配置文件位置和格式
+
+**需要进一步决定，但建议方案：**
+
+基于现有代码，配置可通过以下方式：
+1. **环境变量**（推荐用于敏感信息）：
+   ```bash
+   OPENAI_API_KEY=xxx
+   OLLAMA_ENDPOINT=http://localhost:11434
+   ```
+
+2. **插件配置文件**（位于插件目录）：
+   ```yaml
+   # ~/.atest/extensions/ai-plugin/config.yaml
+   ai:
+     ollama:
+       endpoint: "http://localhost:11434"
+     openai:
+       api_key: "${OPENAI_API_KEY}"  # 引用环境变量
+   ```
+
+3. **通过config参数动态传递**（用于运行时配置）：
+   ```json
+   {
+     "temperature": 0.7,
+     "endpoint_override": "http://custom-ollama:11434"
+   }
+   ```
+
+## 5. SQL执行结果的返回格式
+
+**答案：不建议AI插件执行SQL**
+
+如果必须在AI插件中执行SQL（不推荐），返回格式应该是：
+```go
+// 通过content返回JSON格式的结果
+result.Pairs["content"] = `{
+    "sql": "SELECT * FROM users",
+    "rows": [
+        {"id": 1, "name": "Alice"},
+        {"id": 2, "name": "Bob"}
+    ],
+    "rowCount": 2
+}`
+
+// 通过meta返回执行元数据
+result.Pairs["meta"] = `{
+    "executionTime": "15ms",
+    "affectedRows": 0,
+    "queryType": "SELECT"
+}`
+```
+
+## 总结建议
+
+基于当前架构实现，强烈建议：
+
+1. **保持架构简洁**：AI插件只负责生成内容，不执行数据库操作
+2. **使用现有接口**：通过Query(map[string]string)接口，不创建特殊方法
+3. **插件内部处理降级**：本地/在线模型切换对主程序透明
+4. **配置分层管理**：敏感信息用环境变量，其他配置用文件
+5. **遵循单一职责**：AI生成是AI插件的职责，SQL执行是数据库组件的职责
+
+这样的设计符合当前代码实现（`remote_server.go:1788-1801`）和架构原则，保持了系统的简洁性和可维护性。