夜雨聆风
OpenClaw Buddy v1.0.13 发布,连得上、看得见、带得走
“网关不在本机时，最怕的是『以为在线』；嵌入到别人的页面里，最怕的是『一声不响地失败』。
这一版里，我们把寻址、探针与状态对账拧成一股绳：bind 与自定义 Host 能被读懂，多地址探测与 health 事件把真实落点告诉前端；WebSocket 代理在洪流里学会『只对关键字动刀』，CPU 不再被 JSON 淹没。
与此同时，系统用户有了可轮换的 API 令牌与对外签发接口，Bot 授权与建号拆成清晰的两步；V3 侧协议抬到 V4，却在握手失败时悄悄退回兼容路径；经典模式的流式代理补上了早该在的 defer——空 SSE 不再是玄学。
五月过半，我们把『链路诚实』写进默认路径。”
🔖 版本 (Version): v1.0.13📅 发布日期 (Date): 2026-05-16🆔 基准代码 (Base): f7af7f8🆔 当前提交 (Commit): e000314💠 核心主题: 用户 API 令牌与对外签发、嵌入鉴权体验、网关多地址寻址与 WS 性能、V3 协议 V4 与协商、经典流式代理修复、会话列表与会话操作稳健性。
🚀 新增特性 (NEW FEATURES)
01用户 API 令牌、对外接口与 Bot 授权拆分 🔑
• 数据库与登录: users.api_token；中间件与 /login 识别 buddyu_ 前缀令牌；管理端支持生成、复制、重置与登录链接。
• 对外 API: POST /v1/getUserToken（adminToken 校验，按用户名返回 token 与 bot_ids）；POST /v1/createUserToken（不存在则创建 user 角色并签发；支持姓名等字段）；POST /v1/assignUserBot 独立承担 Bot 绑定，与建号解耦。
• 文档: API.md 同步鉴权说明、curl 示例与字段表。
💡 大白话：给集成方一把『可轮换的钥匙』，谁在哪个 Bot 上有权限，接口层能说清楚、改得动。
02嵌入场景：少打扰、失败要显眼 🖼️
• 静音成功提示: ?embed=true 时不再弹出「自动登录成功」顶栏 message，避免宿主页面噪音。
• 令牌失败全屏遮罩: 嵌入且 URL token 校验失败时直接无权限遮罩，不再误进登录页。
• 用户表: 真实姓名 / 角色列收紧，操作列加宽，便于日常运维。
💡 大白话：嵌进去时，成功别嚷嚷，失败别把人领到登录页兜圈子。
03网关寻址、状态展示与 WebSocket 性能 🛰️
• 配置兼容: 解析 openclaw.json 的 bind、customBindHost，并向前兼容 Buddy 的 host；候选地址按 127.0.0.1 → 自定义 Host 降级探测。
• health 事件: 向前端注入实际连接目标（target / port）；端口为 0 或未配置时回落 HEALTH_PORT，与 HTTP / WS 代理行为对齐。
• WS 代理性能: 对高频帧做字节级关键字过滤后再 JSON 解析，降低流式场景 CPU 占用；多地址存活性扫描与 internal/process 寻址逻辑统一，Guardian 与状态接口一致。
• 前端对账: WS 异常断开即时触发 HTTP 状态查询；握手 / 重连以 gateway.status 为前提；Dashboard 状态与 deriveGatewayState 统一；Tooltip 结构化展示监听地址与延迟。
💡 大白话：网关绑在物理 IP 上时少误报「已停止」；状态栏告诉你『连的是谁、延迟多少』，而不是一个笼统的绿点。
04V3：WebSocket 协议 V4 与版本协商 📡
• 协议: 前端默认尝试 V4；失败时根据网关反馈自动降级 V3；签名载体与网关校验器对齐（v3 签名格式）。
• 工具与文档: tests/manual 下 Go 调试脚本与协议手册同步 V4 / 签名说明。
💡 大白话：新网关用 V4，老环境还能自动聊回去，不必手工改两处配置。
05经典聊天欢迎区与快捷指令 ✨
• 欢迎页: 渐变卡片、悬停效果；embed 下隐藏刷新；移除默认 mascot / 默认图标；窄屏双列紧凑布局与文案截断优化。
• 快捷指令: 管理弹窗两列布局；「当前指令」可折叠（移动端默认折叠），折叠时显示条数提示；系统预置指令右上角 SYS 斜角丝带（深浅主题）；i18n 补全。
💡 大白话：空态更好看、更好管，手机上也不会一排卡片把页面撑爆。
06内置 Expert 与模型默认值 📚
• 专家包: 新增 customer_success、data_analyst、meeting_facilitator、product_manager、prompt_coach、ux_researcher 等；修正 live_stream_coach 字段；新增打包校验测试保证必填字段完整。
• 模型默认: 新模型默认上下文窗口与上限调整为更合理的量级（如 128k 上下文）；maxTokens 默认调整为 50k；Bots 配置写入时移除冗余 capabilities 别名，统一走 input 描述。
💡 大白话：开箱专家更全，默认模型参数不那么『夸张到用不上』。
🛠️ 稳定性、修复与重构 (FIXES, REFACTORS & CHORES)
1. 经典模式 HTTP 流式代理 🔧
• 成功流式请求在响应体读完前不再提前 cancel context，避免 SSE 被截断为空流。
• Port <= 0 时与 WS 一致回落 HEALTH_PORT。
• 流式写路径改为直接 Writer + Flusher、复用缓冲区，降低延迟与 GC。
2. V3 聊天与会话 🧩
• sessions.create 兼容无 payload.key；快捷建会话失败不误清 sessionKey；模型 / 思考等级 patch 失败回滚并提示。
• 经典模式：输入中禁用 Bot 切换；未选 Bot 禁用上传。V3：快捷聊天校验 Bot；发送前拦截未连接、生成中、新建会话中。
• 折叠元数据区块展开状态持久化；思考占位不再因 session.message 兜底误释放输入锁。
• WebSocket：静默授权重复发送修复、NOT_PAIRED 路径恢复；发送顺序优化；标题清洗过滤冗余前缀；Bot 选中同步增加可用性校验。
• useV3Sessions 中 fetchSessions 依赖补全，修复切换用户后会话列表过滤不更新。
3. 后端与工程结构 🏗️
• API：handlers.go 按领域拆分为微信 / 自愈 / 设备 / 状态 / 配置 / 安全 / 用量等文件。
• Process：openclaw.json 读写集中到 config_json.go；OpenClaw 实现拆为多文件（openclaw_*.go），openclaw.go 保留类型入口。
• 前端：useV3Messages 拆为工具与格式化模块；App 抽离 gatewayState、menu、GlobalLoadingMask、NoBotPermissionOverlay 等。
• 自动标题总结：去抖与单批上限调整，减轻网关同步 I/O 压力；聊天分析过程默认折叠；移除冗余动画。
• 会话列表：本地 localStorage 缓存首屏秒开；移除列表收到后的冗余 N² 遍历。
• OpsX：简化 OpenSpec 流程，整合核心 Skill 并同步 .agent / .cursor；清理旧版 Skill 定义。
• 杂项：.cursorignore、.geminiignore；专家文案去个性化为通用「用户」称谓。