orca-cat（虎鲸猫）

A third-party system-tray launcher for the DeepSeek Harness on Windows. DeepSeek Harness 的 Windows 系统托盘启动器：双击启动服务、托盘常驻、一键彻底关闭。

Features / 功能

• 双击 OrcaCat.exe：后台拉起 DeepSeek Harness（dsh web）→ 服务就绪后自动打开浏览器页面 → 系统托盘常驻
• 关闭浏览器页面 不会停止服务，托盘图标保留，表示 Harness 仍在运行
• 托盘左键单击：重新打开页面
• 托盘右键菜单：「打开页面 / 打开日志 / 彻底关闭」（彻底关闭 = 结束 dsh 进程树并退出托盘程序）
• 单实例保护：重复双击只打开页面，不会重复启动服务
• 加载进度窗口：服务启动期间显示进度条与阶段提示（启动服务 → 等待网页就绪），就绪后自动打开浏览器；按 Esc 可跳过等待，服务仍会继续启动
• 图标内嵌于 exe 本体，复制/移动到任意目录均显示正确图标

Requirements / 环境要求

• Windows 10 / 11（内置 .NET Framework 4.8，无需安装任何运行时）
• DeepSeek Harness 已安装，dsh 命令可用；或使用下方的单文件安装器自动安装全部前置（推荐新用户）

Usage / 使用

直接双击 OrcaCat.exe，或创建桌面快捷方式。

可选命令行参数：

参数	说明	默认
--url <url>	打开的页面地址	http://127.0.0.1:3080
--port <port>	服务就绪探测端口	3080
--cmd <path>	指定 dsh 启动命令路径	自动发现

示例：

OrcaCat.exe --port 3080 --cmd "C:\path\to\dsh.cmd"

Installer / 安装器（单文件分发）

用户侧：拿到 OrcaCatSetup.exe 双击即可完成全部安装——内置 Node.js + DeepSeek Harness + 启动器 + 独立卸载器。每个组件可选「使用环境中的 xxx」（环境里有则直接用，没有则自动安装到系统环境：Node 弹出官方安装向导、DSH 装入 npm 全局）或「安装内置」（完全自包含），全程免管理员。

构建侧：运行 build_installer.cmd（Windows 10/11 自带 csc/tar/curl，无需额外工具链）生成单文件安装器 dist\OrcaCatSetup.exe（约 105–140 MB，含 node.msi 时为 140 MB）：

• 自动检测系统环境；每组件独立选择「使用环境中的」或「安装内置」，矛盾组合自动纠正
• 默认自包含安装到 %LOCALAPPDATA%\OrcaCat，全程免管理员、不改 PATH
• 安装后目录内留有独立 Uninstall.exe，只清理自家目录，不动系统环境与用户数据（~/.dsh 默认保留）
• 支持升级覆盖安装、开始菜单/桌面快捷方式（可选项）、安装完成自动启动（可选项）

设计文档见 docs/INSTALLER_DESIGN.md，启动器交接文档见 docs/DESIGN.md。

Build / 编译（可选，开发用）

无需 .NET SDK：build.cmd 调用 Windows 内置的 csc.exe（.NET Framework 4.8 自带），从 OrcaCat.cs 编译出 OrcaCat.exe，图标由同目录 icon.ico 嵌入。

运行时产生的文件

在 exe 同目录下自动生成：

• dsh.log — dsh 启动输出日志（出问题时可通过托盘右键「打开日志」查看）
• crash.log — 崩溃诊断日志

License

MIT © 2026 sjkenterprise