第 08 章 AI 辅助开发集成指南¶

import javax.inject.Provides
import javax.inject.Singleton
import kotlinx.serialization.json.Json
import okhttp3.MediaType.Companion.toMediaType
import retrofit2.Retrofit
import retrofit2.converter.kotlinx.serialization.asConverterFactory

// ✅ 好的注释引导Copilot生成代码
// 创建一个Retrofit实例，配置OkHttp客户端和JSON转换器
@Provides
@Singleton
fun provideRetrofit(okHttpClient: OkHttpClient): Retrofit {
    return Retrofit.Builder()
        .baseUrl(BuildConfig.BASE_URL)
        .client(okHttpClient)
        .addConverterFactory(
            Json { ignoreUnknownKeys = true }
                .asConverterFactory("application/json".toMediaType())
        )
        .build()
}

// ✅ 使用函数签名引导
// 实现一个带缓存的用户Repository
class CachedUserRepository(
    private val api: UserApi,
    private val dao: UserDao
) : UserRepository {
    override suspend fun getUser(id: String): Result<User> =
        runCatching {
            val remoteUser = api.getUser(id)
            dao.upsert(remoteUser.toEntity())
            remoteUser
        }.recoverCatching {
            dao.findById(id)?.toDomain() ?: throw it
        }
}

import javax.inject.Inject
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.withContext
import okhttp3.MediaType.Companion.toMediaType
import okhttp3.OkHttpClient
import okhttp3.Request
import okhttp3.RequestBody.Companion.toRequestBody
import org.json.JSONArray
import org.json.JSONObject

// OpenAI API 客户端
class OpenAiClient @Inject constructor(
    private val client: OkHttpClient
) {
    private val jsonMediaType = "application/json; charset=utf-8".toMediaType()

    suspend fun generateCode(
        prompt: String,
        language: String = "kotlin"
    ): Result<String> =
        withContext(Dispatchers.IO) {
            runCatching {
                val payload = JSONObject()
                    // 模型名建议由配置注入，而不是硬编码在客户端代码中
                    .put("model", BuildConfig.OPENAI_MODEL)
                    .put(
                        "input",
                        JSONArray().put(
                            JSONObject()
                                .put("role", "user")
                                .put(
                                    "content",
                                    JSONArray().put(
                                        JSONObject()
                                            .put("type", "input_text")
                                            .put(
                                                "text",
                                                """
                                                请生成一段 $language 代码。
                                                要求：
                                                1. 只返回代码。
                                                2. 在必要处添加注释。
                                                3. 优先使用稳定、可维护的实现。

                                                任务：
                                                $prompt
                                                """.trimIndent()
                                            )
                                    )
                                )
                        )
                    )

                val request = Request.Builder()
                    .url("https://api.openai.com/v1/responses")
                    .addHeader("Authorization", "Bearer ${BuildConfig.OPENAI_API_KEY}")
                    .addHeader("Content-Type", "application/json")
                    .post(payload.toString().toRequestBody(jsonMediaType))
                    .build()

                client.newCall(request).execute().use { response ->
                    val body = response.body?.string().orEmpty()

                    if (!response.isSuccessful) {
                        error("OpenAI API 调用失败: ${response.code} $body")
                    }

                    val outputText = JSONObject(body).optString("output_text")
                    require(outputText.isNotBlank()) {
                        "Responses API 未返回 output_text，请检查模型输出格式。"
                    }
                    outputText.trim()
                }
            }
        }
}

// AI生成的Compose UI测试示例
@Test
fun loginScreen_displaysErrorWhenCredentialsInvalid() {
    // Given
    composeTestRule.setContent {
        LoginScreen(
            viewModel = LoginViewModel(
                loginUseCase = mockLoginUseCase
            )
        )
    }

    // When
    composeTestRule
        .onNodeWithText("Email")
        .performTextInput("invalid@email")

    composeTestRule
        .onNodeWithText("Password")
        .performTextInput("123")

    composeTestRule
        .onNodeWithText("Login")
        .performClick()

    // Then
    composeTestRule
        .onNodeWithText("Invalid credentials")
        .assertIsDisplayed()
}

// 示例：在 Gemini 聊天窗口中提交结构化任务

"""
请帮我添加一个用户认证模块：
1. 创建LoginScreen Composable
2. 创建LoginViewModel
3. 添加Retrofit API接口
4. 创建数据模型（LoginRequest/LoginResponse）
5. 添加输入验证逻辑
6. 创建单元测试

要求：
- 使用MVVM架构
- 使用Hilt进行依赖注入
- 使用Kotlin Coroutines处理异步操作
- 支持邮箱和密码验证
- 在修改前先给出将要新增/修改的文件列表
- 如果信息不足，先列出缺失假设再继续
"""

@Composable
fun ProfileCard(
    user: User,
    onEditClick: () -> Unit
) {
    Card(
        modifier = Modifier
            .fillMaxWidth()
            .padding(16.dp),
        elevation = CardDefaults.cardElevation(defaultElevation = 4.dp)
    ) {
        Row(
            modifier = Modifier.padding(16.dp),
            verticalAlignment = Alignment.CenterVertically
        ) {
            // 根据设计图生成的头像布局
            AsyncImage(
                model = user.avatarUrl,
                contentDescription = "Avatar",
                modifier = Modifier
                    .size(64.dp)
                    .clip(CircleShape),
                contentScale = ContentScale.Crop
            )

            Spacer(modifier = Modifier.width(16.dp))

            Column(modifier = Modifier.weight(1f)) {
                Text(
                    text = user.name,
                    style = MaterialTheme.typography.titleMedium
                )
                Text(
                    text = user.email,
                    style = MaterialTheme.typography.bodyMedium,
                    color = MaterialTheme.colorScheme.onSurfaceVariant
                )
            }

            IconButton(onClick = onEditClick) {
                Icon(Icons.Default.Edit, contentDescription = "Edit")
            }
        }
    }
}

// ✅ 好的提示示例
"""
请帮我重构这个ViewModel：
1. 将状态管理从LiveData迁移到StateFlow
2. 添加错误处理逻辑
3. 优化内存泄漏风险
4. 添加单元测试

当前代码：
[paste code here]
"""

// ❌ 不好的提示示例
"帮我改代码" // 太模糊，缺乏上下文