# 版本变更记录

各版本变更摘要（新版本在上）。安装与使用说明见 [README.md](README.md)。

## 版本 0.7.24 变更摘要（待发布）

- 面板支持粘贴图片/文件：输入框 paste 拦截剪贴板文件，附件预览条（图片缩略图/文件名 chip，可单个移除，单条消息最多 6 个）
- 新增 `POST /upload` 端点：附件落盘 DSH 工作区 `dsh-relay-uploads/`（文件名白名单净化 + 时间戳防覆盖，单文件 20MB 上限），发送时以工作区相对路径引用拼进任务文本，agent 用原生文件读取工具查看；续聊场景传 taskId 以会话工作区为准

## 版本 0.7.23 变更摘要

- License 修复：剥离第三方附录使 GitHub 正确识别为 MIT，许可声明移入 README

## 版本 0.7.22 变更摘要（待发布）

- 向导页移除「代理统一注入 Authorization 头」配置生成块（保留 script 片段生成，省略 data-token 的代理方案说明仍在提示文字中）

## 版本 0.7.21 变更摘要（待发布）

- 会话回放与 DSH 侧消息透传剔除「伪用户消息」：DSH 内部注入的运行时上下文快照、`<system-reminder>` 技能清单、任务名摘要及 relay 任务提示词不再以用户气泡展示（用户从未说过这些内容）

## 版本 0.7.20 变更摘要（待发布）

- 会话加载回放后，新回合的思考块与过程行自动收进「执行过程」折叠条（对齐 DSH web UI 观感），不再平铺刷屏；开新会话恢复平铺
- 滚动条彻底变细：修复 `.panel` 上的标准属性 `scrollbar-width/scrollbar-color` 令 Chromium 禁用 `::-webkit-scrollbar` 自定义的冲突（标准属性隔离进 `@-moz-document` 仅 Firefox 生效），webkit 滚动条 6px→4px、thumb 视觉 2px 圆角

## 版本 0.7.19 变更摘要（待发布）

- 彻底修复 relay 重启/归档会话无法加载：重挂改用 `sessionController.resolveAgent()`（返回 `{agent}` 包装）拉起活会话，历史事件改用 `sessionController.inspect()` 读持久化完整事件前缀（旧 `resume()` API 不存在，导致 0.7.8 起重挂从未真正成功），inspect 失败再回退 session 多形态探测

## 版本 0.7.18 变更摘要（待发布）

- 修复 relay 重启/归档会话加载后历史为空：重挂事件流多形态探测（新版 `seq`+`eventAt`、旧版 `eventList()` / `events` 数组），并打印不可读时的 session 形态诊断日志，便于跨 DSH 版本定位

## 版本 0.7.17 变更摘要（待发布）

- 开新会话不再往消息流插提示行（「已开新会话：…」），面板顶部保持干净

## 版本 0.7.16 变更摘要（待发布）

- 吸附条箭头修正为向左（原画反成向右）；默认位置上挪 100px（bottom 116px）；提问卡/追问卡/设置框动画改为从右侧滑入（与侧栏朝向一致）

## 版本 0.7.15 变更摘要（待发布）

- 吸附条竖放：22×76 贴右缘竖条（原横向小条），箭头改向左（点开向左展开右侧栏）；位置恢复统一 parseFloat 判空，修无记忆时被钉到顶部的边界 bug

## 版本 0.7.14 变更摘要（待发布）

- 最小化吸附条改右下角：保留原停靠小条样式（仅从顶部换到右缘贴边），可上下拖动、范围限制在页面内、位置 localStorage 记忆，拖后松手不误触发展开
- 修复会话历史加载 404 根因不可见：会话重挂 agents 注册表异常时不再直接放弃（原直接 return null 跳过 resume 兜底），并补全 resume 失败各分支的警告日志
- 提问卡/追问卡/设置框移到内容区底部（输入框上方），显示时从下淡入滑出
- 去掉面板状态栏（status-line 不再展示）：错误提示走消息流，运行态看执行/停止按钮与步骤流

## 版本 0.7.13 变更摘要（待发布）

- 面板改侧边栏式：吸顶右侧、顶边往下回 8px（上下各留 8px）、高度撑满视口；缩放手柄仅调宽度（高度固定），旧高度记忆作废
- 会话抽屉几何与面板对齐（top 8px、同高度），上下拖动保留
- 新增代理鉴权配置生成：向导页方式二在 script 示例下方生成带本机口令的代理注入示例（Nginx `proxy_set_header Authorization`），复制即用
- 向导页示例文案脱敏：placeholder 中真实业务路径改为通用 `your-proxy`

## 版本 0.7.12 变更摘要（待发布）

- 新增 `engines.dsh` 声明（`>=0.2.1-rc.1`），适配 DSH 插件市场按 engines 识别收录
- README 安装命令改为 npm 包方式：`dsh plugin --profile web add dsh-browser-relay`
- 修复深色宿主页面板输入框文字变白：表单控件显式锁定浅色主题（color + color-scheme）
- 提问卡/追问卡增加浅色底衬（#f6f8fb），与消息区视觉区分
- 会话列表改吸顶右侧抽屉：fixed 吸顶往下回 8px、右缘贴边、高度 100vh、宽度随面板同步，动画从右滑入/向右收回（原全面板左盖式）
- 会话抽屉支持上下拖动：按住标题栏调 top（0~视口高-60），位置 localStorage 记忆
- 面板滚动条统一精致化：全部滚动区细滚动条（thumb 视觉 4px 圆角、悬停加深、透明轨道，Firefox 走 thin 继承）
- 新增代理鉴权模式：页面接入省略 `data-token` 时面板请求不带凭据（含 /file 图片参数），由后端代理统一注入 Authorization 头，口令不暴露给页面访客
- 修复回合结束后面板长时间停留「执行中」：0.7.7 长轮询挂起后回合终态未唤醒挂起的 poll，最长等 25s 才切回发送态；终态分支补 wakePoll 立即唤醒
- 修复 L4 档 DSH 原生工具被误拦：执行层守卫把 dsh 档当 site 档处理，office_read 等全部 deny，与 prompt「L4 可用 DSH 插件工具取数」自相矛盾；现 L4/L5 均放行 DSH 工具，差异收敛到导航域校验
- 修复 L5 档跨域导航被误拦：扩展侧 browser_navigate 同域校验未区分档位，补 L5（all）豁免，与「L5 导航不限域」定义对齐

## 版本 0.7.10 变更摘要

- `/file` 图片兜底端点安全收紧：仅放行图片扩展名白名单（png/jpg/jpeg/gif/webp/svg/bmp/ico/avif），非图片请求（源码/.env/配置等）直接 403；SVG 响应附加 `Content-Security-Policy: sandbox` 防内嵌脚本 XSS

## 版本 0.7.8 变更摘要（0.7.9 补充：特效开关由勾选框改为下拉选择框，配置键不变）

- 归档会话可回放：重挂改为活会话快路径 + sessionController.resume 兜底（与 DSH web UI 回看同源），归档会话还能继续输入（仅 relay 改动）

## 版本 0.7.7 变更摘要

- chat 空闲轮询改为服务端挂起长轮询：无新事件/提问/命令时挂 25s 等 pushEvent 唤醒，空闲请求量从 ~15 次/分钟降至 ~2.4 次/分钟（仅 relay 改动，扩展无需更新）

## 版本 0.7.6 变更摘要

- 修复切换/刷新回放时首条任务消息缺失：relay 创建任务时把任务文本记为用户事件（与续聊路径同口径），面板取消本地首条气泡避免重复

## 版本 0.7.5 变更摘要

- 会话列表标题悬停提示扩容：记录任务文本前 200 字符（行内仍显示前 10 字符），老会话条目悬停仍为原 10 字符

## 版本 0.7.4 变更摘要

- 会话列表改为全面板侧滑覆盖层：从左侧滑入盖住整个面板（带回弹缓动动画），点「‹ 返回」或列表图标从左侧收回；出错时自动滑回显示错误信息
- 头部图标顺序调整为「+ 会话列表 设置 最小化」

## 版本 0.7.3 变更摘要

- 修复会话切换到非原标签页时报「tabKey 不匹配」：/history 加载时把任务重绑到当前标签页
- 修复切换历史会话后执行过程不折叠：回放完成后按 live 终态同款口径折叠

## 版本 0.7.2 变更摘要

- 面板头部新增「历史会话列表」图标：点开内容区切换为会话选择列表（会话标题前 10 字符 | 会话 id | 开始时间，两端对齐），列表存浏览器 localStorage（发起任务自动记录，上限 30 条）
- 选择会话即加载其历史记录（与 DSH web UI 同源回放，含执行过程与最终回复），加载后可直接继续输入续聊
- relay 新增 `GET /task/:id/history`：按 sessionId 校验防 relay 重启后任务编号错位；任务记录被清理时按 sessionId 自动重挂并全量回放会话事件流；事件历史上限 200→2000，长会话不截断

## 版本 0.7.1 变更摘要

- 回复内联图片兜底：模型写的本地相对路径图片（如 `![图](charts_display/xxx.png)`）现在可直接显示——relay 新增 `GET /file?taskId=&p=&token=` 静态端点，按任务工作区返回文件（query token 鉴权、路径越界硬拒绝、按扩展名 Content-Type）；面板渲染 markdown 后自动把相对路径 img 改写为该端点，加载失败显示占位提示而非碎图标
- 任务记录新增 workspace 字段（创建会话时保存），/file 端点据此定位文件根目录

## 版本 0.7.0 变更摘要

- 智能等级五档重定义（不兼容变更，配置键值旧档位自动迁移）：L1 `none` 仅问答 / L2 `page` 本页面读写 / L3 `site` 站内浏览（同域含子域可导航）/ L4 `dsh` 页面+DSH 工具（新默认档）/ L5 `all` DSH 全量+浏览器全量（导航不限域）；旧值 read/browser/browserFx→page，特效不再随档位走
- 新增 `browser_navigate` 同域导航工具（L3 及以上开放，跨域硬拦截）；导航后新页面自动恢复任务监听，命令断点续传
- 新增独立特效开关 `showFx`（默认关）：开启且档位≠L1 时显示模拟光标与操作特效，与智能等级解绑
- 页面版（非扩展）封顶 L4：`data-ai-level="all"` 与设置均钳制到 L4

## 版本 0.6.1 变更摘要

- 修复最小化期间渲染内容被误标「内容已渲染但不可见（高度 0）」警告：面板 display:none 时 offsetHeight 必为 0，属正常不可见不再告警；步骤收进折叠条同理跳过
- 面板从最小化展开时对最小化期间的渲染内容补一次可见性校验，真实渲染事故仍会被标注

## 版本 0.6.0 变更摘要

- 「智能等级」五档落地（原「工具范围/操作范围」演进），特效开关并入档位：仅 L4 展示模拟光标与点击特效，其余档位静默执行，独立「操作轨迹」配置移除
- 配置键 `toolScope` 更名 `aiLevel`（含 chrome.storage / localStorage 存储键与 /task payload 字段），页面版新增 `data-ai-level` script 标签入参（接受 L1-L5 或内部档位值）
- 扩展 content script 移除 highlight/marked/purify 三个 vendor 预加载（构建产物已内联，每页减少约 180KB 重复解析）
- 停靠标签与缩放手柄视觉强化：手柄默认显示斜纹拉丝，标签阴影悬浮感增强；死代码清理（env.config 死字段、重复选择器与去重逻辑合并）

## 版本 0.5.8 变更摘要

- 渲染核心全量复刻 DSH 官方 ui-primitives（mdast + shiki + KaTeX 管线），围栏代码语法着色/表格/公式/脚注/复制按钮与 DSH web UI 同源，跟进 0.2.2-alpha.2 版本
- 渲染核心独立为按需加载的 core 产物（页面版经 relay `/dsh-md-core.js` 路由、扩展版经扩展包 core/ 目录），UI 产物瘦身至 1/4；加载失败自动降级轻量渲染
- relay 静态产物 gzip 传输压缩 + no-cache 响应头（改产物后刷新页面即生效，无需强刷）
- 悬浮窗支持标题栏拖动位置、左上角手柄缩放（右下角锚定），位置尺寸自动记忆
- 「工具范围」升级为「操作范围」三档：禁用页面操作（仅问答）/ 仅页面操作工具（推荐）/ 开放 DSH 其他插件工具
- 仅问答档在执行层硬拦截 browser_* 页面操作工具（仅保留 ask_user_question），prompt 同步切换为纯问答模式
- GenUI（```dsh-ui 围栏）渲染保持支持，操作轨迹特效开关默认关闭

## 版本 0.5.7 变更摘要

- 设置面板新增「操作轨迹」开关：关闭后页面不再出现模拟光标与点击特效
- chat 会话空闲轮询退避（800ms → 4s 封顶，有动静恢复），降低代理链路空闲流量
- 回合失败/提交失败时控制台打印完整错误堆栈与 cause，便于定位断在哪一跳
- 宿主回合收尾异常时按会话内容容错判定结果（Desktop 0.2.1-rc.3 收尾 TypeError 不再误报失败）
- 建会话显式登记工作区（`resolveByPath` 传字符串路径 + `attachSession` 补挂），不再产生 Ungrouped 会话
- 页面接入支持 `data-workspace` 属性注入默认工作区