图标启动器 SkyblueeeLabs/dsh-iconic-launcher

dsh-iconic-launcher

面向 DeepSeek Harness（deepseek-harness）的便携启动工具链，运行在 Windows 上。它把 Web UI 变成带真实图标的一键桌面快捷方式，你再也不用敲那串长长的启动命令。

Preview / 预览

设置页首页（顶部项目信息 + 默认分组）

浅蓝分组（16 个预设图标）

Why this exists / 初衷

DeepSeek Harness 的启动流程大家都熟，但实在烦人——打开终端，cd 进你的检出目录，再敲一长串带各种 flag 和环境变量的命令。时间一长就受不了，尤其是重新 clone 之后，或者换了台新机器。

这个项目故意不放进上游仓库。它是一层独立、小巧、自包含的东西，只做三件事：

- 创建桌面快捷方式（带真实图标），用来启动 DeepSeek Harness；
- 需要时从 SVG 重新生成图标；
- 重新 clone 上游仓库后，把一切恢复回来。

它不会修改、打补丁或重新构建 DeepSeek Harness 核心代码。上游保持原样、保持干净——启动器只是包了一层启动流程。一句话：少敲点字，对产品零风险。

因为它待在自己的仓库里（不在 harness 检出目录内），重新 clone harness 目录树永远不会把它冲掉：重新 clone 之后，跑一下 deploy.ps1，快捷方式（连同图标）几秒就回来了。

Install / 安装

Platform / 平台：Windows only（快捷方式依赖 Windows 的 .lnk / PowerShell）。macOS / Linux 上插件可安装，但"写入桌面快捷方式"一项不可用。当前仅支持 Windows 系统。

需要装好 DeepSeek Harness，并且有 dsh 命令。仓库根就是插件包，所以两种方式装的是同一个东西。 / 需要已装好 DeepSeek Harness 并有 dsh 命令。仓库根就是插件包,两种方式装的是同一个东西。

A. From GitHub — recommended; this is what the plugin market uses. 直接从源码安装（插件无构建步骤），插件市场走的就是这条。 / 直接从源码安装 (插件无构建步骤),插件市场走的就是这条。

dsh plugin --profile <name> add github:SkyblueeeLabs/dsh-iconic-launcher

Pin a release instead of tracking the default branch:
dsh plugin --profile <name> add github:SkyblueeeLabs/dsh-iconic-launcher#v0.1.1

B. From a prebuilt tarball — offline / air-gapped. 从 GitHub Releases 页面拿 dsh-iconic-launcher-<version>.tgz，或者在克隆里用 npm pack 自己打一个，然后让 dsh 指向这个文件。 / 从 GitHub Releases 下载 .tgz,或在克隆里 npm pack 自己产出,再指向该文件。

dsh plugin --profile <name> add C:\path\to\dsh-iconic-launcher-0.1.1.tgz

装完之后，重启 web 应用（dsh web），打开 设置 → 桌面图标（或 插件 → 插件配置）来选图标或上传桌面图标。
/ 装完重启 dsh web,在 设置 → 桌面图标(或 插件 → 插件配置)里选图 / 上传。

Layout

| Path | Purpose |
| scripts/start-dsh-web.bat | 便携启动器。在 PATH（或 DSH_NODE_DIR）里找到 node，然后通过 tsx/esm 入口运行 dsh web（node --import tsx/esm .../apps/cli/src/bin.ts web）。每一步都写进 scripts/launcher.log。 |
| scripts/dsh-icon.ico | 桌面快捷方式上显示的多分辨率图标。 |
| scripts/convert-svg-to-ico.mjs | SVG → 多尺寸 .ico 写入器（16–256），除 sharp 外没有构建依赖。 |
| scripts/generate-icon.ps1 | 从 SVG 重新生成 dsh-icon.ico（会探测 sharp 是否安装）。 |
| scripts/create-desktop-shortcut.ps1 | 创建或刷新桌面 .lnk，指向 start-dsh-web.bat，并使用 dsh-icon.ico。 |
| scripts/SETUP-SHORTCUT.md | 完整的安装与排错说明。 |
| deploy.ps1 | 一键恢复：把 scripts/ 复制回 DeepSeek Harness 检出目录，并刷新快捷方式。 |
| install.ps1 | 新用户一键安装：构建一份全新的 deepseek-harness 检出，生成图标，创建快捷方式。 |
| 仓库根目录 | dsh-iconic-launcher —— DSH 插件本体（宿主端 + 浏览器设置卡片）：挑选或上传桌面快捷方式图标、自动去背景、多尺寸 ICO、一键写入 .lnk。 |
| data/ | PNG 图标源素材（也能通过插件当作额外预设使用）。 |

快速使用

重新克隆上游仓库后恢复

from anywhere, point at your harness checkout (auto-detected or -RepoRoot)
./deploy.ps1 -RepoRoot "C:\where\you\cloned\deepseek-harness"

首次安装（新机器）

./install.ps1 # clone upstream + install icon + create shortcut

只重建图标

powershell -ExecutionPolicy Bypass -File ./scripts/generate-icon.ps1
powershell -ExecutionPolicy Bypass -File ./scripts/create-desktop-shortcut.ps1

自定义桌面快捷方式图标插件（Web UI）

插件新增了「挑选或上传桌面快捷方式图标」的能力，运行在 DeepSeek Harness Web 应用里。按上面 Install / 安装 里的任一方式安装即可。路由、配置和当前状态见 docs/plugin.md。scripts/ 和 data/ 两个目录是开发工具和源素材 —— 它们不属于安装包的一部分。

环境要求

- Windows 10/11（快捷方式 = .lnk + PowerShell，仅限 Windows）。
- PowerShell 5.1+（或 PowerShell 7）。
- Node.js 在 PATH 中（启动器还会探测 %ProgramFiles%\nodejs 和 %LOCALAPPDATA%\Programs\nodejs；可用 DSH_NODE_DIR 覆盖）。
- 只有需要重建图标时才要 sharp（可选）。

许可证

MIT。图标派生自 DeepSeek Harness 自己的 favicon（MIT）。

注意事项 / 坑

- 这些文件有意不放进上游仓库。不要提交到那边；留在这里，推到你自己的 fork。
- 桌面快捷方式按绝对路径引用检出目录下的图标和启动器；重新克隆后，要重新运行 deploy.ps1，这样快捷方式重新指向正确。