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。

📸 状态展示

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":[...]} 即表示控制面与跳转桥正常运转

cd swift
./build.sh install

🎮 交互指南

⚙️ 配置说明

配置文件位于各系统标准应用数据目录的 client-config.json 中：

• macOS: ~/Library/Application Support/DSHNotch/client-config.json
• Windows: %APPDATA%\DSHNotch\client-config.json

修改后立即生效（应用端自适应轮询配置文件 mtime：活跃 250ms / 空闲或隐藏 1s，无需重启）：

🏛️ 体系架构

系统解耦为 插件控制面 与 原生呈现宿主，两者通过回环接口解耦交互：

┌────────────────────────────────────────────────────────┐
│                   DSH Desktop Host                     │
│  ┌──────────────────────┐    ┌──────────────────────┐  │
│  │   UI / Workspace     │    │   Session Storage    │  │
│  │ (openSession Hook)   │    │ (*.jsonl.zstd 流追加) │  │
│  └──────────▲───────────┘    └──────────┬───────────┘  │
└─────────────┼───────────────────────────┼──────────────┘
              │ 轮询 /next                 │ 增量多帧解压
┌─────────────┴───────────┐               │
│  插件控制面 (127.0.0.1)  │               │
│  (端口 47311 / IPC 桥)   │               │
└─────────────▲───────────┘               │
              │ POST /jump                ▼
┌─────────────┴──────────────────────────────────────────┐
│             原生状态栏端 (Swift / Electron)             │
│        - ActivityCursor 增量游标 (Multi-frame Zstd)     │
│        - 弹簧物理动效渲染 (Spring Dynamics)             │
└────────────────────────────────────────────────────────┘

💻 平台支持

🧪 开发与测试

本项目高度重视工程稳定性，包含两套无外部测试框架依赖的原生测试集：

# 1. 运行插件端自动化测试（336 项测试用例全部通过）
node test/run.mjs all

# 2. 运行 Windows 原生端回归测试（507 项测试用例全部通过）
cd windows && npm test

# 3. 运行 macOS 原生端测试套件
cd swift && ./build.sh all-tests

# 4. 驱动真实渲染层生成 2x 高清实机状态截图
cd windows && npm run shots

# 5. Windows 渲染层性能基准（与仓库基线对比；数字必须同机、同显示模式看）
cd windows && npm run perf

❓ 常见问题 (FAQ)

📄 开源许可证

本项目基于 MIT 许可证 开源。 Copyright © 2025-2026 Yangyunfan. All rights reserved.