# 更新日志

## 0.5.2 — 2026-11-05

补的是「看不见的那部分」：一个静默失效的提示、一份说明书、一套能自动跑的检查。

- 修掉「会话已失效」提示从不显示：宿主已经发出 `session-reset`，但 `widget.ps1` 的宿主消息分派里漏了这个分支，消息被静默吞掉。现在面板顶部的提示会正常出现
- 新增 `docs/MANUAL.md`（12 章）：界面导览、一次完整交互的时序、会话与线索规则、数据文件表、协议消息表、按症状排错、发版流程
- 本地自检一条命令：`npm run check` = JS 语法 + 9 项宿主协议断言 + 面板内联脚本编译。新增 `test/panel-compile.mjs`，把 `panel.html` 里的 `<script>` 抽出来真正编译一遍，防止改面板时打错一个括号整个界面白屏
- GitHub Actions CI 首次跑通（windows-latest）：`node --check` → `npm test` → PowerShell 解析 `widget.ps1` 并校验 UTF-8 BOM 头
- README 澄清默认模型：DeepSeek-V4.1-Flash 原生支持图片输入，不需要额外装多模态插件；换成纯文本模型才会失败

## 0.5.1 — 2026-11-05

悬浮球的两个小改：大小可调，自定义外观不再挂一圈黑影。

- 右键菜单新增「悬浮球大小」子菜单：小 72 / 标准 84 / 大 96 / 特大 108（DIP），当前档位标「●」；选择后立即生效，写进 `%LOCALAPPDATA%\dsh-glance\settings.json`，下次启动沿用
- 尺寸按屏幕缩放换算，换到高 DPI 屏不会变小；面板贴在球边上，改大小后位置自动重算
- 修掉自定义外观外围的黑色圆环：此前先画 18 层椭圆阴影再把图片缩放盖上去，阴影比图片大一圈就露成黑环，方图还会露方角；现在自定义图片直接绘制，不加阴影

## 0.5.0 — 2026-11-05

让「一瞥」从「看完就忘」变成「有线索、可回看」。

- **一次框选 = 一条线索**：每次框选都新开一个分析会话，追问复用同一条；不会再出现所有截图挤在同一个会话里、越聊越慢的情况
- 会话标题带时间（`一瞥 · 11-05 19:32`），好在 DSH 的会话列表里认出是哪一次
- 面板支持多轮：最新回答完整显示，之前的问答收成气泡（默认截断，点一下展开），标题旁显示「第 N 轮」
- 同一张图追问到第 6 轮时给一句软提示，提醒换话题可以重新框选（不强制打断）
- 「停止」不再清空已生成的内容：保留文字并标注「已停止，这段回答不完整」
- 状态文件升到 v2（`{ version, current: { sessionId, title, startedAt, turns } }`），只记录当前线索；旧的扁平格式启动时自动升级
- `/api/local/dsh-glance/status` 额外返回当前线索的 `sessionId / title / turns / startedAt`
## 0.4.5 — 2026-11-02

- 「运行中」改为向宿主查询真实状态：插件注册 `/api/local/dsh-glance/status`，标题栏按钮每 2 秒轮询一次，从悬浮球菜单里关掉一瞥后按钮会自己变回未启动
- 修掉右键菜单「第一次打开偏小、字贴边」的问题：`$script:dpiScale` 此前只在第一次截图（展开面板）时才赋值，在这之前打开的菜单会按 1.0 缩放构建并被缓存；现在启动悬浮球时就写入真实缩放，并在缩放变化时重建菜单
- 右键菜单重新排版：菜单项文字改为自绘并垂直居中（此前文字贴在每格顶部），行高从 64 收到 42、整体从 297×202 收到 222×136，悬停高亮改为整行内缩，菜单不再显得又大又空
- 菜单项精简为「更换外观… / 恢复默认外观 / 退出」，文字左侧留出 20px 呼吸间距，不再贴着边框
- 测试工具 `backup/ball-menu-test.ps1` 增加 `-Reopen` 与悬停截图

## 0.4.4 — 2026-11-02

- 会话标题栏的「一瞥」开关改成**启动按钮**：按下即拉起悬浮球，成功后会显示「运行中」。不再用本地存储记忆开/关状态，从悬浮球右键菜单关掉后也不会再出现"开关是开的、球其实没了"的不一致
- 重复点击是安全的：悬浮球已在运行时命令只做一次空操作
- 右键菜单按面板视觉重做：圆角浮层、圆角悬停高亮、细描边、内缩分隔线，字号与行高对齐面板按钮
- `widget.ps1` 的自定义菜单渲染器 `ScreenSnapMenuRenderer` 负责悬停/分隔线/描边

## 0.4.3 — 2026-11-02

- 悬浮球加右键菜单：更换悬浮球图片… / 恢复默认外观 / 关闭一瞥。换外观不必再先截一次图把面板叫出来
- 「恢复默认外观」在未自定义时置灰；菜单用与面板一致的深色配色，并在屏幕边缘自动翻转位置
- 菜单实例复用而非每次新建/销毁；菜单项动作改为关闭菜单后延迟执行，修掉了点击菜单项时抛「无法访问已释放的对象（ContextMenuStrip）」、动作不生效的问题

## 0.4.2 — 2026-11-01

- 修复「停止」只停住面板、Harness 里那一轮仍在继续生成的问题：现在会调用宿主的 `sessionController.cancel` 真正中断该轮对话，而不只是断开插件自己的流

## 0.4.1 — 2026-11-01

- 悬浮球重做：柔和立体外观（对角渐变、内高光、细边框、白色放大镜图标），悬停时整体提亮，分析中在球外画进度环
- 悬浮球尺寸改为按系统 DPI 缩放（此前固定 84 物理像素，150% 缩放下只有 56，偏小且模糊）
- 新增「自定义悬浮球图片」：面板标题栏的调色板按钮 → 选 PNG / WebP / BMP / JPG → 复制到 `%LOCALAPPDATA%\dsh-glance\ball.png`；按钮变为 ↺ 可一键恢复默认
- 面板改为贴在悬浮球左侧，放不下时依次退到球下、球上；面板长高时球会自动让位，不再挡住面板右上角的关闭按钮

## 0.4.0 — 2026-11-01

- 「追问」与首次发送拆开：追问只发文字，不再重复上传截图
- 新增「停止」，可中断正在等待或流式接收的这一轮
- 分析会话失效并重建时，面板顶部给出提示，不再静默丢失上下文
- 运行时状态文件从插件目录迁到 `%LOCALAPPDATA%\dsh-glance\state.json`，首次运行自动迁移
- 面板宽高统一按 DPI 换算（宽度限制在 440–560 DIP，不再随截图变宽）；窄面板下输入框与按钮分行排列，预览图按面板宽度铺满
- 删除约 250 行死代码；WebView2 缺失时弹窗提示安装地址

## 0.3.0

- 改名「一瞥 / Glance」
- 改用 WebView2 面板承载结果，支持流式分析、断网与超时错误提示
- 截取内容通用化：不再限定单一场景

## 0.2.0 及更早

早期原型，未单独记录。