把 DeepSeek Harness 的 Web UI 包进一个原生桌面窗口,双击即用。
- 只做基本的打包:壳仅仅把 DSH Web UI 装进一个原生窗口,页面内容与浏览器
打开
http://127.0.0.1:3080看到的完全一致,完全遵循官方 UI; - 不影响任何 UI 插件:皮肤、侧边栏、会话插件等全部照常工作;壳只注入 窗口边框层(顶部拖动条与窗口按钮),不修改 DSH 的任何页面结构或 UI 面板;
- 仅加入窗口层按键:全屏、最小化、最大化、关闭都属于窗口边框层, 不进入 DSH 的页面 UI。
- 启动时探测
http://127.0.0.1:3080(端口可在config.json改):- 已有服务在跑(比如你手动启动的)→ 直接以窗口打开,关闭窗口不会影响原服务;
- 没有服务 → 按
config.json里的命令自动启动 DSH 服务,就绪后打开窗口; 关闭窗口时只杀掉自己启动的服务,不留后台进程。
- 单实例:重复双击只会把已有窗口带到前台。
- 所有启动/停止细节记录在 exe 旁边的
dsh-shell.log,排查问题看它。
- 无边框窗口:顶部有一条自绘顶栏,可拖动窗口;右上角依次是 全屏 / 最小化 / 最大化 / 关闭 四个按钮。
- 按钮颜色跟随 DSH 主题:换皮肤、切深浅色时自动变色。
- 全屏按钮(四角方框图标):长悬停显示「全屏纯享」,点击进入完全全屏; 全屏后按钮组淡出隐藏,鼠标靠近屏幕顶部时柔和淡入(可点按钮退出, 全屏时点击也可关闭窗口)。
- 退出全屏:再点全屏按钮、按 Esc 或 F11 均可;F11 也可进入全屏。
- 不想用无边框:把 exe 旁
config.json的window.overlay改为false, 回到传统原生标题栏(此时 F11/Esc 全屏仍可用)。
任务栏提醒(需 DSH 侧提醒插件配合,推荐配套 dsh-attention-notifier)
任务栏提醒需要 DSH 侧提醒插件配合,推荐配套使用
dsh-attention-notifier
(宿主层持久化插件,只做判定、不碰 UI、自带 stats 自诊断),按其 README
装好后把状态挂在 GET /dsh-attention(审批/提问挂起、一轮工作完成)。壳注入
的页面轮询器读取它,经桥(window.dshShell.setAttention)上报,主进程在
Windows 任务栏用系统级按钮闪烁(微信新消息同款机制,按钮整体明暗呼吸)给出
提醒,介入与完成同款:
- 需要介入(审批/提问等待处理)或一轮工作完成后,只要"你没在关注" —— 窗口失焦/最小化,或聚焦但超过 8 秒没有任何操作 —— 任务栏按钮就闪烁 (闪几轮后常驻淡红,微信同款);
- 回到对话(窗口聚焦,或窗口内任意鼠标移动/点击/滚轮/键盘操作)立即熄灭;
- 完成事件若发生在你正活跃地看着窗口时,视为已看到,不闪。
壳只消费 GET /dsh-attention 这一个契约(字段定义见
dsh-attention-notifier 的 README),任何实现同一契约的提醒插件都能配合
使用,不绑定具体实现;没装这类插件时壳不探测 DSH 页面状态、任务栏也不
闪烁 —— 与"轻量壳、不碰官方 UI"的定位一致。
- 按 dsh-attention-notifier 的 README 把插件装进 DSH(宿主层即可,所有预设、所有会话自动生效);
- 重启 DSH(直接关掉壳重开即可)后验证:
Invoke-WebRequest http://127.0.0.1:3080/dsh-attention返回 JSON 即就绪; - 之后正常使用,无需其他配置。
npm install
npm run dist:dir产物在 release\win-unpacked\DSH Desktop.exe,双击即可运行
(绿色版不含安装器,不会自动创建快捷方式)。
创建桌面快捷方式(手动,一步):
- 右键
DSH Desktop.exe; - Windows 11:点「显示更多选项」→「发送到」→「桌面快捷方式」 (Windows 10 直接有「发送到」);
- 桌面出现「DSH Desktop - 快捷方式」,双击即用,图标自动使用壳的图标。
注意:移动项目文件夹后,快捷方式需要重新创建。
npm start壳不包含任何 DSH 代码,DSH 更新照常进行(在 checkout 里 git pull 等)。
启动配置在 exe 旁边的 config.json:
{
"port": 3080,
"start": {
"cwd": "",
"command": "pnpm dsh web"
},
"window": {
"overlay": true,
"overlayHeight": 36
}
}port:DSH web 端口(默认 3080)start.cwd:DSH checkout 目录。留空则自动探测:- 环境变量
DSH_CHECKOUT; - config 附近常见的并排布局(如
../deepseek-harness)。 自动探测失败时启动页会给出提示;也可以直接填绝对路径(如D:\\Deepseek Harness\\deepseek-harness)或相对 config 所在目录的路径。
- 环境变量
start.command:启动命令(要求pnpm在 PATH 中)window.overlay:false时回到传统原生标题栏window.overlayHeight:顶栏(拖动条 + 按钮)高度,默认 36px
npm run dist同时产出两种形态,都在 release\:
win-unpacked\DSH Desktop.exe— 免安装绿色版;DSH Desktop Setup <版本>.exe— NSIS 安装器,安装时自动创建桌面和开始菜单快捷方式, 免管理员权限(装到当前用户目录),带卸载程序。
未签名安装包首次运行时 Windows SmartScreen 会提示,选「更多信息 → 仍要运行」即可。
- 不要同时手动跑 DSH 又期望壳再开一个:壳发现端口被占会直接复用,这是特性。
- 想让壳"自己启动服务",需要先停掉所有占用 3080 的 DSH 实例。
- 快捷方式图标默认取自打包配置里的
assets/icon.png。 - 任务栏提醒需要 DSH 侧装提醒插件(推荐 dsh-attention-notifier), 没装时任务栏不会闪烁。
本壳在「文字开源」枢纽仓库 dsh-text-open-source 中配有完整描述（功能 / 技术路线 / 结构 / 关键实现 / 复刻提示词，不依赖代码即可复刻、便于理解与微调）：plugins/dsh-shell.md。