danheng383-commits/dsh-fat-fish-widget ↗★ 0

@local/dsh-fat-fish-widget

在Windows桌面常驻置顶显示会话状态的悬浮鱼娘挂件。 适合Windows用户,用于在关闭DSH窗口时持续监控任务状态。

套件
@local/dsh-fat-fish-widget
相容性
待驗證
版本
0.3.2
授權
MIT
最近更新
2026年10月23日

同名套件的其他儲存庫

安裝

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:danheng383-commits/dsh-fat-fish-widget

使用

  • 无底色贴桌面:素材是透明 PNG(desktop/fish.png),鱼身上没有白色圆盘/描边, 收起时就是「一张气泡 + 一只鱼」。
  • 拖动:按住鱼拖到任意位置(虚拟屏幕范围内,自动记住)。
  • 展开/收起:单击鱼;或右键 → 展开详情 / 收起。
  • 大小:右键 → 大小 → 小 / 中 / 大。
  • 归位:右键 → 回到默认位置(右下角,避开 dsh-whale-widget 的鲸鱼)。
  • 退出:右键 → 退出;或结束进程 powershell.exe(窗口标题 FatFishDesktop)。
  • 开机自启:desktop\install-autostart.ps1 会在 %APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup\FatFishDesktop.lnk 建一个 启动项(本机已装好),取消用 desktop\uninstall-autostart.ps1。有它之后即使不开 DSH, 登录桌面也能看到鱼(显示「DSH 未运行」)。
  • 立刻启动:双击 desktop\launch-widget.vbs(无黑框)。

指定状态文件与配置目录(调试用,不碰 %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`。