前言¶
用 DeepSeek Harness 跑 Agent 任务时，主窗口往往被其他应用挡住，或你只想最小化窗口继续干活。此时要知道 Agent 是在思考、调工具还是在等你点批准，通常得切回 Harness 看状态栏或对话区。社区插件 dsh-island 在 Windows 桌面上提供一块类似 iPhone 灵动岛的悬浮条：任务进行时贴在屏幕边缘显示状态，展开后可看计划进度、上下文占用，并在不打开主窗口的情况下批准权限、回答提问或接着发消息。下面介绍它是什么、能做什么，以及如何安装与使用。
这是什么¶
dsh-island 是维护者 a961282799-crypto 发布的 DeepSeek Harness 桌面端插件（社区作品，非 DeepSeek 官方产品）。仓库简介为：DeepSeek Harness desktop dynamic island plugin (community)。当前 package 版本为 0.6.1，许可证 MIT，在 SkillHub 目录中归类为「客户端」。
插件通过 Harness 的 Cordis 生命周期订阅会话与 Agent 事件，在独立 Electron 窗口里渲染 UI；传给界面的只有状态、任务标题、计划条目、工具名、模型与 token 统计等概括信息，不读取 API Key，也不把进行中的对话全文或工具参数塞进灵动岛（可在设置里进一步关闭「显示任务内容」）。
核心功能¶
形态与状态¶
灵动岛有多种尺寸形态：待机（118×32）、紧凑任务条（212×36）、短暂弹出提醒（312×66）、悬停或单击展开的 task 控制台（344×宽自适应），以及贴左右侧时的竖条形态。任务进行中，鲸鱼外圈按上下文占模型窗口比例显示占用环（70% 以下绿、70% 起黄、90% 起红并呼吸）。
README 列出十一种视觉状态，包括随时待命、正在思考、正在回答、正在执行、等待你确认、已完成、已暂停、需要留意、正在重试、整理上下文、连接已断开等，并配有对应动效说明。
任务控制台¶
鼠标在胶囊上停留约 0.7 秒或单击可展开控制台：进行中的任务显示标题、计时、计划进度（如 4/7）、最近工具调用、模型与上下文占用、缓存命中率、工具次数、输出 tokens，以及 停止任务（需点两次确认）。任务刚结束时预览最后回复开头；空闲时显示今日完成数、工作时长、账户余额（登录 DeepSeek 账号时）、24 小时 token 柱状图与估算费用、最近任务列表。
在灵动岛交互，而不必回到主窗口¶
- 回答提问：Agent 使用
ask_user_question时自动展开提问卡；与 Harness 窗口里的提问卡 哪边先答用哪边。计划审阅等需在 Harness 内完成的内容除外。 - 批准权限：需要授权时展开审批卡，可 允许一次 或 拒绝；按钮出现后约 0.6 秒才可点。持久「始终允许」仍在 Harness 设置。
- 发消息：展开面板顶部有对话卡与输入框，走 Harness 会话控制器的
prompt接口；空闲时可 发送 新轮次，任务进行中可 排队 或 插话。暂不支持在灵动岛新建对话或发图片、文件。
用量统计¶
从面板底部柱状图按钮或托盘菜单「用量统计」打开，可选今天（按小时）、7 天、30 天（按天），汇总 tokens、缓存命中率、轮次、工作时长，并按 DeepSeek 官方价格（README 标注 2026-10-27 查询）估算人民币费用。数据来自 Harness 会话记录，汇总保存在 %USERPROFILE%\.dsh\dsh-island\usage.json，保留约 35 天，不含对话正文。
安装与启用¶
需要 DeepSeek Harness 桌面版 0.2.1-rc.5（Windows）。peer 依赖与 README 中适配版本一致。
在 Harness 里安装：侧栏「插件」→「添加插件」，输入 dsh-island，安装后启用。
命令行：先从托盘退出 Harness，再执行：
dsh plugin --profile desktop add dsh-island
装好后，位置、大小、悬停展开、是否在灵动岛回答/审批/发消息等选项在 Harness 的 设置 › 灵动岛 中调整，修改后立即生效。插件条目配置键为 dsh-island；部分本地状态（如显示器选择）由托盘菜单保存。
运行环境复用机器上已有的 %USERPROFILE%\.dsh\dsh-orb\electron-runtime\electron.exe，或通过环境变量 DSH_ISLAND_ELECTRON 指定；安装包不含 Electron，不会自动下载。插件以当前 Harness 进程权限运行，安装前建议在 GitHub 查看源码与 MIT 许可证。
从源码安装需使用仓库内的 安装到 Harness.cmd 或 scripts/install-desktop.ps1（用户若走源码路径，README 有完整说明；本文不展开 clone 步骤）。
典型用法¶
- 安装并启用后，托盘可见蓝色鲸鱼；无任务时灵动岛待机，仅鲸鱼与呼吸蓝点。
- 在 Harness 中启动 Agent 任务后，紧凑形态显示状态文字与动态指示器；多任务时显示数量，待确认与异常优先展示。
- 需要批准或回答提问时，灵动岛自动弹出并展开对应卡片；处理完可移开鼠标让面板收起，或单击固定展开。
- 想接着对话但不切回主窗口：展开控制台，在输入框输入内容，Enter 发送，Shift+Enter 换行。
- 查看费用与 token：空闲时展开面板看 24 小时柱状图，或打开用量统计窗口按天/模型/会话下钻。
透明区域不拦截鼠标；窗口置顶但不抢输入焦点。「隐藏」只藏灵动岛，点托盘鲸鱼可再显示。
适用场景与注意¶
适合：长期在 Windows 上用 Harness Desktop 跑 Agent、希望任务状态始终可见、并经常在后台批准工具或快速回复的用户。
注意：
- 仅适配 README 写明的 Harness Desktop 0.2.1-rc.5 / Windows；换宿主版本前应看仓库
VALIDATION.md与测试脚本说明。 - 社区插件，DeepSeek 名称与商标归其所有者；SkillHub 目录与 DeepSeek / 幻方无官方从属关系。
- 费用估算仅供参考，实际扣费以 DeepSeek 账单为准；高峰时段按 README 表格中的北京时间规则计价。
- 卸载可走
scripts/install-desktop.ps1 -Action Remove（需已退出 Harness）；停用插件后窗口随宿主关闭。
结尾¶
dsh-island 把 Harness 里「Agent 在干什么、要不要你点一下」浓缩到屏幕边缘，并在展开面板里补上用量与简短对话入口，适合不想一直盯着主窗口的桌面用户。更多截图、状态说明与开发细节见仓库 README。
- 目录页：https://www.skillhub.cn/plugins/a961282799-crypto/dsh-island
- GitHub：https://github.com/a961282799-crypto/dsh-island
