Dsh Desktop AI Agent by myYangyunfan

把 DSH 里最好用的一批插件，做成一个开箱即用的桌面客户端。

不是一个「只换皮」的 DSH 壳：我们替你挑插件、调兼容、做整合、压进一个安装包。 装好即用——不用装 Node.js，不用逐个找插件，也不用为版本冲突折腾。

English · 最新版 v1.1.0（2026-11-13）

[!NOTE] v1.1.0 = 内核换代 0.2.2-rc.2 → 0.2.2-rc.3 + 便携版补全内置 Node：Rust 壳与界面零功能改动， 在册插件仍是 33 条。顺带修掉 v1.0.10 的一个缺口——两个便携包当时逐字节相同（内置 node.exe 没进包）， 现在 Full 自带 Node、Lite 真的更小。 随包交付完整 dsh 运行时 + 33 个精选伴随插件，架构是 Tauri 2 + 内置 Node：包更小、启动更快， 坏插件 / 坏配置也永不白屏打不开。完整改动见 Release 说明。

目录：为什么是它 · 界面 · 快速开始 · 内置插件 · 常见问题 · 社区 · 赞助 · 开发与构建 · 发布与架构

---

✨ 为什么是「插件整合包」

DSH 的插件生态很好，但「好」和「装好就能用」之间隔着选型、兼容、版本、配置四道墙。 DSH Pack 把这件事做完：精选，整合，随包交付。

精选，而不是堆积

• 33 个伴随插件，逐个选过 — 不以数量取胜：每个内置件都经过宿主兼容验证、许可核对和真机启动检查， 清单、上游与判定记录在 内置插件清单。
• 一个安装包，一套完整体验 — Bot 团队与群聊（DeepSeek-Bot）、文件工作台（Better Sidebar）、 免费多引擎搜索（Free Search）、插件商店、提示词优化、会话地图、桌面通知、MCP / 技能工具箱、 余额与费用、会话归档、峰谷价格卫士……装完即齐。
• 上游可追溯 — 每个随包插件都标注来源仓库、版本与许可证；第三方许可见 THIRD_PARTY_NOTICES.md，兼容性判定与实测证据见清单 §五。

开箱即用

• 零环境依赖 — 内置独立 Node 运行时与 npm CLI，目标机器不需要安装 Node.js / pnpm。
• 完整 dsh，离线可用 — 打包官方 @deepseek-ai/dsh 与官方插件全集，断网也能启动。
• 双击即用 — 自动复用上次端口，内核就绪后载入原生窗口；提供安装版与便携版两种形态。
• 客户端级更新 — 右上角 ⋯ 一键检查并安装更新，双源 GitHub / Gitee 自动切换， sha256 fail-closed 校验；内核随客户端整体分发，没有第二条独立更新链。

桌面体验

• Tauri 2 原生壳 — 深色玻璃无边框窗口、自绘标题栏、Win11 圆角，关闭默认驻留托盘。
• 文件工作台 — Better Sidebar 把资源管理器、编辑器、Diff 与「在本地打开」接进右栏， 折叠 / 展开与快捷键都按桌面习惯重做。
• Bot 团队 — DeepSeek-Bot 把主 Bot、长期 Bot 和群聊装进同一个客户端： @ 转交、群共享记忆、能力库与用量页，适合把 DSH 当成长期协作工作台。
• 通知与余额 — dsh-notify 接管回合完成 / 审批 / 出错通知，点击回到对应会话； 对话底部实时显示「本轮费用 · 余额」。

工程韧性

• 守护瀑布 — 内核 boot 链逐级自愈：坏插件自动修复、坏配置自动重建、内核崩溃环原地重启， 任何不兼容形态都不退出。
• 崩溃自愈 — 渲染层假死心跳检测自动重载；内核由 supervisor 探活 + 指数退避拉起。
• 数据不动 — 升级覆盖安装保留 profile 与会话；插件启停只改补丁层配置，不碰用户数据。

📸 界面一览

开箱即用（原生 dsh web）vs DSH Pack：

能力	原生 dsh web	DSH Pack
启动	手动安装 Node.js、敲命令	双击即用，内置独立运行时
界面	浏览器标签页	桌面原生窗口 · 深色玻璃无边框
插件	自己逐个找、装、调兼容	33 个精选插件随包交付，统一查看 / 启停 / 更新
会话管理	仅归档	归档 / 恢复 / 删除 + 会话地图
余额	无	实时「本轮费用 · 余额」+ OpenCode Go
桌面能力	无	托盘常驻 / 原生通知 / 文件工作台 / Bot 群聊
更新	手动	客户端双源更新链（GitHub/Gitee + sha256 校验 fail-closed）

🚀 快速开始

系统要求：Windows 10 / 11、macOS 12+（Apple Silicon）、Linux x64。 安装版与便携版 Full 都自带 Node 运行时，目标机器无需预装 Node.js。

到 Releases 下载（下表 <版本> 为发布号，当前是 1.0.10）：

平台	产物	说明
💻 Windows x64	DSH-Desktop-Setup-<版本>-win-x64.exe	主推。NSIS 安装包，currentUser 模式免管理员，内嵌 WebView2 引导器，离线机器也能装 · 约 306 MB
🎒 Windows x64 便携	DSH-Desktop-Portable-<版本>-win-x64.zip	解压即用，数据存 exe 旁 data\，自带 Node · 约 571 MB
🪶 Windows x64 便携 Lite	DSH-Desktop-Portable-<版本>-win-x64-lite.zip	同上但不含内置 Node，需本机已有 Node ≥ 22；比 Full 小约 33 MB
🍎 macOS 12+	DSH-Desktop-<版本>-macos-arm64.dmg	ad-hoc 签名、未公证，首次打开需右键 → 打开（见 FAQ） · 约 542 MB
🐧 Linux x64	DSH-Desktop-<版本>-linux-x64.AppImage / dsh-desktop_<版本>_amd64.deb	· 约 416 / 462 MB
🧪 Windows arm64	DSH-Desktop-Setup-<版本>-win-arm64.exe	实验线，能用但不保证

每个产物都带同名 .sha256 边车文件；担心下载被篡改就先校验再运行。

安装版还是便携版

• 安装版（Setup）— 推荐。装进 %LOCALAPPDATA%，有开始菜单与卸载项，覆盖安装会装回原目录。
• 便携版（Portable）— 解压即用、不写注册表，适合放 U 盘或临时机器。
• Lite 版只省掉内置 Node，其余完全相同；本机已有 Node ≥ 22 才选它，否则会报「未找到可用的 Node.js」。

第一次启动

1. 启动后壳会跑一遍 boot 链：修复 → 同步内置插件 → 打补丁 → 内核预检 → 拉起内核。
2. 内核就绪后载入客户端；从安装包 assets/plugins 镜像 33 个精选插件进 profile。
3. 之后在「设置 → 插件 → 内置插件」里逐条查看版本、启停、检查更新。

数据在哪

数据	位置
客户端设置、窗口状态、日志	Windows 安装版 %APPDATA%\dsh-desktop\ · 便携版 exe 旁 data\ · macOS ~/Library/Application Support/dsh-desktop/
会话、附件、插件 profile、API 凭据	<DSH_HOME>，默认 ~/.dsh，可用环境变量 DSH_HOME 改（三种形态同一套）

设置环境变量 DSH_HOME 可强制指定 dsh 配置目录——便携版想让「数据随 exe 走」，把它指到 data\ 下即可。 升级与覆盖安装不会动这些数据。 完整的数据实践（收集什么、什么时候联网）见隐私政策。

🧩 内置插件生态

内置伴随插件在册共 33 个（v1.0.0 起插件源整树进安装包，装机后首次开机由 boot 的同步链镜像进 profile，开箱可用）。下表按 scripts/lib/companion-plugins.js 的在册顺序逐名列出，包名与版本取自各插件 package.json 实值；「来源 / 许可」列只到「包内自己怎么说」这一层，逐条原仓库可达性与许可原文实测见 内置插件清单 §三，逐条对 0.2.2-rc.2 宿主的兼容判定见 §五：

插件（包名）	版本	说明	来源 / 许可
@deepseek-ai/dsh-balance	0.2.0	账户余额 + 本轮会话费用估算（挂在对话统计栏 dock）	自研 · MIT
@deepseek-ai/dsh-file-changes	0.1.0	会话文件更改投影（折叠 tool/result 的 meta.diffs）	自研 · MIT
dsh-better-sidebar	0.24.2	VSCode 式右栏：editor / git / subagent / sidechat / diff 五个内置标签，并向其他插件开放标签注册服务	omdsh-dev/DSH-better-sidebar · MIT
dsh-session-manager	0.1.0	会话行删除按钮 + 设置内「归档对话管理」面板（恢复 / 删除）	自研 · MIT（包名撞社区已发布包）
@deepseek-ai/dsh-conversation-tweaks	0.1.1	隐藏长篇对话输出 + 会话右侧导航滑轨	自研 · MIT
@dsh-external/dsh-super-injector	0.3.1	运行时注入任意本地插件包（不重启）+ 热重载 + 设置页插件管理 UI	@dsh-external 社区 · BSD-3-Clause（仅 manifest 自标，无许可原文可引）
@deepseek-ai/dsh-prompt-custom	0.5.0	在设置页自定义官方注入的系统提示词（整体替换 / 追加），提示词卡即切即用：点芯片切换、正文写回当前卡	自研 · MIT
@deepseek-ai/dsh-workspace-anchor	0.1.1	把当前工作目录写进稳定系统提示的锚点块，防 agent 工作目录漂移（0.2.1 起内核不再注册 {{cwd}} 变量，锚点由插件自己填实路径）	自研 · MIT
@deepseek-ai/dsh-wsl-settings	0.1.0	设置页「WSL 后端」栏：local↔wsl 切换、发行版与安装目录、状态探活	自研 · MIT
ds-bot	0.2.0	Bot 团队：主 Bot + 长期 Bot + 群聊，Bot 间 @ 转交与共享记忆，开箱即用的协作工作台（loader id bot）	Fei2411/DeepSeek-Bot · Apache-2.0
billion-context	0.1.213	上下文压缩（上游统一版）：模型驱动压缩 + 4 个模型工具与 /acp-prune 命令，另带 preset 级 compaction gate	ranxianglei/billion-context · MIT
dsh-pocket	2.12.0	手机扫码实时同屏操控桌面 web（WebSocket 透传 + 公网隧道 + 二维码配对）	shaobeichen/dsh-pocket · GPL-2.0
@deepseek-ai/dsh-openclaw-bridge	0.8.1	微信 / 飞书官方频道桥接入 DSH agent 会话（分片回写、去重限流）	hzhz314159/openclaw-dsh-bridge · MIT
dsh-input-history	0.1.1	输入框 ↑/↓ 终端式已发送消息回溯（按会话隔离）	自研 · MIT
dsh-easyrewrite	3.0.1	消息撤回 / 重编辑 + 版本翻页器 + 自带设置中心	Renzic-Stone/DSH-EasyRewrite · MIT
dsh-change-review	0.1.2	AI 变更审核：让模型复查自己刚做的改动（正确性 / 安全性 / 目标一致性）	自研 · MIT
dsh-offpeak	1.0.1	峰谷价格卫士：高峰时段拦截发送提醒，可定时到低价时段自动执行	christophersmith2737-commits/OffPeak · MIT
dsh-settings-nav-custom	0.1.1	设置页左侧导航项显示 / 隐藏与排序（localStorage 持久化）	EAC 移植 DSH-EAC/EAC-Desktop · MIT
dsh-settings-groups	0.1.1	把设置「常规」页低频选项收进底部可折叠「高级选项」组	自研 · MIT
dsh-synapse	0.3.1	非线性对话画布：同工作区的会话 / 追问 / 分支可视化拖拽	liangmianya/dsh-synapse · MIT（本地分叉线，不取上游 0.4.2）
@dsh-external/dsh-subagent-lens	0.1.1	Task/subagent 展开式活动视图 + 会话头部命令/文件聚合条（零额外后端请求）	自研 · MIT（借 @dsh-external 作用域，名下无仓库）
dsh-basics-panel	0.4.2	设置页可视化并管理 MCP 服务器 / 技能 / 规则 / 归档会话	yxsj245/dsh-Basics-Panel · MIT
dsh-input-fold	0.1.1	超长用户提示词默认折叠为前几行 + 「展开」遮罩	自研 · MIT
dsh-prompt-optimizer	3.0.0	输入框旁一键分析并优化草稿（SSE 流式上屏；默认实时复用当前会话模型；无上下文走结构模板、有上下文提炼目的顺势润色；保真自检、斜杠命令前缀保护；结果可替换/撤回/复制；设置页可配模型、调用参数与上下文）	Y1X1n/dsh-prompt-optimizer · MIT
dsh-builtin-manager	0.2.1	「设置 → 插件」里的内置插件页：搜索 / 状态筛选 + 单列表逐条查看随包内置件并启停（行内反馈；启停下次启动生效）	自研 · MIT
@deepseek-ai/dsh-goal-completion	0.1.0	内核右栏「目标收尾」标签页：当前会话目标的状态机 + 官方 GoalBar 没有的 complete（标记完成，两次点击确认）	自研 · MIT
dsh-free-search	0.9.39	免费多引擎搜索：注册 ctx.web 搜索 provider，内置 web_search 自动选用（loader id 是 web-search-free，不是包名）	DDDMUC/dsh-free-search · MIT
dsh-plugin-shop	0.9.3	插件商店：浏览 / 安装 / 启停 / 更新 dsh 插件（loader id 是 shop，客户端 bundle id 才是包名）	LivXue/dsh-plugin-shop · Apache-2.0
@local/dsh-network-proxy	1.0.4	设置「通用」里的 HTTP 代理行：读系统代理并热切换 fetch dispatcher（包名保留上游 @local/*，改名会让更新回来的行对不上）	baizhizzl/dsh-network-proxy · MIT
dsh-toolbox-ui	1.10.1	MCP / 技能工具箱：右下悬浮面板，MCP 市场与技能管理（loader id 是 mcp-manager-ui；宿主半边静态导入 smol-toml）	Imzl-zl/dsh-toolbox-ui · MIT
@bittersmilezzz/dsh-notify	0.4.5	桌面通知：渲染进程 Web Notification 六类事件 + 点击回会话，v1.0.7 起取代壳层「回合完成」通知	bitterSmilezzz/dsh-notify · MIT
dsh-context	0.83.0	上下文透视：右栏上下文看板 + /context 命令，拆解当前上下文由什么构成、如何随轮次演变	bowenliang123/dsh-context · Apache-2.0
ds-harness-remote	0.6.4	端到端加密远程访问：桌面 / Web / 安卓远控本机 DSH，含 dsh-TUI Host 支持（内层依赖树随包分发，WebRTC 走纯 JS werift）	liguobao/ds-harness-remote · MIT

清单变更史（新增 / 退役的逐条理由、上游可达性与许可原文）在 内置插件清单，这里只留一行摘要： v1.0.0 由 39 精简到 28；2026-11-08 移除 quest-ui / auto-compact / zcode-migrate 三件；2026-11-09 新增 dsh-context 与 ds-harness-remote 并升 8 件到 npm latest； 上下文压缩件同日整体换成上游统一版 billion-context。退出清单的插件源已从 assets/plugins/ 删除，老装机机器的注册行与 profile 镜像由 RETIRED_COMPANIONS 在下次开机回收。

❓ 常见问题

装完打不开、或者卡在加载页？ 壳有恢复页兜底：点「以安全模式重启」会停用全部内置插件（dsh-builtin-manager 与压缩件除外）再启动， 进去后逐个开回来即可定位是哪一个。日志在 %APPDATA%\dsh-desktop\logs\desktop.log（macOS 在对应数据目录下）。

macOS 提示「已损坏，无法打开」？ 不是包坏了，是未公证的 Gatekeeper 拦截。任选其一：右键 app → 打开 → 再点「打开」； 或终端 sudo xattr -cr "/Applications/DSH Pack.app"；或系统设置 → 隐私与安全性 → 「仍要打开」。 每次覆盖安装后需重做一次。

需要先装 Node.js 吗？ 安装版与便携版 Full 不需要（内置独立 Node 运行时与 npm CLI）。只有便携版 Lite 需要本机 Node ≥ 22。

覆盖安装会丢数据吗？ 不会。安装器会定位旧目录、装回原位置，并保留 profile、会话与插件配置。

为什么没提示更新？ 更新器轮询的是 releases/latest，只有正式版才进 latest。预发布版（prerelease）是刻意不推送的， 想尝鲜可在「设置 → 更新渠道」切到开发版。

Gitee 上的版本是不是更新不及时？ v1.0.0 起不再向 Gitee 同步代码与发布资产，Gitee 上的历史版本仅作存档，请以 GitHub Releases 为准。

💬 社区交流

遇到问题、想反馈建议或与其他用户交流？欢迎加入 QQ 交流群（群号 926561802）：

☕ 赞助支持

赞助支持：Infistar，多模型 API 服务，不构成技术推荐。

🛠 开发与构建

前置：Rust 工具链 + dsh-desktop/ 已 npm ci（内核 payload 源，postinstall 会自动装内核并打补丁）。

# 测试（当前基线：Rust 607 / sidecar 21 / Node 2253）
cd dsh-desktop && npm test
cd ../dsh-tauri && cargo test --workspace && node --test sidecar/cli.test.js

# 开发运行
cd dsh-tauri/src-tauri/src/app && cargo run

# 打包 win-x64 NSIS 安装包 + 安装态冒烟
bash dsh-tauri/scripts/stage-payload.sh
cd dsh-tauri && npx --yes @tauri-apps/cli build \
  --config src-tauri/src/app/tauri.conf.json --target x86_64-pc-windows-msvc
bash dsh-tauri/scripts/smoke-installed.sh

完整流程、调试开关与补丁体系见开发手册； 贡献前请读 CONTRIBUTING.md，代码、文档与 commit message 一律中文。

📦 发布与维护

这一节是维护者向的内容，普通用户可以跳过。

发布

唯一发布入口是推 v* tag → tauri-release.yml： 三平台构建（Windows NSIS / 便携版、Linux AppImage / deb、macOS dmg）→ 版本 / 测试 / 路径门禁 → 汇总并校验 7 个资产 → 发布 Release。版本号三处同步（dsh-desktop/package.json、 Cargo.toml 的 workspace.package.version、tauri.conf.json），漏改直接 fail-fast。 发布正文取自 .github/release-notes/v<版本>.md，发版前先写这个文件。

预发布版不进 GitHub releases/latest，而壳侧更新器轮询的正是 latest —— 因此预发布不会被自动推给 稳定版用户，这是刻意设计。完整流程、转正与回滚见 发布 Runbook。

架构

v0.5.0 起为 Tauri 2（Rust）架构——Electron 壳已退休，其全部职责（窗口 / IPC / 更新 / 打包）由 Rust 侧逐 crate 复刻，契约先行（dsh-tauri/contracts/ 六份硬契约为接口唯一事实源）：

┌──────────────────────────────────────────────────────────┐
│  Tauri 2 壳（Rust · 7 个单向依赖 crate + 装配根）          │
│  · supervisor：boot 守护瀑布 → spawn 内核 → 就绪换页       │
│    → 探活 → 崩溃环原地重启（任何不兼容形态都不白屏）        │
│  · shell-core        路径 / 设置（损坏自愈）/ 单实例        │
│  · kernel-process    spawn 规格 / 就绪行 / Job Object 杀树  │
│  · bridge            Electron IPC 38 通道 → Tauri command  │
│                     全量映射 + 垫片 JS（window.dshDesktop） │
│  · fence / preview-server / session-watcher /              │
│    sidecar-orchestrator（boot 时序 + Node sidecar 复用    │
│    dsh-desktop/scripts 内核侧逻辑，零重写）                 │
└──────────────────────┬───────────────────────────────────┘
                       │  dsh web --host 127.0.0.1 --port <复用端口>
                       ▼
            内置 node + @deepseek-ai/dsh
            路径解析：用户目录 overlay > 内置包
                       │  就绪行检测
                       ▼
            原生窗口加载 Web UI（仅本机回环访问）

分层铁律：crates 不依赖 tauri 运行时、可独立单测；装配根只接线不实现；内核侧 Node 逻辑全部活在 dsh-desktop/scripts/。开发手册见 dsh-tauri/docs/development.md。

Agent 预设

v1.0.0 纯净线不携带任何 Agent 预设——与官方桌面客户端的交付形态对齐：模式列表只出内核自带的出厂集（standard / ptc / minimal / cordis），安装包不注入自定义 persona，客户端也不写入任何预设文件。

想用自己的预设：放进 <DSH_HOME>/.agent-presets/<id>/ 即可被内核发现（agent.cordis.yml + preset.yml）；老用户目录里的历史副本不会被清除。历史上随包过的社区/自研预设来自第三方作者，已整树删除，来源与致谢记录见 git 历史（git log --diff-filter=D -- dsh-desktop/assets/agent-presets）。

📄 License

MIT。基于 @deepseek-ai/dsh（MIT）。

---

⭐ 如果 DSH Pack 帮到了你，点个 Star 就是最实在的支持； 遇到问题请到 Issues 反馈。