dsh-deepseek-launcher

Readme

# DeepSeekLauncher

<img src="assets/icon.png" width="220" alt="蓝发人物与空白对话框启动器图标" />

为 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 提供 macOS 桌面入口。双击 **DeepSeek Harness.app**，启动本地 Web 服务并使用 **Google Chrome** 打开 `http://127.0.0.1:3080`；服务已经运行时直接复用。

这是社区启动器，需要事先安装 DeepSeek Harness 和 Chrome，不包含模型、API Key 或用户配置。

## 下载与安装

从 [GitHub Releases](https://github.com/wangzhuoyuan229-source/DeepSeekLauncher/releases/latest) 下载 `DeepSeek-Harness-macOS-1.0.0.zip`，解压后把应用放入 `~/Applications`，双击启动。也可以从源码构建并安装，安装脚本会创建桌面入口：

```bash
git clone https://github.com/wangzhuoyuan229-source/DeepSeekLauncher.git
cd DeepSeekLauncher
bash scripts/build-macos.sh
bash scripts/install-macos.sh
```

依赖 macOS 自带的 `osacompile`、`sips`、`iconutil`、`codesign`。应用使用 ad-hoc 签名，未进行 Apple 公证；下载版本可能需要在 Finder 中右键选择“打开”。

启动器从 `PATH`、`/opt/homebrew/bin` 和 `/usr/local/bin` 查找 `dsh`。请先在终端确认 `dsh web --no-open` 能正常启动。默认端口固定为 `3080`，最多等待 30 秒，不更改已有 profile、插件或凭证。

## DeepSeekHarness 插件安装

本仓库也提供 skill bundle，安装后可以让 Harness 根据技能创建或更新本机启动器。安装 bundle 本身不会自动运行安装脚本。

```bash
dsh plugin --profile web add github:wangzhuoyuan229-source/DeepSeekLauncher
```

之后向 Harness 提出：“使用 deepseek-launcher-macos 技能安装桌面启动器。”技能会从包内源码构建并安装同一个应用。只支持 macOS。

## 验证

```bash
python3 -m unittest discover -s tests -v
bash -n src/launcher.command scripts/build-macos.sh scripts/install-macos.sh
bash scripts/build-macos.sh
codesign --verify --deep --strict "dist/DeepSeek Harness.app"
```

自动测试覆盖服务复用、冷启动等待、缺少 dsh、启动超时和 Chrome 启动失败。实际验收记录见 [docs/acceptance.md](docs/acceptance.md)。

图标由用户提供的图片编辑而成：保留人物和空白对话框，去除背景与水印。编辑说明见 [docs/icon-edit.md](docs/icon-edit.md)。