dsh-deepisland

🏝️ DSH DeepIsland

专为 DeepSeek Harness 设计的双端原生灵动岛状态栏

实时感知智能体状态 · 深度思维链解析 · 多会话并行监控 · 一键跳转交互

在 macOS 物理刘海或 Windows 屏幕顶端居中悬浮窗实时显示智能体进度，点击即刻跳转对应会话。

---

💡 为什么需要 DeepIsland？

使用 DeepSeek Harness 进行长链路工程任务时，智能体常在后台经历漫长的深度思考与工具调用。切屏确认进度不仅打断心流，更难以及时响应人工审批请求。

DeepIsland 将状态感知推向系统级前台：

• 物理刘海融合：macOS 顶端原生刘海硬件融合；Windows 顶端无边框贴边悬浮（与 macOS 同一套视觉语言：纯黑底 + 状态色内发光带 + 沿剪影外发光）。
• 双路状态仲裁：优先跑会话多帧 zstd 事件流（ActivityCursor），投影启发式兜底；Windows 端实测事件流已含 tool/call、turn/start、approval/* 等完整状态事件。
• 会话一键穿梭：点击状态栏直接拉起 DSH 并聚焦至对应会话，零权限依赖、免键盘模拟。
• 轻量低开销：Windows 端快照只传渲染层真会读的 DTO 并按内容指纹（rev）去重推送，空闲/隐藏时轮询自适应降到 1s；渲染层热路径零强制同步布局、无全量 innerHTML 重建。实测数据见 [windows/README.md](./windows/README.md#性能基准scriptsperfjs)。

---

📸 状态展示

1. 紧凑折叠态（Compact Mode）

屏幕顶端常驻，以色彩与微动效呈现智能体实时动作，不遮挡日常视线：

| 💭 深度思考 | ⚡ 工具执行 | 🔀 多会话并行 |

| :---: | :---: | :---: |

| | | |

| 实时截取思维链要点（蓝光） | 显示当前工具与操作文件（青光） | 显示优先级最高会话 + 数量角标 |

2. 悬停展开态（HUD Mode）

鼠标悬停 0.2s 平滑展开，显示耗时、轮次、工具调用数、Token 消耗及多任务列表：

| 单会话深度监控 | 工具调用与耗时 | 多任务并行调度 |

| :---: | :---: | :---: |

| | | |

| 进度条、思考耗时、上下文量 | 实时显示执行命令与参数 | 按优先级排序，点击切换聚焦 |

---

⚡ 核心功能

• 深度思考链解析：从 assistant/message 提取 reasoning 内容，长思考过程不再显示为空白等待。
• 多会话并发管理：最多同时追踪 6 个后台任务。状态优先级排序：等待审批 > 工具执行 > 思考中 > 已完成 > 待命。
• 阻塞事件主动唤起：检测到需要人工确认的敏感工具调用时，状态指示切换为琥珀色心跳脉冲并自动展开 HUD。
• 界面与动效：宽/高/圆角共用一条按 SwiftUI 弹簧解析式采样 61 点的 linear() 真弹簧；展开时内容按层阶梯入场；思考呼吸 / 工具流光 / 等待脉冲 / 完成微光，全部受「光效开关」与系统 prefers-reduced-motion 双重门控。
• 无感本机跳转：通过本机回环 HTTP 握手桥与 DSH 内部视图管理器联动，点击即可精准唤起并定位目标会话。
• 自动防误唤醒：内置回合结束标记识别（sawTurnEnd），会话交付后杜绝残存投影引发假性激活。

---

🚀 快速安装

推荐：DSH 插件管理器一键安装

插件充当控制面与本机通信桥，并负责应用端缺失时的静默自愈安装。

1. 打开 DSH Desktop → 插件管理。

2. 输入完整 Git 仓库地址并安装：

   git+https://github.com/myYangyunfan/dsh-deepisland.git

3. 在安装完成弹窗中点击 「立即启用」（写入 dsh.profile.bundles 配置）。

4. 重启 DSH Desktop。插件加载后将自动下载校验对应系统的原生应用，数秒后灵动岛即刻呈现。

🔍 验证安装状态

在终端执行健康检查命令：

curl -s http://127.0.0.1:47311/health
# 返回 {"ok":true,"keys":[...]} 即表示控制面与跳转桥正常运转

🛠️ 备用方案：手动编译安装独立应用

无需插件控制面亦可独立运行原生灵动岛（仅失去一键跳转能力）：

macOS 原生构建：

cd swift
./build.sh install

Windows 便携部署：

从 [Releases](https://github.com/myYangyunfan/dsh-deepisland/releases) 下载最新发行版压缩包，解压至 %LOCALAPPDATA%\Programs\DSHNotch\ 即可。

详见 [swift/INSTALL.md](./swift/INSTALL.md) 与 [windows/README.md](./windows/README.md)。

---

🎮 交互指南

| 触发操作 | 响应动作 | 说明 |

| :--- | :--- | :--- |

| 悬停 0.2 秒 | 展开 HUD 面板 | 查看上下文 Token、工具详情及多会话列表 |

| 移出 0.35 秒 | 收起面板 | 平滑淡出，不干扰主屏幕操作 |

| 单击岛体空白处 | 锁定 / 解锁常驻 | 常驻状态下鼠标移开不会自动收拢 |