[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-94962":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":15,"stars7d":16,"stars30d":16,"stars90d":15,"forks30d":15,"starsTrendScore":15,"compositeScore":17,"rankGlobal":9,"rankLanguage":9,"license":18,"archived":19,"fork":19,"defaultBranch":20,"hasWiki":21,"hasPages":19,"topics":22,"createdAt":9,"pushedAt":9,"updatedAt":28,"readmeContent":29,"aiSummary":30,"trendingCount":15,"starSnapshotCount":15,"syncStatus":31,"lastSyncTime":32,"discoverSource":33},94962,"dsh-dafeiyu","QCYTSN\u002Fdsh-dafeiyu","QCYTSN","Desktop-native BigFish companion for DeepSeek Harness — real Agent status, always on top on Windows.",null,"JavaScript",193,23,102,1,0,91,73.24,"MIT License",false,"main",true,[23,24,25,26,27],"agent-companion","deepseek-harness","desktop-pet","dsh-plugin","windows","2026-08-24 04:01:23","\u003Cdiv align=\"center\">\n\n# DSH 大肥鱼 🐋\n\n**住在 Windows 桌面上、由 DeepSeek Harness 真实工作状态驱动的 Agent 伴侣。**\n\n入口属于 DSH，生命周期属于 DSH，显示层属于桌面。\n\n[English](README_EN.md) · [npm](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fdsh-dafeiyu) · [下载最新版本](https:\u002F\u002Fgithub.com\u002FQCYTSN\u002Fdsh-dafeiyu\u002Freleases) · [更新日志](CHANGELOG.md) · [更新与回退](docs\u002FUPDATING.md) · [验收记录](docs\u002FACCEPTANCE.md)\n\n[![npm](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Fdsh-dafeiyu?label=npm)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fdsh-dafeiyu) · [![GitHub Release](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002FQCYTSN\u002Fdsh-dafeiyu?label=GitHub%20Release)](https:\u002F\u002Fgithub.com\u002FQCYTSN\u002Fdsh-dafeiyu\u002Freleases)\n\n\u003C\u002Fdiv>\n\n![DSH 大肥鱼在真实任务中显示项目状态](docs\u002Fimages\u002Fdsh-bigfish-running.png)\n\nDSH 大肥鱼不是一个需要单独启动的桌宠应用。它由 DSH 插件启用，跟随 DSH\n一起启动和退出，并以透明、无边框、始终置顶的原生窗口显示在桌面上。即使切换到\nVS Code、浏览器或文件管理器，也能知道 DSH 当前在思考、修改、测试、等待还是已经完成。\n\n> 当前版本：`0.1.1` · Windows \u002F WSL2 Alpha\n\n## 关注最新进展\n\n- 最新版本永远以 [npm `latest`](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fdsh-dafeiyu) 和 [GitHub Releases](https:\u002F\u002Fgithub.com\u002FQCYTSN\u002Fdsh-dafeiyu\u002Freleases) 为准（Releases 里同时提供 `.tgz` 安装包）；顶部的版本徽章会自动更新。\n- 给仓库 **Star 只是收藏，不会收到更新通知**。想第一时间知道「更新了什么」：\n  1. 打开仓库点 **Watch → Custom → Releases**，只订阅 Release 通知；\n  2. 或直接订阅 Releases 的 feed：\u003Chttps:\u002F\u002Fgithub.com\u002FQCYTSN\u002Fdsh-dafeiyu\u002Freleases.atom>\n- 已安装用户升级：完全退出 DSH 后执行\n  ```powershell\n  dsh plugin --profile web update dsh-dafeiyu\n  ```\n  然后重新启动 DSH 即可。\n\n## 它有什么用？\n\n- **离开 DSH 页面也能看到状态**：大肥鱼始终显示在 Windows 桌面最上层。\n- **反馈来自真实 Agent 事件**：不会读取屏幕，也不会把你在其他软件里的操作误判为 DSH 工作。\n- **展示足够但不过量的信息**：项目名、当前阶段、正在进行的步骤和真实待办进度会显示在状态卡上。\n- **有生命力但不打扰**：思考、查找、修改、执行、验证、等待、完成和错误都有对应动作与自然文案。\n- **没有第二套应用入口**：无需单独运行 Helper、安装 Python或配置额外端口。\n\n如果 DSH 没有提供待办清单，大肥鱼只显示“分析阶段”“实现阶段”“验证阶段”等可靠信息，\n不会编造完成百分比。\n\n## 状态展示\n\n| 思考 | 工作 |\n| --- | --- |\n| ![大肥鱼思考状态](docs\u002Fimages\u002Fstatus-thinking.png) | ![大肥鱼工作状态](docs\u002Fimages\u002Fstatus-working.png) |\n\n| 等待确认 | 完成 |\n| --- | --- |\n| ![大肥鱼等待用户确认](docs\u002Fimages\u002Fstatus-waiting.png) | ![大肥鱼任务完成](docs\u002Fimages\u002Fstatus-success.png) |\n\n| 遇到问题 |\n| --- |\n| ![大肥鱼错误状态](docs\u002Fimages\u002Fstatus-error.png) |\n\n状态大致按照下面的流程变化：\n\n```mermaid\nstateDiagram-v2\n    [*] --> 空闲\n    空闲 --> 思考: DSH 开始一轮任务\n    思考 --> 工作: 搜索、读取、修改、执行或测试\n    工作 --> 思考: 整理工具结果\n    思考 --> 等待: 需要用户确认\n    工作 --> 等待: 需要用户确认\n    思考 --> 完成: 本轮任务完成\n    工作 --> 完成: 本轮任务完成\n    思考 --> 错误: 任务异常结束\n    工作 --> 错误: 工具或任务失败\n    等待 --> 思考: 用户继续任务\n    错误 --> 思考: 用户重试\n    完成 --> 空闲\n```\n\n多个 DSH Session 同时运行时，默认优先展示最需要注意的顶层任务：\n\n`等待确认 > 错误 > 工作 > 思考 > 空闲`\n\n当有多个活动任务时，状态气泡会同时列出这些任务的状态。\n\n## 系统要求\n\n- Windows 10\u002F11 x64，或 WSL2（通过 Windows interop 运行桌面 Helper）\n- 已安装并能正常运行的 DeepSeek Harness WebUI\n- DSH CLI 中可以使用 `plugin --profile web` 命令\n- npm 上的稳定版 `dsh-dafeiyu`（或抢先测试的 `dsh-dafeiyu@alpha`），或 GitHub Release 中的 `.tgz` 安装包\n\n普通用户**不需要**安装 Python、PySide6 或单独运行\n`dsh-dafeiyu-helper.exe`。Windows Helper 已经包含在发布包里。\n\n当前 Alpha 版的设置与桌面状态文案使用简体中文。\n\n## 安装插件\n\n### 1. 完全退出 DSH\n\n先关闭 DSH Host，而不只是关闭浏览器标签页。安装或更新时不要让旧版插件继续运行。\n\n### 2. 一行命令安装\n\n在 PowerShell 中进入你的 DSH 安装目录，例如：\n\n```powershell\ncd D:\\DSH\n```\n\n然后从 npm 安装稳定版：\n\n```powershell\npnpm exec dsh plugin --profile web add dsh-dafeiyu\n```\n\n如果你的系统已经能直接使用全局 `dsh` 命令，只需要：\n\n```powershell\ndsh plugin --profile web add dsh-dafeiyu\n```\n\n想抢先试用新功能（`@alpha` 测试版）的用户，把命令里的包名换成 `dsh-dafeiyu@alpha` 即可。\n\n如果 DSH 运行在 WSL2，请在 WSL 终端执行同一条安装命令。插件会自动通过\n`cmd.exe` 启动包内的 Windows Helper，不需要手动 `chmod`，也不需要在 WSL\n安装 Python 或 PySide6。当前支持范围是 Windows x64 上的 WSL2；普通 Linux、\n远程 Linux 和容器不是本版本的桌面显示目标。\n\n### 3. GitHub Release 备用安装方式\n\n进入 [GitHub Releases](https:\u002F\u002Fgithub.com\u002FQCYTSN\u002Fdsh-dafeiyu\u002Freleases)，下载最新的：\n\n```text\ndsh-dafeiyu-\u003Cversion>.tgz\n```\n\n不要解压这个文件。\n\n不解压，在 DSH 目录中直接安装下载的插件包：\n\n```powershell\npnpm exec dsh plugin --profile web add \"C:\\Users\\you\\Downloads\\dsh-dafeiyu-\u003Cversion>.tgz\"\n```\n\n### 4. 启动 DSH\n\n照常启动 DSH WebUI。插件默认启用，大肥鱼会由 DSH 自动拉起；不要手动打开 Helper。\n\n### 5. 找到设置入口\n\n在 DSH WebUI 中进入：\n\n```text\n设置 → 插件 → 插件配置 → 大肥鱼桌面伴侣\n```\n\n![DSH 大肥鱼插件设置入口](docs\u002Fimages\u002Fdsh-bigfish-settings.png)\n\n## 怎么使用？\n\n安装后不需要额外操作：\n\n1. 启动 DSH。\n2. 在 DSH 中开始一个项目任务。\n3. 大肥鱼根据 DSH 的真实事件切换动作和状态卡。\n4. 切换到其他窗口继续工作；大肥鱼仍然保持在桌面最上层。\n5. DSH Host 真正退出后，大肥鱼自动退出。\n\n状态卡可能显示：\n\n- 项目目录名称，例如 `dsh-dafeiyu`\n- 当前阶段，例如“分析阶段”“实现阶段”“验证阶段”\n- 当前待办，例如“完善项目文档”\n- 真实进度，例如“已完成 3\u002F5 步”\n- 等待、完成或错误提示\n\n大肥鱼不会监听 VS Code、浏览器或其他应用，也不会截图。只有 DSH Agent 的事件能够\n改变它的工作状态。\n\n## 可配置项目\n\n| 设置 | 作用 |\n| --- | --- |\n| 启用大肥鱼 | 立即显示或关闭桌面伴侣 |\n| 角色大小 | 在 70%～140% 之间调整 |\n| 气泡大小 | 在 80%～120% 之间调整状态气泡，兼顾信息可读性 |\n| 气泡显示 | 常驻显示、完全隐藏，或自定义哪些状态显示气泡 |\n| 活跃程度 | 控制空闲时眨眼、观察等微动作频率 |\n| 减少动态效果 | 减少走动、循环帧和程序化晃动 |\n| 响应子 Agent | 允许子 Agent 状态参与优先级选择；默认关闭 |\n\n设置由 DSH 保存，更新插件后通常不需要重新配置。\n\n## 桌面互动\n\n- **拖动**：按住大肥鱼移动位置，位置会自动保存。\n- **点击或双击**：触发摸头、戳一下、尾巴等短互动，之后恢复最新 DSH 状态。\n- **右键菜单**：调整大小、气泡大小、减少动态、打开 WebUI、本次隐藏或本次关闭。\n- **本次隐藏**：只隐藏窗口，不禁用插件。\n- **本次关闭**：关闭当前 Helper，本次 DSH 运行期间不会自动重启；下次启动 DSH 会再次出现。\n\n## 更新插件\n\nGitHub 仓库出现新提交后，已经安装的插件**不会自动变化**。新版本发布后，完全退出\nDSH，然后更新 npm 稳定版包：\n\n```powershell\ncd D:\\DSH\npnpm exec dsh plugin --profile web update dsh-dafeiyu\n```\n\n也可以再次执行安装命令，它会解析 npm `latest` 标签指向的新版本：\n\n```powershell\npnpm exec dsh plugin --profile web add dsh-dafeiyu\n```\n\n使用 `@alpha` 测试版的用户，把更新命令里的包名换成 `dsh-dafeiyu@alpha` 即可。\n\n使用 GitHub Release 安装的用户，可以下载新 `.tgz` 后覆盖安装：\n\n```powershell\npnpm exec dsh plugin --profile web add \"C:\\Users\\you\\Downloads\\dsh-dafeiyu-\u003Cnew-version>.tgz\"\n```\n\n以上方式都会替换插件及随包携带的 Windows Helper，并保留 DSH 已保存的设置。详细\n说明见 [插件更新与回退](docs\u002FUPDATING.md)。\n\n## 回退到旧版本\n\n完全退出 DSH，重新安装之前保留的旧版 `.tgz`：\n\n```powershell\ncd D:\\DSH\npnpm exec dsh plugin --profile web add \"C:\\Users\\you\\Downloads\\dsh-dafeiyu-\u003Cold-version>.tgz\"\n```\n\n## 卸载插件\n\n完全退出 DSH 后运行：\n\n```powershell\ncd D:\\DSH\npnpm exec dsh plugin --profile web remove dsh-dafeiyu\n```\n\n然后重新启动 DSH。插件代码和 Helper 会从 `web` profile 中移除。DSH 可能保留一份\n不会再生效的历史设置，这不会启动进程或占用额外端口。\n\n## 常见问题\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>安装后没有看到大肥鱼\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n1. 确认安装使用的是 `--profile web`。\n2. 完全退出并重新启动 DSH Host。\n3. 进入“设置 → 插件 → 插件配置”确认“启用大肥鱼”已经勾选。\n4. 确认使用 Windows x64 发布包，而不是只克隆了缺少预构建 Helper 的源码。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>关闭了 DSH 网页，为什么大肥鱼还在？\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n大肥鱼绑定的是 DSH Host 生命周期，而不是浏览器标签页。只要 DSH 后台仍在运行，\n大肥鱼就会继续显示；真正退出 DSH Host 后它会自动关闭。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>为什么没有显示数字进度？\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n只有 DSH 写入了结构化待办时，插件才能可靠计算“已完成 3\u002F5 步”。没有真实待办数据时，\n状态卡只显示当前工作阶段，避免制造虚假的百分比。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>右键选择“本次关闭”后为什么没有自动回来？\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n这是预期行为。“本次关闭”会抑制当前 DSH 运行期间的自动重启；完全退出并重新启动\nDSH 后会恢复。若想永久关闭，请在 DSH 设置中取消“启用大肥鱼”。\n\n\u003C\u002Fdetails>\n\n## 隐私与边界\n\n- 不读取或保存模型 API Key\n- 不截图，不读取其他窗口内容\n- 不发送遥测\n- 不监听键盘输入或其他应用行为\n- 不新开网络端口；设置卡复用 DSH 的本地 Web 服务\n- 默认只跟随最近活跃的顶层 DSH Session\n\n## 开发与测试\n\n```powershell\npnpm install\nnpm test\npy -3 -m unittest discover -s runtime\u002Ftests -t .\n```\n\n开发时可以从源码运行 Helper，但正式用户不应手动启动它：\n\n```powershell\npy -3 -m pip install -r requirements.txt\npy -3 runtime\\helper.py\n```\n\n构建 Windows Helper：\n\n```powershell\npython -m pip install -r requirements.txt pyinstaller\n$env:DSH_DAFEIYU_BUILD_PYTHON = (Get-Command python).Source\nnpm run build:helper:windows\n```\n\n## 更多文档\n\n- [产品范围与取舍](docs\u002FPRODUCT_SCOPE.md)\n- [执行计划](docs\u002FEXECUTION_PLAN.md)\n- [兼容性验证](docs\u002FPHASE0.md)\n- [Windows 验收与性能记录](docs\u002FACCEPTANCE.md)\n- [更新、回退与卸载](docs\u002FUPDATING.md)\n- [维护者发布流程](docs\u002FRELEASING.md)\n- [角色视觉资产许可](ASSET_LICENSE.md)\n\n相关项目：[QCYTSN\u002Fds-local-pet](https:\u002F\u002Fgithub.com\u002FQCYTSN\u002Fds-local-pet) 是独立桌宠版本；\n本仓库是只服务于 DSH 状态的插件版本。\n\n## License\n\n代码采用 [MIT License](LICENSE)。角色视觉资产不适用 MIT 代码许可证，来源和使用边界\n见 [ASSET_LICENSE.md](ASSET_LICENSE.md)。\n","DSH大肥鱼是一款专为DeepSeek Harness（DSH）设计的Windows桌面端Agent状态伴侣工具，以透明、无边框、始终置顶的原生窗口实时展示DSH Agent的真实运行状态（如思考、工作、等待确认、完成、错误等）。它不独立运行，而是作为DSH官方插件集成，生命周期与DSH完全同步，通过DSH事件总线获取可信状态，避免屏幕抓取或伪进度估算。适用于开发者在多任务切换（如编码、浏览、调试）时持续感知AI代理执行进展，提升人机协作效率与上下文连贯性。当前支持Windows 10\u002F11及WSL2（通过Windows互操作），开箱即用，无需额外Python环境或手动启动辅助进程。",2,"2026-08-18 02:30:15","CREATED_QUERY"]