frankstanmonster/dsh-overlay_companion

README 摘要

🐋 Deepseek Harness Launcher（鲸鱼悬浮窗） 一个 Windows 桌面悬浮窗，实时反映 DeepSeek Harness 的工作状态，同时作为进入 Harness 的快捷入口。 ✨ 功能特性 - 实时状态动画 ：Harness 内 有任务在跑 时显示 working 动图，空闲时显示 idle 动图（默认每 1.5 秒检测一次，可调） - 实时活动状态 ：气泡框实时显示当前工作状态—— 正在思考… / 正在调用 pwsh / 正在编辑文件 / 正在联网搜索 / 等待审批：xx 等 - 一键进入 ：双击悬浮窗直接用默认浏览器打开 Harness - 状态气泡 ：单击查看 Harness 运行状态（在线/离线、任务执行中/空闲、当前活动） - 自由拖动 ：按住拖动到桌面任意位置 - 更换动图 ：气泡框内一键更换 working / idle 动图（仅支持 GIF 格式，自动校验文件有效性） - 残留自动清理 ：自动清除工作动图右下角抠图残留（绿幕 / 灰黑块），且只作用于原始动图，不影响用户替换后的动图 - 开机自启 ：登录时自动在后台启动 Harness（ npx -y @deepseek-ai/dsh web ）并拉起悬浮窗，无需手动开 cmd 📋 系统要求 - Windows 10 / 11（桌面交互会话） - PowerShell 5.1（Windows 自带）或更高 - 可选的 npx （Node.js）——用于开机自启时自动拉起 Harness；若你手动运行 Harness 也可 📁 目录结构 src/ 目录是 可移动的 ：所有脚本通过自身路径定位资源，复制到任意文件夹即可运行。 🚀 安装 方式一：立即使用（不需要管理员） 1. 双击 src\launcher.vbs （无窗口，静默后台启动 Harness + 悬浮窗） 方式二：注册开机自启 - 普通权限 ：注册 HKCU 开机自启（登录后自动启动） - 管理员权限 （推荐）：额外注册任务计划「登录时」任务，启动顺位排在绝大多数自启软件之前 方式三：手动命令行 🖱️ 使用说明 操作 行为 单击悬浮窗 弹出状态气泡：Harness 在线状态 + 任务状态 + 当前活动 （实时刷新）+ 打开/更换动图按钮 双击悬浮窗 直接用浏览器打开 http://127.0.0.1:3080 按住拖动 移动悬浮窗到任意位置 右键 菜单： 打开 Harness / 停止 Harness （连同进程树结束）/ 退出 气泡框 → 更换工作/空闲动图 选择本地 GIF 替换对应动画，立即生效并持久保存 🧩 工作原理 - 状态检测 ：每 1.5s 轮询 Harness API POST /api/session.list ，任一会话 running=true → 显示 working 动图…

分类