Releases: Astra-Ursae-Majoris/Deepseek-Harness-Local-UI
Release list
DeepSeek Harness Local Desktop v0.3.1 (Python Full Desktop)
Release Notes — v0.3.1
DeepSeek Harness 本地桌面版(Deepseek-Harness-Local-UI)v0.3.1
🎉 本版亮点
Python 完整版桌面应用:Python 主程序 + 原生窗口加载完整 DSH Web GUI——界面效果与原版浏览器完全一致(Markdown 渲染、代码高亮、工具卡片、流式回复),并包含修改版的全部增强功能(对话大纲导航、回退到这一步、重新生成)。Python 负责服务管理、系统托盘、自动启动,PyInstaller 自编译 EXE 无 SmartScreen 拦截。
✨ 功能
- 🖥 原生窗口 + 完整 Web GUI:三栏布局(工作区 / 聊天 / 对话大纲导航),与原版浏览器体验完全一致;
- 🗂 对话大纲导航:完整加载全部轮次(首句摘要),点击定位 + 高亮,可收起;
- ↩️ 回退到这一步 / 🔄 重新生成:用户消息悬浮按钮,一键 fork 分支;
- 🚀 服务管家(Python 侧):自动检测 harness 并启动服务;
- 🪟 系统托盘常驻:关窗不退出(隐藏到托盘),托盘菜单:显示窗口 / 启动服务 / 停止服务 / 退出;
- 🔨 自编译 EXE:
build_exe.bat选 3(约 65MB),自己编译无 SmartScreen 拦截。
📦 使用方式
# 准备:Node.js ≥ 22.19 + pnpm ≥ 9 + Python ≥ 3.10
cd harness && pnpm install
echo DEEPSEEK_API_KEY=你的密钥 > harness/.env
# 方式一:直接运行(Python)
pip install pywebview pystray pillow
python desktop-py/dsh_app.py
# 方式二:自编译 EXE
cd desktop-py && build_exe.bat # 选 3 → dist/DSH-Desktop.exe🧩 与上游的关系
- 基于 DeepSeek Harness 官方提交
f98a57e二次开发; - 官方源码占比 ≈ 99.75%(≈ 742,000 行),本仓库修改净增 ≈ 0.25%(≈ 1,845 行),Python 客户端 / 桌面壳为独立新增代码;
- 全部代码遵循 MIT License:上游版权 © 2026 DeepSeek,修改与新增代码版权 © 2026 Astra-Ursae-Majoris;
- 详细占比、改动清单与法律声明见仓库 NOTICE.md。
🔒 安全说明
- 服务仅绑定
127.0.0.1,不对局域网开放; - API 密钥不落盘、不上传,仅读取环境变量 /
.env; - 停止服务时整棵进程树终止。
⚖️ 免责声明
本项目与 DeepSeek 公司无任何隶属、背书或合作关系;按 MIT 协议以「AS IS」提供,不附带任何担保。
欢迎 Star ⭐ / Issue / Fork。
DeepSeek Harness Local Desktop v0.3.0 (Python Full-UI)
Release Notes — v0.3.0
DeepSeek Harness 本地桌面版(Deepseek-Harness-Local-UI)v0.3.0
🎉 本版亮点
新增 Python 全量 UI 桌面版(desktop-py/dsh_app.py):用 Python 自绘的完整聊天应用,包含我们讨论过的全部功能——对话大纲导航、回退到这一步、重新生成、流式回复、服务管家,全部在一个原生窗口里,不依赖浏览器、不需要 Electron。
✨ 全量 UI 桌面版功能
- 💬 完整聊天界面:左侧会话列表 + 中间消息流 + 底部输入框(Enter 发送 / Shift+Enter 换行),回复流式打字机显示;
- 🗂 对话大纲导航栏:右侧常驻目录,完整加载全部轮次(首句摘要),点击任意轮次定位消息 + 高亮,支持收起;
- ↩️ 回退到这一步:用户消息悬浮按钮,在该轮之前 fork 分支并打开子会话;
- 🔄 重新生成:fork 后自动重发原消息;
- 🚀 服务管家:顶栏一键 启动 / 停止 / 重启服务,实时状态 + 版本显示;
- 📡 实时事件流:SSE 接收会话事件,流式回复实时刷新;
- 🔨 自编译 EXE:
build_exe.bat选 3,在自己电脑上编译(约 48MB),无 SmartScreen 拦截。
📦 使用方式
方式一:Python 全量 UI(推荐)
# 准备:Node.js ≥ 22.19 + pnpm ≥ 9 + Python ≥ 3.10
cd harness && pnpm install # DSH 依赖(一次)
echo DEEPSEEK_API_KEY=你的密钥 > harness/.env
pip install pywebview # 一次
python desktop-py/dsh_app.py # 启动全量 UI 桌面版方式二:自编译 EXE
cd desktop-py
build_exe.bat # 选 3 → dist/DSH-Desktop.exe(约 48MB,自己编译不被 SmartScreen 拦截)方式三:轻量启动器 / WebView / Electron
python desktop-py/dsh_launcher.py— 零依赖轻量启动器(浏览器打开);python desktop-py/dsh_webview.py— WebView 窗口版;- Electron 桌面壳源码保留在
src/(可选,自行构建)。
🧩 与上游的关系
- 基于 DeepSeek Harness 官方提交
f98a57e二次开发; - 官方源码占比 ≈ 99.75%(≈ 742,000 行),本仓库修改净增 ≈ 0.25%(≈ 1,845 行),Python 客户端 / 桌面壳为独立新增代码;
- 全部代码遵循 MIT License:上游版权 © 2026 DeepSeek,修改与新增代码版权 © 2026 Astra-Ursae-Majoris;
- 详细占比、改动清单与法律声明见仓库 NOTICE.md。
🔒 安全说明
- 服务仅绑定
127.0.0.1,不对局域网开放; - API 密钥不落盘、不上传,仅读取环境变量 /
.env; - 停止服务时整棵进程树终止。
⚖️ 免责声明
本项目与 DeepSeek 公司无任何隶属、背书或合作关系;按 MIT 协议以「AS IS」提供,不附带任何担保。
欢迎 Star ⭐ / Issue / Fork。
DeepSeek Harness Local Desktop v0.2.0 (Python Launcher)
Release Notes — v0.2.0
DeepSeek Harness 本地桌面版(Deepseek-Harness-Local-UI)v0.2.0
🎉 本版亮点
新增 Python 启动器(推荐方案):纯 Python 实现、零依赖、可自编译 EXE——彻底绕开 SmartScreen「无法验证发布者」问题(自己编译的 EXE 不会触发该拦截)。
📦 使用方式
方式一:Python 启动器(推荐)
# 0. 准备:Node.js ≥ 22.19 + pnpm ≥ 9 + Python ≥ 3.10
# 1. 安装 DSH 依赖(只需一次)
cd harness && pnpm install
echo DEEPSEEK_API_KEY=你的密钥 > harness/.env
# 2. 运行启动器(图形界面)
python desktop-py/dsh_launcher.py
# 点「🚀 启动服务」→「🌐 打开界面」方式二:自编译 EXE(可选)
cd desktop-py
build_exe.bat # 在自己电脑上编译,产物:dist/DSH-Desktop-Python.exe自己编译的 EXE 不会出现「无法验证发布者」提示,双击即用。
方式三:Electron 桌面壳(可选,源码保留)
src/ 目录保留 Electron 桌面壳源码,需自行 npm install && npm run build。对外分发 Electron EXE 需要商业代码签名证书。
✨ 功能特性
🐍 Python 启动器
- 纯 Python 标准库 + tkinter,零第三方依赖;
- 一键 启动 / 停止 / 重启 DSH 服务,实时状态显示;
- 一键打开系统浏览器访问 GUI;
- 自动检测 DSH 目录(
DSH_HOME→ 同级harness/→ 手动选择); - 设置记忆、中文界面、日志输出。
🔍 修改版 Web GUI 增强
- 对话大纲导航栏:右侧常驻目录,完整加载全部轮次(首句摘要),点击定位 + 高亮;窗口过窄自动收起;
- 回退到这一步 / 重新生成:用户消息悬浮按钮,一键 fork 分支或重发;
- 新增
session.outline服务端 RPC。
🖥 Electron 桌面壳(可选)
- 原生窗口、右键手势、快捷键屏蔽、文件拖放、托盘常驻、模型/密钥管理窗口。
🧩 与上游的关系
- 基于 DeepSeek Harness 官方提交
f98a57e二次开发; - 官方源码占比 ≈ 99.75%(≈ 742,000 行),本仓库修改净增 ≈ 0.25%(≈ 1,845 行),Python 启动器 / 桌面壳为独立新增代码;
- 全部代码遵循 MIT License:上游版权 © 2026 DeepSeek,修改与新增代码版权 © 2026 Astra-Ursae-Majoris;
- 详细占比、改动清单与法律声明见仓库 NOTICE.md。
🔒 安全说明
- 服务仅绑定
127.0.0.1,不对局域网开放; - API 密钥不落盘、不上传,仅读取环境变量 /
.env; - 停止服务时整棵进程树终止。
❓ 常见问题
- SmartScreen 提示「无法验证发布者」? → 用 Python 启动器(
python desktop-py/dsh_launcher.py)或自编译 EXE(build_exe.bat),不会触发该提示; - 找不到 DSH 目录? → 启动器里点「更改 DSH 目录…」选择
harness/; - 端口被占用? → 点「重启服务」自动接管;
- 服务重启后对话会丢吗? → 不会,数据持久化在会话存储中。
⚖️ 免责声明
本项目与 DeepSeek 公司无任何隶属、背书或合作关系;按 MIT 协议以「AS IS」提供,不附带任何担保。
欢迎 Star ⭐ / Issue / Fork。
DeepSeek Harness Local Desktop v0.1.3
Release Notes — v0.1.3
DeepSeek Harness 本地桌面版(Deepseek-Harness-Local-UI)首个公开发布
🎉 发布亮点
DeepSeek Harness 官方 Web GUI 的 Windows 桌面发行版:免命令行、免浏览器折腾,点按钮即可启动 / 停止 / 重启本地 DSH 服务,并附带修改版 GUI 的对话大纲导航与回退 / 重新生成能力。
📦 下载
| 文件 | 说明 |
|---|---|
DSH-Desktop-0.1.3-portable.exe |
便携版(推荐):免安装,双击即用,约 85 MB |
完整源码(含
harness/官方源码修改版)见仓库 Code → Download ZIP,或git clone。
✨ 新特性
🖥 桌面 EXE 壳
- 原生窗口加载本地 Web GUI(仅
127.0.0.1白名单); - 服务管家:一键 启动 / 停止 / 重启 DSH 服务,实时状态显示(运行中 / 已停止 / 异常);
- 托盘常驻:「保持服务后台运行并退出」后服务进程独立存活,下次打开秒进;
- 右键手势:按住右键左右拖动 = 收起 / 展开侧边栏(
Alt+← / →同效); - 快捷键屏蔽:不再被 Ctrl+T / Ctrl+W 等浏览器快捷键打扰;
- 文件拖放:拖入图片等文件获得真实文件路径;
- 模型 / API 密钥管理窗口:可视化配置(应用不存储密钥);
- 安装目录自动检测:
DSH_HOME→ 同级harness/→ 常见位置 → 手动选择; - 窗口状态记忆、单实例锁、完整安全策略(沙箱 / 权限拒绝 / 仅本机)。
🔍 修改版 Web GUI 增强
- 对话大纲导航栏:右侧常驻目录,完整加载全部轮次(首句摘要),点击定位 + 高亮提示;窗口过窄自动收起;
- 回退到这一步:任意用户消息一键 fork 分支并打开子会话;
- 重新生成:fork 后自动重发原消息;
- 新增
session.outline服务端 RPC(逐轮摘要,独立于窗口加载)。
🚀 快速开始
# 1. 准备环境(Windows 10/11 x64)
# Node.js ≥ 22.19 + pnpm ≥ 9
# 2. 安装 DSH 依赖(只需一次)
cd harness
pnpm install
# 3. 配置 API 密钥
echo DEEPSEEK_API_KEY=你的密钥 > .env
# 4. 回到仓库根目录,双击 release/DSH-Desktop-0.1.3-portable.exe
# 欢迎页点「🚀 启动服务」→ 自动进入聊天界面💡 也可以不用 EXE:
pnpm dsh web --host 127.0.0.1 --port 3080后用浏览器访问。
🧩 与上游的关系
- 基于 DeepSeek Harness 官方提交
f98a57e二次开发; - 官方源码占比 ≈ 99.75%(≈ 742,000 行),本仓库修改净增 ≈ 0.25%(≈ 1,845 行),桌面壳为独立新增代码;
- 全部代码遵循 MIT License:上游版权 © 2026 DeepSeek,修改与桌面壳版权 © 2026 Astra-Ursae-Majoris;
- 详细占比、改动清单与法律声明见仓库 NOTICE.md。
🔒 安全说明
- 仅允许加载
http://127.0.0.1:<端口>,外部链接交给系统浏览器; - 渲染进程沙箱 + 上下文隔离;摄像头 / 麦克风等权限一律拒绝;
- 服务仅绑定 127.0.0.1,不对局域网开放;
- API 密钥不落盘、不上传,仅读取环境变量 /
.env。
❓ 常见问题
- 找不到 DSH 安装目录? → 欢迎页「更改 DSH 安装位置」选择
harness/目录; - 端口被占用? → 点「重启服务」自动接管;
- 服务重启后对话会丢吗? → 不会,数据持久化在会话存储中;
- 需要联网吗? → 需要 DeepSeek API(对话推理),服务本身全在本机。
⚖️ 免责声明
本项目与 DeepSeek 公司无任何隶属、背书或合作关系;按 MIT 协议以「AS IS」提供,不附带任何担保。
欢迎 Star ⭐ / Issue / Fork。