Turns a plain-browser DSH session into the WhaleHarbor lite client: a standalone browser --app window with a client-style top bar and task notifications, while the full desktop installer downloads in the background (multi-source, SHA-256 verified) and an install prompt appears when ready.
Install
# from npm (prebuilt)
dsh plugin --profile web add @duke-dsh-plugins/whaleharbor-promo
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:MoonlitDropOfBlood/DSH-Desktop#path:/plugins/whaleharbor-promo
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
This plugin publishes its README in Chinese only.
鲸港 Web 引导插件：把普通浏览器里的 DSH 会话变成「鲸港简版客户端」（独立窗口），同时后台下载完整桌面安装包并提示安装（Web → Desktop 转化漏斗）。
工作流程
- 独立窗口（简版客户端）：普通标签页打开 DSH 时，Host 探测本机 Chrome / Edge / Brave（Windows：常见安装路径 +
where兜底；macOS：/Applications与~/Applications的 .app；Linux：which），以--app=<当前页 URL>拉起无浏览器 UI 的独立窗口（自动只开一次，localStoragewhprom.appOpened）。独立窗口内渲染：- 顶部胶囊栏：品牌 / 下载进度 / 任务通知开关（浏览器 Notification）/ 全屏 / 收起；
- 右下角引导卡：客户端预览 + 下载状态机；
- 侧栏底部「客户端」按钮：随时重开引导卡。
- 后台下载完整安装包：发布元信息按
[WHPROMO_RELEASE_JSON → GitHub API → gh-proxy.com 镜像]顺序探测；安装包按[browser_download_url → 镜像]顺序下载到~/Downloads；完成后用 GitHub 资产digest做 SHA-256 校验。单请求超时 30s（gh-proxy 冷启动实测 ~17s）。 - 安装提示：下载完成引导卡弹出一次「安装包已就绪 — 完整功能需要安装客户端」+
explorer /select（macOSopen -R、Linuxxdg-open）定位安装包。
已在鲸港桌面客户端内运行时（window.dshDesktop 存在）全部 UI 自动禁用。
安装（profile 插件）
包内自带 dsh.bundle 清单（cordis.patch.yml 随包挂载），一条命令即可：
dsh plugin --profile web add @duke-dsh-plugins/whaleharbor-promo
或在 dshmarket 插件市场里一键安装。
环境变量
| 变量 | 默认 | 说明 |
|---|---|---|
WHPROMO_REPO |
MoonlitDropOfBlood/DSH-Desktop |
发布仓库（owner/repo） |
WHPROMO_MIRRORS |
https://gh-proxy.com/ |
镜像前缀（逗号分隔，带尾斜杠）；空串禁用镜像。默认只留 gh-proxy.com——ghproxy.net 实测恒定 403（v1.9.1 起与壳 SHELL_MIRRORS 对齐） |
WHPROMO_RELEASE_JSON |
空 | 自有 latest.json（推荐/方案 A），逗号分隔多个，形状同 GitHub release 对象（tag_name + assets[] 含 name/size/browser_download_url/digest），探测优先级最高 |
备注
- 认证 token：
--app用当前页location.href原样打开，首次启动的一次性?token=…可以带过去；在已认证标签页手动打开时，若目标浏览器 profile 不同会见到 "authentication required" 页——按页面提示重开dsh web打印的 URL 即可。 - CLI 子命令：
dsh的子命令由核心硬编码（web/plugin），插件无法扩展；本插件不提供斜杠命令。 - 上架 dshmarket 时把本目录打包发布即可（
dsh.client.platform = web，Client 走window.__ModuleLoader__格式）。
Links
More in this category
zhu1090093659/dsh-web#packages/dsh-task-board★ 9925
Task board for the dsh web GUI: a sidebar multi-column kanban whose cards run in real DSH agent sessions and can also be scheduled with cron expressions, executed host-side even with the browser closed.
zhu1090093659/dsh-web#packages/dsh-web-all★ 9925
Plugin and skin collection for the DSH Web UI: task board, Git graph, right-side panel, remote mobile UI, pet, live token stats, and a skin center.
MeteorNOX/DeepSeek-Balance-Whale-Widget★ 6712
A fixed-corner whale widget for the DSH web GUI — balance, today's usage and per-turn cost with peak/off-peak pricing, editable balance-alert and daily-budget bubbles, a module-based custom bubble queue with A/B weighted choices and random lines or images, 30+ vendor templates (OpenAI, OpenRouter, Kimi, SiliconFlow, Ark, Zhipu, MiniMax and more) with per-model balance and subscription quota, plus task-end sound, imported audio, custom roles and a resource manager. Local-only, no telemetry.
ccch1mneyyy/dsh-TUI★ 6538
Claude Code-style full-screen terminal UI: pixel-whale header, live status line, and streaming thought expansion.
omdsh-dev/DSH-better-sidebar★ 4808
Full sidebar workbench with file rendering and editing, terminal, Git, and subagents; third-party plugins can register new tabs.
Devin-AXIS/deepseek-design#deepseek-idesign★ 1672
Visual design studio for websites, app prototypes, posters, cards, reports, and magazines, with templates, direct element editing, selection-aware AI draft handoff, and export.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.