dsh-desktop 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；暂不能直接安装（需源码编译或环境不满足）：仓库 package.json 标记 private，未发布到 npm，需从源码安装。

dsh-desktop 兼容性怎么样？

暂不能直接安装（需源码编译或环境不满足）：仓库 package.json 标记 private，未发布到 npm，需从源码安装。

dsh-desktop 有中文文档吗？

已提供中文翻译 README（由 DeepSeek 最新模型翻译生成），本站可切换中英文对照阅读。

dsh-desktop 还在维护吗？

GitHub 2 星。最近一次上游提交在 2026/9/12。

桌面客户端 Yuel25/dsh-desktop

DeepSeek Harnessv0.2.0

Yuel2552 天前有提交已提供中文文档扫描：含敏感能力

在 GitHub 查看 ↗

在 Windows 上以窗口方式启动并管理 DSH 服务

30.8/100

综合分

GitHub 星标

—

npm 周下载

—/5

用户评分

数据截至 2026/9/18 · 周下载取自 npm 全网（含 CI / 镜像），非本站安装数；综合分由星标、活跃度与兼容性检查合成。

自动兼容检查未通过：仓库 package.json 标记 private，未发布到 npm，需从源码安装。以下命令仍可尝试，但可能失败。

安装命令 · 需先装 dsh CLI 引擎

dsh plugin --profile web add Yuel25/dsh-desktop

该包不可直接 npm 安装，改从 GitHub 源安装（明细见下方安装检查）

状态速览

判定依据：实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态

信任档位：已验证

是什么

dsh 原生插件 · desktop

装得上吗

本站已在 dsh 0.2.1-rc.5 下真实安装成功

非静态推断

L5 · 运行时冒烟等级说明 →

安全吗

本站尚未对该插件做风险分级

暂未覆盖，不等同于无风险

还在维护吗

更新放缓：最近一次提交在 52 天前

档位由哪些信号合成

本站实装验证（真实安装 L4 覆盖全站；L5 为运行时冒烟或实机截图，覆盖范围小于 L4） · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。

验证判据与等级说明 →

社区实装还没有人打卡 · 装过的第一个就是你

安装兼容性检查需源码安装

仓库 package.json 标记 private，未发布到 npm，需从源码安装

展开查看检查明细 ↓

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。

✓npm 包dsh-desktop @ 0.2.0

✓Node 引擎要求 ^22.19.0 || >=24.0.0 · 基线 Node 22.19 满足

✓dsh CLI 依赖未声明 dsh 版本约束

✓入口文件main/exports/bin 已声明

源码安装时若 pnpm 拦截 prepare 脚本，按其提示在 pnpm-workspace.yaml 的 allowBuilds 中放行后重跑。

验证方式：npm registry 存在性 + package.json 静态校验 · 最后检查 2026/10/12 08:15:55

安全扫描自动 · 静态分析源码

v2.7.0

🔵 扫描：含敏感能力尚无人工评估

展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力：执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量（至少其一）。这是能力清单，不是危险判定——具体能力项与证据见下方，安装前请自行判断是否需要。

可执行外部命令读写/删除本地文件发起外部网络请求

查看扫描证据（共 31 处，展示前 27 条）

读取本地文件
src/main/config.ts:22
const parsed = JSON.parse(readFileSync(join(app.getPath('userData'), fileName), 'utf8')) as Record<string, unknown>
读取本地文件
src/main/config.ts:39
Object.assign(loaded, JSON.parse(readFileSync(settingsPath(), 'utf8')) as Partial<AppSettings>)
写入本地文件
src/main/config.ts:73
writeFileSync(temporary, `${JSON.stringify(appSettings, null, 2)}\n`, 'utf8')
写入本地文件
src/main/config.ts:74
renameSync(temporary, target)
删除本地文件
src/main/config.ts:78
try { unlinkSync(temporary) } catch { }
读取本地文件
src/main/config.ts:101
return readdirSync(root, { withFileTypes: true })
读取本地文件
src/main/config.ts:102
.filter((entry) => entry.isDirectory() && isValidProfileName(entry.name) && existsSync(join(root, entry.name, 'cordis.yml')))
读取本地文件
src/main/dsh.ts:210
if (powershellLauncher && existsSync(powershellLauncher)) {
读取本地文件
src/main/dsh.ts:228
if (cmdLauncher && existsSync(cmdLauncher)) {
发起网络请求
src/main/dsh.ts:409
? await mainWindow.webContents.session.fetch(url, {
执行外部命令来自配置/变量
src/main/dsh.ts:436
const child = spawn(plan.command, plan.args, {
执行外部命令来自配置/变量
src/main/dsh.ts:690
const child = spawn(plan.command, plan.args, {
读取本地文件
src/main/index.ts:232
const icon = readFileSync(appIconPath())
写入本地文件
src/main/logging.ts:25
mkdirSync(directory, { recursive: true })
读取本地文件
src/main/logging.ts:44
const entries = readdirSync(dir, { withFileTypes: true })
读取本地文件
src/main/logging.ts:52
const stats = statSync(filePath)
删除本地文件
src/main/logging.ts:69
unlinkSync(file.path)
读取本地文件
src/main/logging.ts:86
if (!existsSync(filePath)) return false
读取本地文件
src/main/logging.ts:87
const stats = statSync(filePath)
读取本地文件
src/main/logging.ts:100
if (existsSync(oldest)) {
删除本地文件
src/main/logging.ts:102
unlinkSync(oldest)
读取本地文件
src/main/logging.ts:112
if (existsSync(src)) {
写入本地文件
src/main/logging.ts:114
renameSync(src, dst)
写入本地文件
src/main/logging.ts:124
renameSync(filePath, firstBackup)
写入本地文件
src/main/logging.ts:153
await appendFile(filePath, chunk.subarray(offset, offset + length))
写入本地文件
src/main/logging.ts:184
writeFileSync(filePath, `[${timestamp}] ${redacted}\n`, { flag: 'a' })
发起网络请求
src/main/updater.ts:41
const response = await electronNet.fetch(UPDATE_FEED_URL, {

扫描于 2026/11/2（1 天前） · 范围入口闭包 + 全包扫描 · 来源 GitHub 仓库

静态扫描只反映源码中出现的调用，不构成安全背书；人工评估与自动扫描相互独立、互不覆盖。

给这个插件打分还没有人投票↓

用户评分

还没有人投票，来当第一个

广告精选好物

飞利浦 TAH6519 主动降噪耳机 ¥299

头戴式无线 anc 主动降噪，蓝牙连接，久戴舒适向。

·anc 主动降噪 · 头戴式无线
·价格与库存以商品页实时为准

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

Cursor、Claude Code、VS Code 逐个核对：能不能装、配置怎么写、装不上是什么原因。

·按客户端逐格核对
·结论标注依据与风险等级

查 MCP 兼容性→

功能亮点

管理DSH服务

DeepSeek Harness 的 Windows 桌面客户端。

README

由 DeepSeek 最新模型翻译生成

dsh-desktop 面向 Windows 的 DeepSeek Harness 桌面客户端。 English · 中文 [!IMPORTANT] 本项目是社区开发的非官方桌面客户端，与 DeepSeek 官方无隶属、背书或合作关系。功能 - 在无命令行窗口的情况下启动和管理 dsh web - 使用 Electron 窗口承载 DeepSeek Harness Web UI - 自定义无边框标题栏、系统托盘和单实例运行（标题栏显示当前 profile），托盘菜单保持精简 - 可从系统托盘安全重启桌面应用及其启动的 DSH 服务 - 可在设置中选择黑色或白色标题栏，并自动保存选择；启动页、加载动画和错误提示同步跟随该预设 - 可在设置中切换 DSH profile（扫描 ~/.dsh/profiles），切换时仅重启 DSH 服务 - 可为任意 profile 打开独立窗口，多个 profile 并行运行（各自使用独立端口） - 内置设置窗口：外观与语言、开机自启（可隐藏到托盘）、DSH 端口、profile 管理 - 内置日志查看器与「复制诊断信息」（应用版本、dsh 版本、当前 profile 等） - 启动时自动检查新版本，有新版本时托盘会出现下载入口并发系统通知 - DSH 服务或界面意外崩溃时自动恢复，并通过系统通知告知结果

展开完整文档（README 剩余 1 节）

dsh-desktop

面向 Windows 的 DeepSeek Harness 桌面客户端。

English · 中文

[!IMPORTANT]
本项目是社区开发的非官方桌面客户端，与 DeepSeek 官方无隶属、背书或合作关系。

功能

- 在无命令行窗口的情况下启动和管理 dsh web
- 使用 Electron 窗口承载 DeepSeek Harness Web UI
- 自定义无边框标题栏、系统托盘和单实例运行（标题栏显示当前 profile），托盘菜单保持精简
- 可从系统托盘安全重启桌面应用及其启动的 DSH 服务
- 可在设置中选择黑色或白色标题栏，并自动保存选择；启动页、加载动画和错误提示同步跟随该预设
- 可在设置中切换 DSH profile（扫描 ~/.dsh/profiles），切换时仅重启 DSH 服务
- 可为任意 profile 打开独立窗口，多个 profile 并行运行（各自使用独立端口）
- 内置设置窗口：外观与语言、开机自启（可隐藏到托盘）、DSH 端口、profile 管理
- 内置日志查看器与「复制诊断信息」（应用版本、dsh 版本、当前 profile 等）
- 启动时自动检查新版本，有新版本时托盘会出现下载入口并发系统通知
- DSH 服务或界面意外崩溃时自动恢复，并通过系统通知告知结果
- 检测已有的 127.0.0.1:3080 服务，识别其 profile 后再连接；不一致时会提示
- 未安装 dsh 时显示安装引导页，可一键重试或打开文档
- 界面与通知支持中英双语，可在设置中跟随系统或手动切换
- 关闭窗口后驻留托盘，退出时清理本应用启动的 DSH 进程
- 记录 DSH 标准输出和错误日志（主实例与各 profile 窗口分文件记录）
- 生成 Windows NSIS 安装包

当前状态

目前应用依赖：

- Windows x64
- 在 Windows 中安装并加入 PATH 的 DeepSeek Harness dsh 命令

应用尚未内置 DSH 运行时，而是启动 Windows 中现有的 DSH 安装。

快速开始

1. 在 Windows 中准备 DeepSeek Harness

npm install -g @deepseek-ai/dsh
dsh --version

如果需要社区 Web UI 插件，请先按插件自己的说明安装到 DSH 的 web profile。

2. 运行 dsh-desktop

从 GitHub Releases 下载 Windows 安装包，安装并启动。

如果 DSH 已经监听 127.0.0.1:3080，应用会识别其 profile 并连接现有实例（与所选 profile 不一致时会先询问）；否则应用会直接启动：

dsh --profile web --no-open

切换 profile

设置窗口的 Profile 区块会列出 ~/.dsh/profiles 下所有包含 cordis.yml 的子目录。选择后：

- 应用只重启自己管理的 DSH 进程，无需退出桌面应用；
- 选择会保存到用户数据目录的 settings.json，下次启动沿用；
- 如果端口被外部启动的 DSH 占用，应用无法替它切换 profile，会提示并保持原选择。

列表中每个非当前 profile 旁的「新窗口」按钮会为它启动一个独立的 DSH 实例（自动分配空闲端口）并打开独立窗口；关闭该窗口即结束对应的 DSH 进程。每个实例的日志单独记录为 dsh..stdout.log / dsh..stderr.log。

设置与诊断

托盘菜单只保留高频操作（打开、浏览器打开、设置、重启、退出），其余选项都在设置窗口中。设置窗口包含：

设置使用浅色侧栏导航，可按类别切换页面；标题栏颜色提供可视预览，并显示保存状态。窗口缩小时，导航和内容可独立滚动。

- 外观：标题栏黑/白与语言切换，即时生效；
- 启动：开机自启动（可选自启动时隐藏到托盘、后台拉起 DSH）、DSH 端口（重启应用后生效）；
- Profile：切换主窗口 profile，或为其他 profile 打开新窗口；
- 日志：内置查看器（dsh 输出、错误、恢复日志及各 profile 窗口日志），也可一键打开日志文件夹；
- 诊断：一键复制应用版本、dsh 版本、当前 profile、运行端口和配置端口等信息，方便反馈问题；
- 更新：手动检查新版本并打开发布页。启动时也会自动检查一次，有新版本时通过系统通知提醒。

DSH 输出日志在持续写入时按 5 MiB 轮转，每份日志最多保留 3 个历史文件；目录超过 50 MiB 时优先清理历史日志，保留活动日志。设置文件采用临时文件替换写入，保存失败会返回错误并恢复内存中的原配置，未保存的端口输入会保留。

本地开发

pnpm install
pnpm run dev

[!NOTE]
pnpm run dev 与 pnpm run preview 会在启动前自动调用 scripts/prepare-runtime.mjs 检查并准备 Electron 运行时。如处于网络受限环境，可配置 ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/"。亦可单独执行 pnpm run prepare:runtime 预先完成准备。

常用命令：

pnpm run prepare:runtime # 校验并准备 Electron 运行时
pnpm run typecheck # TypeScript 检查
pnpm run test # 运行自动化单元与生命周期测试
pnpm run build # 生产构建
pnpm run check # 类型检查 + 自动化测试 + 生产构建
pnpm run dist # 生成 Windows NSIS 安装包

构建产物位于 release/，该目录不会提交到 Git。

运行机制

Electron 主进程负责窗口、托盘和 DSH 子进程生命周期。启动时会先检查 127.0.0.1:3080：

1. 端口已存在且服务可用：通过监听进程的命令行识别其 profile，一致则连接现有 DSH，不取得该进程的所有权；不一致时提示用户选择。
2. 端口不可用：在 Windows 中启动 dsh --profile --no-open，并在应用退出时终止本应用启动的进程。
3. 后端就绪后：窗口从本地加载页切换到 DSH Web UI。

日志保存在 Electron 的用户日志目录。可从托盘菜单选择“查看日志”。

新版 DSH 启用浏览器认证时，桌面客户端会读取所启动实例输出的认证链接，自动完成认证；各 profile 窗口和自动恢复后的新实例分别使用对应链接。HTTP 401/403/404 不再视为就绪。若连接外部启动的 DSH 且桌面客户端尚未认证，请关闭外部实例后点击重试，由桌面客户端启动服务。

安全说明

- DSH Web UI 默认只绑定 127.0.0.1。
- Electron renderer 禁止 Node.js 集成并启用上下文隔离。
- 应用自身的桥接 API（如开机自启设置）只暴露给本地加载页，DSH Web 页面无法调用。
- 外部链接交给系统默认浏览器打开。
- 应用不会在卸载时删除 ~/.dsh 或 DSH 会话数据。

如发现安全问题，请参阅 SECURITY.md。

路线图

- DSH 运行时诊断界面
- 设置界面与运行时诊断
- 自动更新和签名发布
- 完善安装、升级、卸载测试

贡献

请阅读 CONTRIBUTING.md。提交更改前请运行 pnpm run check。

许可证与品牌资产

项目代码使用 MIT License。DeepSeek Harness 官网图标不属于 MIT 许可范围，详情见 THIRD_PARTY_NOTICES.md。