W5: 新建会话时选角色(persona)
改了什么:
- `POST /api/v1/sessions` 支持可选 `personaId`:null(或全空白)走**不带 body** 的重载
(与选角之前逐字节相同),非空才发 `{"personaId":"…"}`;新增 CreateSessionRequest /
CreateSessionResponse.personaId / SessionSummaryDto.personaId。
- 新增**用户侧**角色目录取数:PersonaApi + UserPersonaDto + PersonaRepository(沿用 apiCall/Result)。
刻意不用 admin 的 PersonaSummaryDto/AdminApi:用户侧不下发 admin 专属 thinking,admin 端点还要管理档。
- 抽屉「+」不再直接建会话,而是先开角色弹层(「默认角色」+ 各角色,角色名 + character 简述,
失败/加载中各自有话说);确认后按所选创建。角色表拿不到时降级为「只有默认角色」,不挡建会话。
- 会话行摘要前缀该会话绑定的角色名:能拿到角色表就显示名字,拿不到就原样显示 id,未绑就不显示。
为什么:
- 此前 createSession 完全没有 body,新建的会话一律是默认角色,后端 v0.42 起的多角色能力用不上。
- 会话角色**创建后不可变**(`PATCH /sessions/{id}` 一旦收到 personaId 就 400),所以选角这一步
只在建会话时问一次,也必须在建会话时问。
测试 353 → 385(+32),assembleDebug 与 testDebugUnitTest 均通过。
变异验证:把仓库改回「null 也发 body」后,SessionRepositoryCreateTest 有 2 条断言 FAIL。
This commit is contained in:
1 parent
664fd8dcef
commit
217cfe3d5f
15 files changed
+917
-11
No files matched your search
@@ -10,12 +10,14 @@ import top.yeij.cyrene.data.api.AdminApi
|
||||
import top.yeij.cyrene.data.api.ApiClientFactory
|
||||
import top.yeij.cyrene.data.api.ChatApi
|
||||
import top.yeij.cyrene.data.api.MetaApi
|
||||
import top.yeij.cyrene.data.api.PersonaApi
|
||||
import top.yeij.cyrene.data.api.SessionsApi
|
||||
import top.yeij.cyrene.data.api.UploadApi
|
||||
import top.yeij.cyrene.data.repository.AdminRepository
|
||||
import top.yeij.cyrene.data.repository.ChatRepository
|
||||
import top.yeij.cyrene.data.repository.MessageRepository
|
||||
import top.yeij.cyrene.data.repository.MetaRepository
|
||||
import top.yeij.cyrene.data.repository.PersonaRepository
|
||||
import top.yeij.cyrene.data.repository.SessionRepository
|
||||
import top.yeij.cyrene.data.repository.UploadRepository
|
||||
import top.yeij.cyrene.data.ws.ChatSocket
|
||||
@@ -147,6 +149,28 @@ class AppContainer(context: Context) {
|
||||
|
||||
val metaRepository: MetaRepository get() = MetaRepository(metaApi)
|
||||
|
||||
private var cachedPersonaApi: PersonaApi? = null
|
||||
private var cachedPersonaBaseUrl: String? = null
|
||||
|
||||
/** 用户侧角色目录(`GET /api/v1/personas`);与 [metaApi] 同源(同一 baseUrl、同一 token/401 处理)。 */
|
||||
val personaApi: PersonaApi
|
||||
get() {
|
||||
val baseUrl = authManager.currentBaseUrl
|
||||
val cached = cachedPersonaApi
|
||||
if (cached != null && cachedPersonaBaseUrl == baseUrl) return cached
|
||||
val created = ApiClientFactory.create(
|
||||
baseUrl = baseUrl,
|
||||
service = PersonaApi::class.java,
|
||||
tokenProvider = authManager::currentToken,
|
||||
unauthorizedPolicy = authManager.unauthorizedPolicy,
|
||||
)
|
||||
cachedPersonaBaseUrl = baseUrl
|
||||
cachedPersonaApi = created
|
||||
return created
|
||||
}
|
||||
|
||||
val personaRepository: PersonaRepository get() = PersonaRepository(personaApi)
|
||||
|
||||
fun createChatSocket(): ChatSocket = ChatSocket(
|
||||
baseUrlProvider = { authManager.currentBaseUrl },
|
||||
tokenProvider = authManager::currentToken,
|
||||
|
||||
@@ -0,0 +1,18 @@
|
||||
package top.yeij.cyrene.data.api
|
||||
|
||||
import top.yeij.cyrene.data.api.dto.UserPersonaDto
|
||||
import retrofit2.Response
|
||||
import retrofit2.http.GET
|
||||
|
||||
/**
|
||||
* **用户侧**角色目录(api-client §1 行 9)。任意已认证角色可读,无 token 才 `401`。
|
||||
*
|
||||
* 与 [AdminApi.personas] 分开是有意的:admin 端点每项多一个 `thinking`,而且整条路径要求
|
||||
* `viewer` 以上的管理档——拿它当用户侧接口用,普通用户身上会拿到 `403`。
|
||||
*/
|
||||
interface PersonaApi {
|
||||
|
||||
/** 角色列表;服务端顺序即权威顺序,客户端不重排。 */
|
||||
@GET("api/v1/personas")
|
||||
suspend fun personas(): Response<ApiEnvelope<List<UserPersonaDto>>>
|
||||
}
|
||||
@@ -1,5 +1,6 @@
|
||||
package top.yeij.cyrene.data.api
|
||||
|
||||
import top.yeij.cyrene.data.api.dto.CreateSessionRequest
|
||||
import top.yeij.cyrene.data.api.dto.CreateSessionResponse
|
||||
import top.yeij.cyrene.data.api.dto.DeleteSessionResponse
|
||||
import top.yeij.cyrene.data.api.dto.HistoryMessageDto
|
||||
@@ -26,10 +27,26 @@ interface SessionsApi {
|
||||
@GET("api/v1/sessions")
|
||||
suspend fun listSessions(): Response<ApiEnvelope<List<SessionSummaryDto>>>
|
||||
|
||||
/** 无 body;服务端返回 `201 {data:{sessionId}}`。 */
|
||||
/**
|
||||
* 新建次级会话,**完全不带 body**(= 不绑角色,跟随全局默认角色)。
|
||||
*
|
||||
* 这个无参重载是给「不选角色」这条路留的:`personaId` 为 null 时走它,线上请求与本端支持
|
||||
* 选角之前**逐字节相同**——不会因为多了一个可选字段而改变任何既有行为。
|
||||
* 服务端返回 `201 {data:{sessionId}}`。
|
||||
*/
|
||||
@POST("api/v1/sessions")
|
||||
suspend fun createSession(): Response<ApiEnvelope<CreateSessionResponse>>
|
||||
|
||||
/**
|
||||
* 新建会话并**在创建时绑定角色**(v0.42)。
|
||||
*
|
||||
* `personaId` 为**未知角色** → `400 bad_request`;非空时响应会回显它。
|
||||
* 会话角色**只在创建时写入、之后不可变**:`PATCH /sessions/{id}` 收到 `personaId` 一律 `400`,
|
||||
* 要换角色只能新开会话(见 [UpdateSessionRequest])。
|
||||
*/
|
||||
@POST("api/v1/sessions")
|
||||
suspend fun createSession(@Body body: CreateSessionRequest): Response<ApiEnvelope<CreateSessionResponse>>
|
||||
|
||||
/** 主会话 `web` 删除会返回 `403 forbidden`。 */
|
||||
@DELETE("api/v1/sessions/{id}")
|
||||
suspend fun deleteSession(@Path("id") sessionId: String): Response<ApiEnvelope<DeleteSessionResponse>>
|
||||
|
||||
@@ -0,0 +1,26 @@
|
||||
package top.yeij.cyrene.data.api.dto
|
||||
|
||||
import kotlinx.serialization.Serializable
|
||||
|
||||
/**
|
||||
* `GET /api/v1/personas`(**用户侧**角色目录,api-client §1 行 9)的一项。
|
||||
*
|
||||
* 与 admin 侧的 [PersonaSummaryDto] 同源同形,但**用户侧不下发 admin 专属的 `thinking`**
|
||||
* ——这正是不能拿 admin 端点当用户侧端点用的原因之一(用户侧不暴露模型调用旋钮)。
|
||||
*
|
||||
* [mode] / [mood] 都是**开放集合**:未知取值原样保留(不丢弃、不报错、不占位符),渲染时才映射。
|
||||
* `mood` 为空串是「该角色暂无被跟踪的情绪」,不是异常,也不伪造默认值。
|
||||
* [chatBackground] 与 admin 侧共用 [ChatBackgroundDto](同一个后端结构)。
|
||||
*/
|
||||
@Serializable
|
||||
data class UserPersonaDto(
|
||||
val id: String,
|
||||
val name: String = "",
|
||||
val character: String = "",
|
||||
val isDefault: Boolean = false,
|
||||
val mode: String = "",
|
||||
val memoryNamespace: String = "",
|
||||
val avatar: String? = null,
|
||||
val chatBackground: ChatBackgroundDto? = null,
|
||||
val mood: String? = null,
|
||||
)
|
||||
@@ -31,6 +31,13 @@ data class SessionSummaryDto(
|
||||
* 默认 `0` 的口径也是安全的:它只会让角标少显示一会儿,`Get /sessions` 一到就被纠正。
|
||||
*/
|
||||
val unreadCount: Int = 0,
|
||||
/**
|
||||
* 该会话绑定的角色 id(v0.42,可选);**空/缺省 = 继承全局默认角色**。
|
||||
*
|
||||
* 只读字段:会话角色**只在创建时**写入,之后不可变(`PATCH` 一旦收到 `personaId` 一律 400),
|
||||
* 所以它不可能被本端改。默认值是为了旧快照仍能解码(同 [unreadCount] 的理由)。
|
||||
*/
|
||||
val personaId: String? = null,
|
||||
) {
|
||||
val isMain: Boolean
|
||||
get() = type == TYPE_MAIN || id == MAIN_SESSION_ID
|
||||
@@ -42,10 +49,32 @@ data class SessionSummaryDto(
|
||||
}
|
||||
}
|
||||
|
||||
/** `POST /api/v1/sessions` → `201 {"data":{"sessionId":"web:<uuid>"}}`。 */
|
||||
/**
|
||||
* `POST /api/v1/sessions` → `201 {"data":{"sessionId":"web:<uuid>"}}`。
|
||||
*
|
||||
* [personaId] 只在**创建时显式绑了角色**才回显(v0.42);省略时响应形状与 v0.41 完全一致,
|
||||
* 所以它是可空字段,不能拿它的有无去判断别的事。
|
||||
*/
|
||||
@Serializable
|
||||
data class CreateSessionResponse(
|
||||
val sessionId: String,
|
||||
val personaId: String? = null,
|
||||
)
|
||||
|
||||
/**
|
||||
* `POST /api/v1/sessions` 的请求体(v0.42:创建时绑定角色)。
|
||||
*
|
||||
* 服务端把「省略 `personaId`」与「`personaId` 为空」当成同一件事:**不绑**
|
||||
* (`persona_id=''`,继承全局默认角色)。`personaId` 为**未知角色**时回 `400 bad_request`。
|
||||
*
|
||||
* 生产路径上 null 不会走到这里——仓库对 null 走的是**完全不带 body** 的重载
|
||||
* (与本端支持选角之前的线上请求逐字节相同)。这里保留可空字段,是为了让
|
||||
* 「null 序列化后整个键缺席」这件事有一处**可被测试钉住**的表达
|
||||
* (生产 `Json` 的 `explicitNulls = false`)。
|
||||
*/
|
||||
@Serializable
|
||||
data class CreateSessionRequest(
|
||||
val personaId: String? = null,
|
||||
)
|
||||
|
||||
/**
|
||||
|
||||
@@ -0,0 +1,24 @@
|
||||
package top.yeij.cyrene.data.repository
|
||||
|
||||
import kotlinx.coroutines.CoroutineDispatcher
|
||||
import kotlinx.coroutines.Dispatchers
|
||||
import kotlinx.coroutines.withContext
|
||||
import top.yeij.cyrene.data.api.PersonaApi
|
||||
import top.yeij.cyrene.data.api.apiCall
|
||||
import top.yeij.cyrene.data.api.dto.UserPersonaDto
|
||||
|
||||
/**
|
||||
* 用户侧角色目录取数层(api-client §1 行 9),供「新建会话时选角色」用。
|
||||
*
|
||||
* 仓库不持有持久化状态:调用方失败时保留上一次拿到的列表——角色目录拿不到只会让弹层少几行,
|
||||
* 不该连带挡掉「用默认角色新建会话」这条降级路径。
|
||||
*/
|
||||
class PersonaRepository(
|
||||
private val api: PersonaApi,
|
||||
private val dispatcher: CoroutineDispatcher = Dispatchers.IO,
|
||||
) {
|
||||
|
||||
suspend fun personas(): Result<List<UserPersonaDto>> = withContext(dispatcher) {
|
||||
apiCall { api.personas() }
|
||||
}
|
||||
}
|
||||
@@ -2,6 +2,7 @@ package top.yeij.cyrene.data.repository
|
||||
|
||||
import top.yeij.cyrene.data.api.SessionsApi
|
||||
import top.yeij.cyrene.data.api.apiCall
|
||||
import top.yeij.cyrene.data.api.dto.CreateSessionRequest
|
||||
import top.yeij.cyrene.data.api.dto.ReadSessionRequest
|
||||
import top.yeij.cyrene.data.api.dto.ReadSessionResponse
|
||||
import top.yeij.cyrene.data.api.dto.SessionSummaryDto
|
||||
@@ -30,9 +31,24 @@ class SessionRepository(
|
||||
apiCall { api.listSessions() }
|
||||
}
|
||||
|
||||
/** `POST /sessions`,成功返回新建的 `sessionId`(形如 `web:<uuid>`)。 */
|
||||
suspend fun createSession(): Result<String> = withContext(dispatcher) {
|
||||
apiCall { api.createSession() }.map { it.sessionId }
|
||||
/**
|
||||
* `POST /sessions`,成功返回新建的 `sessionId`(形如 `web:<uuid>`)。
|
||||
*
|
||||
* @param personaId null(或全空白)= **不绑角色**:走**不带 body** 的请求,线上与本端支持选角
|
||||
* 之前逐字节相同。空白按 null 处理是有依据的——契约里「省略 `personaId`」与「`personaId`
|
||||
* 为空」是同一件事(不绑,继承全局默认角色),没必要把 `{"personaId":""}` 发上去。
|
||||
* 非空 = 创建时绑定该角色,未知角色服务端回 `400 bad_request`。
|
||||
*
|
||||
* 角色**只在创建时**能定:`PATCH /sessions/{id}` 一旦收到 `personaId` 就回 `400`,要换角色只能新开。
|
||||
*/
|
||||
suspend fun createSession(personaId: String? = null): Result<String> = withContext(dispatcher) {
|
||||
val persona = personaId?.takeIf { it.isNotBlank() }
|
||||
val created = if (persona == null) {
|
||||
apiCall { api.createSession() }
|
||||
} else {
|
||||
apiCall { api.createSession(CreateSessionRequest(personaId = persona)) }
|
||||
}
|
||||
created.map { it.sessionId }
|
||||
}
|
||||
|
||||
/**
|
||||
|
||||
@@ -0,0 +1,104 @@
|
||||
package top.yeij.cyrene.ui.sessions
|
||||
|
||||
import top.yeij.cyrene.data.api.dto.UserPersonaDto
|
||||
|
||||
/**
|
||||
* 「新建会话时选角色」的纯逻辑:弹层选项的构造、会话行上的角色名回填。
|
||||
* 抽在这里是为了能直接单测——不依赖 Compose,也不依赖服务端。
|
||||
*/
|
||||
|
||||
/**
|
||||
* 弹层里的一项。[personaId] 为 null 就是**「默认角色」**:不绑 personaId,跟随全局默认角色。
|
||||
*
|
||||
* [title] 一定非空(服务端 `name` 为空白时回落到 `id`);[description] 为 null 表示
|
||||
* **没有简述**,此时只显示名字,不编占位符。
|
||||
*/
|
||||
data class PersonaChoice(
|
||||
val personaId: String?,
|
||||
val title: String,
|
||||
val description: String?,
|
||||
)
|
||||
|
||||
/** 「默认角色」那一行的标题([PersonaChoice.personaId] 为 null 的那一项恒是它)。 */
|
||||
internal const val DEFAULT_PERSONA_TITLE = "默认角色"
|
||||
|
||||
/** 「默认角色」的简述:只写契约里写明的事。 */
|
||||
private const val DEFAULT_PERSONA_DESCRIPTION = "不绑定角色,跟随全局默认"
|
||||
|
||||
/**
|
||||
* 构造弹层选项:**「默认角色」恒在第一位**,其余按服务端顺序原样排——服务端是排序的权威,
|
||||
* 客户端不重排、不去重、不丢弃不认识的取值。
|
||||
*
|
||||
* 角色名空白时回落到 `id`(与管理页同一口径:宁可显示一个 id,也不显示空行);
|
||||
* `character` 空白 = 没有简述,只显示名字。
|
||||
*/
|
||||
internal fun personaChoices(personas: List<UserPersonaDto>): List<PersonaChoice> = buildList {
|
||||
add(
|
||||
PersonaChoice(
|
||||
personaId = null,
|
||||
title = DEFAULT_PERSONA_TITLE,
|
||||
description = defaultRoleDescription(personas),
|
||||
),
|
||||
)
|
||||
personas.forEach { persona ->
|
||||
add(
|
||||
PersonaChoice(
|
||||
personaId = persona.id,
|
||||
title = persona.name.ifBlank { persona.id },
|
||||
description = persona.character.takeIf { it.isNotBlank() },
|
||||
),
|
||||
)
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 「默认角色」那一行的简述:能看出全局默认是哪个角色时**点名**它,免得弹层里两行都叫「默认」
|
||||
* 分不清——服务端 `isDefault` 标记的那一位就是 `personaId` 省略时的回落目标。
|
||||
*
|
||||
* 角色表里没有任何默认标记(或它没有名字也没有 id)时不点名:**不猜**。
|
||||
*/
|
||||
private fun defaultRoleDescription(personas: List<UserPersonaDto>): String {
|
||||
val fallback = personas.firstOrNull { it.isDefault }?.let { it.name.ifBlank { it.id } }
|
||||
return if (fallback.isNullOrBlank()) {
|
||||
DEFAULT_PERSONA_DESCRIPTION
|
||||
} else {
|
||||
"$DEFAULT_PERSONA_DESCRIPTION(当前「$fallback」)"
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 会话行上的角色名:**只有真的绑了角色(`personaId` 非空白)才显示**。
|
||||
*
|
||||
* - 绑了 + 角色表里有 → 角色名;
|
||||
* - 绑了 + 角色表里没有(角色表没拉回来 / 角色被改名或删掉)→ **原样显示那个 id**,
|
||||
* 不猜、不硬编码任何映射表;
|
||||
* - `personaId` 空/缺省(继承全局默认角色)→ null(不显示):那是绝大多数会话的常态,
|
||||
* 每行都挂一个「默认」只是噪声。
|
||||
*/
|
||||
internal fun personaLabelFor(personaId: String?, personas: List<PersonaChoice>): String? {
|
||||
val id = personaId?.takeIf { it.isNotBlank() } ?: return null
|
||||
return personas.firstOrNull { it.personaId == id }?.title ?: id
|
||||
}
|
||||
|
||||
/** 会话行的摘要行文本:`[角色名 ·] 最后一条消息预览`;两者都没有 → null(该行不画摘要)。 */
|
||||
internal fun sessionSummaryText(personaLabel: String?, preview: String?): String? =
|
||||
listOfNotNull(personaLabel, preview)
|
||||
.filter { it.isNotBlank() }
|
||||
.takeIf { it.isNotEmpty() }
|
||||
?.joinToString(" · ")
|
||||
|
||||
/**
|
||||
* 角色目录的拉取结果 → 新状态(纯函数)。
|
||||
*
|
||||
* **只有成功才动列表**:失败保留上一次拿到的列表(一次网络抖动不该把好数据擦掉),
|
||||
* 也不把 [SessionsUiState.personasLoaded] 打回 false——拿到过就是拿到过,那时列表里还是有内容的。
|
||||
* 失败只把原因写进 [SessionsUiState.personaError]:弹层里显示它,用默认角色建会话这条路不受影响。
|
||||
*/
|
||||
internal fun SessionsUiState.withPersonaResult(
|
||||
loaded: List<UserPersonaDto>? = null,
|
||||
failure: String? = null,
|
||||
): SessionsUiState = if (loaded != null) {
|
||||
copy(personas = personaChoices(loaded), personasLoaded = true, personaError = null)
|
||||
} else {
|
||||
copy(personaError = failure)
|
||||
}
|
||||
@@ -9,11 +9,14 @@ import androidx.compose.foundation.layout.Row
|
||||
import androidx.compose.foundation.layout.Spacer
|
||||
import androidx.compose.foundation.layout.fillMaxWidth
|
||||
import androidx.compose.foundation.layout.height
|
||||
import androidx.compose.foundation.layout.heightIn
|
||||
import androidx.compose.foundation.layout.padding
|
||||
import androidx.compose.foundation.layout.width
|
||||
import androidx.compose.foundation.lazy.LazyColumn
|
||||
import androidx.compose.foundation.lazy.items
|
||||
import androidx.compose.foundation.rememberScrollState
|
||||
import androidx.compose.foundation.shape.RoundedCornerShape
|
||||
import androidx.compose.foundation.verticalScroll
|
||||
import androidx.compose.runtime.Composable
|
||||
import androidx.compose.runtime.getValue
|
||||
import androidx.compose.runtime.mutableStateOf
|
||||
@@ -48,12 +51,20 @@ import top.yukonga.miuix.kmp.theme.MiuixTheme
|
||||
*
|
||||
* 行内交互:单击切换会话、**长按重命名**、行尾置顶/取消置顶;删除只对次级会话开放。
|
||||
* 标题是服务端的自动标题(首条用户消息生成),没有就落到兜底标题。
|
||||
*
|
||||
* ## 新建会话要先选角色
|
||||
* 「+」不再直接建会话,而是先开 [NewSessionDialog]。理由是角色**只在创建时**能定、之后不可变
|
||||
* (`PATCH /sessions/{id}` 收到 `personaId` 一律 400),选错了只能删掉重开——这一步值得停下来问一次。
|
||||
*
|
||||
* @param onCreate 参数是这次要绑定的角色 id:**null = 「默认角色」**(不绑,跟随全局默认角色)。
|
||||
* 类型必须是 `(String?) -> Unit`:调用方传的是 `SessionsViewModel::createSession` 这个方法引用,
|
||||
* 两边签名逐字对应。
|
||||
*/
|
||||
@Composable
|
||||
fun ColumnScope.SessionDrawerContent(
|
||||
state: SessionsUiState,
|
||||
onSelect: (String) -> Unit,
|
||||
onCreate: () -> Unit,
|
||||
onCreate: (String?) -> Unit,
|
||||
onDelete: (SessionItem) -> Unit,
|
||||
onTogglePin: (SessionItem) -> Unit,
|
||||
onRename: (String, String) -> Unit,
|
||||
@@ -63,6 +74,7 @@ fun ColumnScope.SessionDrawerContent(
|
||||
) {
|
||||
var pendingDelete by remember { mutableStateOf<SessionItem?>(null) }
|
||||
var pendingRename by remember { mutableStateOf<SessionItem?>(null) }
|
||||
var pendingNewSession by remember { mutableStateOf(false) }
|
||||
|
||||
Column(modifier = Modifier.padding(horizontal = 20.dp, vertical = 20.dp)) {
|
||||
Text("Cyrene", style = MiuixTheme.textStyles.title2)
|
||||
@@ -80,7 +92,7 @@ fun ColumnScope.SessionDrawerContent(
|
||||
verticalAlignment = Alignment.CenterVertically,
|
||||
) {
|
||||
Text("会话", style = MiuixTheme.textStyles.subtitle, modifier = Modifier.weight(1f))
|
||||
IconButton(onClick = onCreate) {
|
||||
IconButton(onClick = { pendingNewSession = true }) {
|
||||
Icon(imageVector = MiuixIcons.Add, contentDescription = "新建会话")
|
||||
}
|
||||
}
|
||||
@@ -92,6 +104,9 @@ fun ColumnScope.SessionDrawerContent(
|
||||
items(items = state.sessions, key = { it.id }) { session ->
|
||||
SessionRow(
|
||||
session = session,
|
||||
// 角色名在这里回填而不是在 VM 里拼进 SessionItem:这里能拿到角色表(也就能表达
|
||||
// 「角色表还没回来」的降级),而且 [personaLabelFor] 是一条可单测的纯函数。
|
||||
personaLabel = personaLabelFor(session.personaId, state.personas),
|
||||
active = session.id == state.activeSessionId,
|
||||
onClick = { onSelect(session.id) },
|
||||
onTogglePin = { onTogglePin(session) },
|
||||
@@ -157,8 +172,118 @@ fun ColumnScope.SessionDrawerContent(
|
||||
onDismiss = { pendingRename = null },
|
||||
)
|
||||
}
|
||||
|
||||
if (pendingNewSession) {
|
||||
NewSessionDialog(
|
||||
personas = state.personas,
|
||||
personasLoaded = state.personasLoaded,
|
||||
personaError = state.personaError,
|
||||
onConfirm = { personaId ->
|
||||
onCreate(personaId)
|
||||
pendingNewSession = false
|
||||
},
|
||||
onDismiss = { pendingNewSession = false },
|
||||
)
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 「新建会话」的角色弹层。
|
||||
*
|
||||
* 用 Compose 的 `Dialog` + Miuix 内容,与同文件的重命名 / 删除确认**同一套做法**:抽屉只有 300dp 宽,
|
||||
* 角色列表需要一块能盖住全屏的空间,也没必要去猜 Miuix 的弹层组件 API。选项行仍是
|
||||
* `PreferenceCard { BasicComponent(...) }`(Miuix 列表项的底座,自身没有背景与圆角)。
|
||||
*
|
||||
* 选中项是一个 `String?`,与 [PersonaChoice.personaId] 同一口径(null = 「默认角色」);
|
||||
* **每次打开都从「默认角色」开始**——新建会话是一次新决定,不沿用上一次的选择。
|
||||
*
|
||||
* 角色目录没拉回来时,这里只剩「默认角色」:**正在拉**与**服务端真的没有角色**要分开说
|
||||
* ([personasLoaded]),失败则把原因也摆出来。降级目标是「照样能用默认角色建会话」,
|
||||
* 而不是把新建会话整个挡掉。
|
||||
*/
|
||||
@Composable
|
||||
private fun NewSessionDialog(
|
||||
personas: List<PersonaChoice>,
|
||||
personasLoaded: Boolean,
|
||||
personaError: String?,
|
||||
onConfirm: (String?) -> Unit,
|
||||
onDismiss: () -> Unit,
|
||||
) {
|
||||
var selected by remember { mutableStateOf<String?>(null) }
|
||||
|
||||
Dialog(onDismissRequest = onDismiss) {
|
||||
Column(
|
||||
modifier = Modifier
|
||||
.fillMaxWidth()
|
||||
.background(MiuixTheme.colorScheme.surface, RoundedCornerShape(20.dp))
|
||||
.padding(20.dp),
|
||||
) {
|
||||
Text("新建会话", style = MiuixTheme.textStyles.title3)
|
||||
Spacer(Modifier.height(4.dp))
|
||||
Text(
|
||||
text = "选择这个会话的角色。角色创建后不可更改,要换角色请新开会话。",
|
||||
style = MiuixTheme.textStyles.footnote2,
|
||||
color = MiuixTheme.colorScheme.onSurfaceVariantSummary,
|
||||
)
|
||||
Spacer(Modifier.height(12.dp))
|
||||
|
||||
Column(
|
||||
modifier = Modifier
|
||||
.heightIn(max = PERSONA_LIST_MAX_HEIGHT)
|
||||
.verticalScroll(rememberScrollState()),
|
||||
) {
|
||||
personas.forEach { choice ->
|
||||
PreferenceCard {
|
||||
BasicComponent(
|
||||
title = choice.title,
|
||||
summary = choice.description,
|
||||
onClick = { selected = choice.personaId },
|
||||
endActions = {
|
||||
if (selected == choice.personaId) {
|
||||
Text(
|
||||
text = "✓",
|
||||
style = MiuixTheme.textStyles.main,
|
||||
color = MiuixTheme.colorScheme.primary,
|
||||
)
|
||||
}
|
||||
},
|
||||
)
|
||||
}
|
||||
Spacer(Modifier.height(8.dp))
|
||||
}
|
||||
}
|
||||
|
||||
if (!personasLoaded && personaError == null) {
|
||||
// 「还没拉到」不能长得像「服务端没有角色」——那会让人以为角色功能没了。
|
||||
Text(
|
||||
text = "角色列表加载中…",
|
||||
style = MiuixTheme.textStyles.footnote2,
|
||||
color = MiuixTheme.colorScheme.onSurfaceVariantSummary,
|
||||
)
|
||||
Spacer(Modifier.height(8.dp))
|
||||
}
|
||||
|
||||
if (personaError != null) {
|
||||
Text(
|
||||
text = "角色列表加载失败:$personaError",
|
||||
style = MiuixTheme.textStyles.footnote2,
|
||||
color = MiuixTheme.colorScheme.error,
|
||||
)
|
||||
Spacer(Modifier.height(8.dp))
|
||||
}
|
||||
|
||||
Row(modifier = Modifier.fillMaxWidth(), horizontalArrangement = Arrangement.End) {
|
||||
TextButton("取消", onClick = onDismiss)
|
||||
Spacer(Modifier.width(8.dp))
|
||||
TextButton("创建", onClick = { onConfirm(selected) })
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/** 弹层里角色列表的最大高度:超出就滚动,别把「创建」按钮挤出窄屏的可见区。 */
|
||||
private val PERSONA_LIST_MAX_HEIGHT = 320.dp
|
||||
|
||||
/**
|
||||
* 会话行。手势只有**一个**检测器:整个行由 `combinedClickable` 负责单击/长按,
|
||||
* `BasicComponent` 因此不再传 `onClick`(传了它内部会再装一个 clickable,
|
||||
@@ -176,10 +301,14 @@ fun ColumnScope.SessionDrawerContent(
|
||||
* `body2.fontSize` + `summaryColor()`),**唯一的差异是收紧了行数**:
|
||||
* 标题与摘要都 `maxLines = 1` + 省略号——这正是「可读性要强」要的效果:长标题不再在约 116dp 的
|
||||
* 列里折成两三行把卡片撑高,而是稳定地占一行、尾部省略,列表因此等高、可扫读。
|
||||
*
|
||||
* @param personaLabel 该会话绑定的**角色名**([personaLabelFor] 的回填;拿不到就不显示)。
|
||||
* 它挂在摘要行前面——「这个会话是谁在答话」比最后一条消息更该先被看到。
|
||||
*/
|
||||
@Composable
|
||||
private fun SessionRow(
|
||||
session: SessionItem,
|
||||
personaLabel: String?,
|
||||
active: Boolean,
|
||||
onClick: () -> Unit,
|
||||
onTogglePin: () -> Unit,
|
||||
@@ -189,6 +318,7 @@ private fun SessionRow(
|
||||
val titleColor = BasicComponentDefaults.titleColor().color
|
||||
val summaryColor = BasicComponentDefaults.summaryColor().color
|
||||
val badge = unreadBadgeText(session.unreadCount)
|
||||
val summary = sessionSummaryText(personaLabel, session.lastMessage)
|
||||
|
||||
PreferenceCard {
|
||||
BasicComponent(
|
||||
@@ -254,9 +384,9 @@ private fun SessionRow(
|
||||
}
|
||||
}
|
||||
}
|
||||
session.lastMessage?.let { preview ->
|
||||
summary?.let { line ->
|
||||
Text(
|
||||
text = preview,
|
||||
text = line,
|
||||
fontSize = MiuixTheme.textStyles.body2.fontSize,
|
||||
color = summaryColor,
|
||||
maxLines = 1,
|
||||
|
||||
@@ -29,6 +29,11 @@ data class SessionItem(
|
||||
val lastMessageAt: Long? = null,
|
||||
/** 未读条数(服务端 `unreadCount`,D4);`0` = 无未读、不显示角标。 */
|
||||
val unreadCount: Int = 0,
|
||||
/**
|
||||
* 该会话绑定的角色 id(服务端 `personaId`,v0.42);null = 未绑(继承全局默认角色)。
|
||||
* 只用来在列表行上回填角色名,见 [personaLabelFor]。
|
||||
*/
|
||||
val personaId: String? = null,
|
||||
)
|
||||
|
||||
data class SessionsUiState(
|
||||
@@ -39,6 +44,17 @@ data class SessionsUiState(
|
||||
val fromCache: Boolean = false,
|
||||
val syncedAt: Long = 0L,
|
||||
val error: String? = null,
|
||||
/**
|
||||
* 角色目录(`GET /personas`),渲染「新建会话」的角色弹层用;第一项恒是「默认角色」。
|
||||
*
|
||||
* 拿不到时它就是空的——弹层里只剩「默认角色」,新建会话照样能走完。这是**有意的降级**:
|
||||
* 角色目录拿不到不该挡掉建会话。
|
||||
*/
|
||||
val personas: List<PersonaChoice> = emptyList(),
|
||||
/** 角色目录**已经成功拉回过一次**。用来把「还没拉到」与「服务端就是没有角色」分开。 */
|
||||
val personasLoaded: Boolean = false,
|
||||
/** 角色目录拉取失败的原因。与会话列表的 [error] 分开:它只影响弹层里那几行,不动列表状态。 */
|
||||
val personaError: String? = null,
|
||||
)
|
||||
|
||||
/**
|
||||
@@ -134,6 +150,24 @@ class SessionsViewModel(private val container: AppContainer) : ViewModel() {
|
||||
super.onCleared()
|
||||
}
|
||||
|
||||
/**
|
||||
* 拉角色目录(用户侧 `GET /personas`),供「新建会话」的角色弹层用。
|
||||
*
|
||||
* **跟着 [refresh] 走**:初始化 / 新建 / 删除 / 抽屉打开,与会话列表同一节奏——角色也可能在
|
||||
* 管理侧被改名或增删,而那些改动**没有任何 WS 帧**会推过来,只能靠这里对齐。
|
||||
*
|
||||
* 失败**只记 [SessionsUiState.personaError]**,并**保留上一次拿到的列表**(一次网络抖动不该把
|
||||
* 好数据擦掉);不碰会话列表的错误态——角色目录拿不到只影响「能不能选角色」,
|
||||
* 用默认角色新建会话这条路照样通。
|
||||
*/
|
||||
private fun loadPersonas() {
|
||||
viewModelScope.launch {
|
||||
container.personaRepository.personas()
|
||||
.onSuccess { list -> _state.update { it.withPersonaResult(loaded = list) } }
|
||||
.onFailure { e -> _state.update { it.withPersonaResult(failure = e.userMessage()) } }
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 拉取服务端列表。
|
||||
*
|
||||
@@ -141,6 +175,7 @@ class SessionsViewModel(private val container: AppContainer) : ViewModel() {
|
||||
* 只是去对齐服务端状态的场景(抽屉打开、改名/置顶之后),避免闪一下横幅。
|
||||
*/
|
||||
fun refresh(silent: Boolean = false) {
|
||||
loadPersonas()
|
||||
viewModelScope.launch {
|
||||
if (!silent) _state.update { it.copy(loading = true) }
|
||||
container.sessionRepository.listSessions()
|
||||
@@ -195,9 +230,15 @@ class SessionsViewModel(private val container: AppContainer) : ViewModel() {
|
||||
pushReadCursor(sessionId)
|
||||
}
|
||||
|
||||
fun createSession() {
|
||||
/**
|
||||
* 新建会话;[personaId] 为 null 表示**「默认角色」**(不绑 personaId,跟随全局默认角色)。
|
||||
*
|
||||
* 角色**只在创建时**能定:服务端 `PATCH /sessions/{id}` 一旦收到 `personaId` 就回 `400`,
|
||||
* 所以本端没有「会话内换角色」这个动作,选角只发生在这里。
|
||||
*/
|
||||
fun createSession(personaId: String? = null) {
|
||||
viewModelScope.launch {
|
||||
container.sessionRepository.createSession()
|
||||
container.sessionRepository.createSession(personaId)
|
||||
.onSuccess { sessionId ->
|
||||
refresh()
|
||||
select(sessionId)
|
||||
@@ -340,6 +381,8 @@ internal fun SessionSummaryDto.toItem(): SessionItem = SessionItem(
|
||||
lastMessage = lastMessage?.content?.toPreviewText()?.takeIf { it.isNotBlank() },
|
||||
lastMessageAt = lastMessage?.createdAt?.takeIf { it > 0 },
|
||||
unreadCount = unreadCount,
|
||||
// 空串与缺省同义(契约:空/缺省 = 继承全局默认角色),统一收成 null——UI 上只有「绑没绑」两种。
|
||||
personaId = personaId?.takeIf { it.isNotBlank() },
|
||||
)
|
||||
|
||||
/**
|
||||
|
||||
@@ -0,0 +1,98 @@
|
||||
package top.yeij.cyrene.data.api.dto
|
||||
|
||||
import kotlinx.serialization.builtins.ListSerializer
|
||||
import org.junit.Assert.assertEquals
|
||||
import org.junit.Assert.assertFalse
|
||||
import org.junit.Assert.assertNull
|
||||
import org.junit.Assert.assertTrue
|
||||
import org.junit.Test
|
||||
import top.yeij.cyrene.data.api.ApiClientFactory
|
||||
import top.yeij.cyrene.data.api.ApiEnvelope
|
||||
|
||||
/**
|
||||
* **用户侧**角色目录(`GET /api/v1/personas`,api-client §1 行 9)的解码测试。
|
||||
*
|
||||
* 用户侧与 admin 侧同形,但**不下发 admin 专属的 `thinking`**——用的是独立的 [UserPersonaDto],
|
||||
* 这张测试同时钉住「多出 admin 专属键也不许崩」。手写载荷覆盖线上暂未出现、但契约允许的边界
|
||||
* (未知字段、整块缺字段、未知枚举取值)。
|
||||
*/
|
||||
class PersonaDtoDecodingTest {
|
||||
|
||||
private val json = ApiClientFactory.json
|
||||
|
||||
private val personaList = ListSerializer(UserPersonaDto.serializer())
|
||||
|
||||
private fun decode(body: String): List<UserPersonaDto> =
|
||||
json.decodeFromString(ApiEnvelope.serializer(personaList), body).data!!
|
||||
|
||||
@Test
|
||||
fun `a full user side row decodes field by field`() {
|
||||
val personas = decode(
|
||||
"""
|
||||
{"data":[{"id":"xilian","name":"昔涟","character":"memokeeper","isDefault":true,
|
||||
"mode":"chat","memoryNamespace":"xilian","avatar":"/a.png",
|
||||
"chatBackground":{"landscape":"/l.png","portrait":"/p.png"},"mood":"calm"}]}
|
||||
""".trimIndent(),
|
||||
)
|
||||
|
||||
val persona = personas.single()
|
||||
|
||||
assertEquals("xilian", persona.id)
|
||||
assertEquals("昔涟", persona.name)
|
||||
assertEquals("memokeeper", persona.character)
|
||||
assertTrue(persona.isDefault)
|
||||
assertEquals("chat", persona.mode)
|
||||
assertEquals("xilian", persona.memoryNamespace)
|
||||
assertEquals("/a.png", persona.avatar)
|
||||
assertEquals("/l.png", persona.chatBackground?.landscape)
|
||||
assertEquals("/p.png", persona.chatBackground?.portrait)
|
||||
assertEquals("calm", persona.mood)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun `a minimal row decodes with documented defaults instead of failing`() {
|
||||
val persona = decode("""{"data":[{"id":"xilian"}]}""").single()
|
||||
|
||||
assertEquals("xilian", persona.id)
|
||||
assertEquals("", persona.name)
|
||||
assertEquals("", persona.character)
|
||||
assertFalse(persona.isDefault)
|
||||
assertEquals("", persona.mode)
|
||||
assertEquals("", persona.memoryNamespace)
|
||||
assertNull(persona.avatar)
|
||||
assertNull(persona.chatBackground)
|
||||
assertNull(persona.mood)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun `a blank mood means no tracked mood and is not faked`() {
|
||||
// `""` = 该角色暂无被跟踪的情绪(契约明说),不是「后端没报告」,也不许伪造默认值。
|
||||
assertEquals("", decode("""{"data":[{"id":"xilian","mood":""}]}""").single().mood)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun `unknown mode and mood are kept raw instead of being dropped`() {
|
||||
val persona = decode("""{"data":[{"id":"xilian","mode":"telepathy","mood":"euphoric"}]}""").single()
|
||||
|
||||
assertEquals("telepathy", persona.mode)
|
||||
assertEquals("euphoric", persona.mood)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun `unknown keys are ignored and never break the decode`() {
|
||||
// 同一个后端结构还会长:admin 专属的 thinking、以及将来任何新键,用户侧遇到都不能炸。
|
||||
val persona = decode(
|
||||
"""
|
||||
{"data":[{"id":"xilian","name":"昔涟","thinking":{"budgetTokens":1,"effort":"low"},
|
||||
"nickname":"小昔","unknownList":[1,2]}]}
|
||||
""".trimIndent(),
|
||||
).single()
|
||||
|
||||
assertEquals("昔涟", persona.name)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun `an empty persona list decodes to an empty list`() {
|
||||
assertTrue(decode("""{"data":[]}""").isEmpty())
|
||||
}
|
||||
}
|
||||
@@ -229,4 +229,72 @@ class SessionDtoRealPayloadTest {
|
||||
assertEquals("web", data.sessionId)
|
||||
assertEquals(1_753_000_000_000L, data.readAt)
|
||||
}
|
||||
|
||||
// —— 新建会话时选角色(契约 v0.42) ——
|
||||
|
||||
@Test
|
||||
fun `a create request without a persona omits the key entirely`() {
|
||||
val body = json.encodeToString(CreateSessionRequest.serializer(), CreateSessionRequest())
|
||||
|
||||
// 服务端把「省略 personaId」与「personaId 为空」当同一件事(不绑,继承全局默认角色)。
|
||||
// 生产路径对 null 走的是**完全不带 body** 的重载(见 SessionRepositoryCreateTest);
|
||||
// 这里钉的是:真要序列化它,出来的也必须是 `{}`,绝不能是 `{"personaId":null}`。
|
||||
assertEquals("{}", body)
|
||||
assertFalse(body, body.contains("personaId"))
|
||||
}
|
||||
|
||||
@Test
|
||||
fun `a create request with a persona sends exactly one key`() {
|
||||
val body = json.encodeToString(
|
||||
CreateSessionRequest.serializer(),
|
||||
CreateSessionRequest(personaId = "xilian"),
|
||||
)
|
||||
|
||||
assertEquals("""{"personaId":"xilian"}""", body)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun `a create response echoes the persona only when the session got bound`() {
|
||||
val bound = json.decodeFromString(
|
||||
ApiEnvelope.serializer(CreateSessionResponse.serializer()),
|
||||
"""{"data":{"sessionId":"web:abc","personaId":"xilian"}}""",
|
||||
).data!!
|
||||
|
||||
assertEquals("web:abc", bound.sessionId)
|
||||
assertEquals("xilian", bound.personaId)
|
||||
|
||||
// 不绑时响应形状与 v0.41 完全一致:`personaId` 整个键缺席。
|
||||
val unbound = json.decodeFromString(
|
||||
ApiEnvelope.serializer(CreateSessionResponse.serializer()),
|
||||
"""{"data":{"sessionId":"web:abc"}}""",
|
||||
).data!!
|
||||
|
||||
assertEquals("web:abc", unbound.sessionId)
|
||||
assertNull(unbound.personaId)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun `a session row carries the optional persona id`() {
|
||||
val bound = json.decodeFromString(
|
||||
SessionSummaryDto.serializer(),
|
||||
"""{"id":"web:abc","type":"sub","createdAt":1,"pinned":false,"unreadCount":0,"personaId":"xilian"}""",
|
||||
)
|
||||
assertEquals("xilian", bound.personaId)
|
||||
|
||||
// 未绑的会话:键整个缺席(= 继承全局默认角色)。这是绝大多数行的形状。
|
||||
val unbound = json.decodeFromString(
|
||||
SessionSummaryDto.serializer(),
|
||||
"""{"id":"web","type":"main","createdAt":1}""",
|
||||
)
|
||||
assertNull(unbound.personaId)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun `a legacy snapshot without the persona key still decodes`() {
|
||||
// 本版之前写下的那份快照里没有 personaId:升级后整份快照必须照样解得开,
|
||||
// 否则第一次启动会先闪一下空列表(同 unreadCount 的那条理由)。
|
||||
val legacy = """{"id":"web","type":"main","createdAt":1788724031196,"pinned":false,"unreadCount":0}"""
|
||||
|
||||
assertNull(json.decodeFromString(SessionSummaryDto.serializer(), legacy).personaId)
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,139 @@
|
||||
package top.yeij.cyrene.data.repository
|
||||
|
||||
import com.sun.net.httpserver.HttpExchange
|
||||
import com.sun.net.httpserver.HttpServer
|
||||
import kotlinx.coroutines.runBlocking
|
||||
import org.junit.After
|
||||
import org.junit.Assert.assertEquals
|
||||
import org.junit.Test
|
||||
import top.yeij.cyrene.core.error.CyreneError
|
||||
import top.yeij.cyrene.data.api.ApiClientFactory
|
||||
import top.yeij.cyrene.data.api.CyreneException
|
||||
import top.yeij.cyrene.data.api.SessionsApi
|
||||
import java.net.InetSocketAddress
|
||||
import java.util.concurrent.CopyOnWriteArrayList
|
||||
import java.util.concurrent.Executors
|
||||
|
||||
/**
|
||||
* `POST /sessions` 的**线级**行为:真 OkHttp + 真 Retrofit + JDK 自带 HTTP 服务端
|
||||
* (不引新依赖,与 [UploadRepositoryTest] / [ChatRepositoryTest] 同一手法)。
|
||||
*
|
||||
* 这里要钉住的是一件很容易改坏的事:**不选角色时发出去的请求必须与引入选角之前逐字节相同**。
|
||||
* 服务端 body 完全可选,「多一个 `personaId` 键」不是无害的——那会变成一次真的绑定尝试
|
||||
* (未知角色直接 `400`,而 `""` 还有它自己的语义)。所以 null 走的是**不带 body** 的重载,
|
||||
* 而不是 `{}`。
|
||||
*/
|
||||
class SessionRepositoryCreateTest {
|
||||
|
||||
private val backend = FakeSessionsBackend()
|
||||
|
||||
@After
|
||||
fun tearDown() {
|
||||
backend.close()
|
||||
}
|
||||
|
||||
private fun repository() = SessionRepository(
|
||||
ApiClientFactory.create(baseUrl = backend.baseUrl, service = SessionsApi::class.java),
|
||||
)
|
||||
|
||||
@Test
|
||||
fun `creating without a persona sends a body of zero bytes`() = runBlocking {
|
||||
backend.reply(201, """{"data":{"sessionId":"web:abc"}}""")
|
||||
|
||||
val created = repository().createSession().getOrThrow()
|
||||
|
||||
assertEquals("web:abc", created)
|
||||
val request = backend.requests.single()
|
||||
assertEquals("POST", request.method)
|
||||
assertEquals("/api/v1/sessions", request.path)
|
||||
// **一个字节都没有**:连 `{}` 都不是——契约说 body「可完全省略」,那就省略。
|
||||
assertEquals("", request.body)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun `a blank persona id is treated as no persona at all`() = runBlocking {
|
||||
backend.reply(201, """{"data":{"sessionId":"web:abc"}}""")
|
||||
|
||||
repository().createSession(" ").getOrThrow()
|
||||
|
||||
// 「省略」与「空」在服务端是同一件事(不绑),所以没必要把 `{"personaId":""}` 发上去。
|
||||
assertEquals("", backend.requests.single().body)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun `creating with a persona sends exactly that one key`() = runBlocking {
|
||||
backend.reply(201, """{"data":{"sessionId":"web:abc","personaId":"xilian"}}""")
|
||||
|
||||
repository().createSession("xilian").getOrThrow()
|
||||
|
||||
assertEquals("""{"personaId":"xilian"}""", backend.requests.single().body)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun `an unknown persona stays a server failure instead of silently falling back`() = runBlocking {
|
||||
backend.reply(400, """{"error":{"code":"bad_request","message":"unknown persona"}}""")
|
||||
|
||||
val error = repository().createSession("ghost").exceptionOrNull() as CyreneException
|
||||
|
||||
// 绝不「失败就改用默认角色重试」:那会建出一个用户没要的会话。
|
||||
assertEquals(CyreneError.Server("bad_request", "unknown persona", 400), error.error)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun `a 201 without data is a parse failure`() = runBlocking {
|
||||
backend.reply(201, "{}")
|
||||
|
||||
val error = repository().createSession().exceptionOrNull() as CyreneException
|
||||
|
||||
assertEquals(CyreneError.Local(CyreneError.LocalKind.Parse), error.error)
|
||||
}
|
||||
|
||||
/** 记录每次请求的原始字节,按 `reply(...)` 回话的假后端。 */
|
||||
private inner class FakeSessionsBackend : AutoCloseable {
|
||||
|
||||
private val server = HttpServer.create(InetSocketAddress("127.0.0.1", 0), 0).apply {
|
||||
executor = Executors.newFixedThreadPool(2)
|
||||
createContext("/api/v1/sessions", ::handle)
|
||||
start()
|
||||
}
|
||||
|
||||
val baseUrl: String get() = "http://127.0.0.1:${server.address.port}/"
|
||||
|
||||
val requests = CopyOnWriteArrayList<RecordedRequest>()
|
||||
|
||||
@Volatile
|
||||
private var status: Int = 201
|
||||
|
||||
@Volatile
|
||||
private var body: String = ""
|
||||
|
||||
fun reply(status: Int, body: String) {
|
||||
this.status = status
|
||||
this.body = body
|
||||
}
|
||||
|
||||
private fun handle(exchange: HttpExchange) {
|
||||
// ISO-8859-1:字节 ↔ 字符一一对应,断言里比对的就是线上真实字节。
|
||||
val raw = exchange.requestBody.readBytes()
|
||||
requests += RecordedRequest(
|
||||
method = exchange.requestMethod,
|
||||
path = exchange.requestURI.path,
|
||||
body = raw.toString(Charsets.ISO_8859_1),
|
||||
)
|
||||
val bytes = body.toByteArray()
|
||||
exchange.responseHeaders.add("Content-Type", "application/json")
|
||||
exchange.sendResponseHeaders(status, bytes.size.toLong())
|
||||
exchange.responseBody.use { it.write(bytes) }
|
||||
}
|
||||
|
||||
override fun close() {
|
||||
runCatching { server.stop(0) }
|
||||
}
|
||||
}
|
||||
|
||||
private data class RecordedRequest(
|
||||
val method: String,
|
||||
val path: String,
|
||||
val body: String,
|
||||
)
|
||||
}
|
||||
@@ -0,0 +1,162 @@
|
||||
package top.yeij.cyrene.ui.sessions
|
||||
|
||||
import org.junit.Assert.assertEquals
|
||||
import org.junit.Assert.assertFalse
|
||||
import org.junit.Assert.assertNull
|
||||
import org.junit.Assert.assertTrue
|
||||
import org.junit.Test
|
||||
import top.yeij.cyrene.data.api.dto.UserPersonaDto
|
||||
|
||||
/**
|
||||
* 「新建会话时选角色」的三条纯逻辑:弹层选项构造、会话行上的角色名回填、摘要行拼接。
|
||||
* 都不依赖 Compose,也不依赖服务端。
|
||||
*/
|
||||
class PersonaSelectionTest {
|
||||
|
||||
private fun persona(
|
||||
id: String,
|
||||
name: String = "",
|
||||
character: String = "",
|
||||
isDefault: Boolean = false,
|
||||
) = UserPersonaDto(
|
||||
id = id,
|
||||
name = name,
|
||||
character = character,
|
||||
isDefault = isDefault,
|
||||
)
|
||||
|
||||
// —— 弹层选项 ——
|
||||
|
||||
@Test
|
||||
fun `the default role is always the first choice and binds nothing`() {
|
||||
val choices = personaChoices(listOf(persona("xilian", name = "昔涟", character = "memokeeper")))
|
||||
|
||||
assertEquals(2, choices.size)
|
||||
assertNull(choices[0].personaId)
|
||||
assertEquals(DEFAULT_PERSONA_TITLE, choices[0].title)
|
||||
assertEquals("xilian", choices[1].personaId)
|
||||
assertEquals("昔涟", choices[1].title)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun `an empty persona list still offers the default role`() {
|
||||
// 角色目录没拉回来(或真的没有角色)时弹层不能是空的——那样连用默认角色建会话都做不到。
|
||||
val choices = personaChoices(emptyList())
|
||||
|
||||
assertEquals(1, choices.size)
|
||||
assertNull(choices.single().personaId)
|
||||
assertEquals(DEFAULT_PERSONA_TITLE, choices.single().title)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun `the server order is kept verbatim and no role is dropped`() {
|
||||
val choices = personaChoices(listOf(persona("b", name = "第二个"), persona("a"), persona("z")))
|
||||
|
||||
assertEquals(listOf("b", "a", "z"), choices.drop(1).map { it.personaId })
|
||||
}
|
||||
|
||||
@Test
|
||||
fun `a blank name falls back to the id and a blank character means no summary`() {
|
||||
val choices = personaChoices(listOf(persona("xilian", name = " ", character = " ")))
|
||||
|
||||
assertEquals("xilian", choices[1].title)
|
||||
assertNull(choices[1].description)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun `the character field becomes the summary verbatim`() {
|
||||
// character 是开放集合:未知取值原样显示,客户端不做映射、也不丢。
|
||||
val choices = personaChoices(listOf(persona("xilian", name = "昔涟", character = "memokeeper")))
|
||||
|
||||
assertEquals("memokeeper", choices[1].description)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun `the default role names the server side default when there is one`() {
|
||||
// 弹层里会出现两行「默认」:点名当前全局默认角色才不会让人选错。
|
||||
val choices = personaChoices(listOf(persona("xilian", name = "昔涟", isDefault = true)))
|
||||
|
||||
assertEquals("不绑定角色,跟随全局默认(当前「昔涟」)", choices[0].description)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun `the default role does not guess when nothing is marked default`() {
|
||||
val choices = personaChoices(listOf(persona("xilian", name = "昔涟")))
|
||||
|
||||
assertEquals("不绑定角色,跟随全局默认", choices[0].description)
|
||||
}
|
||||
|
||||
// —— 会话行上的角色名 ——
|
||||
|
||||
@Test
|
||||
fun `a bound and known persona shows its name`() {
|
||||
val choices = personaChoices(listOf(persona("xilian", name = "昔涟")))
|
||||
|
||||
assertEquals("昔涟", personaLabelFor("xilian", choices))
|
||||
}
|
||||
|
||||
@Test
|
||||
fun `a bound but unknown persona shows the raw id`() {
|
||||
// 角色表没拉回来、或那个角色已经被删掉:原样显示 id,不猜、也不硬编码映射表。
|
||||
assertEquals("ghost", personaLabelFor("ghost", personaChoices(emptyList())))
|
||||
}
|
||||
|
||||
@Test
|
||||
fun `an unbound session shows nothing at all`() {
|
||||
val choices = personaChoices(listOf(persona("xilian", name = "昔涟")))
|
||||
|
||||
assertNull(personaLabelFor(null, choices))
|
||||
assertNull(personaLabelFor("", choices))
|
||||
assertNull(personaLabelFor(" ", choices))
|
||||
}
|
||||
|
||||
// —— 摘要行 ——
|
||||
|
||||
@Test
|
||||
fun `the persona label is prefixed to the preview`() {
|
||||
assertEquals("昔涟 · 她说她一直在", sessionSummaryText("昔涟", "她说她一直在"))
|
||||
}
|
||||
|
||||
@Test
|
||||
fun `either half alone is enough for a summary line`() {
|
||||
assertEquals("昔涟", sessionSummaryText("昔涟", null))
|
||||
assertEquals("她说她一直在", sessionSummaryText(null, "她说她一直在"))
|
||||
assertNull(sessionSummaryText(null, null))
|
||||
assertNull(sessionSummaryText(" ", " "))
|
||||
}
|
||||
|
||||
// —— 拉取结果 → 状态(只有成功才动列表) ——
|
||||
|
||||
@Test
|
||||
fun `a successful load replaces the list and marks it loaded`() {
|
||||
val state = SessionsUiState(personaError = "上一次失败").withPersonaResult(
|
||||
loaded = listOf(persona("xilian", name = "昔涟")),
|
||||
)
|
||||
|
||||
assertEquals(listOf(null, "xilian"), state.personas.map { it.personaId })
|
||||
assertTrue(state.personasLoaded)
|
||||
assertNull(state.personaError)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun `a failed load keeps the previous list instead of wiping it`() {
|
||||
val previous = SessionsUiState().withPersonaResult(loaded = listOf(persona("xilian", name = "昔涟")))
|
||||
|
||||
val failed = previous.withPersonaResult(failure = "连接失败")
|
||||
|
||||
assertEquals(previous.personas, failed.personas)
|
||||
// 拿到过就是拿到过:一次刷新失败不该让弹层退回「加载中…」。
|
||||
assertTrue(failed.personasLoaded)
|
||||
assertEquals("连接失败", failed.personaError)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun `a failure before the first success is an error, not a pretend empty list`() {
|
||||
val failed = SessionsUiState().withPersonaResult(failure = "连接失败")
|
||||
|
||||
assertTrue(failed.personas.isEmpty())
|
||||
// 这一条决定弹层显示「加载中…」还是失败原因——两者绝不能混在一起。
|
||||
assertFalse(failed.personasLoaded)
|
||||
assertEquals("连接失败", failed.personaError)
|
||||
}
|
||||
}
|
||||
@@ -124,4 +124,12 @@ class SessionItemTest {
|
||||
// 空列表是异常响应,不该拿它去改用户的选择。
|
||||
assertEquals("web:alive", resolveActiveSession("web:alive", emptyList()))
|
||||
}
|
||||
|
||||
@Test
|
||||
fun `toItem keeps a bound persona and folds a blank one to null`() {
|
||||
assertEquals("xilian", dto().copy(personaId = "xilian").toItem().personaId)
|
||||
// 契约:空串与缺省同义(都是继承全局默认角色)——UI 上只该有「绑没绑」两种,空串不能漏到行上。
|
||||
assertNull(dto().copy(personaId = "").toItem().personaId)
|
||||
assertNull(dto().toItem().personaId)
|
||||
}
|
||||
}
|
||||
Reference in new issue
Block a user