dsh-launcher
为 DSH Web 自动创建 Windows 桌面快捷方式：双击直达工作页面，未启动时自动拉起 dsh web。 适合Windows用户，希望双击桌面图标直接启动并打开DSH工作台。
같은 패키지 이름의 다른 저장소
설치
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:NoMindSama/dsh-launcher方式 C：不使用 DSH 插件，手动创建快捷方式
如果你只想使用启动器脚本，也可以手动运行安装脚本：
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\install-shortcut.ps1 `
-LauncherScript .\scripts\launch-web.ps1 `
-IconPath .\assets\icon.ico `
-ShortcutName "DSH 工作台" `
-WorkingDirectory "E:\your-workspace"
其中 -WorkingDirectory 改成你希望 dsh web 启动时使用的工作目录。
配置说明
插件配置优先级为：
DSH 插件配置 > 环境变量 > 默认值
1. DSH 插件配置
在你的 profile patch 层（例如 $DSH_HOME/profiles/web/cordis.patch.yml 或 $DSH_HOME/cordis.patch.yml）中加入：
- id: dsh-launcher
config:
workspace: "E:\\projects\\my-dsh-workspace"
port: 3080
shortcutName: "DSH 工作台"
dshCommand: "C:\\Users\\you\\AppData\\Roaming\\npm\\dsh.cmd"
desktop: "C:\\Users\\you\\Desktop"
字段说明：
| 字段 | 类型 | 默认值 | 说明 |
|---|---|---|---|
workspace | string | DSH 启动时的工作目录 | 双击快捷方式后启动 dsh web 的工作目录 |
port | number | 3080 | DSH Web 默认端口；实际运行时优先使用真实监听端口 |
shortcutName | string | DSH 工作台 | 桌面快捷方式名称，不需要带 .lnk |
dshCommand | string | 自动查找 dsh.cmd | dsh 可执行文件路径，适用于非全局 npm 安装 |
desktop | string | 系统桌面目录 | 自定义桌面目录，支持 OneDrive 重定向 |
2. 环境变量配置
如果不想修改 DSH patch，也可以设置环境变量：
| 环境变量 | 对应配置 | 示例 |
|---|---|---|
DSH_LAUNCHER_WORKSPACE | workspace | E:\projects\my-app |
DSH_LAUNCHER_PORT | port | 3080 |
DSH_LAUNCHER_SHORTCUT_NAME | shortcutName | DSH 工作台 |
DSH_LAUNCHER_DSH_CMD | dshCommand | C:\Users\you\AppData\Roaming\npm\dsh.cmd |
DSH_LAUNCHER_DESKTOP | desktop | C:\Users\you\Desktop |
PowerShell 中临时设置示例：
$env:DSH_LAUNCHER_WORKSPACE = "E:\projects\my-app"
$env:DSH_LAUNCHER_PORT = "3080"
dsh web
3. 更换快捷方式图标
方式一：替换包内图标后重启 DSH：
assets/icon.ico
方式二：直接替换运行时图标：
%USERPROFILE%\.dsh\launcher\icon.ico
然后重新双击快捷方式；如果 Windows 仍显示旧图标，在桌面按 F5 刷新即可。
4. 运行时生成的文件
插件会在 DSH Home 下生成：
%USERPROFILE%\.dsh\launcher\
├── icon.ico
├── launch-web.ps1
├── install-shortcut.ps1
└── config.json
其中 config.json 由插件根据配置自动生成，一般不需要手动修改。
1. DSH 插件配置
在你的 profile patch 层（例如 $DSH_HOME/profiles/web/cordis.patch.yml 或 $DSH_HOME/cordis.patch.yml）中加入：
- id: dsh-launcher
config:
workspace: "E:\\projects\\my-dsh-workspace"
port: 3080
shortcutName: "DSH 工作台"
dshCommand: "C:\\Users\\you\\AppData\\Roaming\\npm\\dsh.cmd"
desktop: "C:\\Users\\you\\Desktop"
字段说明：
| 字段 | 类型 | 默认值 | 说明 |
|---|---|---|---|
workspace | string | DSH 启动时的工作目录 | 双击快捷方式后启动 dsh web 的工作目录 |
port | number | 3080 | DSH Web 默认端口；实际运行时优先使用真实监听端口 |
shortcutName | string | DSH 工作台 | 桌面快捷方式名称，不需要带 .lnk |
dshCommand | string | 自动查找 dsh.cmd | dsh 可执行文件路径，适用于非全局 npm 安装 |
desktop | string | 系统桌面目录 | 自定义桌面目录，支持 OneDrive 重定向 |
2. 环境变量配置
如果不想修改 DSH patch，也可以设置环境变量：
| 环境变量 | 对应配置 | 示例 |
|---|---|---|
DSH_LAUNCHER_WORKSPACE | workspace | E:\projects\my-app |
DSH_LAUNCHER_PORT | port | 3080 |
DSH_LAUNCHER_SHORTCUT_NAME | shortcutName | DSH 工作台 |
DSH_LAUNCHER_DSH_CMD | dshCommand | C:\Users\you\AppData\Roaming\npm\dsh.cmd |
DSH_LAUNCHER_DESKTOP | desktop | C:\Users\you\Desktop |
PowerShell 中临时设置示例：
$env:DSH_LAUNCHER_WORKSPACE = "E:\projects\my-app"
$env:DSH_LAUNCHER_PORT = "3080"
dsh web