dsh-iconic-launcher:为 DSH 桌面客户端定制快捷方式图标

前言

DeepSeek Harness(DSH)把能力拆成可安装的插件,但桌面客户端自带的快捷方式图标通常仍由安装包固定:任务栏、Alt-Tab 里每天看到的都是同一张图,上游一般只提供一个,且更新安装包时还可能被重置。若你希望在不改上游仓库、不重新构建的前提下,把「DeepSeek Harness 桌面快捷方式」换成自己的视觉,需要一个走 DSH 插件机制、能在客户端里完成选图与写回 .lnk 的方案。下面介绍社区插件 dsh-iconic-launcher(维护者 SkyblueeeLabs)的做法。

这是什么

dsh-iconic-launcher 是面向 DeepSeek Harness 桌面客户端(Windows) 的桌面图标插件:从内置预设中选一个,或上传 PNG / JPEG / WebP;插件会处理白底、打包成多尺寸 .ico,并改写客户端自己的桌面快捷方式(不是并排新建一个)。纯 JavaScript,无构建步骤;卸载插件后上游客户端与官方发布可保持逐字节一致。许可证为 MIT(见仓库 README);当前 package 版本为 0.1.2。

社区目录页:SkillHub · dsh-iconic-launcher。源码与说明:GitHub · SkyblueeeLabs/dsh-iconic-launcher。

核心功能

资料中明确列出的能力如下。

能力 说明
44 个内置预设 分四组:默认 1、浅蓝 16、深紫 15、混搭 12;离线预生成的多尺寸 .ico,运行时无栅格化开销。
自定义上传 PNG / JPEG / WebP,单文件上限 1 MiB;在浏览器侧解码并重编码。
自动去白底 从四边向内 flood-fill 白色底板,边缘 2 步羽化重算 alpha;不做全局白→透明,避免打穿图内白色区域。
7 档 ICO 256 / 128 / 64 / 48 / 32 / 24 / 16 像素,单文件多尺寸。
一键写 .lnk 写入的是客户端自身的桌面快捷方式;图标文件按内容哈希命名,用于缓解 Windows 按路径缓存图标的问题。
自定义持久化 上传图保存在「自定义」分组,可两段式点击删除。
大图边界 画布长边上限 1024,超出自动降采样,避免 flood fill 拖垮设置页。

上传与栅格化在 browser half(client.js)完成;host 侧校验 PNG 签名、尺寸白名单与体积后打包 ICO,并通过 PowerShell 写快捷方式。desktop profile 由 Electron 桌面应用独占管理,不能用 CLI 的 dsh plugin --profile desktop add … 安装(会被拒绝)。

安装与启用

平台:README 标明 Windows 10 / 11;其它平台可装插件,但写快捷方式不可用,host 会报错而非静默失败。

1. 在桌面客户端添加插件来源

打开客户端的 插件 页面(插件市场 / 插件配置 / Plugins),添加仓库来源:

github:SkyblueeeLabs/dsh-iconic-launcher

请勿用命令行向 desktop profile 安装;README 示例:

dsh plugin --profile desktop add …    # ✗ 会被拒绝
# profile "desktop" is managed exclusively by the Electron application

2. 重启并打开设置

重启桌面客户端后,进入 设置 → 桌面图标。同一卡片也会出现在 插件 → 插件配置(默认折叠)。

离线安装时,自 v0.1.2 起 GitHub Releases 上的 .tgz 与 main 一致;若仍持有 v0.1.1 的旧包,README 建议升级到 v0.1.2(旧包快捷方式目标指向已废弃的 dsh web 且缺少 launcher.js)。

典型用法

经过上面的安装步骤,可按 README 中的顺序操作:

  1. 打开 设置 → 桌面图标。
  2. 选择分组:默认 / 浅蓝 / 深紫 / 混搭 / 自定义。
  3. 点选一个图标——底部确认栏会显示缩略图与名称,写入前可核对。
  4. 或在「自定义」中点「+ 添加图片」上传 PNG / JPEG / WebP,处理完成后点 写入桌面。
  5. 成功后会显示 .lnk 的落地路径;失败时错误信息显示在确认栏(非弹窗)。

客户端更新安装包时会重建自带快捷方式,图标可能恢复默认;插件与用户图标目录仍在用户数据路径(README 提到 ~/.dsh/profiles/desktop/node_modules/dsh-iconic-launcher 与 ~/.dsh-launcher/icons),无需重装插件,只需再次打开 设置 → 桌面图标,重选同一图标并写入即可(README 称约两秒;卡片暂不记忆上次选择)。

适用场景与注意

适合谁:在 Windows 上使用 DSH 桌面客户端、希望快捷方式图标与品牌或个人素材一致、且愿意通过插件而非改上游源码实现的用户。

权限与安全:插件以当前 DSH / 桌面客户端进程权限运行,会读写本机快捷方式与用户数据目录下的图标文件。安装前请自行查看 GitHub 仓库 源码与 MIT 许可证,确认符合你的环境策略。

生态说明:DSH 强调「万物皆插件」;SkillHub 等社区目录为独立站点,与 DeepSeek / 幻方无官方从属关系,本文介绍的是社区维护的插件包,非官方应用商店条目。

结尾

dsh-iconic-launcher 把「写死在安装包里的快捷方式图标」改成可在客户端里选的预设或自定义图,并一键写回 .lnk,与 DSH 插件化思路一致。需要细节、路由与预设命名规则时,以仓库 README 为准。

  • 目录页:https://www.skillhub.cn/plugins/SkyblueeeLabs/dsh-iconic-launcher
  • GitHub:https://github.com/SkyblueeeLabs/dsh-iconic-launcher
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜