Skip to content

feat(chat): 多附件 + 常驻日志 + 渲染/滚动修复 (0.4.6 → 0.4.13) - #11

Merged
CjiW merged 8 commits into
masterfrom
agent/peer/multi-attach/multi-file-attachments-in-comp
Oct 28, 2026
Merged

CjiW merged 8 commits into
masterfrom
agent/peer/multi-attach/multi-file-attachments-in-comp

Conversation

@CjiW

@CjiW CjiW commented Oct 28, 2026 •

Copy link
Copy Markdown
Contributor

概述

汇总 0.4.6 → 0.4.13 八个版本,集中在聊天页的附件、渲染、滚动体验与端侧可观测性,
最后一版顺带清掉了仓库里硬编码的内部分发域名。
净变更:约 27 个文件,+1700 / −240;新增 4 个纯 JVM 测试类。

主要变更

1. 多附件(0.4.6 → 0.4.8)

  • 一条消息最多 5 个附件,输入区用 FlowRow 排多个 chip,每个可单独移除。
  • 选中即上传(对齐 Web 端):每项一条状态机 Queued / Uploading / Done(uploadKey) / Failed(reason),
    最多 2 个并发,失败的 chip 变红并可单条重试。
  • 上传改为流式(自定义 RequestBody 直接把 InputStream 写进 socket),不再 readBytes() 整块进内存;
    流式失败自动回退到内存上传(个别 provider 的 content:// 流长度与 OpenableColumns.SIZE 不一致)。
  • 发送门控:只有所有附件都 Done 才能发送,避免静默丢文件;失败/上传中会提示具体文件。
  • 限制:单文件 10MB(服务端 /api/files/upload 的 MaxBytesReader 硬限制)、最多 5 个,
    空文件 / 超限 / 超额会合并成一条提示。

2. 端侧日志(0.4.9)

  • logs/AppLog.kt:内存环形缓冲(1500 条)+ 落盘 filesDir/logs/app.log(512KB 滚动保留 2 份)
    • logcat 前缀 xbot- + 未捕获异常同步落盘 + 写入前凭据脱敏
      (cookie / token / password / signature…)。
  • logs/LogBundle.kt:把 device.txt(版本/机型/Android/ABI/locale/服务器地址,不含账号)
    • session.txt(内存快照)+ 落盘日志打成 zip,走 /api/files/upload 上传并给出可打开链接。
  • 设置 → 日志:实时查看 / 复制 / 打包 / 上传 / 清空。
  • 全局接入:每个 REST 调用(方法/路径/状态码/耗时/字节,失败带异常栈)、附件上传、SSE 连接与结构性事件、会话动作、列表贴底。
  • 删除 0.4.3 加的一次性探针 ChatScrollTrace。

3. 滚动 / 贴底修复(0.4.10)

  • 贴底不再每次先 scrollToItem(最后一项) —— 它只把该项顶部对齐视口顶部,补回底部的 scrollBy
    要下一帧才生效,中间那一帧就是「跳到这条消息开头」;流式输出时贴底每几十毫秒一次,肉眼即持续抖动。
  • 改为增量滚动:最后一项已可见时只补 deficit = last.offset + last.size - viewportEndOffset
    (单次 scrollBy,同帧生效、无中间帧);只有最后一项还不可见(新回合、从顶部回到底部)才走
    scrollToItem + 等两帧布局落地再补差距。
  • 贴底日志节流(流式期间每 2 秒一条,带 suppressed 计数),不再冲掉环形缓冲。

4. 渲染顺序与过程折叠(0.4.11、0.4.12)

  • iteration 内顺序修正为 思考 → 正文 → 工具(原来正文排在工具后面,像倒放)。
  • 一轮的思考 / 过程旁白 / 工具整体折叠成一行 过程 · 思考 3 · 工具 6:
    运行中自动展开(显示 过程 · 正在 Shell + 转圈),回合结束自动收起,手动点过之后按用户的来。
  • 最终答复永远显示、不参与折叠;展开后的时间线仍按「思考 → 正文 → 工具」呈现。
    手机上原来 3 思考 + 6 工具逐条铺开 ≈ 350dp(半屏以上),折叠后 1 行。

5. 仓库清理(0.4.13)

  • DEFAULT_MEDIA_BASE_URL 默认值改为空串:对象存储域名属于各部署自己的配置,不再硬编码。
    默认关闭 localhost 图片地址重写,需要时在 设置 → 服务器 → 媒体/对象存储地址 填写(本地保存)。
  • 设置页 placeholder、单测里的真实域名统一换成 https://media.example.com。
  • AGENTS.md 删除内部分发地址相关备忘。

提交清单

版本 提交 内容
0.4.6 2d316b8 feat(chat): multiple attachments per message
0.4.7 d997340 feat(chat): upload attachments as soon as they are picked
0.4.8 6bf6b59 fix(chat): fall back to buffered upload and surface the real error
0.4.9 2101f8c feat(logs): always-on device logging with package / copy / upload
0.4.10 58f9d91 fix(chat): scroll incrementally instead of scrollToItem on every pin
0.4.11 39e162b fix(chat): render thinking → text → tools inside an iteration
0.4.12 8a9be00 feat(chat): fold the whole turn's process into one row
0.4.13 ebaefae chore: stop hardcoding the internal distribution domain

验证

  • 84 个单测全部通过(新增 AttachmentRulesTest 8 / StreamingFileBodyTest 3 / AppLogTest 7 / TurnProcessTest 7)
  • :app:lintDebug、:app:lintVitalRelease、:app:assembleRelease 均通过
  • StreamingFileBodyTest 用 MockWebServer 真发包,校验 Content-Length 与实际写入字节一致、文件字节完整
  • 逐版在真机验证(0.4.6 ~ 0.4.13),内部分发不走仓库

说明 / 已知限制

  • 用户选了文件却不发送,会在服务端留下未被引用的上传对象(与 Web 端一致),由服务端侧定时清理;客户端不处理。
  • 附件单文件上限受服务端 10MB 限制,客户端提前拦截;如需放宽需同时改服务端与客户端。
  • 0.4.13 起图片地址重写默认关闭:升级后若历史消息里的本地图片不显示,去设置里填一次媒体地址即可。

关联

  • 知识文档:新增 docs/agent/logs.md,更新 docs/agent/ui.md、docs/agent/ui-composer.md

CjiW added 8 commits October 25, 2026 13:23
一次可以带多个附件,最多 5 个。

- ChatScreen: attachment 单值 → attachments 列表;选择器换 GetMultipleContents,
  按 Uri 去重,选中后 append 而不是覆盖
- Composer: 单个 chip → FlowRow 多 chip(每个可单独移除),上传时显示「正在上传 2/3」
- submit(): 串行上传,逐个收集 upload_keys/file_names/file_sizes/file_mimes;
  失败保留待发送列表可直接重试
- 新增 ui/AttachmentRules.kt(纯函数):最多 5 个、单个 10MB(服务端
  /api/files/upload 的 MaxBytesReader 硬限制),空文件/超限/超额跳过并合并提示
- AttachmentRulesTest 覆盖 7 种情形
和 Web 端对齐:选中即上传,发送不再等上传。

- PendingAttachment 带状态机(Queued/Uploading/Done(uploadKey)/Failed(reason)),
  选中后立刻发起上传,最多 2 个并发(Semaphore),其余排队
- XbotApi.uploadFile 改为流式:自定义 RequestBody 直接把 InputStream 写进请求体
  (contentLength 用 picker 拿到的真实大小,服务端 MaxBytesReader 不接受 chunked),
  5×10MB 的峰值内存从几十 MB 降到单次缓冲
- Composer: chip 显示转圈/红色失败态,失败可单条「重试」;发送按钮只在
  attachmentsReady()(全部 Done)时可用,发送只带 Done 的 uploadKey
- AttachmentRules 新增 AttachmentState + attachmentsReady(),补单测
- 服务端孤儿对象由服务端定时清理,客户端不再关心选了不发的浪费
….4.8)

真机上附件一直红 chip,但流式请求体本身经 MockWebServer 单测验证是正确的
(Content-Length 与写入字节一致、字节完整、Content-Type 正常),服务端直连传
5MB 也没被代理拦(401 而非 413)。剩下的可能都集中在设备侧,所以:

- 流式上传失败自动回退 uploadFileBytes(整块读进内存):个别 provider 的
  content:// 流长度与 OpenableColumns.SIZE 不一致时 OkHttp 会直接抛
  unexpected end of stream
- contentType 解析失败回退 application/octet-stream,不再在 IO 线程抛
- 失败原因写明到 snackbar(含异常消息)并记入 设置 → 滚动 / 上传诊断
- 抽出 data/StreamingFileBody + StreamingFileBodyTest(MockWebServer 真发包验证)
- 引入 testImplementation mockwebserver 4.12.0
…4.9)

不再为单个问题临时加探针,改成常驻日志系统。

- logs/AppLog:内存环形缓冲 1500 条 + 落盘 filesDir/logs/app.log(512KB 滚动,
  保留 2 份)+ logcat 前缀 xbot- + 未捕获异常同步落盘;cookie/token/password/
  signature 等在写入前统一脱敏
- logs/LogBundle:device.txt(版本/机型/Android/ABI/locale/服务器地址,不含账号)
  + session.txt(内存快照)+ 落盘日志打 zip,走 /api/files/upload 上传并给出可打开链接
- ui/LogsScreen + 设置 → 日志:实时查看 / 复制 / 打包 / 上传 / 清空
- 全局接入:每个 REST 调用(方法/路径/状态码/耗时/字节,失败带异常栈)、附件上传
  (流式失败回退、最终失败原因)、SSE 连接与结构性事件、会话 open
- 删除 0.4.3 的临时探针 ChatScrollTrace,滚动记录改走统一日志(tag scroll)
- 新增 docs/agent/logs.md 并在 AGENTS.md 索引
…(0.4.10)

真机日志(流式输出期间)显示贴底每 30-100ms 一次,而且 canFwd=false 时仍在 pin:

  19:38:08.580 pin done  first=8/51 last=9 lastEnd=923 vpEnd=1147 canFwd=false
  19:38:08.598 pin start first=8/51 ... canFwd=false
  19:38:08.626 pin done  first=8/51 ...

每次 pin 都先 scrollToItem(最后一项)(把该项顶部对齐视口顶部),补回底部的
scrollBy 要下一帧才生效 —— 中间那一帧就是「跳到这条消息开头」,看起来是持续抖动。

- scrollToBottom: 最后一项已可见时只 scrollBy(deficit)
  (deficit = last.offset+last.size - viewportEndOffset,单次滚动同帧生效,无中间帧);
  只有最后一项不可见(新回合/从顶部回到底部)才保留 scrollToItem + 等两帧再补差距
- 贴底日志节流:每 2 秒最多一条,带 suppressed 计数,避免流式期间冲掉环形缓冲
- ui.md 记下这条规则:最后一项可见时绝不调 scrollToItem
IterationBlock 之前是「思考 → 工具 → 正文」,正文被排到工具后面,看起来像
「先跑工具再解释」甚至倒放。改成跟模型真实产出顺序一致:思考 → 正文 → 工具。

- ChatScreen.IterationBlock 调整渲染顺序
- ui.md 记下这条约定
手机上把思考/工具逐条铺开要占半屏(3 思考 + 6 工具 ≈ 350dp),改成整轮过程折叠成一行。

- 新增 ui/TurnProcess.kt(纯函数 + TurnProcessTest):finalAnswerText() 决定最终答复,
  process() 统计思考块/工具数/过程旁白
- TurnBlock: 过程折叠条 + 最终答复;折叠条运行中自动展开(显示「正在 Shell」+ 转圈),
  结束自动收起,手动点过之后按用户的来
- 最终答复永远显示;中间的过程旁白收进折叠条,展开后仍按「思考 → 正文 → 工具」呈现
- 删除 IterationBlock(合并进 ProcessBlock)
- ui.md 记下折叠约定
仓库是公开的,不该出现内部分发/对象存储域名。

- DEFAULT_MEDIA_BASE_URL 默认值改为空串:该域名属于各部署自己的配置,
  默认关闭地址重写,需要时在 设置 → 媒体/对象存储地址 里填(本地保存)
- 设置页 placeholder、ImageUrlTest 里的真实域名换成 media.example.com
- AGENTS.md 删掉内部分发地址备忘
@CjiW CjiW changed the title feat(chat): 多附件 + 常驻日志 + 渲染/滚动修复 (0.4.6 → 0.4.12) feat(chat): 多附件 + 常驻日志 + 渲染/滚动修复 (0.4.6 → 0.4.13) Oct 28, 2026
@CjiW
CjiW merged commit f85d342 into master Oct 28, 2026
1 check passed
@CjiW
CjiW deleted the agent/peer/multi-attach/multi-file-attachments-in-comp branch October 28, 2026 03:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant