W72 纯附件消息也有气泡外侧时间
时间原本挂在「这条消息**最后一个有正文的气泡**」外侧（W69），而纯附件消息（`documents` 或 `image` 非空、`content` 为空）解析出来的那个占位气泡 `body` 也是空，`Bubble` 见空 `body` 什么都不画 ⇒ 那条时间**整条没被画出来**（主人 2026-10-07 验收 W69 时发现的缺口）。 - 判据抽成纯函数 `messageTimeCarrier(message, bubbles)`：先找最后一个有正文的气泡（W69 原本那一档，一个字都不改）；一个都没有时按「谁最后画」往回退（语音形态 → 图片 → 附件芯片排），落点用 `MessageTimeCarrier` 表示。真的空气泡（`isContentlessUserMessage`） 仍由 `ContentlessNote` 那条路自己画时间，与 W69 一致，未改。 - 附件芯片排 / 图片 / 语音形态三块改为经 `BubbleWithTime` 渲染：**不是落点时 `time = null`， 连 `Box` 都不建** ⇒ 与 W69 之前逐像素相同。贴哪一侧、宽度预扣（时间不参与 weight）、 底对齐全部复用 W69 那一个组件，没有第二份布局逻辑。 - 新增 `MessageTimeCarrierTest` 11 条：纯附件 / 纯图片 / 无转写语音 / 角色无关 / 多块时的优先序 / 有正文时 W69 口径不变 / 真空消息返回 null；`MessageTimeLabelTest` 16 条一条未动。 - 假后端补夹具：`/__control/messages` 的 `text=`（**空串** = 这条没有正文）与 `documents=` （`extracted` / `listed` / `unreadable`）。此前「纯附件消息」在本机**根本造不出来** ——工具不实现 upload 摄取链路，`PATCH` 又要求 `content` 非空——设备验收因此无从做起。 README 补 §8.3 与端点表。 验收：`assembleDebug` 通过；`testDebugUnitTest` **129 suites / 1636 tests / 0 failures / 0 errors**（基线 128 / 1625）。
This commit is contained in:
AskaEth committed
1 parent
f1e894e71f
commit
a94e310cd7
4 files changed
+436
-27
No files matched your search
@@ -389,6 +389,52 @@ curl -s -X POST "$B/__control/messages?session=web&count=1&role=user&text=image%
|
||||
> 要让「服务端历史」成为唯一真相，得清 App 数据重登（`adb shell pm clear top.yeij.cyrene`）——
|
||||
> 这一步会连登录态一起清掉，动手前先想清楚。
|
||||
|
||||
### 8.3 纯附件 / 无正文消息（`documents=` + `text=` 留空）
|
||||
|
||||
**它解决什么问题**：**纯附件消息**（`documents` 非空、`content` 为空）这条形状以前**灌不出来** ——
|
||||
本工具不实现 upload / 摄取链路（§11），`PATCH /api/v1/messages/{id}` 又要求 `content` 非空。
|
||||
于是「没有正文的消息」这一类（纯附件 / 纯图片 / 没转出字的语音）在本机一条都造不出，
|
||||
W72 修的那条「气泡外侧的时间」也就无从验收。
|
||||
|
||||
两个参数一起用就能造出来：
|
||||
|
||||
| 参数 | 取值 | 说明 |
|
||||
|---|---|---|
|
||||
| `text` | **空串**（`text=`） | 与「不带 `text`」是**两件事**：不带 ⇒ 沿用默认正文 `seed #N`；`text=` ⇒ 这条 `content` 就是 `""`。带非空值时照旧（支持 `{n}` 占位） |
|
||||
| `documents` | `extracted` / `listed` / `unreadable` / `none`（默认） | 往这条消息的 `documents` 键打**一枚**芯片。三档见下（`none` = 不打这个键，后端本来就是空即省略） |
|
||||
|
||||
| `documents=` | `status` | 设备上那枚芯片（文案出处 `DocumentChips.statusLabel`） |
|
||||
|---|---|---|
|
||||
| `extracted` | `extracted` | 常规色 · `TXT · 12 B · 10 字 · 已读入` |
|
||||
| `listed` | `listed` | 常规色 · `… · 只看得到清单`（正文没进上下文，**不是**读不到） |
|
||||
| `unreadable` | `unreadable` | 灰态 · `… · 读不到`；`reason` 那句原话留给附件预览弹层 |
|
||||
|
||||
```bash
|
||||
B=http://127.0.0.1:18080
|
||||
|
||||
# 1) 纯附件消息：content 为空 + 一枚附件芯片
|
||||
curl -s -X POST "$B/__control/messages?session=web&count=1&role=user&text=&documents=extracted"
|
||||
|
||||
# 2) 纯图片消息：同一个招牌的另一半（content 为空，只有 image 键）
|
||||
curl -s -X POST "$B/__control/messages?session=web&count=1&role=user&text=&image_file=D:/tmp/w70/with_exif.jpg"
|
||||
|
||||
# 3) 没转出字的语音（正文为空、只有语音形态）
|
||||
curl -s -X POST "$B/__control/messages?session=web&count=1&role=user&text=&voice=empty"
|
||||
|
||||
# 4) 确认那条真的没有正文、也没被塞一个默认正文
|
||||
curl -s "$B/api/v1/sessions/web/messages?limit=1"
|
||||
|
||||
# 5) 对照：真的空气泡（三样都没有）——它走的是 ContentlessNote 那条路，不是本夹具的重点
|
||||
curl -s -X POST "$B/__control/messages?session=web&count=1&role=user&text=&documents=none"
|
||||
```
|
||||
|
||||
灌完之后**重进聊天页**（或 `POST /__control/ws-close` 踢一次重连触发补拉）就能看到。
|
||||
`documents` 与 `voice` 不同：真后端**也会**在握手 `history` 回放与 `message_persisted` 里带上它
|
||||
（同一个 DTO，`MessageDto.kt:13` 那一段），所以这里回放出来没有「比真后端更容易」的问题。
|
||||
|
||||
> ⚠️ 这两个参数**只是往消息上打那两个键**，不是摄取链路：文件没有真的被读、正文没有真的进上下文，
|
||||
> 所以附件预览弹层里「服务端读到的那段正文」在本机永远是空的。
|
||||
|
||||
`/api/v1/**`（一律包信封：成功 `{data}` / 失败 `{error:{code,message}}`，`ApiEnvelope.kt:8`）：
|
||||
|
||||
| 端点 | 备注 |
|
||||
@@ -412,7 +458,7 @@ curl -s -X POST "$B/__control/messages?session=web&count=1&role=user&text=image%
|
||||
|
||||
| 端点 | 作用 |
|
||||
|---|---|
|
||||
| `POST /__control/messages?session=&count=&role=&text=&prefix=&platform=&voice=&duration=&image_file=` | 免费灌 N 条（`text` 支持 `{n}` 占位）；`voice=` 灌一条**语音消息**（见 8.1）；`image_file=` 灌一条**带图的消息**（见 8.2） |
|
||||
| `POST /__control/messages?session=&count=&role=&text=&prefix=&platform=&voice=&duration=&image_file=&documents=` | 免费灌 N 条（`text` 支持 `{n}` 占位；**`text=` 空串 = 这条没有正文**）；`voice=` 灌一条**语音消息**（见 8.1）；`image_file=` 灌一条**带图的消息**（见 8.2）；`documents=` 灌一条**带附件的消息**（见 8.3） |
|
||||
| `GET /__control/message?session=&index=` | 取第 n 条（1 基），脚本里用来**精确**拿游标 |
|
||||
| `POST /__control/busy` / `idle` / `interrupted` | 下发 `session_busy` / `session_idle` / `session_interrupted` |
|
||||
| `POST /__control/reply?session=&text=&chunks=&frame=&persist=` | 下发一轮助手回复（`frame=default\|chunk\|structured`） |
|
||||
@@ -467,7 +513,9 @@ curl -s -X POST "$B/__control/messages?session=web&count=1&role=user&text=image%
|
||||
- **`platform` 过滤**是「相等即收」的近似，不是契约里那套 LIKE 转义语义。客户端当前所有调用点都传 `null`
|
||||
（`MessageRepository.kt:42,99`），所以这条路径没被真正走过。
|
||||
- **`q` 搜索**是 ASCII 大小写不敏感的子串匹配；`%` / `_` / `\` 不做通配（我根本不解析通配符）。
|
||||
- **不实现**：admin 面全部端点、`documents` / `upload` 的**摄取链路**、`voice_input` 的落库、
|
||||
- **不实现**：admin 面全部端点、`documents` / `upload` 的**摄取链路**（`POST /upload` 与「文件真的被读、
|
||||
正文真的进上下文」那一段；`/__control/messages` 的 `documents=` **只是往消息上打那个键**，见 8.3）、
|
||||
`voice_input` 的落库、
|
||||
`mode_switch` 的语义、`observability_*` 推送、`subagent_ask` / `task_output_query`。上行收到这些帧
|
||||
**只记录、不处置**。因此 App 里管理员页面、附件上传这类路径在这个假后端上跑不通。
|
||||
⚠️ `GET /api/v1/media/{name}` **实现了**（语音播放那一半，见 8.1），但**不校验 Bearer**
|
||||
|
||||
Reference in new issue
Block a user