Releases: XMZF-vAI/clerkbox
Releases · XMZF-vAI/clerkbox
Release list
v2.5.0
ClerkBox v2.5.0
本版聚焦两件大事：AI 运行中也能排队发消息，以及按各家官方形态调优的第三方 harness 兼容模式；同时对全项目完成了一轮 40+ 项问题的安全与稳定性审查修复。
AI 运行中消息排队（新功能）
- 运行中可发消息：AI 正在运行或压缩上下文时发消息不再被拦截，消息进入输入框上方的排队组件，等 AI 干完后按顺序逐条自动发出
- 排队条目管理：单条可编辑（回填输入框）、删除或「立即发送」——立即发送会中断当前运行并即刻发出
- 多条排队 FIFO：支持一次排多条，按入队顺序逐条自动发出；图片附件随队列保留并显示缩略图
- 不丢消息：手动停止或出错时队列保留；发送失败自动放回队首
第三方 harness 兼容模式（新功能）
- 模式选择器：输入框上方新增 ClerkBox 默认 / Codex / Grok Build / dsh / dsh 极简五种模式，每项带说明与推荐模型搭配
- 官方形态对齐：以各家官方 harness prompt（Apache-2.0 / MIT，署名见源码文件头）为底本适配 ClerkBox 工具集，第三方模型对齐官方形态后效果接近官方
- 会话级锁定：模式随会话持久化，发出首条消息后锁定；旧会话自动回退默认模式，零迁移
- 顺带修复 token 追踪器跨会话残留，导致新会话上下文指示器显示上一场对话用量的问题
全项目安全审查（主进程加固）
- WebUI 远程能力收敛：远程模式下读取密钥、执行命令、伪终端、拉起 MCP 等敏感调用一律拒绝；API 鉴权不再接受 URL query 传 token，防 token 泄漏被放大为远程执行与密钥失窃
- 单实例锁：防止多开互覆数据文件
- 路径校验加固：拦截 UNC 路径、NTFS 命名流与 Windows 保留设备名
- 技能市场强制 https，防下载被中间人替换
- 子进程治理：MCP 连接超时回收半成品子进程，退出时限时等待清理，不再残留僵尸进程
- webview 权限请求默认拒绝
运行时正确性修复
- 修复 Anthropic 每轮 usage 双计，Token 用量统计不再翻倍
- 修复工具结果 token 双倍估算，不再提前触发上下文压缩
- 修复 WebUI 代理流断连后 agent 循环永久挂起
- 修复用户消息重复发送（token 双花）与多会话并发时工作目录 / 任务模式 / 用量锚点串台
- 修复流中断后残缺工具调用参数仍被执行；删除会话时清理挂起的提问等待
界面与体验打磨
- 删除供应商、卸载技能等危险操作统一二次确认——此前一键抹除 API Key 无任何提示
- 流式回复期间输入框可以打字；切换会话重置滚动位置，新增「回到底部」悬浮按钮
- 新增全局字体档位（默认 / 衬线），CSS 变量驱动，启动无闪变
- 修复打开设置页整屏闪白；上下文指示器配色走 MD token，浅色主题正常可见
- i18n 漏翻补齐；终端面板修复多开标签的监听器泄漏；文件树目录读取失败可辨识
Vibe 氛围模式
- 本地播放器补音量滑块与松手才提交的进度拖动
- 轮播图按需解析 + LRU 缓存，WebUI 端不再全量驻留 base64，内存占用大幅下降；切图动画只走合成器属性，防核显掉帧
- 默认背景外链签名过期时渐变兜底不再死黑；音频加载失败兜底；玻璃定制菜单展示实际生效轨道
Lunora API 官方合作伙伴
- 设置页提供商列表新增 Lunora API 官方合作伙伴宣传卡：一个入口聚合 Claude / GPT / DeepSeek / 通义 / Gemini / Grok 等多厂商模型
- 「去拿 Key」入口统一指向 Lunora 注册页
工程与安装包
- 版本号收敛为 package.json 单一来源，About 页 / MCP 客户端 / 安装器许可协议全部自动同步
- 安装包瘦身：asar 不再整包打入构建产物目录，仅保留窗口图标引用
- 仓库卫生：移除误跟踪的 Electron 运行时二进制与一次性脚本
Windows x64 · NSIS 安装包（可选安装路径，自带卸载器）。从旧版本覆盖安装即可，会话数据自动保留。
ClerkBox v2.1.0
ClerkBox v2.1.0
聚焦 WebUI 移动端体验：局域网地址探测更准，手机端获得专属设置页。本版本合并了社区贡献者 @RETUSTU 的 PR #2。
WebUI
- 局域网 IP 智能探测：改用 UDP 路由探测获取真实出口 IP，绕开 Hyper-V / WSL / Docker 等虚拟网卡干扰，手机扫码直连更可靠；阿里 DNS + Google DNS 双目标冗余兜底，单点失败自动回退
- 手机专属设置页：窄屏/手机端设置页重构为仿 Android 的「列表 → 详情」双层结构，API 配置 / MCP 插件 / 通用 / 外观逐项可达；账户登录与同步涉及云端 OAuth 授权与本地数据覆盖，统一引导至桌面端完成
其他
- 版本号同步至 2.1.0，安装包使用协议随之更新
Windows x64 · NSIS 安装包（可选安装路径，自带卸载器）。从旧版本覆盖安装即可，会话数据自动保留。
Contributors
RETUSTU
Assets 5
ClerkBox v2.0.0
ClerkBox v2.0.0
AI Agent 桌面工作台的里程碑版本：接入 MCP 工具生态、Trae 式工作台，并对 agent 运行时做整轮加固。
Agent 与工具生态
- MCP 服务器接入：对话可直接调用外部 MCP 工具生态
- 插件市场：技能商店升级为双标签扩展商店，接入 MCP Hub 中国版
- 工具链加固：read_file 分页与超长文件续读、命令执行超时保护（默认 120 秒）与超大输出自动转存、ripgrep 加速内容检索、重复调用自动拦截、截断响应拒绝执行、search_replace 匹配加固——长会话更稳、更省
- 系统提示词静态/动态分段：提升前缀缓存命中，降低 token 消耗
工作台与交互
- Trae 式工作台面板：文件 / 终端 / 浏览器 / 子 Agent 一体的右侧面板
- TRAE 风格审批模式 +
/命令菜单：Spec / Plan / Goal 工作流 - /goal 目标模式：设定会话目标后，AI 每轮自动评估「进行中 / 已达成 / 无法完成」并自动续跑，长任务一口气完成
- 交互卡片：AI 可主动给出 TodoList 计划卡片、就关键决策向用户提问、展示已加载技能
- 上下文用量指示器与手动压缩
技能系统
- 技能自动发现：全量技能目录注入（预算内三级降级），AI 免手动激活即可发现并按需加载技能；触发词智能提醒
- 安装即落盘：市场 / 自定义技能安装后写入本地技能库，重启不丢
- 预置技能内置：docx / pdf / pptx / xlsx / find-skills / create-skill 六个技能随安装包分发，开箱即用
其他
- 氛围模式升级：背景三模式、系统音频与玻璃定制面板
- 技能市场搜索覆盖率改进
- 安装包使用协议更新至 2.0.0，新增 AI 代理授权执行条款
Windows x64 · NSIS 安装包（可选安装路径，自带卸载器）。从旧版本覆盖安装即可，会话数据自动保留。
ClerkBox v1.7.5
ClerkBox v1.7.5
- WebUI 移动端适配：窄屏自动切换移动端布局（大触控按钮、底部抽屉菜单、虚拟键盘避让），更便于手机操作
- WebUI 局域网访问 + 扫码直达：默认仅本机访问，可一键开启「允许局域网访问」，开启后生成二维码，手机扫码即刻连接
- WebUI 浏览器文件：浏览器可上传文件到主机（默认每文件 10MB），并可浏览选择主机工作目录
- 安全加固：WebUI 默认仅绑定本机回环地址、启用内容安全策略（CSP）
- 稳定性：长会话写入改为原子替换，避免压缩途中损坏会话
Windows x64 · NSIS 安装包（可选安装路径，自带卸载器）
v1.7.0
v1.7.0
v1.6.3 以来最大的一次更新：新增 WebUI 远程访问、模型级高级设置、Token 用量统计三大功能，并对前缀缓存做了系统性优化。
🌐 WebUI 远程访问（新功能）
- 新增 WebUI 远程访问模式：同一局域网内用任意设备浏览器打开地址，即可远程操控 ClerkBox，手机 / iPad / 另一台电脑都能用
- 双模式数据实时同步：桌面端与浏览器端的对话记录、会话状态保持一致
- 侧边栏显示 Web UI [BETA] 徽章，新增浏览器标签页图标
- WebUI 模式下窗口样式优化
⚙️ 模型级高级设置与推理档位（新功能）
- 每个模型可独立配置高级参数（温度、思考预算等），互不影响
- 思考配置简化为「开关 / 档位」两种模式：开关一键启停，档位自动匹配当前协议
- 对话界面滑块可直接切换当前档位，思考默认开启
📊 Token 用量统计（新功能）
- 新增通用设置栏与 Token 用量统计面板，按会话查看消耗明细
- 兼容各家供应商的缓存统计口径，缓存命中、命中率一目了然
🚀 前缀缓存优化（成本大幅下降）
- 会话内多轮请求缓存命中率稳定在 90% 以上，长对话成本显著下降
- Anthropic 协议下对话历史也纳入缓存
🧠 AGENTS.md 支持
- 工作目录下的 AGENTS.md 自动注入上下文，项目规范直接生效
- 项目迁移至 Apache 2.0 开源协议
🛠 技能商店
- 迁移至 CocoLoop Hub，技能源更稳定
- 修复 Windows 下技能安装失败的问题
- 修复技能商店搜索几乎零结果的问题
🐛 问题修复
- 修复流式回复头尾截断的问题
- 修复部分环境下联网搜索、网页读取失效的问题
- 修复思考内容渲染不可见的问题