@local/dsh-fat-fish-widget

使用

• 无底色贴桌面：素材是透明 PNG（desktop/fish.png），鱼身上没有白色圆盘/描边， 收起时就是「一张气泡 + 一只鱼」。
• 拖动：按住鱼拖到任意位置（虚拟屏幕范围内，自动记住）。
• 展开/收起：单击鱼；或右键 → 展开详情 / 收起。
• 大小：右键 → 大小 → 小 / 中 / 大。 三档之上还有一层全局缩放 $script:UiScale（desktop/FatFishDesktop.ps1 里，默认 1.12）： 几何走 U()、字号乘同一个系数，卡片、鱼和文字一起等比放大，不会出现「字小框大」。 改完重启挂件生效（右键 → 退出，再双击 desktop\launch-widget.vbs）。
• 归位：右键 → 回到默认位置（右下角，避开 dsh-whale-widget 的鲸鱼）。
• 退出：右键 → 退出；或结束进程 powershell.exe（窗口标题 FatFishDesktop）。
• 随 DSH 启动：0.3.3 起不再注册开机自启。挂件只在 DSH 宿主（Host）加载本插件时 由 index.js 在 1.5 秒内自动拉起——也就是说，打开 DSH 就有鱼，DSH 没开就没有。 挂件启动后仍独立于 DSH 存在：关掉 DSH 窗口鱼不会消失（显示「DSH 未运行」）， 下次 DSH 启动时如鱼还在，插件加载会被单实例互斥锁忽略，不会叠出第二只。
• 立刻启动：双击 desktop\launch-widget.vbs（无黑框）；或直接把 DSH 打开。

指定状态文件与配置目录（调试用，不碰 %LOCALAPPDATA%）：

powershell.exe -ExecutionPolicy Bypass -File desktop\FatFishDesktop.ps1 ` -StatePath .\state.json -DataDir .\fishdata

注意：`FatFishDesktop.ps1` 必须保持 **纯 ASCII**（中文全在 `strings.json`），否则
Windows PowerShell 5.1 会按 ANSI 解码导致乱码；`strings.json` 则以 UTF-8 显式读取。

诊断时间线（事件 → 写盘 → 挂件读盘）可以打开 Host 侧的调试记录：在
`%LOCALAPPDATA%\dsh-fat-fish\` 放一个空文件 `debug-on`，插件的每个会话事件和每次快照
发布都会追加到同目录 `debug.log`；删掉 `debug-on` 即停止（默认不写任何日志）。

## 已知边界

- 只支持 **Windows**（WinForms + 分层窗口 API）；其它平台不启动挂件。
- 挂件是置顶窗口，会盖住全屏游戏/全屏视频；需要时可右键退出或临时收起。
- 进度读的是「最近活跃的会话」：多个会话同时跑时，面板会提示另有几个在跑，但只详细
  展示最活跃那个。
- 挂件本身不联网、不读会话日志，只读本机那个 `state.json`。

## 更新记录

- **0.3.3**（当前）：取消开机自启——删除 `desktop/install-autostart.ps1` 与
  `desktop/uninstall-autostart.ps1`，删掉启动文件夹里的 `FatFishDesktop.lnk`。
  挂件改为**只在打开 DSH、Host 加载插件时自动拉起**（加载后 1.5 秒内）；
  关掉 DSH 鱼仍留在桌面上，下次开 DSH 会复用同一只（单实例互斥）。
- **0.3.2**：整体放大一圈——新增全局缩放 `$script:UiScale`（默认 `1.12`），
  卡片、鱼、文字等比放大 12%（收起气泡 465×303 → 521×339）。开源到 GitHub。
- **0.3.1**：去掉大肥鱼外面的白色圆圈/描边/投影，素材换成透明 PNG，鱼直接贴在桌面
  上；审批提示改用右上角角标（`!` / ✓ / ✗），不再套光环。
- **0.3.0**：审批提醒——有待审批项时气泡变琥珀色「需要你审批」，点卡片把 DSH 窗口
  提到最前，新审批响提示音；审批有结果后闪 6 秒「已允许 / 已拒绝 / 已取消」确认。
- **0.2.2**：进度延迟优化——Host 每个会话事件后 120 ms 内补写快照，挂件轮询降到
  180 ms，事件到显示 ≈ 0.3–0.4 s；用户发消息立刻切「排队中」。
- **0.2.1**：修拖动时闪烁——拖动锚定屏幕坐标、移动合并为一次 `SetWindowPos`、禁用
  WinForms 自绘，拖动期间暂停重绘。
- **0.2.0**：`state.json` 原子写 + 挂件共享读，消灭遗留 `*.tmp` 与读取冲突。
- **0.1.0**：第一版桌面挂件：独立 WinForms 分层窗口，关掉 DSH 也留在桌面上。