feat(text-asset): 支持文本类文件上传并作为会话上下文

[wynxing]

Close #701

概述

复用已有的图片上传入口与 session asset 存储链路，新增文本类文件（.txt/.md/.json/.yaml/.yml/.csv）支持。Runtime 在提交会话前将文本 asset 按 UTF-8 解码并内联为普通 text content part，Provider 层不感知"文件"概念。

变更内容

Go 后端

• 策略层 (session/assets_policy.go)

  • 新增 TextAssetWhitelist：扩展名↔MIME 双向白名单，支持 WithExtensions 不可变扩展
  • 新增 TextAssetPolicy：字节/字符上限、截断策略、文件名长度限制
  • 硬上限兜底：4 MiB / 4M 字符，防止配置失控

• 存储层 (session/asset_store.go, session/sqlite_store.go, session/asset_text.go)

  • AssetStore 新增 SetTextAssetPolicy 接口
  • 文本 asset 持久化与读取，UTF-8 校验

• 输入准备 (session/input_preparer.go, runtime/input_prepare.go)

  • 解析附件时按 MIME 路由到文本/图片策略
  • 文本 asset 内联到 conversation parts，超长内容截断并附提示
  • 事件载荷新增 TextAssetCount 字段

• Runtime (runtime/text_assets.go)

  • 文本 asset 运行时处理：读取→解码→截断→包装为带文件名边界的文本块

• Config (config/runtime.go)

  • TextAssetEnabled 开关（默认开启）
  • MaxTextAssetBytes / MaxTextAssetChars 可配置限额

• Gateway (gateway/network_server.go)

  • 网关层文本附件路由与策略注入

Web 前端

• ChatInput: 支持文本文件选择，区分图片/文本附件校验逻辑，文本附件不依赖模型视觉能力
• MessageItem: 用户消息中展示文本文件 chip（文件名、大小）
• useComposerStore: 新增 resolveAttachmentKind、acceptedTextMimeTypes、文本附件限额
• format.ts: 新增 formatBytes 工具函数

文档

• docs/gateway-rpc-api.md：更新 RPC API 文本附件说明
• docs/guides/configuration.md：新增文本附件配置项文档

验收清单

• Web 可上传并发送文本类文件
• 文本输入和文本文件附件可一起发送
• 超过限制的文本文件被拒绝或截断
• 文件名仅作为上下文标签，不作为可信路径
• Provider 差异不泄漏到上层
• go test ./... 通过
• Web 相关测试通过

测试

go test ./internal/session/... ./internal/runtime/... ./internal/config/... ./internal/gateway/...
cd web && npm test

回滚

保留上传存储能力，关闭 TextAssetEnabled 配置项即可禁用文本 asset 转上下文逻辑。

[chatgpt-codex-connector]

Codex usage limits have been reached for code reviews. Please check with the admins of this repo to increase the limits by adding credits.
Credits must be used to enable repository wide code reviews.

[fennoai]

Review findings:

I found two issues that can break text attachment behavior around configuration and the feature flag.

[codecov]

Codecov Report

❌ Patch coverage is 73.20675% with 127 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
internal/session/input_preparer.go	36.76%	33 Missing and 10 partials ⚠️
internal/session/asset_text.go	72.28%	19 Missing and 4 partials ⚠️
internal/session/assets_policy.go	84.68%	13 Missing and 4 partials ⚠️
internal/config/runtime.go	55.55%	13 Missing and 3 partials ⚠️
internal/runtime/text_assets.go	82.02%	9 Missing and 7 partials ⚠️
internal/gateway/network_server.go	78.57%	3 Missing and 3 partials ⚠️
internal/session/sqlite_store.go	80.00%	2 Missing and 2 partials ⚠️
internal/runtime/input_prepare.go	92.85%	1 Missing and 1 partial ⚠️

📢 Thoughts on this report? Let us know!