Repository navigation
Added - Cloudflare Agents SDK 运行时 🧠
- Agent 运行时迁移:AI 会话改由
@cloudflare/ai-chat的AIChatAgent(Durable Object)承载,支持断线续传、多端同步与审批后同轮继续;旧 AgentEngine、RAG 引擎、SSE 链路、熔断器与工具选择器全部移除 - 模型调用层统一:新增
lib/ai/modelRuntime.ts,Agent 与后台功能统一走 AI SDK provider(Workers AI / OpenAI 兼容 / Anthropic);Workers AI 视觉模型改走原生{ image, prompt }输入 - 供应商连接重构:接入 models.dev 运行时模型快照,供应商连接支持自定义视觉模型能力筛选
- 真实用量与配额:每次调用写入
ai_usage_events,新增日配额与分钟限流(ai.quota.*、ai.rate.*),会话头部支持模型切换 - 检索增强:分块正文落
file_chunks,新增 FTS5 关键词召回、可选 rerank 与search_content工具 - 任务队列:移除 KV 并发锁,改由 Queue
max_concurrency;ai_task_items提供逐文件幂等与真续跑;agent_batch走 fileService - 配置迁移:功能级模型配置从 KV 迁入
ai_feature_config(首次读取自动迁移) - 前端:
useOssShelfChat(useAgent+useAgentChat)、agentMessages映射、用量统计 Tab
Fixed(运行时相关)
- 视觉模型返回空:Workers AI 视觉调用改为原生 image/prompt,视觉调用直接使用已配置模型,能力字段仅用于 UI 筛选
- 无效模型 ID 与目录截断:修正 models.dev 快照解析,避免模型目录截断导致不可用
- Vectorize 限流:写入增加退避重试,放宽队列重试
- D1 绑定参数上限:任务项、文件分块与批量删除按批拆分,修复
too many SQL variables - 文件夹路径与会话文件引用:修正文件夹路径解析,
@引用文件优先处理 - 长请求超时:客户端超时提升至 150 秒
Changed - 工程与部署
- CI 部署改用 Node 22 匹配 Wrangler 4;移除自动 D1 迁移,生产 schema 变更改为人工执行
- 修复迁移脚本
060缺少category非空字段,以及d1 migrations apply不支持--yes的问题 - WebSocket 使用
VITE_API_URL域名,并开启 Agent 路由 CORS - 统一 LF 行尾并应用 Prettier;清理各模块未引用代码与死导出
- 团队空间文件夹赋权与存储统计优化
Fixed - AI 会话链路全面修复 🛠️
本次修复聚焦 Agents SDK 迁移后遗留的协议断层:旧确认/计划/来源/中断/上下文链路仍在 UI 与工具定义中,但新运行时不再产生或消费,导致"看起来有功能、实际不生效"。
Critical(功能失效)
- 写操作审批缺口:
WRITE_TOOLS中的create_share/update_share/write_note与实际工具名不一致,导致create_share_link/update_share_settings/add_note绕过确认直接执行;已重写集合并补充契约测试 - 草稿创建死循环:
draft_and_create_file先走needsApproval,执行时又因缺少_confirmed返回"待确认",文件永远无法创建;已移除旧确认分支 _confirmed参数冲突:删除文件/批量删除/撤销权限/撤销直链/恢复版本的 schema 仍要求_confirmed,模型漏传即校验失败;已在工具适配层统一剥离,并在系统提示词中移除相关说明@文件引用 / 文件夹上下文无效:contextFileIds/contextFolderId此前只写入审计表;现已注入 system prompt,引用文件优先处理- 错误全静默:连接、换票、模型、工具错误均无 UI;现新增错误条与重试入口,并暴露连接/恢复状态
- 消息时间失真:每条消息渲染时重新
new Date();服务端现写入metadata.createdAt,前端读取 - 中断状态丢失:
aborted标记未写入;现由服务端写入 metadata,UI 显示"输出已中断 + 重新生成" - 历史工具卡片丢失:审计种子只恢复 reasoning+text,且助手审计使用随机 id;现复用 DO message.id 并以 upsert 镜像,历史恢复包含工具调用
- 删除会话残留:删除只清 D1,Durable Object 仍保留消息;现先调用
resetConversation()清理 - 无上下文 Token 预算:
ai.agent.max_context_tokens配置未生效;现按预算裁剪历史消息
Added(补齐已宣称能力)
- 跨会话记忆:对话开始时召回相关记忆注入 system;完成后节流提取(每 4 条消息一次)
- 执行计划:新增
update_plan工具,复杂任务先出计划,前端渲染进度条 - 来源引用:从搜索类工具结果派生"参考文件"chips
- Diff 预览:审批前由前端复算 edit/append/find_replace 的变更预览
- 对话导出:
GET /api/ai-chat/sessions/:id/export导出 Markdown - 自动标题:首轮完成后
POST /api/ai-chat/sessions/:id/title生成 8-24 字标题 - 模型切换:会话头部选择模型,随消息 body 下发
- 工具裁剪:分享/权限/存储/系统管理类工具按关键词注入,降低 schema token 与误选
Changed(UI / 交互)
- AI 会话页按全站 design token 重构:移除大面积渐变与重阴影,工具调用降噪为单行活动卡
- 安装
tailwindcss-animate,修复此前全部失效的animate-in/slide-in-from-*动画 - 引入
highlight.js/styles/github-dark.css,聊天与预览的代码高亮生效 - 移动端:头部/输入区安全区适配、会话抽屉、长按引用
@下拉补齐键盘导航、300ms 防抖、空查询不请求- 流式期间输入框可编辑;新增"回到最新"按钮;代码块复制修复
- 删除会话增加二次确认;会话列表支持搜索与日期分组
Docs
- README / AI_FEATURES 修正"PDF 导出"、SSE 计划推送、
_confirmed等与实现不符的描述