Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

9.2 KB
Raw Blame

#6892:群聊组件图片交付验收

验证日期:2026-10-23。分支:fix/6892-group-component-images。

改动与结论

伙伴回复中的 cindy-ui 图片节点现在复用现有图片附件交付通道。按组件最终树提取图片, 应用 patch / move / remove 后再与 Markdown 图片统一去重;继续执行任务读取授权、 MIME、大小、数量及执行状态检查。群正文保留说明、替代文字与图注,隐藏内部媒体地址, 没有说明时显示类型占位,不凭地址宣称图片已送达。

本轮 macOS Desktop 双账号核心验收通过,用户已确认验收完成。图片通过真实伙伴回复 结算路径上传,接收账号可以查看、打开和保存;发送端离线后接收端冷启动仍可查看。

实机范围

  • 同一台 macOS 电脑上的两个独立 Desktop 进程、两个真实账号,连接真实群服务。
  • 发送端基线 415f2fc19ebe54f1598995be81cf7dac1a83a218,包含本次修复。
  • 接收端基线 8af10eb2470e49906e73022d8c78ba533d1c3eff,仅移植本次共享正文投影 及其回归测试;这是旧基线接收端兼容性验收,不是发送端基线的完整接收构建验收。
  • 经仓库安全启动入口确认实例 ready,再从普通群输入框点名测试伙伴发送。 接收端沿用原隔离环境,未复制凭证或数据库,未修改数据库 schema。
场景 观察结果
QA6892-M2:合法 Markdown 图片 接收账号得到 1 个真实图片附件
QA6892-C:组件 image 得到 1 个附件,正文保留说明且不显示内部 src
QA6892-MIX:同图 Markdown 与组件混合 仅交付 1 个附件
QA6892-FINAL:创建后修改、删除节点 仅交付最终保留的有效图片;旧路径和删除节点未上传
QA6892-UNIQUE:本轮独有图片 首次查看、看图器打开、保存文件并校验内容均通过
历史重开与重载 切走再返回群、页面重载后图片仍可读
发送端离线 确认发送进程退出、调试端口关闭后,接收端冷启动,图片与看图器仍正常
Light / Dark 真实群消息截图均已目检,正文与图片正常
QA6892-MISSING:不存在的组件图片 明确失败,没有提交丢图的成功回复
QA6892-RECOVERY:失败后重新发起 用有效图片人工发起新一轮后正常交付,混合去重仍为 1 个

首次 QA6892-M 输出的路径含空格但未使用合法 Markdown 包裹,未产生附件,未计为成功。 纠正语法后的 QA6892-M2 通过;本次不将普通文本中的任意路径扩展为图片指令。

保存与离线证据

独有图片为 73×59 PNG,12,070 字节。接收端通过看图器“另存为”触发原生窗口, 用户完成保存并确认“已保存”;实际文件的格式、尺寸、字节数及 SHA-256 均已校验:

9f3bcb22b49cf4c5535c76e2dd63cb80d0b66c1ecaa9da7f24a8d0741917d646

发送端离线后,接收端冷启动并重新读取同一图片,打开看图器成功。接收端仍联网; 这里的“离线”专指发送端退出。未删除磁盘缓存,未在此阶段再次执行“另存为”。 缺失图片后的恢复是人工新发起的一轮,不等同于网络错误自动重试或完成回执恢复。

原始截图、消息与附件标识、文件校验和实例状态保留在本机验收记录,未随提交发布。 此文保存脱敏后的结果;自动回归与实现一同提交。

自动验证

以下检查在最终代码上完成,整理本文时未再修改产品源码:

检查 结果
Desktop 完整类型检查 通过
Mobile 完整类型检查 通过
maker-shared tsc --noEmit 通过
Desktop 回复图片、群服务与媒体上传定向测试 347 项通过
Desktop quota 测试夹具相关回归 4 项通过,579 项按名称过滤
Mobile 菜单、输入栏、粘贴、群正文及附件相关测试 5 个文件,29 项通过
maker-shared 全套测试 100 个文件,1,798 项通过
任务图片交付回归 58 项通过
Desktop 附件组件回归 3 项通过
群正文 body-answer 组件场景 Light / Dark 共 2 项通过,overview 已目检
接收端补丁副本 58 项正文回归及 maker-shared 类型检查通过
文档、测试规范、diff 空白检查 通过

Desktop 类型错误通过补齐测试夹具必需的 statDirectory 依赖修复。 Mobile 类型错误来自依赖安装不完整;按现有锁文件重新安装并应用仓库已有补丁后通过, 未修改 Mobile 源码、依赖清单、锁文件或原生配置。

主要复查命令(在本分支根目录运行):

pnpm --filter desktop run --if-present typecheck
pnpm --filter mobile run --if-present typecheck
pnpm --dir packages/maker-shared exec tsc --noEmit
pnpm --dir apps/desktop exec vitest run src/main/maker-ipc/__tests__/chatServerReplyImages.test.ts src/main/maker-ipc/__tests__/chatServer.test.ts src/main/maker-ipc/__tests__/chatServerMedia.test.ts --maxWorkers=1
pnpm --dir apps/desktop exec vitest run src/main/maker-ipc/__tests__/agent-input-coordinator.test.ts -t 'preserves bootstrap quota through the send transaction' --maxWorkers=1
pnpm ui:check --page group-chat --case body-answer --theme all --locale zh-CN --viewport 720x700
pnpm check:dev-docs
pnpm check:test-hygiene
git diff --check

未覆盖项

本轮未验证 Mobile 实机、Windows、两台物理电脑、网络上传故障注入、完成回执丢失、 跨账号撤权实测;单元测试不能替代这些实测。未运行整仓全量测试或远端 CI。 接收端首次编译曾超过启动器时限,随后确认 ready 才开展验收;后续冷启动直接 ready。

2026-10-27:同步主干后的补充检查

提交 PR 前同步 origin/main@a94dc25130,解决图片准备入口、测试及产品规则的冲突。 保留主干新增的已授权文件分类、原始附件位置和来源路径,组件图片按同一准备入口处理。 主干已经补齐 quota 测试夹具的 statDirectory,本分支不再重复修改该夹具。

  • 图片、文件、群服务及媒体上传:4 个文件 494 项通过,总耗时 8.61 秒。
  • maker-shared:104 个文件 1,923 项通过,总耗时 19.41 秒;tsc --noEmit 通过。
  • 图片准备测试单独运行:26 项通过,总耗时 0.836 秒;正文投影测试单独运行: 62 项通过,总耗时 0.202 秒。
  • Desktop 完整类型检查通过。首次同步检查因夹具重复属性报 TS1117,移除重复变更后重跑通过。
  • Mobile 完整类型检查通过;群正文与附件 2 个测试文件 18 项通过,总耗时 3.95 秒。
  • quota 夹具回归重跑:4 项通过,593 项按名称过滤,总耗时 4.46 秒。
  • 群正文 body-answer:Light / Dark 共 2 项通过,总耗时 7.7 秒,overview 已目检。

上文双账号实机验收来自 2026-10-23 的构建,未在同步主干后重做;原始限制继续有效。

2026-10-27:PR #7492 文件 URL 评审修复

Greptile 指出组件 image.src 为本机 file:// URL 时被静默跳过。图片提取现在先通过 Node fileURLToPath 转换为本机绝对路径,再复用原图片导入、任务账本、类型、大小和数量检查。 远端 host、网络/设备路径、非法编码、NUL、相对地址及带查询/片段的文件 URL 在文件访问前明确拒绝。 不修改通用协议读取器、共享图片路径解析器或授权规则。

生产入口回归先复现 13 失败 / 26 通过,修复后单文件 39 项通过,总耗时 0.699 秒。 覆盖带空格、中文、编码字符及 localhost 的本机 URL、与 Markdown 混合去重、拒绝非法来源和账本拒绝。 图片、文件、群服务及媒体上传定向回归 4 个文件 507 项通过,总耗时 4.48 秒。 Desktop 完整类型检查通过。 本次没有重做双账号实机、Mobile 或 Windows 实机验收,不将此前结果当作本次补丁的实机结果。

2026-10-27:公开媒体链接评审修复

维护者指出,正文不应把尚未作为附件交付的公开图片、视频与音频链接一并删除。 现在仅为 HTTP(S) 来源增加独立网页链接;说明文字继续按字面显示,内部协议、本机路径、 脚本及 data 来源不生成链接。URL 分隔符编码后进入单个 Markdown 自动链接,避免注入额外正文。 不增加视频/音频上传或任务媒体读取能力。

  • 共享正文回归先复现 4 失败 / 62 通过,修复后单文件 66 项通过,总耗时 0.241 秒。
  • maker-shared 全套 104 个文件 1,927 项通过,总耗时 11.37 秒,类型检查通过。
  • Mobile 群正文与附件 2 个文件 19 项通过,总耗时 3.76 秒;正文单文件 7 项总耗时 1.03 秒。
  • Desktop body-answer Light / Dark 共 2 项通过,总耗时 5.0 秒,截图已目检, 并通过真实群正文组件确认图片、视频及音频三个公开地址各保留一个网页链接。
  • Mobile 保留既有群正文只读规则:公开 URL 文字可复制,不把单测当作原生点击或真机结果。

Desktop、Mobile 完整类型检查均通过。 本次未重做双账号、Mobile 或 Windows 实机验收;历史实机证据的构建范围不变。