jovequli/dsh-launchpad

dsh-launchpad

给 DeepSeek Harness（dsh）用的一键启动器，支持 macOS 与 Linux —— 顺带解决余额查看、超支提醒和界面美化。

DeepSeek Harness 本身很好用，但日常有三个小麻烦：每次都要记启动命令、不知道钱烧得多快、界面比较素。这个小工具把这三件事收进了一个窗口。

与 DeepSeek 官方无关。这是一个独立的配套工具，只是调用官方 dsh 命令 —— 不是 fork，不打包也不修改上游代码。

截图

| 一个窗口管所有事 | 自定义聊天背景 |
|---|---|
| 控制台 | Web 界面 |

为什么用它

傻瓜式操作，什么都不用记。 点开就自动启动服务、等它真正就绪、然后直接跳转 Web UI。不用背命令，不用输端口，也不用自己开浏览器。

- API key 只输一次。你在 Web UI 里填一次，之后由 dsh 保管；本工具（包括余额查询）直接复用那一份，不会再问你要。
- 随时知道花了多少。一启动就显示余额，后台还会在你烧钱时主动提醒。
- 关得干净。关掉窗口服务就真的没了，不会留个进程在后台偷偷占着端口。

能做什么

- 一个窗口 = 一个服务。启动后：显示余额 → 拉起服务 → 自动开浏览器 → 滚动日志。关窗口（或按 Control+C）即停止服务，不会留下占着端口的僵尸进程。
- 启动即看余额。开工前就知道现在还剩多少、这一轮花了多少。
- 超支提醒。后台每 10 分钟查一次：每消耗设定金额（默认 5 元）弹一条通知，并告诉你这笔钱用了多久；余额低于设定值（默认 10 元）提醒充值。
- 自定义背景。放一张图就能当聊天背景，并自动适配浅色/深色主题，保证文字清晰。

余额监控不依赖服务运行 —— 它直接查 DeepSeek API，服务关着也照常提醒。

文件都放在哪

本工具不改变 dsh 存放数据的方式 —— 会话和凭据仍在 dsh 自己的目录里。

| 路径 | 内容 | 归属 |
|---|---|---|
| ~/.dsh/sessions/ | 聊天记录，每个会话一份追加式日志，边聊边写 | dsh |
| ~/.dsh/.credentials.yaml | 你的 API key，只写 | dsh |
| ~/.dsh/settings.yaml | 模型与主题偏好 | dsh |
| ~/.dsh-launchpad/ | 本工具：配置、用量快照、外观、日志 | 本项目 |

因为记录是实时落盘的，停服务、崩溃、重启都不会丢历史对话，只有正在进行中的那一轮会被打断。

环境要求

- macOS 或 Linux
- Node.js —— 唯一的硬性依赖，dsh 本身由 npx 自动获取

| | macOS | Linux |
|---|---|---|
| 通知 | osascript（自带） | notify-send（libnotify） |
| 定时 | launchd（自带） | systemd 用户定时器，无则回退 cron |
| 端口检查 | lsof（自带） | lsof 或 ss |
| 图片压缩 | sips（自带） | ImageMagick（可选，没有就跳过） |

不需要 Homebrew 装包，不需要 jq，不需要 Python。

安装

git clone https://github.com/jovequli/dsh-launchpad.git
cd dsh-launchpad
./install.sh                        # 或： ./install.sh ~/图片/你的壁纸.jpg

会安装到 ~/.dsh-launchpad/，创建启动器，并注册后台监控。

然后：

1. 启动它（见下表）。
2. 在 Web UI 里进 Settings → Models，填入你的 DeepSeek API key。key 由 dsh 以只写方式存在 ~/.dsh/.credentials.yaml，本项目不会单独索取或保存你的 key。
3. 选一个工作区，开始使用。

使用

| 操作 | macOS | Linux |
|---|---|---|
| 启动 | 双击桌面的 DeepSeek.command | 从应用菜单打开 DeepSeek Harness，或运行 bash ~/.dsh-launchpad/console.sh |
| 停止 | 关掉窗口，或按 Control+C | 同左 |

窗口开着 = 服务在跑；关掉窗口 = 服务停止。 如果已有旧服务在运行，启动器会自动接管，保证同时只有一个。

停止服务不影响历史记录 —— 会话是实时写入硬盘的，存放在 ~/.dsh/sessions/。

macOS：首次双击可能提示"无法打开，因为无法验证开发者"。右键点该文件 → 打开 → 再点打开即可，只需一次。

Linux：部分桌面环境需要先把 .desktop 文件标记为可信（右键 → 允许启动）才能双击。

配置

改 ~/.dsh-launchpad/config.sh（下次启动生效，不用重装）：

PORT=3080              # Web UI 端口
WORKDIR="$HOME"        # dsh 启动时的工作目录
ALERT_STEP=5           # 每消耗多少提醒一次
ALERT_LOW=10           # 余额低于多少提醒
MONITOR_INTERVAL=600   # 后台检查间隔（秒）

只有改 MONITOR_INTERVAL 需要重跑 ./install.sh（要重新生成定时任务）。

自定义背景

把任意图片放到 ~/.dsh-launchpad/theme/bg.jpg，然后执行：

~/.dsh-launchpad/apply-theme.sh     # 然后刷新浏览器

想微调效果，改 ~/.dsh-launchpad/theme/custom.css：

--bg-fade-dark: 0.62;    /* 调小 = 图更鲜艳；调大 = 字更清楚 /
--bg-panel-alpha: 0.80;  / 设为 1 = 消息面板完全不透明 /
--bg-fade-light: 0.82;   / 浅色主题的遮罩 /

想还原成官方外观：~/.dsh-launchpad/apply-theme.sh --remove。

原理：dsh 的前端是静态文件，所以脚本把你的 CSS 和图片复制进去，再往 index.html 加一行 。有两个细节决定它能不能长期用下去：

- 只使用稳定选择器（body 和官方 --dsw-alias- 设计变量）。编译后的 class 名形如 _boot_9gj4p_6，带内容哈希，每次发版都会变，靠它写样式必然频繁失效。
- dsh 更新时 npx 会换一个新目录，自定义会被冲掉 —— 所以启动器每次启动都会幂等地重新注入一遍。

卸载

./uninstall.sh

会移除启动器、定时监控、自定义外观和 ~/.dsh-launchpad/。不会动 ~/.dsh/ —— 你的会话记录和 API key 都在那里。

说明

- DeepSeek Harness 目前是开发者预览版，迭代很快。如果将来前端结构大改，背景注入这部分可能需要跟着调整；其余功能只依赖公开的命令行接口。
- DeepSeek API 只提供当前余额，没有历史用量接口。"这笔钱用了多久"是靠本地快照算出来的。想看 token 级明细，请到 platform.deepseek.com/usage。
- 不支持 Windows。脚本依赖 POSIX shell 以及各平台的通知/定时工具，移植到 Windows 需要用 PowerShell 重写。WSL 下应该可以按 Linux 方式使用。

许可

MIT