dsh-desktop-tools

DeepSeek Harness 桌面端 + 插件社区 + Agent 社区 三件套 让 dsh(DeepSeek Harness)更好用:托盘常驻的桌面端、Web 里的插件商城、270 个开源中文 Agent 预设

---

📦 项目组成

子项目	目录	是什么	运行位置
DSH 桌面端	desktop-app/	Windows 托盘常驻 + 一键拉起 dsh 服务 + 掉线自愈	Windows 桌面
插件社区	plugin-store/	Web 设置页独立栏:浏览本机 186 个官方插件 + 社区插件 + 一键安装	dsh Web 客户端
Agent 社区	agent-store/	Web 设置页独立栏:270 个开源中文角色预设,详细描述 + 一键安装	dsh Web 客户端

三者独立可装:桌面端是独立 exe;两个插件装进 dsh 的 web profile,作为「设置」侧边栏的独立入口。

---

🚀 快速开始

1. 安装 DSH 桌面端(Windows)

1. 编译:desktop-app/ 里有 C# 源码,用 .NET Framework 4.x 编译(或直接下载 Releases 里的 exe)
2. 双击运行 → 托盘出现黑色鲸鱼图标
3. 首次启动:自动检测 dsh 服务(端口 3080),未运行则自动拉起;自动打开 Chrome/Edge 独立窗口
4. 可选:config.ini 放 exe 同目录,自定义工作目录与启动命令(见下方「配置」)

2. 安装插件社区 + Agent 社区

# 在 dsh 项目根目录执行
dsh plugin --profile web add ./plugin-store
dsh plugin --profile web add ./agent-store
# agent-store 首次使用前需生成预设数据(需网络):
node agent-store/scripts/fetch-presets.js

装完后重启 dsh web,打开界面 → 左下角设置 → 侧边栏出现:

• 插件社区 —— 本机已装插件 + 社区插件,一键安装
• Agent 社区 —— 270 个中文角色预设,一键安装/卸载

---

🖥️ DSH 桌面端(desktop-app/)

功能

• 托盘常驻:黑鲸鱼图标(官方 DeepSeek 标志),常驻系统托盘
• 自动拉起服务:端口未开时自动在配置的工作目录启动 dsh
• 掉线自愈:每 8 秒检测服务,挂了自动重启 + 气泡提醒
• 开机自启:托盘菜单一键开关(写入注册表 HKCU Run)
• 独立窗口:Chrome 优先 / Edge 兜底,--app 模式(无地址栏,像原生应用)
• 窗口复用:已开窗口时点击菜单只聚焦,不重复开

编译(Windows,无任何依赖)

csc /nologo /target:winexe /codepage:65001 /win32icon:whale.ico ^
  /out:DSH桌面端.exe /r:System.Windows.Forms.dll /r:System.Drawing.dll ^
  DshDesktop.cs PluginStoreForm.cs PluginZh.cs CommunityPlugins.cs

需要 .NET Framework 4.x(Windows 10/11 自带)

配置(config.ini,放 exe 同目录)

[dsh]
workdir=E:\path\to\your\dsh\project     ; dsh 项目目录(默认 E:\DeepSeekHarness)
startcmd=npx.cmd @deepseek-ai/dsh web    ; 启动命令(默认同上,可自定义)

技术说明

• 纯 C# WinForms,单文件 exe,零外部依赖(不需要装 Electron/Node)
• 日志:%TEMP%\dsh-desktop.log
• 图标:官方 favicon.svg 渲染 → 白底去背 → 多尺寸 ico

---

🛒 插件社区(plugin-store/)

功能

• 本机已装:扫描 profile + npx 缓存里的 186 个官方插件,中文描述(自动提取官方 README.zh.md),分类徽章(界面/工具/客户端/核心/框架)
• 社区发现:内置 32 个精选社区插件(人工中文翻译),在线刷新拉取 npm registry
• 一键安装:后台执行 dsh plugin --profile web add <包名>,完成弹窗提示
• 自装收纳:你手动装的插件带橙色「自装」徽章,分类下拉可单独筛选
• 仓库跳转:每个插件可打开 npm 页面

安装

dsh plugin --profile web add ./plugin-store
# 重启 dsh web → 设置 → 插件社区

API(host 端,/api/plugin-store/)

接口	方法	说明
/installed	GET	本机已装插件(含分类/描述/source)
/community	GET	社区插件(内置 + 缓存)
/refresh	POST	在线刷新 npm 社区列表
/install	POST	一键安装(body: {name})
/install-status	GET	安装任务状态

文件结构

plugin-store/
├── lib/
│   ├── index.js        # host 端:API 路由 + 扫描 + 安装
│   ├── client.js       # 浏览器端:注册 settings.section + React UI
│   └── zh-map.json     # 官方插件中文描述(自动生成)
├── package.json        # dsh.client.inject 声明
└── cordis.patch.yml    # 注册进 web profile

---

🤖 Agent 社区(agent-store/)

功能

• 270 个开源中文角色预设:代码审查员/安全渗透测试员/小红书运营专家/抖音策略师/Unity 开发者…22 大分类
• 详细描述:每个预设展示完整说明(角色定位、擅长领域),不是一句话摘要
• 一键安装/卸载:安装 = 复制到 ~/.dsh/.agent-presets/<id>/,立即生效(新会话可用)
• 分类筛选 + 搜索:22 分类彩色徽章 + 关键词过滤
• 仓库跳转:每个预设可打开 GitHub 源仓库对应目录
• 自定义预设友好:你手写的预设不会被误认为商城安装,单独提示

首次使用:生成预设数据

预设本体(5.7MB / 270 个)不在仓库里,运行脚本从源仓库拉取:

node agent-store/scripts/fetch-presets.js
# 生成 presets/ 目录 + lib/presets.json

安装

dsh plugin --profile web add ./agent-store
# 重启 dsh web → 设置 → Agent 社区

API(host 端,/api/agent-store/)

接口	方法	说明
/store	GET	全部预设(含分类/描述/repo/已装状态)
/installed	GET	已安装预设(仅商城安装的)
/install	POST	安装(body: {id})
/uninstall	POST	卸载(body: {id})

安装后的使用

1. 在 Agent 社区点「安装」
2. 刷新/重启后,打开 设置 → Agent 预设
3. 选择你安装的预设 → 新会话即以该角色运行

---

🔗 参考与致谢

本项目参考、借鉴、数据源自以下开源项目与文档:

项目	用途
deepseek-ai/deepseek-harness	dsh 本体;插件开发基于其官方扩展机制(settings.section / settings.plugins.tab slot、webServer 路由、client __ModuleLoader__)
dsh-skill-manager	插件结构模板:host JSON API + client 注册设置栏的完整范式
MoreChanger/dsh-agent-presets	Agent 社区的数据源:270 个开源中文角色预设(MIT)
dsh 官方插件包 @deepseek-ai/dsh-client-ui-settings	设置页 slot 契约(slots.d.ts)与注册规范
dsh 官方 README.zh.md 合集	插件中文描述的自动提取来源
npm registry	社区插件在线发现数据源

许可

• 本项目代码:MIT
• Agent 预设数据:源自 MoreChanger/dsh-agent-presets(MIT)
• 黑鲸鱼图标:来自 dsh 官方 favicon.svg(版权归 DeepSeek)

---

🧪 测试情况(2026-08-14)

• ✅ 桌面端:托盘/自启/掉线自愈/Chrome+Edge 窗口实测通过
• ✅ 插件社区:186 官方 + 32 社区扫描、分类、搜索、一键安装(dsh-email 实测安装成功)
• ✅ Agent 社区:270 预设加载、分类、安装/卸载、仓库跳转实测通过
• ✅ 重启脚本:restart-dsh.ps1 支持 -DryRun 干跑,已实测完整重启

⚠️ 已知限制

• 桌面端工作目录默认 E:\DeepSeekHarness,换机器请用 config.ini 配置
• 一键安装依赖 npx 与网络;安装后需刷新/重启 web 才生效
• Agent 社区预设数据需联网生成(脚本一次即可,之后离线可用)
• 插件安装后需在「设置 → 插件」中启用开关