147228/dsh-black-whale 预览 preview

147228/dsh-black-whale

Plugin插件 Native原生 ⭐ 3 NOASSERTION Dev Workflow开发与代码工作流UI & Themes界面与主题

DeepSeek Harness 黑鲸实验室主题:官网黑鲸 × 夕小瑶 IP,真实 profile 可安装的 Web UI 插件

Project Overview项目介绍

Black Whale Lab is a custom UI theme plugin built exclusively for DeepSeek Harness (DSH) web client. It loads into the official DSH web application via DSH profile and Cordis plugin loader, and only modifies the presentation layer of the interface while keeping all native DSH functions intact. Key features include background penetration, automatic contrast protection for text, and a one-click focus mode for better reading of long content, code, and logs. Unlike static wallpaper overlays, it modifies the underlying canvas of DSH to insert custom artwork without altering any core backend logic of DSH.

To install the plugin, you need a working DSH web profile, and it has been tested and verified on DSH version 0.1.0-rc.6 and Node.js 24 across macOS, Windows, and Linux. The recommended installation method is to run the command dsh plugin --profile web add https://github.com/147228/dsh-black-whale/releases/download/v0.1.3/xiaoyao-ai-dsh-client-ui-skin-black-whale-0.1.3.tgz in your terminal, then restart DSH web to apply the change. You can verify the installation by checking for the plugin entry in your DSH plugin list or running a config dump command to confirm it is loaded correctly. If you already have another global DSH skin installed, you should remove it first to avoid conflicting theme variables.

The plugin is purely presentation-focused, meaning it does not access any network requests, user credentials, session data, or make any calls to your AI models. The source code is licensed under MIT, while the custom visual assets from Xiaoyao Community are licensed under CC BY-NC 4.0. This is a community-developed plugin and is not affiliated with, endorsed by, or sponsored by DeepSeek. All styles are scoped to avoid interfering with DSH core code, and uninstalling the plugin fully restores the original DSH interface with no residual changes. For local development, you can clone the repository and install dependencies with pnpm to test your own custom changes.

黑鲸实验室(Black Whale Lab)是专为 DeepSeek Harness 打造的原生界面主题插件,通过 DSH 的配置文件和 Cordis 插件加载器接入官方 Web 客户端,仅修改界面表现层,完整保留所有原生 DSH 的会话、模型、工具和设置能力。它实现了背景透传、自动对比度保护、一键专注模式等特性,完全不会改动 DSH 的核心后端逻辑。

本插件适合希望自定义 DSH 工作区视觉体验的开发者,安装后可让主画布透出定制背景,同时为侧边栏、输入框、弹窗等关键交互控件保留可靠底色,避免文字融入复杂背景影响阅读。卸载插件后可完整恢复原有界面,不会残留任何修改或污染 DSH 本身的配置。

本插件源代码采用 MIT 许可证授权,定制视觉资源采用 CC BY-NC 4.0 许可证,属于社区开发项目,和 DeepSeek 官方无隶属关系。它支持全平台运行,要求 DSH 版本不低于 0.1.0-rc.6,不建议同时启用多个全局 DSH 皮肤,避免主题变量冲突。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 3 stars - very few users, little community feedback星标只有 3,几乎没人在用,遇到问题缺少社区反馈
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:147228/dsh-black-whale#v0.1.3

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

READMEREADME

Black Whale Lab for DeepSeek Harness

Black Whale Lab · 黑鲸实验室

夕小瑶 × DeepSeek Harness:让真实 DSH Web 主画布透出黑鲸与小瑶的专业实验室皮肤。

English · 安装 · 原理 · 反馈问题

CI Release MIT CC BY-NC 4.0 DSH plugin

它不是一张盖在界面上的壁纸

Black Whale Lab 是一个真实的 DeepSeek Harness Web 客户端插件。它通过 DSH 的 profile 与 Cordis 插件加载器进入官方 Web 应用,保留原生会话、模型、工具、沙箱、权限和设置能力,只接管浏览器表现层。

  • 背景透传:处理 DSH 嵌套的两层基础画布,让鲸鱼与小瑶真正进入主工作区。
  • 局部承载:侧栏、输入卡、菜单和弹窗仍保持可靠底色,文字不会落进复杂背景。
  • 自动对比度保护:运行时识别“浅底+浅字”控件并自动切换深色文字,不依赖易变化的 CSS 哈希类名。
  • 专注模式:右上角一键压暗画布,适合长对话、代码和日志阅读。
  • 完整回滚:卸载时恢复标题、背景、DOM 与样式作用域,不污染 Harness 本身。
  • 本地优先:不读取会话,不发送提示词,不调用模型,不上传任何数据。

安装

要求:可正常运行的 DeepSeek Harness Web profile。当前版本在 DSH 0.1.0-rc.6、Node.js 24 上完成真实验收。

从 GitHub Release 安装(推荐)

dsh plugin --profile web add \
  https://github.com/147228/dsh-black-whale/releases/download/v0.1.3/xiaoyao-ai-dsh-client-ui-skin-black-whale-0.1.3.tgz

也可以直接安装固定 Git tag:

dsh plugin --profile web add github:147228/dsh-black-whale#v0.1.3

安装后重启:

dsh web

全局皮肤会覆盖同一批主题变量。若已经安装其他 DSH 全局皮肤,请先移除旧皮肤,再安装 Black Whale Lab。

验证

dsh web --dump-config | grep -n "ui-skin-black-whale"

输出中出现 ui-skin-black-whale,并且在「设置 → 插件 → 插件列表」中显示“已挂载”,即表示 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-llm-verifier 下一个 Next dsh-openai-api →