feat(chat): 数字员工产出文件可下载（捕获/存储/消息卡片/下载端点）

[tianling536]

概述

数字员工产出的文件(如通用技能生成的 PPT)从"死在临时目录"变成可下载的一等产出:runner 捕获 → 磁盘+DB 持久化 → assistant 消息挂载 → 聊天内点击下载。

参考 Clawith 的工作区模型后按我们的产品形态取舍:产出回聊天(对话即交付),不做独立 Workspace 面板。

实现

产出捕获(runner)

• _execute_plan 执行后扫描工作区,捕获净新增文件(排除物化进去的技能包输入与 runner 脚本;单文件 ≤12MB、单次 ≤20 个);
• 仅当该次尝试被采用且结果可用时才经 output_sink 持久化;失败/被废弃尝试的产出随临时目录清理;
• 顺带修复既有泄漏:run_dir 此前从不清理,现在执行后一律 rmtree。

存储(AgentOutputFile + output_files.py)

• 元数据与归属(tenant/session/agent/user/message)落表,本体写用户数据目录 outputs/(不内联 base64——PPT 数 MB 会撑爆消息表);
• 产出经 output_sink 回调贯穿三条运行路径:agent_loop 流式聊天、SOP 内 general_skill.* 工具调用、通用技能运行测试页;
• assistant 消息落库时按会话+时序挂载到本轮(output_files 进消息 metadata),幂等。

下载

• GET /api/chat/outputs/{file_id}/download:仅产出归属人或管理员,FileResponse 直出;outputs 根外路径拒绝(防逃逸);
• 前端聊天气泡渲染下载卡片(文件名/大小/类型,点击 fetch→blob 保存,复用头像同款认证模式,不把 JWT 放 URL);运行测试页结果区同样挂下载。

测试

• 净新增捕获(输入排除/runner 排除/空文件跳过/超限跳过);
• 持久化与消息挂载(时间窗、幂等、路径逃逸拒绝);
• 下载权限(owner 200 / 他人 403 / admin 200 / 不存在 404);
• runner 端到端:_execute_plan 产出收集 + 临时目录确认删除;
• 存量 mock 签名适配新 output_sink 参数;全量 1249 passed、ruff 零告警、前端 build 通过。

说明

• 无 schema 迁移(新表 create_all 建);
• 本 PR 基于 feat/general-skills-standard(PR feat(general-skills): 按 Agent Skills 标准升级通用技能（规范校验/标准导入导出/目录树编辑器） #54)开发,改动与 feat(general-skills): 按 Agent Skills 标准升级通用技能（规范校验/标准导入导出/目录树编辑器） #54 有共享文件(runner/api/技能页);feat(general-skills): 按 Agent Skills 标准升级通用技能（规范校验/标准导入导出/目录树编辑器） #54 合并后本 PR diff 自动收敛;
• 后续扩展(不在本 PR):渠道侧把产出文件推给微信/企微用户、会话级产出聚合页、publish 公开链接。