🦞 OpenClaw Buddy v1.0.12 Release Notes

🛡️ OpenClaw Buddy v1.0.12：边界清晰处，才有真正的自由

“权限不是为了挡住谁，而是为了让大家知道自己站在哪里。

这一版里，我们为控制台加上了『看得见』的边界：谁能改 Bot、谁能碰网关、谁能打开 Shell—— ticket 不再是一把万能钥匙；记忆文件名有了自己的戒律；配置写入前先问过校验之神。

与此同时，我们把工坊变得更顺手：CodeMirror 接棒编辑器、运维终端有了多 Tab、日志与活跃榜更贴近真实战场；经典聊天在流式与隔离之间学会了喘息。

五月，我们把『可信』写进默认路径。”

版本 (Version): v1.0.12
发布日期 (Date): 2026-05-11
基准代码 (Base): 92d2ca2
当前提交 (Commit): e49e76d
核心主题: 用户与 RBAC、OpenClaw API 权限收口、聊天与会话隔离、控制台性能与编辑体验、自愈与 Bots 安全加固。

---

🚀 新增特性 (New Features)

1. 身份、权限与数据边界：用户管理与 RBAC 👥

• 用户管理与角色：新增系统用户管理能力，配合后端 RBAC（菜单/操作粒度权限），为控制台各模块建立可审计的访问控制。
• Bot 绑定与过滤：支持按用户配置可见 Bot；接口层对 bots-models 等数据进行基于绑定关系的过滤，避免『看见了不该看的』。
• 会话隔离：会话 ID 与用户名注入、按用户区分存储与列表过滤；经典聊天侧同步收紧，减少多人共用环境下的串会话风险。
• 💡 大白话： 谁在后台能点哪儿，现在有谱了；每个人看到的 Bot 列表更符合自己的授权；聊天会话也不容易跟别人混在一起。

2. OpenClaw API 权限与 Ticket 语义修正 🔐

• 路由级权限：大量 OpenClaw / 网关 / 审计 / 渠道 / WebSocket 相关路由挂载菜单权限校验；新增 RequireAnyPermission，支持『任一权限即可』的组合场景。
• 一次性 Ticket：签发 Ticket 时绑定当前登录主体，消费时继承该主体的权限；不再将 Ticket 视为超级管理员替身；签发 Ticket 需已登录。
• 💡 大白话： 以前『拿个 ticket 好像无所不能』的路被堵上了；现在 ticket 只是把你当时的权限暂时接力出去，而不是凭空升格。

3. 控制台体验：更轻、更快、更像 IDE ⚡

• 懒加载与实时信号：控制台路由懒加载；WS / 网关状态与缓存策略优化；Buddy 日志支持末尾历史批量推送；实时日志默认滚到底、活跃榜支持强制刷新并与审计大屏口径对齐。
• 顶栏网关状态：HTTP gateway.status 大小写不敏感 判定运行中；区分『授权中』『WS 重连 / 异常』与『已停止』；Badge / Tooltip 展示 HTTP·WS·延迟与健康时间。
• 运维终端多 Tab：终端侧支持多会话 Tab，并优化选中态底线样式。
• 💡 大白话： 控制台首开更顺，网关状态不再一惊一乍；运维终端可以像本机终端一样开多个 Tab。

4. 文件 / 技能工坊：CodeMirror、预览与路径安全 📂

• 编辑器换代：文件浏览器与技能资源浏览器集成 CodeMirror，替换 Monaco；对齐标题栏与编辑浮标体验。
• 交互增强：目录侧栏支持拖拽调宽；目录树长文件名单行省略；右键菜单定位修正；HTML 等类型支持新窗口预览。
• 技能资源 API：新增技能文件创建 / 目录创建等接口；路径校验（含符号链接解析与目录逃逸防护）；浏览器侧上传体积上限与遍历限流。
• 💡 大白话： 编辑更轻、拖拽更顺手；技能文件新建与上传多了一层『别乱跑目录』的保险。

5. 聊天：经典模式与 V3 双线打磨 💬

• 经典模式：流式输出与会话存储重写（SSE 行缓冲、中止与错误气泡、队列排空策略）；HTTP 聊天补齐上下文路径、全屏与 Bot 能力提示；代理在上游非 2xx 时透传状态码与正文。
• 嵌入与布局：聊天嵌入可选项、经典模式布局与全屏对齐 V3；编辑重发、技能帮助 Popover、ClawHub 链接等交互补完。
• V3：会话列表首屏加载、bootstrap 去重、分页条数与 memo 优化；缓解长时间使用后的列表/详情变慢；侧栏默认展开时全屏误取消等问题修复。
• 💡 大白话： 经典聊天更跟手、报错更真实；V3 在大会话量下不那么『越用越卡』。

---

🛠️ 稳定性、修复与文档 (Fixes, Robustness & Docs)

1. 自愈与配置写入 🩹

• OpenClaw 配置 先校验再通过临时文件原子 rename 写入，避免半成品配置落盘。
• 自愈事件扫描对可空文本列更健壮；报表 / 备份目录不存在时返回空列表；自愈页刷新联动仪表盘与失败提示优化。

2. Bots 与进程侧 🔧

• 记忆文件名仅允许 .md / .txt，禁止路径穿越；模型异步任务 Target、删除接口等与前端 Bots 管理对齐。
• 会话列表超大 JSON 输出改走临时文件，降低截断风险。
• 『虾兵蟹将』立即聊天与网关就绪、会话恢复等边界冲突修复。

3. 前端构建与杂项 🌐

• WebRoot 相对构建、技能列表解析与 V3 中文编辑等问题修复；禁用状态下隐藏会话删除按钮。
• README / README_en 增补 Stars、Forks、Release 徽章与 Star History；API 文档微调。
• 仓库横幅图 docs/images/banner.png 体积压缩（同步用于本发行说明 ./banner.png）。

---

📄 变更清单 (Commit Log)

下列为 92d2ca2..e49e76d 区间内 非 merge 提交（时间新 → 旧）。合并节点参见 GitHub PR #29–#33。

简写	描述
e49e76d	docs(images): 压缩横幅图 banner.png
0b9f3cb	feat(web): 优化顶栏网关状态与 HTTP/WS 兜底展示
1ddba54	feat(api): 路由 RBAC、ticket 继承主体与 bots-models 过滤
1f52945	feat(skills): 技能资源新建 API 与路径校验，浏览器上传限流
8f52ee8	fix(bots): 记忆文件名安全校验与模型任务、删除接口对齐
5fc8521	fix(heal): OpenClaw 配置先校验再原子写入，自愈事件与页面容错
2e1c697	fix(chat): 经典模式流式与会话存储，chat 代理透传上游错误
c41be7b	fix(v3): 会话状态、滚动与列表拉取及 memo 优化
1722d25	feat: 活跃榜强制刷新与实时日志默认滚到底
c991396	fix(process): 机器人活跃榜与审计大屏口径对齐
5f7f7ad	feat(web): 文件浏览器 HTML 支持新窗口预览
c3bcca2	fix(chat): 虾兵蟹将立即聊天与网关就绪及会话恢复冲突
674f74d	fix(process): 会话列表 JSON 大输出走临时文件避免截断
ddac29f	fix(web): WebRoot 相对构建、技能列表解析与 V3 中文编辑
14a2d18	fix(web): 禁用状态隐藏会话删除按钮
00c82e0	feat: 用户 Bot 权限与 V3 聊天体验
4ec11cf	feat(web): 文件浏览器目录侧栏支持拖拽调整宽度
ebcd600	fix(web): 目录树长文件名改为单行省略
ce5c60c	fix(web): 文件浏览器目录树右键菜单定位修正
598785f	fix(web): 经典聊天会话ID写入用户名
553b071	feat(web): 会话ID注入用户名并按用户过滤
91f2bc9	feat: 新增用户管理与 RBAC 权限控制
21dfec1	feat(web): 经典聊天编辑重发、技能帮助 Popover 与 ClawHub 链接
04b73ba	feat(web): 聊天嵌入可选项与经典模式布局、全屏对齐 V3
5675b61	feat(web): 运维终端支持多 Tab 并优化选中底线样式
975c7dc	feat(web): 控制台懒加载、WS/网关与缓存；Buddy 日志末尾历史批推送
d999216	feat(web): 技能资源浏览器对齐文件浏览器标题栏与编辑浮标
4859064	docs: README 新增 Stars/Forks/Release 徽章及 Star History 图表
4901480	feat(web): 文件与技能资源浏览器集成 CodeMirror 替换 Monaco
70eb0a1	fix(web): HTTP 聊天模式补齐上下文路径、全屏与 bot 能力提示
6649d94	fix(v3): 修复侧栏默认展开时文件浏览器与终端全屏被误取消
df1b8a5	perf(v3): 缓解长时间使用后会话列表与详情变慢
adc8151	fix(v3): 会话列表首屏加载态、去重 bootstrap 与分页条数

---

📦 发布产物 (Release Artifacts)

• 🐧 Linux (amd64): openclaw-buddy-linux-1.0.12.tar.gz
• 🍎 macOS (Universal): openclaw-buddy-mac-1.0.12.tar.gz

🔗 下载地址: GitHub Releases v1.0.12

---

❤️ 特别致谢

感谢每一位把 Buddy 带进真实运维现场的同伴——你们在工单里写的每一句话，最后都变成了提交说明里的动词。

“自由的前提，是边界被温柔地讲清楚。”

---