TanXin
059c850b2d
## 发布说明 v1.10.4 核心修复 AI Agent 在多步任务或使用特定大模型时，会话直接异常终止且无最终回复输出的问题，并优化了流式解析与 System Prompt 工作流约束。 ### 提交列表 - `a57f6bb` fix: 修复 AI Agent 异常终止与最终回复缺失问题 - `77906a0` release: 发布 v1.10.4 AI Agent 会话稳定性修复版本 ### 本次版本更新要点 **Fixed（AI 会话稳定性，核心防线）** - **`runLoop` 响应派发兜底**：修复当大模型直接以自然语言文本总结（无 `tool_calls`）时，后端控制循环直接 return 导致漏发响应帧、任务执行一半静默终止且无任何输出的问题。 - **流式空数组误判修复**：修正流式解析中将 `delta.tool_calls: []` 空数组误判为工具调用、导致文本流被拦截的问题。 - **推理模型思维链兼容**：收集 `delta.reasoning_content` / `delta.reasoning`，当仅有推理内容时自动回退作为回复输出，并在模型极端返回空内容时提供多语言安全兜底（“任务已执行完成。” / "Task completed."）。 **Changed** - **工作流约束优化**：优化 System Prompt 第 6 步，允许模型在任务完成时直接以 Markdown 形式输出总结报告，消除对 `respond_to_user` 虚拟工具的强制要求，对齐业界标准 Agent 范式。 **Added** - **自动化测试套件**：新增 4 个针对 AgentCore 响应交付与异常终止场景的单元测试（`tests/worker/agent-core-response.test.ts`）。 ### 验证结果 - `pnpm run typecheck`（worker + frontend）：全部通过（0 错误） - `pnpm test`：50 个测试文件 / 619 项用例全部通过（100% Pass） - `pnpm run build:frontend`：前端生产构建成功并内联至 `src/worker/html.ts` - 代码已推送 `test` 分支并在云端 CI 自动触发测试环境验证
CloudSSH 测试套件
本目录包含 CloudSSH 的单元测试、协议集成测试、构建回归和浏览器 E2E。测试框架以 Vitest 和 Playwright 为主。
目录结构
tests/
├── build/ # 生产构建、可复现性和原生弹窗回归
├── e2e/ # Chromium 浏览器交互与 axe 无障碍检查
├── ssh/ # SSH 算法、认证、加密、KEX、Packet 与测试密钥夹具
├── worker/ # Worker 路由、安全、DNS、UserDB 与标签测试
├── agent-code-actions.test.ts # Agent 代码块复制/填入规则
├── agent-terminal-selection.test.ts # 终端选区附件和非授权安全边界
├── auth-challenge-dialog.test.ts # RFC 4256 认证挑战对话框交互
├── clipboard.test.ts # Clipboard API 与旧版复制回退
├── frontend-ux.test.ts # 前端关键交互源码回归（标签栏/状态栏渲染等）
├── host-display.test.ts # IPv4/IPv6 掩码与完整地址复制
├── i18n.test.ts # 中英文词条和语言解析
├── known-hosts.test.ts # 已知主机指纹 TOFU 信任与变更流程
├── mobile-input.test.ts # iOS IME diff 与一次性修饰键帮助函数
├── share-session.test.ts # 分享会话确认/领取幂等与页面状态
├── sftp-selection.test.ts # SFTP 单选、多选、连选和全选模型
├── snippet-local-store.test.ts # 匿名命令片段 localStorage 存储与限额
├── snippet-schema.test.ts # 片段名称/命令/数量校验与规范化
├── terminal-status.test.ts # SSH 状态事件翻译
├── terminal-text.test.ts # 终端文本处理
├── theme.test.ts # 内置/自定义主题
├── types.test.ts # 共享类型和终端尺寸边界
└── README.md
tests/ssh/fixtures/ 中的私钥只用于公开的协议测试，不得用于生产服务器或真实账号。
运行命令
# 运行全部 Vitest 单元与集成测试
pnpm test
# 运行指定测试文件
pnpm test tests/ssh/auth.test.ts
# 生成覆盖率报告（输出到 coverage/）
pnpm run test:coverage
# 监听模式
pnpm test --watch
# 安装并运行 Chromium E2E 与 axe 无障碍检查
pnpm exec playwright install chromium
pnpm run test:e2e
# 类型检查、测试、可复现构建和 E2E 完整门禁
pnpm run verify
当前覆盖范围
SSH 协议
- 算法协商列表与兼容性
- 密码认证
- Ed25519、ECDSA P-256/P-384/P-521、RSA-SHA2 私钥认证
- OpenSSH 私钥解析、DER/SSH 签名转换
- AES-GCM/CTR、HMAC、Packet、KEX 辅助和二进制工具
Worker 与安全边界
- Turnstile 验证 token 的结构、过期时间和 HMAC
- Origin 检查、端口范围、连接令牌和错误信息边界
- IPv4/IPv6 保留地址、DoH 解析与 DNS rebinding 防护
- Agent 危险命令拦截、确认规则和 SSRF URL 校验
- 主机密钥信任：首见指纹确认、更换指纹阻断与路由作用域隔离
- 键盘交互认证、OS 检测、跳板链、SFTP 上传冲突、分享会话策略
- UserDB 服务器标签/片段迁移、规范化、序列化、更新与隔离
前端与构建
- 服务器搜索、标签筛选和响应式分页（桌面 9 / 平板 6 / 移动 3）
- SFTP 单选、Cmd/Ctrl 多选、Shift 连选和全选
- Agent 终端选区附件、问题组合和非授权安全边界
- 终端选区自动复制、指针取消和旧版复制回退
- i18n、主题、终端状态/文本、已知主机与片段本地存储
- 构建可复现性、xterm 生产构建兼容和原生弹窗禁用
浏览器 E2E
- 匿名连接表单 axe 检查
- 服务器弹窗的基本对话框语义、初始焦点和 Escape 关闭
- 服务器标签筛选与分页
- Agent 终端选区附件
- 终端选区复制与焦点恢复
- 认证挑战对话框、iOS 输入法、移动端后台连接恢复与分享会话领取
- SFTP 覆盖确认、主题样式与 UI 回归
当前限制
- Playwright 的完整界面与无障碍回归主要运行 Chromium；认证挑战、iOS 输入法和移动端后台连接恢复另在 WebKit 设备项目中执行。Firefox 尚未纳入当前质量门禁。
- 浏览器 E2E 主要通过 mock API 验证前端行为，尚未连接真实 OpenSSH/Dropbear 和 SFTP 服务。
- SSHSessionDO、SSH 会话状态机、SFTP 数据流和 AgentCore 等运行态模块的覆盖率仍偏低。
- 新增协议状态、WebSocket 消息或安全边界时，应优先补充运行时错误、取消、超时和畸形输入测试，而不仅验证成功路径。