Skip to content

v3.2.0

Latest

Choose a tag to compare

@Zoroaaa Zoroaaa released this 04 Nov 06:33

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 等与实现不符的描述