# Changelog 所有显著更改都将记录在此文件中。 ## [1.5.2] - 2026-10-10 桌面版 0.2.0-rc.2 契约体检批(Host 半 + 浏览器半各一轮对照 `app.asar` 真实代码的审计)后的修复与加固。 ### 加固(安全) - **三条路由绕过宿主的 `/api` 围栏**:它们是 `webServer` 上的 **exact** 注册,而 DSH 的 `/api` 围栏是 **prefix** 路由——`dsh-host-webserver` 的 `match()` 先查 exact 表、命中即返回,围栏根本看不到它们。实测(对运行中的 0.2.0-rc.2):带 `Origin: https://evil.example` + `Sec-Fetch-Site: cross-site` 的 `POST /api/prompt-enhance/enhance` 返回 **200**(handler 已执行,可被迫读项目文件并远端调用模型),而同头的 `/api/gateway/*` 是 **403**。 - `POST /enhance`、`POST /log-error` 现在每请求调用宿主的 `connection.requestRejection`(官方 API,就是 `/api` 围栏那套 Host/Origin 同源校验 + 浏览器 cookie 认证);**必须惰性读取**——`connection` 由宿主在 `await BrowserAuth.create(...)` 之后才 provide,mount 时读永远是 undefined(dshmarket #729 踩过同一个坑)。门禁抛错一律 **fail closed**(403)。 - 宿主没有该服务时(老版本)回退到同规则的本机校验:Host 存在时必须回环、`sec-fetch-site` 不得为 `cross-site`、Origin 存在时必须与 Host 同源;Host 缺失时放行(桌面版转发层会剥掉 Host/Origin/cookie 再自己注入 cookie,不能因此误伤)。 - `GET /log` 只走 Host/Origin 围栏、不要求 cookie:读接口不改状态、跨源页面也读不到响应体(无 CORS),真正的威胁是 DNS rebinding,那由 Host 围栏挡住;要求 cookie 只会让本机脚本(含本插件的诊断流程)再也读不到诊断环。 - **跨站"简单请求"**:POST 若带非 JSON 的 `content-type`(表单 / `text/plain`)直接 415,挡掉无需预检的跨站表单提交。 - **超大请求体**:>1MB 时不再 `req.destroy()`(客户端只看到连接重置、桌面版转发必然失败),改为停止累积并正常应答 **413** 结构化错误。 - **单次调用成本上限**:草稿超过 20000 字符直接 `BAD_BODY`。 - **单条路由注册冲突不再一损俱损**:`webServer.register` 对重复 `(kind,path)` 会 throw,而 effect 体抛错会让整个 fiber 回滚(三条路由一起消失);现在每条独立 try/catch,失败的只记进诊断环。 - 响应统一带 `cache-control: no-store`。 ### 修复 - **重试阶梯在 0.2.0 下方向相反**:省略 `reasoningEffort` 不等于关推理——宿主会用模型默认档位补齐(`dsh-llm` 的 `requested ?? reasoning.defaultEffort`,deepseek 未配置时默认 `high`)。于是「空输出恢复」实际是把推理调更高,「去档位重试」对专家模式(本来就是 `high`)等于把同一请求再发一遍、只让计费翻倍。现在:空输出(含 0.2.0 官方适配器把「正常停止但零内容」抛出的 `EMPTY_RESPONSE`)→ **显式发 `'off'` + 加大预算**;只有「档位参数确实被拒」(`UNSUPPORTED_REASONING_EFFORT`、400 回显 effort/thinking、`developer` 角色不被接受)才去掉参数重试;限流/网络等无关失败不再重发。配置文档同步澄清 `effort: 'none'` 的真实语义是「不带该参数、由宿主按模型默认决定」。 - **增强用的是全局默认模型而非会话当前模型**:0.2.0 的会话选择记录在 `request/header` 事件里(宿主优先读 `session.requestHeader().config`,只在还没落过 header 时才用全局默认)。恢复/分叉的历史会话与全局默认不一致时,用户界面显示一个模型、增强却用另一个。候选链顺序改为:`config.candidates` → **会话当前模型** → 全局默认 → 自动补足。 - **跨会话状态串扰(真数据错乱风险)**:两个槽位都是 `scope: 'session'`,DSH renderer 切会话时按 `sessionGenerationKey` remount 条目(`dsh-client-ui-renderer` 里 `StrictSessionEntry` 的 key),但插件把 `current`/`draftMirror`/`activeAbort` 放在 `apply()` 闭包里跨会话共享。后果:甲会话的对比面板/撤回提示会显示在乙会话的输入框上,点「撤回」会把**甲会话的原文写进乙会话的输入框**。 - **多 composer 并存时的互相清空**:同一文档可能同时挂载两个 composer(右侧栏子智能体聊天 = `ui-subagent` 用 `renderFactorySlot("conversation.content", {variant:"embedded"})` 再渲一份),共享状态会被另一个 composer 的渲染覆盖(草稿镜像串、变更检测按错会话假报错)。 - 上两条统一改为**状态按 `sessionId` 分桶**(`seatOf(sessionId)`,最多缓存 8 个会话位):提示/对比面板/草稿镜像/输入阶段/在途请求/定时器全部随会话隔离,互不串、互不清。会话历史 `listHistory(sessionId)` 也按会话过滤(此前标着「会话内」实为全局,能在乙会话里采用甲会话的版本)。 - **Esc 会连「停止本轮」一起触发**:宿主把 `Escape` 注册成固定命令 `response.stop`(`ui-conversation`),它的分发器先消费该键,插件的 `preventDefault()` 拦不住 → 面板打开且 turn 在跑时按 Esc 既停 turn 又丢弃增强结果。现在 `e.defaultPrevented` 为真时不再放弃结果。 - **Enter 抢走按钮激活**:焦点在「放弃/采用/历史版本采用」等按钮上按 Enter,原本会被插件抢成「采用当前结果」(`