danheng383-commits/dsh-fat-fish-widget ↗★ 0
@local/dsh-fat-fish-widget
在Windows桌面常驻置顶显示会话状态的悬浮鱼娘挂件。 适合Windows用户,用于在关闭DSH窗口时持续监控任务状态。
同名包的其他仓库
安装
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:danheng383-commits/dsh-fat-fish-widget说明文档
阅读完整 README ↗使用
- 无底色贴桌面:素材是透明 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`。