DeepSeek Harness 服务管理器

当前版本：v1.1.1 ｜ 更新记录见 CHANGELOG.md

一个轻量桌面工具（单文件 exe，无任何依赖），用来一键管理本机的 DeepSeek Harness（dsh web）服务。 浅色/深色/跟随系统三种主题，标准原生窗口（原生最小化/最大化/关闭与动画），带系统托盘常驻，图标为 DeepSeek 官方鲸鱼 Logo。

快速开始

双击桌面上的 「DeepSeek Harness 启动器」 快捷方式即可打开管理器。

核心功能

• 服务状态总览：运行中 / 已停止 / 启动中 / 端口被占用 / 错误，自动每 2 秒探测； 显示 PID、端口、启动时间、内存占用。
• 一键操作：启动 / 停止 / 重启 / 打开浏览器 / 复制访问地址。
• 多实例管理：左侧列表可添加多个实例（不同端口/地址），右键编辑或删除。
• 日志查看器：实时滚动显示服务输出，按级别着色（错误红 / 警告黄），一键打开日志文件夹。
• 看门狗：实例意外退出后自动重启（按实例开关）。
• 系统托盘：最小化到托盘常驻，托盘菜单可启停服务、双击打开主界面。
• 自检诊断：检测 node / dsh 版本与路径、DSH_HOME、给出启动命令（含局域网访问提示）。
• 开机自启动：登录后最小化到托盘（可开关）。
• 明暗主题：浅色 / 深色 / 跟随系统 三档切换，设置页一键循环。

命令行（可选，供脚本/自动化）

# 环境自检
DeepSeek-Harness-Manager.exe --cli doctor

# 查询 3080 端口状态（退出码 0 = 运行中）
DeepSeek-Harness-Manager.exe --cli status --port 3080

# 启动 / 停止 / 重启（例如 3099 端口，不会打开浏览器）
DeepSeek-Harness-Manager.exe --cli start --port 3099
DeepSeek-Harness-Manager.exe --cli stop  --port 3099

文件说明

运行要求（分享给他人时）

• Windows 10/11（.NET Framework 4.8 系统自带，无需额外安装）。
• 不需要安装 Node.js：分享包已自带便携版 Node（runtime\node），管理器优先使用。
• 兼容各种 dsh 安装方式（自动识别，无需配置）：
  • 命令行安装（npx @deepseek-ai/dsh）：自动从 PATH / npm 缓存找到；
  • 源码仓库本地运行（如 git clone deepseek-ai/DeepSeek-Harness 后运行）： 管理器会从正在运行的实例自动反查其 node 与 dsh 路径并记住，停止后也能用原路径重启；
  • 均找不到时，「诊断」页可手动指定 node.exe / dsh 入口路径，或点「一键安装 dsh」（需联网一次）。
• 首次运行会在程序所在目录自动创建 config.json 与 logs\，请把程序放在可写目录 （如桌面、D 盘），不要放 Program Files。
• 自签名说明与 SmartScreen 处理见 dist\数字签名说明.md。

打包分享（dist\ 目录）

便携版解压后直接运行 DeepSeek-Harness-Manager.exe；安装版双击 Setup 按向导安装即可。

版本约定

每次功能或修复变更：递增版本号（Manager.cs 与 tools\Setup.cs 中的 AssemblyVersion/AssemblyFileVersion 同步修改），并在 CHANGELOG.md 顶部补充说明； 重建后按标准流程重新打包并签名。

从源码构建（仓库克隆后）

# 需要：Windows + .NET Framework 4.8（系统自带）+ 首次联网（下载便携 Node，约 34MB）
powershell -ExecutionPolicy Bypass -File build.ps1

仓库结构

发布二进制请使用 GitHub Releases（dist/ 已 gitignore，不进入仓库）。

常见问题

• 端口被占用：状态显示「端口被占用」并给出占用进程 PID；可先关闭占用程序， 或新建一个实例换端口。
• 首次启动较慢：dsh web 首次运行需解析依赖，最坏约 90 秒，管理器会自动等待。
• 局域网访问：默认只监听 127.0.0.1。如需从其他设备访问，在「诊断」页复制 dsh web --host 0.0.0.0 --port <端口> --trusted-host <设备IP> 命令启动。
• 关闭窗口：默认最小化到托盘（不会退出）；设置页可改为「关闭即退出」。 彻底退出请用托盘菜单「退出」。