DeepSeek HarnessHub
Submit plugin

xxccdl/deepseek-harness-desktop--plugins-deepseek-ai-dsh-client-ui-quickchat ↗★ 3

@deepseek-ai/dsh-client-ui-quickchat

Quick chat glass panel: Ctrl+D+S opens a modern frosted-glass mini dialog over the app — 4 agent-preset modes (Standard / PTC / Minimal / Creator), send to the current session, and a task list with per-session mini conversations 适合需快速向当前会话提问或管理任务的用户，桌面端使用。

Agent collaborationInterface extensionsProductivity
Package
@deepseek-ai/dsh-client-ui-quickchat
Compatibility
Unverified
Harness peer range
^0.1.0-rc.6
Cordis peer range
^4.0.1
Version
0.1.0-rc.6
License
NOASSERTION
Last updated
Sep 13, 2026

Other repositories with this package name

Install

This plugin has no verified bundle, or compatibility checks failed. Read the repository notes first. Read the full README ↗

README

Read the full README ↗

DeepSeek Harness — Desktop

简体中文 · English

把 deepseek-harness 的 Web 界面 (dsh web) 打包成原生 Electron 桌面应用，并在其基础上扩展了一整套桌面向能力： 电脑控制、浏览器自动化、长期记忆、定时任务、快捷对话、插件市场、桌宠等。

开源说明（版权）：上游 deepseek-harness 由 DeepSeek 于 2026 年以 MIT 许可发布。 本仓库为桌面 fork，桌面壳层与新增桌面插件由 xxccdl 于 2026 年补充，沿用 MIT。 详见 LICENSE 与 LICENSE-THIRD-PARTY。

目录

它是怎么运行的

与网页版完全相同的 harness 在应用进程内部启动（无需浏览器、无需单独的 CLI 进程）：

  • 主进程通过 @deepseek-ai/dsh-app-boot 的稳定 API 挂载 web profile 的 cordis 组合 （与 dsh web 完全相同的 bundle 层 + 用户 patch 层）
  • harness 服务器绑定在操作系统分配的随机 loopback 端口（仅本机可访问）
  • BrowserWindow 直接加载该端口上的 SPA；window.__DSH_BOOT__ 仍由服务端 index-tap 注入，前端代码零改动
  • 退出时自动 dispose harness 树，干净落盘会话状态

会话、设置、凭据与网页版完全共享，都在 %USERPROFILE%\.dsh（即 $DSH_HOME）。

功能总览

领域能力
桌面壳无边框窗口、自定义标题栏、托盘、开机自启、老板键、全局呼出、单实例、窗口状态恢复
快捷对话Ctrl+D+S 全局呼出玻璃拟态 mini 对话，4 种智能体模式 + 任务列表
AI 工具电脑控制、浏览器、记忆、通知/定时、剪贴板、文件搜索、网页抓取、视觉、片段、产物交付等
电脑控制经 Windows-MCP 让 AI 看屏幕、点按、输入；自带 uv 与隔离 Python 运行时
浏览器自动化经 CDP 驱动 Edge/Chrome：导航、点击、输入、截图、执行 JS
长期记忆remember/recall 等工具 + 设置里的文字/KV/思维导图查看器
通知与定时任务开始/完成系统通知、可重复定时任务、remind 延时提醒、/btw 插话
用量花费token 花费估算 + DeepSeek 实时余额血条、token 构成统计条
界面增强Ctrl+K 会话搜索、F1 快捷键帮助、剪贴板历史、Markdown 导出、代码块工具栏、Mermaid
插件市场应用内浏览/安装/卸载插件与技能，创造模式一键发布
其它世界时钟、桌宠、底部控制面板 + 共享 PowerShell、GitHub 自动更新、会话日志导出

桌面壳层

  • 无边框窗口 + 自定义标题栏：无原生边框；标题栏由 preload 注入（左侧标题/拖拽区， 右侧自定义最小化、最大化/还原、关闭按钮）。双击标题栏切换最大化，按钮图标随状态切换； 标题栏参与文档流（body 为 flex 列），SPA 自动缩进剩余高度，内容永不被遮挡
  • 系统托盘：可最小化到托盘而不退出；托盘菜单含「显示主窗口 / 退出」
  • 开机自启：设置里一键开关（写入系统登录项）
  • 老板键 Ctrl+Alt+B：立即隐藏整个应用，再按恢复（可在设置里关闭）
  • 全局呼出热键：可自定义的全局快捷键，任何界面下都能把主窗口唤到前台
  • 快捷对话三键和弦 Ctrl+D+S：由底层键盘钩子实现（globalShortcut 无法表达三键）， 且保证单独按 Ctrl+S 不会误触发
  • 单实例锁：二次启动自动聚焦已有窗口
  • 窗口状态恢复：位置、尺寸、最大化状态在重启后还原
  • 菜单：Edit（撤销/剪贴板，Web 输入框可用）、View（重载/DevTools/缩放/全屏）、 Help（打开 $DSH_HOME、打开 web profile 目录、关于）；按 Alt 临时唤出菜单栏
  • 外部链接：target=_blank 与站外导航自动交给系统浏览器
  • 原生通知：harness 的 dsh/notify 事件走 Windows 系统通知，并可按事件播放提示音
  • 剪贴板监听：后台监听剪贴板，为 Ctrl+Shift+V 历史面板提供数据
  • 缩放：Ctrl + / - / 0 放大、缩小、重置界面
  • preload bridge：SPA 通过 window.dshDesktop 调用 getAppInfo() / getServerUrl() / openExternal() / showItemInFolder() / openPath() 等白名单 API（沙箱开启）

快捷对话（Ctrl+D+S）

Ctrl+D+S 在任何界面（即使主窗口未聚焦）呼出一个脱离主窗口的玻璃拟态 mini 对话面板， 主窗口完全不受打扰：

  • 4 种智能体模式：标准（Standard）/ PTC / 极简（Minimal）/ 创造（Creator）
  • 消息发送到当前会话，可随时收起
  • 任务列表页：查看后台任务，每个会话都有独立的迷你对话

AI 对话与工具

除了 harness 自带的读写文件、跑命令、子智能体等能力，本 fork 额外注册了一批模型可调用的工具：

工具（包）作用
电脑控制（dsh-tool-computer-use）经 Windows-MCP 操控整台 Windows PC
浏览器（dsh-tool-browser）经 CDP 自动化 Edge/Chrome
记忆（dsh-tool-memory）remember / recall / list / forget 长期记忆
通知/定时（dsh-tool-notify）任务开始/完成通知、可重复定时任务
提醒（dsh-tool-remind）remind：N 分钟后弹一条桌面通知
剪贴板（dsh-tool-clipboard）clipboard_read / clipboard_write 读写系统剪贴板
文件搜索（dsh-tool-filesearch）file_name_search：目录内递归文件名快速搜索（忽略 node_modules/.git）
网页抓取（dsh-tool-webfetch）web_fetch：取 URL 正文纯文本（去脚本样式、折叠空白、限长）
视觉（dsh-tool-vision）用 DeepSeek 视觉模型分析图片或屏幕截图
持久 PowerShell（dsh-tool-pwsh-persistent）按会话归属的常驻 PowerShell，与底部面板共用同一个 PTY
片段（dsh-tool-snippets）snippet_save/list/get/delete，与 UI 选择器共用一个库
产物交付（dsh-tool-deliver）send_file 把文件放进交付目录并通知，界面出现「产物」标签可一键保存
市场发布（dsh-tool-plugin-market）plugin_publish / ask-publish-plugin（仅创造模式）
手机控制（dsh-tool-phone）移动端：读屏、点击/滑动/输入/按键/滚动/打开 App

其它对话能力：

  • /btw 插话：在 AI 正在干活时问一个附带问题，不打断当前任务（作为下一步上下文排队）
  • 多模态图片：截图/图片可直接作为图片发给视觉模型；模型「图像输入」能力可在 设置 → 模型里手动开关或修正
  • 会话日志导出：会话工具栏溢出菜单里可把整段会话导出下载
  • 底部控制面板：抽屉式面板展示智能体实时动作（后台任务、子智能体）与共享 PowerShell 终端；会话头部右侧工具条；含 DeepSeek 高峰/低谷电价提示

电脑控制

让 AI 能像人一样操作这台 Windows 电脑（基于 Windows-MCP）：

  • AI 可以看屏幕、读取界面元素、点击、输入、滚动、按键等
  • 自带运行时，开箱即用：用打包的 uv 在 $DSH_HOME/runtime 下建立隔离的 Python 环境 （windows-mcp-venv），不污染系统 Python
  • 设置页「电脑控制」：开关功能、选择 Python 版本/包、配置提示词提醒、查看实时状态、 一键重建运行时
  • 对应 AI 工具在 dsh-tool-computer-use

浏览器自动化

经 Chrome DevTools Protocol 驱动本机 Edge / Chrome：

  • AI 可执行导航、点击、填写、截图、执行 JS 等网页操作
  • 设置页「浏览器控制」：选择浏览器与端口、是否无头（headless）、启动/停止/测试被控浏览器
  • 状态通过 /api/browser 暴露

长期记忆

AI 拥有跨会话的长期记忆：

  • 模型工具：remember（记住）/ recall（回想）/ list / forget
  • 持久化在 $DSH_HOME/memory/memory.jsonl，并附带一个记忆技能引导模型何时使用
  • 设置页「记忆」：以文字、键值（KV）、思维导图三种视图浏览记忆，数据来自 dsh-tool-memory 的 /api/memory

通知与定时任务

  • 任务通知：AI 开始 / 完成长任务时弹 Windows 系统通知（可带提示音），不必盯着窗口
  • 定时任务：设置页「定时任务」管理 AI 开始/完成通知与用户自定义的可重复计划任务 （可附带要执行的命令）
  • 延时提醒：AI 用 remind 工具安排「N 分钟后提醒我」
  • 移动端另有 dsh-mobile-bridge 把通知转发到 Android 系统通知（后台也能收到）

用量与花费

  • 侧栏预算血条：左下角（设置上方）一条紧凑的「已用 / 余额」条
    • 已用：回放会话事件，按 DeepSeek（deepseek-chat 等）价格估算人民币花费
    • 余额：实时查询 DeepSeek /user/balance
    • 余额查询失败会在 tooltip 说明原因；提供方无余额接口时只显示花费，不会把未上报的余额显示成 ¥0.00
  • token 构成统计条：输入框上方的统计条按 token 构成着色——缓存命中（绿）/ 新增输入（蓝）/ 缓存写入（琥珀）/ 输出（中性），宽度比例即真实用量；悬停面板给出完整统计
  • 设置页「统计」：花费与余额、会话数（总计/进行中/今日）、当前会话的消息数与工具调用数

界面增强

dsh-client-ui-enhance 提供一组纯前端增强：

  • Ctrl+K 会话搜索：模糊搜索并快速跳转会话（键盘上下选、回车跳）
  • F1 快捷键帮助：所有快捷键与代码块操作一览
  • Ctrl+Shift+V 剪贴板历史：在输入框里呼出历史，选一条最近复制的内容插入
  • Ctrl+E Markdown 导出：把当前会话导出为 Markdown 文件
  • 代码块工具栏：悬停代码块显示「复制 / 保存为文件 / 折叠长代码」
  • Mermaid 渲染：mermaid 代码块自动渲染成流程图/图表，可切回源码
  • 所有弹层配色跟随系统的深/浅主题

快捷片段（Ctrl+/）

dsh-client-ui-snippets：

  • Ctrl+/ 呼出快捷片段选择器，把保存好的提示词/代码片段插入输入框
  • 可把当前草稿存成片段，也可删除旧片段
  • 与 AI 的 snippet_* 工具共用同一个片段库（/api/snippets），人和模型都能读写

世界时钟

dsh-client-ui-world-clock（在插件市场可安装，纯前端零依赖）：

  • 侧栏底部（设置旁）常驻秒级本机时间，窄栏显示简版
  • 点击展开世界时钟面板：多城市实时对照、真实 IANA 时区与 UTC 偏移、跨日自动标注 昨天/明天，外加 5 / 15 / 25 分钟倒计时

桌宠

dsh-client-ui-desktop-pet：界面右下角一只可拖拽的蓝色小鲸鱼，会漂浮眨眼、跟你说话、 按心情切换表情；设置页「桌宠」可配置。

插件市场

一个自托管的插件/技能商店：在应用内浏览、安装、卸载，或让 AI 把刚写好的插件/技能一键发布。

部分路径职责
服务端plugin-market/目录 API + 商店页面（默认 9009 端口），独立部署
商店界面dsh-client-ui-market应用内市场窗口（iframe 承载商店页面）
宿主桥dsh-host-plugin-market校验/落盘/热挂载，/api/market/* 四条路由
AI 工具dsh-tool-plugin-marketplugin_publish 与 ask-publish-plugin（仅创造模式）

两种类型：

  • 插件（plugin）：含 package.json 与 JS 入口，安装后加载代码
  • 技能（skill）：只含 SKILL.md（YAML frontmatter 描述 name/description），不加载代码； 安装即把目录放进 $DSH_HOME/skills，出现在技能列表（/ 可查看）

安装：下载 → 服务端逐项校验（包名、入口、每个 .js 过 node --check、禁止 npm 依赖）→ 写入 profile 的 patch 层（$DSH_HOME/profiles/ /cordis.patch.yml）并经 loader 热挂载， 界面部分刷新即可见。任一步失败都整体回滚，不影响正在运行的应用。

卸载：详情抽屉与「管理」弹窗都提供卸载，两段式确认（首点变为「确认卸载？」， 2.6 秒内再点才执行）；宿主桥摘掉 patch 行、卸载运行时条目并删除目录。

发布：创造模式里 AI 写完插件/技能后调用 ask-publish-plugin 询问，输入框上方出现发布条， 可选**版本号、类型（插件/技能/自动判断）**并填更新说明；用户确认后 AI 才调用 plugin_publish 真正发布。也可以直接调接口或用脚本：

curl -X POST http:///api/plugins \
  -H "X-Market-Meta: $(echo -n '{"title":"我的插件","category":"开发工具"}' | base64 -w0)" \
  --data-binary @my-plugin.tgz

# 或
node plugin-market/tools/publish.mjs  --market http:// [--token ]

部署服务端：

node plugin-market/server.js   # env: MARKET_PORT(9009) / MARKET_DATA(./data) / MARKET_ADMIN_TOKEN

挂载说明：dsh-client-ui-world-clock 目前经市场分发（未写进默认组合，装完即用）； 想让它开箱常驻，可把它加进 dsh-web-app 的 patch 层。

更新器

dsh-client-ui-updater（仅 Electron 桌面端）：

  • 设置页「更新」检查 GitHub Releases、阅读更新日志
  • 50 线程并行加速下载安装器并安装（不自动后台更新，需手动确认）

设置页一览

设置分区内容
通用（general）外壳、版本公告、通用偏好
模型（models）凭据与模型管理、模型「图像输入」开关
统计（stats）花费/余额、会话数、当前会话消息与工具统计
记忆（memory）文字 / KV / 思维导图三种记忆视图
电脑控制（computer-use）Windows-MCP 开关、Python 运行时、重建
浏览器控制（browser）被控浏览器选择、端口、无头、启停/测试
桌面（desktop）托盘、开机自启、全局显示/隐藏热键
定时任务（scheduler）任务通知与可重复计划任务
桌宠（desktop-pet）桌宠开关与配置
更新（updater）检查更新、更新日志、下载安装
插件（上游）已装插件清单与管理

首次启动还有欢迎向导（API Key 实时校验、功能导览、快捷键速查），完成状态持久化； 设置里的「使用教程」可随时重跑向导。

快捷键一览

快捷键作用范围
Ctrl D S呼出/隐藏快捷对话 mini 面板全局（底层键盘钩子）
Ctrl Alt B老板键：立即隐藏/恢复应用全局（可关闭）
Ctrl K快速搜索并跳转会话应用内
F1快捷键帮助应用内
Ctrl Shift V剪贴板历史（输入框内插入）应用内
Ctrl E导出当前会话为 Markdown应用内
Ctrl /快捷片段选择器应用内
Ctrl + / - / 0界面缩放 放大/缩小/重置应用内
双击标题栏最大化/还原窗口
Alt临时唤出菜单栏窗口
悬停代码块复制 / 保存为文件 / 折叠对话

数据存放位置

所有用户数据都在 $DSH_HOME（Windows 下即 %USERPROFILE%\.dsh）：

路径内容
$DSH_HOME/memory/memory.jsonl长期记忆
$DSH_HOME/skills//从市场安装的技能（SKILL.md）
`$DSH_HOME/profiles/
/cordis.patch.yml`用户 patch 层（市场安装的插件在此登记）
$DSH_HOME/plugin-market.json插件市场状态（已装列表、令牌、市场地址）
$DSH_HOME/runtime/电脑控制的 uv 与隔离 Python 运行时
$DSH_HOME/plugin-market-backup/安装/更新时的备份
附件存储内容寻址的本地附件目录（dsh-attachment-local）
产物交付/deliver/（send_file 落位，界面可一键保存）

复现 / 构建

npm install
# 把 plugins/@deepseek-ai/* 覆盖到 node_modules/@deepseek-ai/（替换/新增对应包），
# 并在 $DSH_HOME/profiles/node_modules 下建立 junction
node scripts/install-plugins.mjs
npm start

computer-use 运行时：电脑控制需要 uv（仅打包时读取）。从 https://github.com/astral-sh/uv/releases 下载 uv-x86_64-pc-windows-msvc.zip， 解压后把 uv.exe 放到 resources/runtime/uv/uv.exe（该目录不入库）。

打包 Windows 安装包：

npm run dist          # NSIS 安装器 + portable 单文件 exe（输出到 dist/）
npm run dist:portable # 仅 portable exe

国内网络先设置镜像：

$env:ELECTRON_MIRROR = "https://npmmirror.com/mirrors/electron/"
$env:ELECTRON_BUILDER_BINARIES_MIRROR = "https://npmmirror.com/mirrors/electron-builder-binaries/"

若不想让 electron-builder 尝试发布到 GitHub，构建时加 --publish never。

仓库结构

本仓库不包含 node_modules（约 671MB，npm install 后生成）。

src/main.js               Electron 主进程：进程内 boot harness + 窗口/菜单/托盘/热键/生命周期
src/preload.cjs           contextBridge 桥（沙箱开启，仅白名单 API）
src/quickchat-hotkey.cjs  Ctrl+D+S 三键和弦的底层键盘钩子
src/quickchat.html        快捷对话 mini 面板页面
src/splash.html           启动开屏页
src/update-downloader.mjs 多线程并行加速的安装器下载器
resources/icon.svg        应用图标源（DeepSeek 鲸鱼）
scripts/                  图标生成、插件同步安装、发布与各类验证脚本
plugins/@deepseek-ai/     本 fork 新增/修改的 dsh 插件（复制进 node_modules 使用）
plugin-market/            插件市场服务端（独立部署，不参与打包）

plugins/@deepseek-ai/ 里既有本 fork 新增的插件，也有修改过的上游包完整副本 （如 dsh-client-ui-sidebar、dsh-client-ui-settings-general、dsh-web-app、dsh-base 等）。

工作原理（为什么不需要改前端）

dsh web 的本质是：挂载 @deepseek-ai/dsh-base + @deepseek-ai/dsh-web-app 两个 bundle 的 patch 层，由 dsh-host-webserver 监听 127.0.0.1，由 dsh-host-frontend-static 托管 @deepseek-ai/dsh-web-frontend/dist 并在每个 index 响应里注入 window.__DSH_BOOT__（client 插件清单）。桌面版复用同一套 composition，只是：

  • 用 boot() + provideCmdline() 在 Electron 主进程内挂载，传 --port 0 让系统分配端口， 再从 ctx.webServer.port 读回实际端口
  • 原生模块（sharp/koffi/node-pty 等）全部是 N-API，在 Electron 的 Node 上无需重编译
  • node:sqlite（会话搜索）在 Electron 43+ 内置的 Node 24 中已可用
  • 打包时 node_modules 全部 asarUnpack：harness 的模块回退机制会把 $DSH_HOME/profiles/node_modules 的 junction 指向真实目录——指向 asar 虚拟文件系统的 junction 无法被原生模块解析（会导致 __DSH_BOOT__ 空清单，UI 报 “Failed to load plugins”）