前言¶

在 DSH Desktop 上日常开发，版本升级往往还要自己下 DMG、拖进 /Applications；技能、MCP、Agent 预设分散在 profile patch、本机其它 AI 工具的配置里，改一处常常要重启或手改 YAML。社区 Cordis 插件 @mhxy13867806343/dsh-update-vd（npm 包名同 GitHub 仓库 mhxy13867806343/dsh-update-vd）把「检查更新 → 下载 → 替换 app → 重启」收成侧栏一条链路，并在设置里补上技能、MCP、智能体、从其它 AI 导入等页面。下面介绍它是什么、能做什么、怎么装、用的时候要注意什么。

这是什么¶

dsh-update-vd 是面向 DSH Desktop 的 Cordis 插件（宿主端 + Web 客户端，dsh.client.immediately 为 true，加载即挂载 UI）。维护者为 mhxy13867806343；在 SkillHub 目录中归类为客户端插件。当前资料中的版本为 1.10.4，许可证 MIT。插件会通过 bundle 里的 cordis.patch.yml 关闭 DSH Desktop 自带的更新行（desktop-updates）；若不想关闭，需按 README 说明自行调整 patch，避免两套更新 UI 同时出现。

核心功能¶

侧栏更新中心¶

侧栏底部（账号行上方）展示当前版本与更新状态：

• 无新版本：显示如 版本 2.0.16 与 [检查更新]。
• 有新版本：显示版本跃迁（如 2.0.16 → 2.0.17）与高亮 [更新]。
• 下载中：侧栏显示百分比与细进度条；窄栏收起时为图标按钮，有新版本时带小圆点。
• 中断后可 [继续下载]，支持 HTTP Range 断点续传。

点击更新会弹出进度弹窗：可取消（二次确认，已下载部分保留）、点空白或 Esc 则后台继续下载（侧栏仍显示进度）。下载完成后流程为：挂载 DMG → 校验版本与签名 → 替换 app → 自动重启。

装机侧的安全约束（README 原文）：更新请求仅允许 dshdesktop.cn 上两个固定端点，重定向到其它主机会拒绝；安装前用 ditto 整份拷到暂存目录并 codesign --verify --deep --strict，失败则恢复旧 app；退出旧进程采用 TERM → AppleScript quit → 等待端口 → 必要时 KILL 的组合。

设置 → 技能（settings.section = skills）¶

列出随包、项目内与本机可写目录下的技能，只读项会标明。支持搜索，新增 / 编辑 / 删除（删除需确认并展示路径）。可写目录包括 ~/.dsh/skills、~/.agents/skills。导入支持 http(s) 抓 SKILL.md 或本机路径；重名报错、不静默覆盖。可从本机 Codex / Claude / .agents 等目录扫描并复制技能；支持按源地址在线搜索（如 anthropics/skills、obra/superpowers 或自定义 owner/repo）。

设置 → MCP（settings.section = mcp）¶

管理 MCP 服务器列表（名称、类型、地址或命令、连接状态）。支持 streamable-http 与 stdio；配置写入 ~/.dsh/mcp-servers.json，保存后按 @deepseek-ai/dsh-mcp-client 规则动态挂载，无需改 profile patch 或重启。可从 Codex、Claude、Cursor 等工具的常见配置文件导入；可在线搜索 MCP 官方注册表或 modelcontextprotocol/servers 等源。

设置 → 智能体（settings.section = agents）¶

管理 DSH Agent 预设（@deepseek-ai/dsh-agent-preset 声明，数据在 ~/.dsh/agent-presets.json）。提供列表、搜索、新建 / 编辑 / 删除、导入 / 导出（本插件 JSON 或 DSH 补丁 YAML）、在线搜索第三方预设仓库。内置预设只读，可「复制一份」再改；保存后运行时动态挂载，装配失败会在列表中标红并展示 DSH 诊断。v1.9.1 起，「从其它 AI 导入」不再在本页，而独立为下一节所述「导入」页。

设置 → 导入（settings.section = other-ai，order 160）¶

导航排在「智能体」下方，两个页签：

1. 智能体预设：探测 Codex、Claude Code、TRAE、WorkBuddy 等（按本机目录 / 应用是否存在）；将它们的指令、子代理、技能等转成 DSH 智能体预设（系统提示词形态），写入 ~/.dsh/agent-presets.json 并立刻挂载。未安装的工具仍显示条目并给出官网入口。
2. 对话记录：只读列出 Codex / Claude Code / WorkBuddy 等本地会话文件，可搜索、多选、分页，一键导入为可在左侧会话列表继续聊的 DSH 会话（按会话 id 幂等），或导出 Markdown / 插入输入框。

技能 / MCP 页另提供「从本机其它 AI 工具导入」入口（与上表不同，侧重配置与服务器清单）。

侧栏笔记与 Token 活动¶

侧栏提供笔记弹窗：管理命令或 git 片段，支持增删改查、搜索、分页与多选插入聊天输入框。

在 设置 → 账号与余额 的「充值余额」下方追加 Token 活动热力图（一天一格；每天 / 每周 / 年 / 累计总量四种配色模式，数据来自本机会话日志）。若宿主 UI 改版找不到锚点，会 fallback 到设置里独立的「Token 活动」页。

安装与启用¶

推荐从 DSH Desktop 插件市场搜索 dsh-update-vd 安装，重启后常驻。

命令行安装（README 原文）：

# 从 npm（若已发布）
dsh plugin --profile desktop add @mhxy13867806343/dsh-update-vd

# 或直接从本仓库装（本地目录 / git 均可）
dsh plugin --profile desktop add /path/to/dsh-update-vd

也可在 desktop profile 的 package.json 中加入依赖，或在 cordis.patch.yml 中插入插件条目（详见仓库 README）。安装后需重启 DSH Desktop。

社区目录页（非 DeepSeek / 幻方官方商店，仅为社区收录）：https://www.skillhub.cn/plugins/mhxy13867806343/dsh-update-vd

典型用法¶

用侧栏完成一次 macOS 升级¶

1. 打开 DSH Desktop，看侧栏底部版本行；若有新版本，点 [更新]。
2. 在弹窗中等待下载；需要时可点「后台升级」，侧栏仍显示进度。
3. 下载完成后插件自动验签、替换 /Applications 内的 app 并重启；无需手动拖 DMG。

若需下载完手动确认再装，可在启动 DSH Desktop 的环境中设置：

export DSH_UPDATER_AUTO_INSTALL=0

其它常用环境变量见 README：DSH_UPDATER_CHANNEL（默认 stable，支持 beta / next）、DSH_UPDATER_CACHE_DIR、DSH_UPDATER_DRY_RUN=1、DSH_UPDATER_NO_RELAUNCH=1。

在设置里管理 MCP 并立刻生效¶

1. 进入 设置 → MCP，新增或编辑一条 streamable-http 或 stdio 配置。
2. 保存后清单写入 ~/.dsh/mcp-servers.json，客户端立即尝试挂载；连不上时界面会标明服务器名与原因。
3. 也可点「在线搜索」从注册表选取，或从 Cursor / Codex 等已有配置导入。

从 Codex 迁入历史对话¶

1. 打开 设置 → 导入，切换到 对话记录 页签。
2. 在 Codex 来源中搜索或分页勾选会话，执行导入。
3. 导入后在 DSH 左侧会话列表打开对应条目即可继续对话（同一 session_id 重复导入为幂等刷新）。

排查更新问题时，README 建议查看 ~/Library/Caches/dsh-update-vd/state.json、宿主日志中 [dsh-update-vd] 行，以及 ~/Library/Caches/dsh-update-vd/install.log。宿主 API 包括 GET /api/dsh-update-vd/status|check 与 POST /api/dsh-update-vd/download|install|cancel。

适用场景与注意¶

适合谁： 主要在 macOS 上使用 DSH Desktop、希望侧栏一键升级客户端；同时希望在同一套 UI 里维护技能、MCP、Agent 预设，或从 Codex / Claude Code / WorkBuddy 等迁配置与会话的用户。

平台限制： README 明确 完整自动安装目前仅 macOS（hdiutil + ditto + 重启）；Windows / Linux 上更新能力到「检查更新」为止。自动安装会退出并重启 DSH Desktop，进行中的任务会中断（会话记录仍保留）。安装包约 500MB，缓存目录默认 ~/Library/Caches/dsh-update-vd/。

安全与权限： 插件在当前 DSH 进程权限下运行，会读写 ~/.dsh/、访问本机其它 AI 工具的配置与会话文件，并在 macOS 上替换应用程序。安装前应阅读 GitHub 仓库 源码与 MIT 许可证，确认更新端点与环境变量行为符合你的策略。

生态说明： DeepSeek Harness 强调「一切皆插件」；SkillHub 为社区插件目录，与 DeepSeek / 幻方无官方从属关系。

结尾¶

dsh-update-vd 把 DSH Desktop 的版本升级收成侧栏可观测的一条链路，并把技能、MCP、智能体与跨工具导入集中进设置页，减少手改 patch 和重复装 DMG 的成本。进一步了解与 issue 反馈：

• 目录页：https://www.skillhub.cn/plugins/mhxy13867806343/dsh-update-vd
• 源码与 README：https://github.com/mhxy13867806343/dsh-update-vd