cdxiaodong/dsh-island 预览 preview

cdxiaodong/dsh-island

将 DeepSeek Harness(DSH)代理的实时状态桥接到 CodeIsland 刘海面板 — 在动态岛上显示会话、工具和审批状态。

Project Overview项目介绍

dsh-island is a native DeepSeek Harness (DSH) plugin built exclusively for DSH that adds a dynamic island to the macOS menu bar. When the plugin is applied via the Cordis loader, it automatically spawns a native Swift panel that lives permanently in the macOS menu bar. The panel listens to all core DSH events including session creation, tool calls, approval requests, and subagent status changes, and updates its display in real time. Users can click the menu bar icon to open the panel and approve or reject requests directly without switching to the DSH main window.

The project includes planned support for cross-device sync between macOS and a mobile management app for iOS. The mobile app pulls the full list of capabilities from DSH, including all installed third-party plugins, and dynamically generates a management interface for all features. The menu bar capsule changes its text, color, and animation based on DSH's current status, with over 15 custom whale girl animations that switch based on whether DSH is idle, working, waiting for approval, or finished. Other DSH plugins can register custom menu items in the tray’s right-click menu via the plugin’s exposed API.

To install the plugin, users need to run the DSH CLI command dsh plugin --profile <profile> add github:cdxiaodong/dsh-island. The plugin requires macOS 14 or newer, and the precompiled panel binary is currently only built for Apple Silicon (arm64). Intel users need to compile the binary manually using the provided panel/build.sh script. The project is licensed under MIT, and the docs folder contains a full interactive preview that can be run locally with a simple Python static server. This preview lets users test all interface interactions and animations before installing the plugin to their DSH setup.

这是 DeepSeek Harness (DSH) 的原生插件,为 macOS 系统添加了菜单栏灵动岛功能。插件启用后会自动拉起原生 Swift 编写的状态栏面板,常驻 macOS 菜单栏,动态展示 DSH 的会话状态、工具调用进度和审批请求。用户点击菜单栏图标即可展开实时面板,还能直接在面板上完成审批操作,不用切回 DSH 主界面。

它还规划了跨端同步功能和手机动态管理端,可根据 DSH 的能力清单(包括第三方插件)动态生成管理界面。菜单栏胶囊会根据 DSH 实时状态切换文案和动画,内置 15 种以上鲸鱼娘动画,会根据工作状态协调切换。它还支持其他 DSH 插件在托盘右键菜单注册自定义菜单项。

通过 DSH 命令行可一键安装,命令为 dsh plugin --profile <profile> add github:cdxiaodong/dsh-island,运行要求 macOS 14 以上,预编译二进制仅支持 arm64 架构,Intel 芯片用户需要通过自带脚本手动编译。项目基于 MIT 许可证开源,docs 目录下有完整可交互的预览,可本地启动静态服务器体验全部功能。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 2 warnings2 项注意
  • No license declared - all rights reserved by default; ask the author before commercial use or redistribution未声明开源许可证 —— 默认「保留所有权利」,商用或再分发前先问作者
  • Only 9 stars - very few users, little community feedback星标只有 9,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:cdxiaodong/dsh-island

把 cdxiaodong/dsh-island 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-island · 鲸鱼娘灵动岛

DeepSeek Harness (DSH) 的 macOS 菜单栏灵动岛 —— 插件一启动,DSH 的会话、工具调用、审批直接出现在顶部菜单栏, 点击展开实时面板;配套 跨端同步 与 手机动态管理端,让 AI 任务一边跑、你一边掌控。

功能预览 · 快速安装 · 功能 · 路线图


🎬 功能预览

交互式预览(浏览器直接体验):docs/ 下是一整套可运行的产品预览。本地起一个静态服务器即可逐页体验全部交互:

cd docs && python3 -m http.server 8080
# 打开 http://localhost:8080/index.html

① DSH 对话联动 · 会话全览 + Auto 模式

DSH 对话联动

所有 DSH 会话一屏总览:活跃会话、工具调用、时长、状态一目了然;点击会话二次展开最近工具 / Token / 运行模式(Auto 全程无需批准),可直接跳转会话或停止。灵动岛胶囊随状态实时切换「空闲 / 运行中 / 等待授权」。

② 跨端互通 · Mac 灵动岛 ↔ 手机灵动岛

跨端互通

任务在电脑上跑,进度实时同步到手机灵动岛:菜单栏胶囊一瞥即得,关键节点(完成/失败/审批)主动展开提醒,手机上直接跟随确认。异构灵动岛形态(macOS 菜单栏 ↔ iPhone Dynamic Island)同一状态源双向流转。

③ 价值对比 · 一天工作流的前后之差

价值对比

镜头对准一个开发者的工作日:反复切窗看进度、错过关键节点、离开电脑即失联 —— 有了灵动岛之后,一瞥即得、主动提醒、手机随手掌控。数字会滚动,前后差距一目了然。

④ 手机动态管理端 · 接口映射,不写死任何一个功能

手机动态管理端

手机管理端从 DSH 拉取能力清单(原生功能 + 全部插件接口),动态生成管理界面:装上一个新的第三方插件,手机端自动多一个管理入口,App 永不过时。内置对多个真实高 star 插件(open-design 87.4k★、voyager 19.5k★、dsh-web-ui、modlens、OpenBiliClaw…)的实时监测:状态 / 调用量 / 内存 / 健康度,远程启停、检查更新。

预览即产品形态:追平甚至超越市面上「写死 UI」的 DSH 手机端,走的是「接口即入口」的动态映射路线。


⚡ 快速安装

dsh plugin --profile <profile> add github:cdxiaodong/dsh-island

前提:macOS 14+(面板为 arm64 二进制;Intel 需自行用 panel/build.sh 重编)。


是什么

开发 AI agent 时,最常见的烦恼是「切窗口看它到底在干嘛、是不是卡在审批」。dsh-island 把 DSH 的实时状态带进 macOS 菜单栏:

  • 插件 apply 时自动拉起原生 Swift 面板(bin/dsh-island-panel,NSStatusItem + NSPopover + SwiftUI,借鉴 CodeIsland 的实现)
  • 菜单栏按钮文案随状态动态变化:🐋 DSH(空闲)→ 🔧 运行中 / 🔧 <工具>(执行中)→ 🛡️ 需要授权(审批中)
  • 点击菜单栏图标 → 弹出毛玻璃灵动岛面板:会话、工具调用、事件流
  • 审批请求直接在面板上点「允许 / 拒绝」,决策回写 DSH
DSH 进程
  └─ dsh-island 插件(cordis)
       ├─ apply() 时 spawn → bin/dsh-island-panel(Swift 原生,常驻菜单栏)
       ├─ 监听 DSH 事件(session/tools/approval/subagent/status)
       └─ Unix socket /tmp/dsh-island-<uid>.sock → 菜单栏图标 + 面板实时更新
                            ↑ 面板上点「允许/拒绝」→ 决策回写 DSH

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-tylina 下一个 Next dsh-skin-market →