方式 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

dsh-launcher

Other repositories with this package name

Install

README

方式 C：不使用 DSH 插件，手动创建快捷方式

配置说明

1. DSH 插件配置

2. 环境变量配置

3. 更换快捷方式图标

4. 运行时生成的文件

1. DSH 插件配置

2. 环境变量配置