Skip to content

Releases: Astra-Ursae-Majoris/Deepseek-Harness-Local-UI

DeepSeek Harness Local Desktop v0.3.1 (Python Full Desktop)

Choose a tag to compare

@Astra-Ursae-Majoris Astra-Ursae-Majoris released this 15 Aug 02:52

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 并启动服务;
  • 🪟 系统托盘常驻:关窗不退出(隐藏到托盘),托盘菜单:显示窗口 / 启动服务 / 停止服务 / 退出;
  • 🔨 自编译 EXEbuild_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)

Choose a tag to compare

@Astra-Ursae-Majoris Astra-Ursae-Majoris released this 15 Aug 02:07

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 接收会话事件,流式回复实时刷新;
  • 🔨 自编译 EXEbuild_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)

Choose a tag to compare

@Astra-Ursae-Majoris Astra-Ursae-Majoris released this 15 Aug 01:46

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

Choose a tag to compare

@Astra-Ursae-Majoris Astra-Ursae-Majoris released this 14 Aug 15:23

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。