官方对话与 Agent
Session、Agent、Tool、Skill、MCP、设置与历史由 DSH 自己管理，没有第二套 Chat 页面，也不维护私有前端分叉。
DSH Desktop 插件集成版 · v0.1.9 · 基于 DeepSeek Harness 0.1.1-rc.2
把官方 DSH Web、社区插件
和桌面能力，装进一个开箱即用的应用
DSH Desktop 直接运行官方 DSH npm 运行时与官方 Web，并预装一组经过固定与验证的社区 Bundle。 对话、文件、Git、终端、任务、Worktree 与插件市场，都运行在同一个 DSH Profile 中—— 不用先搭环境、找插件或维护另一套插件状态。
- SIGNEDDeveloper ID 签名 + Apple 公证
- OFFLINE-INIT新 Profile 离线初始化
- SINGLE-PROFILE官方 Profile 单一权威
- RECOVERABLE出错进入恢复页，不自毁配置
打开就能用
一个应用，覆盖 Agent 工作的完整链路
主窗口就是官方 DSH Web，其余能力全部以插件 Bundle 提供——可以按需组合，也可以随时停用。
Better Sidebar 工作台
内置文件树、代码与 Markdown 编辑、Git、终端、网页与扩展 Tab。支持多仓库、Worktree 与 Vue 文件，终端工具默认对模型关闭。
插件市场
在官方设置页里发现、安装、更新、停用和卸载插件。界面、CLI 和应用重启都以同一个 Profile 为准，状态不会错乱。
任务、附件与 Worktree
任务看板、文件与文件夹附件、Git Worktree、项目工具、Office 与结构化结果，都由独立 Bundle 提供并可按需组合。
桌面 Host 与恢复
应用负责窗口、原生文件选择、更新与恢复。发现新版本先询问再下载，Profile 出错时进入恢复页，可重试或安全启动。
可复现的默认环境
新 Profile 从随包固定产物离线初始化，带完整性校验；普通启动不重写已有 Profile，也不会把你卸载的插件装回来。
界面
官方 Web 的样子，加上社区的能力
对话、审批与历史留在官方 Session；插件市场使用官方设置 Slot，不替换页面、不另建数据库。
插件生态
「集成版」的底气：默认 14 个 Bundle，全部固定版本、可验证
每个 Bundle 都锁定精确版本并记录 SHA-256、权限与许可证；除两个桌面基础服务外， 全部可以停用或卸载，更新永远不会把你移除的插件装回来。
桌面能力 本项目维护的 10 个 Bundle
- dsh-work-product-host-ipc桌面 IPC、Browser Workspace、文件对话框与窗口 Host
- dsh-desktop-profile-hostProfile 文件系统、受控 pnpm 与 DSH CLI 运行时
- dsh-desktop-chromemacOS 标题栏安全区等桌面外观适配
- dsh-project-tools项目工作区工具
- dsh-canvas-toolsSession 级版本化 Canvas 与本地站点工具
- dsh-structured-ui-tools结构化结果渲染
- dsh-model-inheritance父/子 Agent 模型继承（可移植）
- dsh-product-bridge面向当前 Profile 的应用指令上下文
- dsh-office-toolsOffice 文档（docx / xlsx / pptx / pdf）产物
- dsh-client-ui-worktreeGit Worktree 工作区（可移植）
生态推荐
皮肤中心
上游仓库 ↗
应用默认保持官方 Web 外观。想换装时，从插件市场安装社区维护的皮肤中心
@linxin666/dsh-client-ui-skin-center：数十款皮肤试穿即生效、可随时还原官方外观。
皮肤资产各自带有上游许可，因此不随应用默认内置，由你自行选择安装。
dsh plugin --profile web add @linxin666/dsh-client-ui-skin-center也可以用官方 CLI 操作同一个 Profile
dsh plugin --profile web add -w <package>@<exact-version> --save-exact --ignore-scripts
dsh plugin --profile web remove <package>架构
官方 Web 单一界面 + 官方 Profile 单一权威
Electron 在这里只是一层很薄的桌面 Host。真正的 Agent、会话与插件系统仍属于 DSH。
是否依赖私有前端
直接加载官方 Web 与 npm 运行时，不维护私有 Chat 分叉。
插件状态会不会错乱
官方 Profile 是唯一权威；市场、设置和 CLI 操作同一份数据。
默认插件是否可靠
固定版本、完整性、权限、依赖和许可证，并保留离线安装产物。
原生能力是否过大
文件、窗口和 Browser Workspace 只通过按 Session 绑定的有限方法开放。
启动会不会覆盖配置
已有 Profile 保持用户选择；失败时保留原 Profile 并进入恢复页。
应用更新会不会改插件
更新前只读预检 Profile；不恢复用户已停用或卸载的 Bundle。
安全与隐私
单机应用，数据留在你手里
签名与公证
macOS Developer ID 签名并完成 Apple 公证，启用 Hardened Runtime；Windows 安装包强制校验签名。
本地数据
Profile、Session 与运行数据默认保存在 ~/.dsh，没有外部账号模型，密钥不进入日志与诊断。
最小攻击面
官方 Web 没有产品 preload、Node 权限或通用 IPC；文件只有在用户主动选择或插件声明权限时才进入 Session。
可恢复
插件启动失败不会静默修改原 Profile；恢复页可重试、安全启动、移除问题插件并导出脱敏诊断。
快速开始
三步，从零到第一个 Session
-
1
下载并安装
下载安装包，拖入「应用程序」即可。安装包内置官方运行时与离线初始化产物，不需要先装 Node.js，首次打开也不用联网配环境。
-
2
配置模型 API Key
在 DeepSeek 开放平台等获取 API Key，粘贴到应用内的 DSH 设置。凭据只保存在本机
~/.dsh，由 DSH 自己管理，不上传、不写进日志。 -
3
开始工作
选一个工作目录创建 Session；侧栏打开文件、Git 或终端；需要更多能力时，去「设置 → 插件市场」按需安装。
下载
选择你的平台
最新版本 v0.1.9 · 以 GitHub Release 页面提供的产物为准，更新由应用内询问后进行。
macOS Apple Silicon
Developer ID 签名 + Apple 公证
Windows x64
NSIS 安装器 · 强制签名校验
macOS Intel / Linux
暂无正式安装包
可从源码运行（需要 Node.js 24+），支持 macOS x64 与 Linux。
查看从源码运行 →国内访问 GitHub 较慢？安装包体积较大（内置官方运行时与离线初始化产物），建议复制直链后使用下载工具或加速代理下载；应用内更新同样走 GitHub Release。
从源码运行
git clone https://github.com/vibeinging/dsh-desktop.git
cd dsh-desktop && npm install
npm run doctor
npm run dev:electronFAQ
常见问题
如何获取并配置模型 API Key？
在 DeepSeek 开放平台等模型服务处获取 API Key，打开应用后在 DSH 设置中粘贴即可。凭据由 DSH 设置与本地环境管理，只保存在本机 ~/.dsh，不会上传，也不会写进日志、截图或插件清单。
macOS 首次打开提示「无法验证开发者」？
正式安装包已完成 Developer ID 签名与 Apple 公证，正常情况下不会出现该提示。如果仍然出现，在「应用程序」中右键点击应用选择「打开」，或到「系统设置 → 隐私与安全性」中允许打开。
Windows 被 SmartScreen 拦截怎么办？
安装包带有签名校验。若 SmartScreen 仍弹出「Windows 已保护你的电脑」，点击「更多信息」→「仍要运行」即可。
GitHub 下载慢或连不上怎么办？
安装包体积较大（内置官方运行时与离线初始化产物，约 300–400 MB），建议用上方「复制直链」拿到下载地址后，使用下载工具或 GitHub 加速代理下载；应用内更新同样走 GitHub Release。
我的数据保存在哪里？
Profile、Session 与本地运行数据默认保存在 ~/.dsh（可通过 DSH_DATA_ROOT 修改）。DSH Desktop 是单机应用，没有外部账号模型。
我在用官方 npx dsh，数据会冲突吗？
默认数据目录与官方一致（~/.dsh）。应用启动对已有 Profile 只读、不重写配置；只有创建新 Profile 时才会使用安装包内的固定产物离线初始化。
应用会自动更新吗？
正式安装包会从公开 GitHub Release 检查更新：先询问你，确认后才下载，并在安装前对 Profile 做只读预检。更新不会恢复你已停用或卸载的 Bundle。
怎么安装更多插件？
普通用户直接使用「设置 → 插件市场」，市场会显示来源、版本、兼容性与权限；也可以用官方 CLI（dsh plugin --profile web …）操作同一个 Profile。
支持 Linux 吗？
暂无正式安装包，可以从源码运行（Node.js 24+）。macOS Intel 同样支持源码运行。
DSH Desktop 和 DeepSeek 是什么关系？
DSH Desktop 是基于 DeepSeek Harness 与 Cordis 插件体系构建的独立社区项目，与深度求索不存在隶属、合作、授权或背书关系。
自己写的插件能直接用吗？
符合官方 DSH Bundle 与 dshClient 合同的插件不需要为 DSH Desktop 重写。需要窗口、原生文件对话框或 Browser Workspace 的插件，则要显式使用窄 Host 合同。