桌面客户端 yhfgyyf/dsh-app

dsh-app

独立的 DeepSeek Harness 桌面应用，支持 macOS Apple Silicon、Windows x64 和银河麒麟龙芯。当前桌面版 0.1.45 支持 DSH 0.2.2-alpha.2，持续跟进 DSH 上游版本。

应用内置 Node.js 与 DSH 核心，使用独立 Electron 主进程、React 入口和 Cordis 组装。无需预先启动 DSH Web。会话、模型、工具、审批和附件复用 DSH 的核心服务及功能组件。

v0.1.45：适配 DSH 0.2.2 Alpha 通道

适配 DSH 0.2.2-alpha.2，截至 2026-10-30 为 0.2.2 Alpha 通道最新版。官方同日另发布 0.2.1-rc.5（RC 通道）；本安装包采用已验证的 0.2.2-alpha.2。v0.1.45 Release 同时提供 Mac Apple Silicon、Windows x64 和麒麟 V10 LoongArch64 旧 ABI 安装包。

- 统一原生引用：框选聊天文字只显示「引用文本到主会话」和「在侧边聊天中提问」，使用原生引用节点及原文预览；已有侧聊直接复用，引用不会自动发送。侧聊需单独安装 dsh-side-chat 0.1.6。
- 独立内容搜索：Ctrl+S / Command+S 搜索当前对话、侧聊或文件；浮窗不挤占内容布局，Ctrl+F / Command+F 继续搜索左侧会话。
- 启动修复：修复 macOS 初始化未完成时再次激活窗口的竞态，以及 Windows 缓存端口被拒绝时的恢复。
- 麒麟修订 2：请使用 DSH-Desktop-0.1.45-2-Kylin-V10-loongarch64.deb，修复 node-addon-require-builtin 遗漏。系统包版本为 0.1.45-2，App 界面版本仍为 0.1.45。

Mac 已完成实际安装与界面验证；Windows 通过原生 CI 及最终 EXE 安装、更新、卸载验证。麒麟最终 DEB 已在真实 LoongArch Node22.16 的 QEMU 仿真中通过 101 个必需依赖、Worker、Host 冷启动/重启和会话持久化验证，未做麒麟真机 Chromium 图形界面测试。Mac 为 ad-hoc 签名且未公证，Windows 未签名；麒麟继续使用 Electron31.7.7 / Node22.16 的旧 ABI 移植，低于内核官方 Node>=24.9 的要求。完整范围和 SHA-256 见 Release。

安装包包含匿名 local-plugins/package.json，不预装 P2P、Side、Univer 等用户扩展，也不删除用户已安装的插件与配置。麒麟原生依赖的来源、补丁和启动门禁见 旧 ABI 构建说明。

v0.1.44：DSH 0.2.2-alpha.2

适配新版独立 Native/PTC 工具执行器、按步骤的工具可用性和会话观察接口。更新 Auto、Audit、Progressive Tools、TUI 的兼容补丁；已有用户扩展需使用对应兼容版，安装包保留匿名本地插件目录且不预装用户扩展。麒麟 V10 旧 ABI 的 Node 运行时需单独验证。

v0.1.43：独立内容搜索浮窗

Ctrl+S / Command+S 在应用上方打开独立的非模态搜索浮窗，不再将搜索框嵌入主对话或右侧面板，也不添加页面占位。主对话、侧聊、文件和原生网页预览的布局与尺寸保持不变；搜索仍作用于当前选中的面板。Enter / Shift+Enter 跳转，Esc 关闭，原有 Ctrl+F / Command+F 继续搜索左侧会话。

v0.1.42：紧凑搜索框与选文原文预览

内容搜索框缩小至当前面板右上角。点击输入框中的「@选中内容」即可查看原文；长文先显示开头片段，可展开或收起全文，预览不会修改或发送草稿。侧聊插件继续使用 0.1.5，已有侧聊仍直接追加引用。

v0.1.41：选文引用与当前内容搜索

选中主对话或 /side 中的文字后，可以「添加到主对话」或「在侧边聊天中提问」。选文作为引用片段加入原生输入框，保留已有草稿与附件，确认发送前不调用模型。侧聊入口需要启用 dsh-side-chat 0.1.5；它与 /side 使用同一个临时会话，关闭后重新打开仍是新的空侧聊。

点击或聚焦主对话、右侧文件或 /side 后，按 Windows/Linux Ctrl+S、macOS Command+S 搜索当前面板已载入的文字。匹配内容会高亮，Enter / Shift+Enter 跳转，Esc 关闭。原有 Ctrl+F / Command+F 继续查找左侧会话。

dsh-p2p-collab 0.1.3（未发布）

手机远程控制入口移至「插件 → dsh-p2p-collab」详情，可设置中继地址、注册码、扫码绑定和解绑手机。详情页沿用官方插件的表单、按钮与开关；插件关闭时仍可配置和进行局域网配对。协作空间仅在插件启用且中继已注册时显示，解除注册后收起；现有手机连接方式与后台运行行为不变。

v0.1.32：手机预览、下载共享、终端与语音输入

Android 0.12.5-dsh.4 按文件格式预览：Office 在电脑转换为 PDF，手机翻页查看；GIF 保留动画，音视频分块下载到手机私有缓存播放。文件可保存到手机或通过系统分享面板共享原件。控制权限的手机可使用电脑上的交互终端。单次语音录音交给电脑本地模型转写，结束后自动发送文字；可取消，切换会话或进入后台会停止本次语音输入。

v0.1.31 修复：手机连接稳定性

修复扫码后任务状态订阅被误拒绝、导致整条 WebSocket 反复断开的问题。单个被拒绝的订阅现在只返回该订阅的错误，其他会话继续连接；Android 0.12.4-dsh.3 同时将隧道网络异常转为界面错误，避免闪退。已有绑定可继续使用。

v0.1.30 更新：扫码绑定手机

- 管理连接集中显示中继注册、一次性扫码和手机绑定状态，按钮与「编辑快捷键」一致。
- 同一局域网无需中继即可扫码；注册中继后，手机自动优先直连并在需要时回退中继。手机无需输入账号密码或手工连接参数。
- 两端均可解绑，离线撤销会保留并同步。手机侧栏显示远程主机、地球标记及切换/解绑入口。
- 关闭窗口默认继续运行：Windows/麒麟托盘、macOS Dock 与菜单栏。应用菜单「退出」才停止 Host。

构建、配对及中继升级说明见 远程接入说明。

v0.1.28 更新：DSH 0.2.0-rc.1 与全平台语音输入

- DSH 0.2.0-rc.1：适配新版核心，保留标准、PTC、极简、创造、自动和审计预设及本地插件兼容修复。
- 全平台语音输入：macOS、Windows、银河麒麟均支持在 DSH 对话输入框录音并转为文字。修复系统已授权、App 仍拒绝麦克风请求的问题。
- Mac / Windows：使用 Electron 44.4.5，macOS 最低要求 13；支持 Browser Use 和 Computer Use。
- 银河麒麟龙芯：保留 Electron 31.7.7 和 Node 22.16.0 的旧 ABI 环境，新增不依赖 SIMD 的离线语音识别库，随包附带 SenseVoiceSmall INT8 和 Silero VAD 模型。

历史 v0.1.28 Release 发布 Windows 和麒麟安装包及校验信息；macOS 可从当前源码构建。麒麟新版已通过构建主机测试和安装包校验，尚待龙芯实机验证；Browser Use、Computer Use 目前仅在 macOS / Windows 提供，麒麟可使用独立的侧边栏网页预览。

v0.1.12 预览版更新

本次补齐 侧边栏常见文件预览，并修复 Windows 文本编码和文件路径兼容问题。

- 标题栏精简：移除 Windows 和 macOS App 右上角的「运行状态」图标。
- Office 本地预览：Word DOCX 的正文、图片和表格，PowerPoint PPTX 的页面，以及 Excel XLS/XLSX 多工作表；同时支持 ODS、CSV、TSV 等表格格式。
- Windows TXT 修复：兼容 UTF-8、UTF-16LE/BE 和 GBK/GB18030；可手动选择 Big5、Windows-1252 等编码。支持中文、空格、盘符大小写和工作区外的文件路径。
- 图片与音视频：补充 BMP、ICO、AVIF，以及 MP3、WAV、FLAC、MP4、WebM 等本地预览与播放控件，保留现有 PDF、HTML/Canvas、SVG、Markdown 和代码预览。
- 清楚的格式边界：旧版 DOC/PPT 提示另存为 DOCX/PPTX/PDF；损坏、加密或超出限制的文件显示具体提示。

Office 文件在本机解析。Word/PowerPoint 的预览禁用联网资源和外部链接，复杂排版、字体、动画及部分图表可能与 Office 有差异。表格显示已保存的单元格内容，不重算公式或执行宏，预览范围为前 200 行、40 列、100 个工作表。完整内容可通过「在本地打开」查看。完整文件预览上限为 32 MiB，表格为 25 MiB；音视频还取决于系统内置解码器。

v0.1.10 预览版更新

本次重点更新 Computer Use（电脑操作）功能，改善坐标定位、原生输入和操作后的画面反馈。

- 更可靠的电脑操作坐标：统一按完整截图（含标题栏）的 0–1 相对坐标定位；窗口移动或缩放后拒绝旧坐标，重新观察后继续。
- macOS 原生输入修复：前台点击同步真实光标，避免重新激活窗口后把快捷键送到错误区域；前台长文本输入期间失焦会中止后续文本，粘贴前核验剪贴板内容。真实光标同步修复适用于 macOS 原生驱动。
- 操作后及时核对：窗口操作默认返回新截图和观察编号；实时画中画不抢占当前应用的键盘焦点，可随时停止操作。
- 升级内置核心：内置 DSH 0.1.5-rc.1，迁移并校验本地兼容补丁，保留会话写锁、工具调用一致性检查及 Web/TUI 共享能力。
- 修复源码预览：HTML 文件的「源码」按钮直接显示文本；手动选择其他查看方式后，切换标签或重新加载仍保留选择。

界面预览

DSH Desktop 主界面，工作区和会话信息已模糊处理

工作区名称和会话信息已模糊处理，模型名称保留显示。

下载与使用

从 GitHub Releases 下载对应版本：

| 平台 | 安装包 | 安装方式 |
| macOS 13+ Apple Silicon | DSH-Desktop--macOS-arm64.zip | 解压，将 DSH Desktop.app 放入应用程序目录 |
| Windows 10/11 x64 | DSH-Desktop--Windows-x64-Setup.exe | 运行安装程序，默认按当前用户安装，无需管理员权限 |
| 银河麒麟 V10 SP1 龙芯（旧 ABI、glibc 2.28） | DSH-Desktop-*-Kylin-V10-loongarch64.deb | 按 Release 附带的麒麟安装说明手动安装；不提供应用内自动更新 |

打开应用，在「设置 → 模型」配置提供方与密钥，选择工作区并创建会话。已有 DSH 用户直接沿用 ~/.dsh 中的配置；Windows 默认对应 %USERPROFILE%\.dsh。安装包内已包含运行所需的 Node 和 DSH，无需另外安装。
每次 Release 都提供 SHA256SUMS.txt。macOS 从 v0.1.1 起使用完整的 ad-hoc 签名，尚未使用 Apple Developer ID 签名或公证。首次打开若被阻止，先关闭提示，再到“系统设置 → 隐私与安全性”找到 DSH Desktop，点击“仍要打开”，按系统要求确认；参见 Apple 官方说明。v0.1.0 的 Mac 包存在签名缺陷，请重新下载 v0.1.1 或更新版本。

Windows 安装包尚未代码签名，系统可能要求确认来源。Windows 卸载会移除程序，保留 DSH 会话和用户配置。

从 v0.1.2 起，macOS / Windows App 自动检测本仓库已发布的 GitHub Release（包含预览版）。发现新版后，标题栏出现小更新图标，点击即开始下载；校验完成后再次点击图标重启安装。安装前请等待当前任务完成；会话、配置和旧版 App 备份会保留。设置中的“桌面应用”可选择“每次打开 App 检查一次”（默认）或“每日定时检查一次”，每日模式在 App 运行时按本地时间执行。v0.1.1 及更早版本需要手动安装一次新版。

更新下载使用系统代理。安装失败后可直接重试安装，复用已校验的下载包。macOS 若从只读临时目录运行，更新器会在用户的 ~/Applications 中保留旧版副本并安装新版；原位置的 App 保留。

Windows 从 v0.1.6 起将旧安装目录整体保留在相邻备份目录，再安装和启动新版，避免旧版 DLL 仍被占用时覆盖失败。安装失败会恢复旧目录并重新打开应用。使用旧版更新器遇到无法重启时，请手动安装一次新版。

能力

- macOS、Windows、银河麒麟三平台语音输入，支持录音转文字；各平台准备和验证范围见下文。
- macOS / Windows 提供 Browser Use 与 Computer Use，开关位于设置中。
- 工作区与会话列表、历史、重命名、分支、删除、搜索、日志导出。
- 流式文本、推理、Markdown、代码、工具详情、图片与 MP4 附件。
- 模型提供方配置、权限审批、计划、目标、问答、工作流与子代理。
- 标准、PTC、极简、创造、自动、审计预设；模型推理强度单独设置。
- 原生菜单、文件/目录选择、下载保存、缩放、窗口状态和核心异常恢复。
- 会话网页链接在右侧浏览器标签打开；文件侧栏支持 Office、表格、文本、代码、Markdown、HTML／Canvas、SVG、图片、PDF 和常见音视频预览。
- 回复中的已有文件路径可点击打开，图片提供缩略图；关闭最后一个文件或网页标签后，右侧栏自动收起。
- 聊天与右侧栏支持选中文字后右键复制，输入框提供剪切、粘贴、撤销与全选。
- “在本地打开”使用系统默认应用打开右侧当前文件；菜单可选择其他应用、在文件夹中显示、选择文件或文件夹。没有当前文件时弹出文件选择器，工作区文件夹作为单独菜单项保留。

Desktop 0.1.45 内置 DSH 0.2.2-alpha.2、Auto Router 0.2.4、Audit 0.6.1 和 Progressive Tools 0.3.2，包含这些插件针对新核心的兼容补丁。TUI 0.2.0 用于跨端兼容测试，单独安装到 DSH 的 TUI profile。具体 Git 提交固定在 依赖清单。

部分能力依赖所选模型或外部工具：MP4 需要提供方支持 video_url；Audit 的 Codex / Claude Code 后端需要对应 CLI，也可配置 DSH 模型后端。安装包不包含模型账号、密钥或这些外部 CLI。

与 Web / TUI 共享

App、Web 和 TUI 可共用同一个 DSH_HOME，默认 ~/.dsh。会话、附件、工作区和 API 凭据在这里保存。DSH 0.1.7 的模型与界面设置改为按 profile 保存；App 首次启动会导入旧设置并保留原件，此后各 profile 的设置独立。App 自己的 profile、窗口与端口状态位于系统 Application Support / AppData 下的 DSH Desktop 目录。

Codex 登录通过 DSH 自己的授权服务保存到共享凭据文件，过期令牌由现有提供方自动刷新。Web/TUI 的安装步骤见构建说明。TUI 使用 /login openai-codex，远程终端可加 --device；/auth 查看状态，/logout openai-codex 退出。授权输入不会作为聊天提交或进入输入历史。

使用官方会话生命周期锁：同一会话同时只有一个进程可以写入。其他端尝试恢复、修改或删除占用中的会话会收到占用错误；持有端退出后可以接手。切换页面不保证释放会话，跨进程实时跟随活动流也不属于当前功能。

本地补丁提供删除、MP4 和部分旧事件兼容，没有替换官方会话写锁，也没有放宽工具调用一致性校验。旧日志如已损坏，仍可能需要单独修复。补丁及其校验清单位于 patches。

升级到核心 0.2 时，App 会备份并迁移 profile 中显式引用的旧 DeepSeek 插件名，保留模型与密钥配置。第三方插件须通过新版兼容性检查；不会自动豁免不兼容插件。旧会话读取可能生成新的 V4 日志文件，原日志保留，因此降级时应使用升级前备份。

Univer Office 插件升级

DSH 0.2.2-alpha.2 检查第三方插件兼容性；升级 App 不会替换用户独立安装的插件。v0.1.45 Release 附带 dsh-univer-office-0.3.5-universal.2.tgz 兼容包，声明适配当前内核，并保留 telemetry: false 默认值及 right 对齐修复。

通过“设置 → 插件市场 → 手动添加”安装 .tgz，然后完整退出并重启 App。该包为本项目基于官方 0.3.5 的兼容构建，不是上游 npm 新版本；兼容层源码见 universal overlay。插件单独提供，不预装进 App。

全平台语音输入

macOS、Windows 和银河麒麟均提供 DSH App 内的语音输入：点击对话输入框的录音按钮，授予系统麦克风权限，录音结束后点击“停止并识别”，检查并编辑转写文字后再发送。

| 平台 | 本地识别方式 | 模型准备与验证范围 |
| macOS Apple Silicon | 官方 SenseVoice 本地识别 | 首次按界面提示准备模型；本机实际录音和合成语音识别已验证 |
| Windows x64 | 官方 SenseVoice 本地识别 | 首次按界面提示准备模型；模拟设备录音、权限隔离及安装测试通过，真实麦克风需在用户电脑验证 |
| 银河麒麟 V10 SP1 龙芯 | SenseVoice INT8 + Silero VAD，标量 WebAssembly 单线程识别 | 模型随包提供，首次使用也无需外网；缺失或损坏时明确报错。构建主机验证通过，龙芯实机的录音、识别和性能待验证 |

DSH 仅允许当前 App 主文档请求麦克风，不授予摄像头、嵌入网页或其他窗口媒体权限。若无法录音，检查系统麦克风权限、输入设备与 App 版本，并在更改权限后重启 DSH。麒麟的离线验收命令、KYSEC 安装步骤及回退方式见 安装说明。

浏览器操作（Browser Use）

macOS 和 Windows 在“设置 → 通用设置”中提供 Browser Use 开关，位于“电脑操作”下方，默认关闭。后端继续使用 Playwright MCP，通过 Microsoft 官方 Playwright 扩展 接入本机 Chrome（没有 Chrome 时使用 Edge），沿用该浏览器已有的登录状态，无需另装 Python 服务。默认在首次操作时由用户在扩展页面授权并选择标签页；不同会话使用各自的标签页组。关闭 Browser Use 会断开 DSH 连接，原浏览器登录状态保留。开关状态随 App 重启保留。

首次使用前，请在所选浏览器中安装并启用扩展。每次调用都会检查扩展是否已安装，缺少时立即提示安装地址；安装后可直接重试。若旧版已经因缺少扩展进入连接超时，请在安装扩展后完全退出并重开 DSH，清除尚未完成的连接。

需要跳过连接确认页时，点击同一行的“自动连接”，粘贴扩展提供的 PLAYWRIGHT_MCP_EXTENSION_TOKEN（也支持完整的环境变量行），保存后重启 App。保存令牌代表允许 DSH 自动连接浏览器并使用已有登录会话。令牌通过系统加密存储单独保存在本机，不写入普通偏好设置，也不会回传给设置页面或进入对话；没有可用的系统加密时拒绝保存。清除令牌后重启 App，即恢复手动确认。更改在重启后生效，以免中断正在运行的会话。

开启后新建或重新打开会话，AI 可导航网页、填写表单、点击和截图。关闭开关会卸载浏览器工具并关闭其浏览器连接。右侧网页预览可继续单独使用。

电脑操作

目前在 macOS 和 Windows 提供，银河麒麟尚未适配。

先打开设置或标题栏显示器图标中的“电脑操作”开关；App 自动检查并申请系统权限，权限齐全且功能启动成功后开关才显示开启。
手动开启开关即允许电脑操作，后续任务不再逐次弹窗确认；此开关独立于文件／命令审批模式。关闭开关会立即停止操作，模型不能自行开启。
选定窗口后会显示实时画中画，可隐藏、从电脑操作菜单重新打开，或随时点击“立即停止”。画中画不会抢占键盘焦点，任务结束后自动关闭。
窗口操作默认返回新截图和新的观察编号，供模型核对实际效果。生成桌面应用文件时，模型会先检查已有窗口、保留已有文档，再打开保存后的结果核对视图、颜色和画面范围。
截图坐标统一使用完整截图的 0–1 相对值，包含标题栏；画中画截图不会改变操作截图的坐标比例。窗口移动或缩放后，旧坐标会被拒绝，需要重新观察。操作结果区分输入投递与重新观察，画面变化仍需结合实际目标核对。
macOS 前台键盘输入可先用坐标定位编辑区域；前台坐标点击会在严格窗口校验内同步真实光标，避免窗口重新激活后按旧光标位置分发快捷键。后续快捷键和输入省略坐标及控件目标，以保留当前选区；长文本输入期间如果焦点离开目标窗口，会中止后续输入。type_text 的 method="paste" 模式支持需要粘贴的编辑器：替换系统剪贴板、读回核验后，向指定窗口发送粘贴快捷键。输入报错后先重新观察实际内容，不按字符计数盲目补发。
全局停止快捷键为 macOS ⌘ + Option + Shift + Esc、Windows Ctrl + Alt + Shift + Esc。

macOS 首次使用需为 DSH Desktop 授予辅助功能和屏幕录制权限。
当前 macOS 测试包使用 ad-hoc 签名，升级后可能需要重新授权。如果系统设置显示已开启，App 开关却无法开启或系统提示签名不匹配，请按升级后的权限检查与恢复处理；重新启动或签名校验通过本身不能证明原授权仍然有效。

给其他用户分发并保留更新后的权限，需要使用固定开发者团队的 Developer ID 签名与 Apple 公证。参见正式签名、历史授权迁移和构建命令。
截图操作需要支持图片的模型，例如 deepseek-v4-flash-vision-exp；纯文本模型可读取窗口的辅助功能树。
工具支持应用/窗口查找、截图、控件点击、输入、快捷键、滚动和拖动。
一次只允许一个会话操作桌面，完成、取消、锁屏或退出 App 后释放占用。
Windows 需要已登录的交互桌面；锁屏和 UAC 安全桌面不能操作。整屏截图目前对应主显示器，其他显示器上的应用可按窗口观察。

从源码构建

当前 main 源码为 Desktop 0.1.45，内置 DSH 0.2.2-alpha.2，包含三平台语音适配与兼容补丁。下面的标准构建命令用于 macOS / Windows；麒麟使用独立的旧 ABI 环境，离线语音构建与固定来源见 麒麟语音适配，安装使用 Release 的 .deb 及随包说明。

需要 Git、Node.js 24.15.0 与 npm：

npm ci
npm run setup:runtime
npm run check
npm start

setup:runtime 下载指定 DSH 版本与固定提交的插件，检查并应用补丁，生成独立 .runtime。不会读取或复制用户的 DSH 配置、凭据和会话。

npm run package # macOS：需要 Swift 和 iconutilbash
npm run package:windows # Windows x64：需要 Inno Setup 7

Windows 上也可以在仓库的 Actions 页面手动运行 Build Windows installer，它会依次执行检查、跨端测试、打包、静默安装、启动、退出和卸载验证，完成后可下载构建产物。

详情：构建说明 · 架构 · 测试 · 第三方声明。

这是独立项目，并非 DeepSeek 或 OpenAI 官方产品。