Repository navigation
feat(chat): 多附件 + 常驻日志 + 渲染/滚动修复 (0.4.6 → 0.4.13) - #11
Merged
CjiW merged 8 commits intoOct 28, 2026
Merged
Conversation
一次可以带多个附件,最多 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
deleted the
agent/peer/multi-attach/multi-file-attachments-in-comp
branch
October 28, 2026 03:51
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
概述
汇总 0.4.6 → 0.4.13 八个版本,集中在聊天页的附件、渲染、滚动体验与端侧可观测性,
最后一版顺带清掉了仓库里硬编码的内部分发域名。
净变更:约 27 个文件,+1700 / −240;新增 4 个纯 JVM 测试类。
主要变更
1. 多附件(0.4.6 → 0.4.8)
FlowRow排多个 chip,每个可单独移除。Queued / Uploading / Done(uploadKey) / Failed(reason),最多 2 个并发,失败的 chip 变红并可单条重试。
RequestBody直接把InputStream写进 socket),不再readBytes()整块进内存;流式失败自动回退到内存上传(个别 provider 的
content://流长度与OpenableColumns.SIZE不一致)。Done才能发送,避免静默丢文件;失败/上传中会提示具体文件。/api/files/upload的MaxBytesReader硬限制)、最多 5 个,空文件 / 超限 / 超额会合并成一条提示。
2. 端侧日志(0.4.9)
logs/AppLog.kt:内存环形缓冲(1500 条)+ 落盘filesDir/logs/app.log(512KB 滚动保留 2 份)xbot-+ 未捕获异常同步落盘 + 写入前凭据脱敏(cookie / token / password / signature…)。
logs/LogBundle.kt:把device.txt(版本/机型/Android/ABI/locale/服务器地址,不含账号)session.txt(内存快照)+ 落盘日志打成 zip,走/api/files/upload上传并给出可打开链接。ChatScrollTrace。3. 滚动 / 贴底修复(0.4.10)
scrollToItem(最后一项)—— 它只把该项顶部对齐视口顶部,补回底部的scrollBy要下一帧才生效,中间那一帧就是「跳到这条消息开头」;流式输出时贴底每几十毫秒一次,肉眼即持续抖动。
deficit = last.offset + last.size - viewportEndOffset(单次
scrollBy,同帧生效、无中间帧);只有最后一项还不可见(新回合、从顶部回到底部)才走scrollToItem+ 等两帧布局落地再补差距。suppressed计数),不再冲掉环形缓冲。4. 渲染顺序与过程折叠(0.4.11、0.4.12)
过程 · 思考 3 · 工具 6:运行中自动展开(显示
过程 · 正在 Shell+ 转圈),回合结束自动收起,手动点过之后按用户的来。手机上原来 3 思考 + 6 工具逐条铺开 ≈ 350dp(半屏以上),折叠后 1 行。
5. 仓库清理(0.4.13)
DEFAULT_MEDIA_BASE_URL默认值改为空串:对象存储域名属于各部署自己的配置,不再硬编码。默认关闭 localhost 图片地址重写,需要时在 设置 → 服务器 → 媒体/对象存储地址 填写(本地保存)。
https://media.example.com。AGENTS.md删除内部分发地址相关备忘。提交清单
2d316b8d9973406bf6b592101f8c58f9d9139e162b8a9be00ebaefae验证
AttachmentRulesTest8 /StreamingFileBodyTest3 /AppLogTest7 /TurnProcessTest7):app:lintDebug、:app:lintVitalRelease、:app:assembleRelease均通过StreamingFileBodyTest用 MockWebServer 真发包,校验Content-Length与实际写入字节一致、文件字节完整说明 / 已知限制
关联
docs/agent/logs.md,更新docs/agent/ui.md、docs/agent/ui-composer.md