dshdesktop-client

简体中文 | English

DSH Desktop 的官方 client 插件：把「插件市场」和「DSH Desktop 设置」装进 dsh web 侧栏。
市场发现、安装、更新、启停一次搞定，配置面板与桌面端共享同一套 host bridge。

`dshdesktop-client` 通过 dsh 官方 slots 机制注入两个入口：

• 侧栏设置按钮上方注入「插件市场」按钮（sidebar.footer.action），点击打开页内市场面板；
• dsh 设置面板新增「DSH Desktop」区（settings.section），展示软件介绍与 dshd 配置。

所有能力通过 chrome.webview.hostObjects.dshdesktop 与 DSH Desktop 主窗口通信（GitHub 发现、dsh plugin 安装、环境/配置读写都在 host 侧完成），浏览器侧不做特权操作。

市场面板

⚠️ 安装功能尚不完善，敬请期待。 当前「发现」tab 支持浏览、搜索与查看详情；安装 / 更新 / 启停等操作正在打磨中，部分插件（如 git 仓库安装、带构建脚本的包）可能无法顺利安装，建议先以官方插件（@dshd/dshdesktop-client、@dshd/dsh-usage）体验完整流程。

发现

• 来源：GitHub topic 搜索（默认 dsh-plugin / dsh-plugins，配置可改）+ 社区收录目录（seed catalog），按 star 排序、去重、本地缓存（24h，断网回退缓存）
• 过滤：只保留带 dsh-plugin/dsh-plugins topic 的仓库——宽泛 topic（如 deepseek-harness）搜到的非插件项目不会出现
• 搜索：按名称 / 描述 / 仓库 / 标签实时过滤
• 详情：仓库 / Star / License / 来源 / 信任 / 归档 + 标签；安装命令自动从仓库 README 识别，按类别提示：
  • 识别期间输入框禁用并显示加载动画，不预填任何猜测值；
  • npm / GitHub / 本地路径 → 填好可直接安装的命令（绿色提示）；
  • Skill / 全局 CLI / MCP / 桌面应用 / repository-plugin / 其它 profile → 判定为「不可直接安装」，输入框锁定并给出橙色分类提示（如「这是 Skill，请用 skills 安装」）；
  • 未识别到 → 输入框留空可手动输入（灰色提示）；README 获取失败 → 红色提示，仍可手动输入。

已安装

• 列出已装插件：版本 / 激活方式（bundle 启动 / client patch）/ 启用状态
• 启用 / 禁用 / 移除（经 dsh plugin 落地，重启 dsh 生效）
• 检查更新：逐个查 npm registry 对比版本，有更新显示「有更新 vX」+ 更新按钮
• 立即重启：杀掉旧 dsh 进程、按最新配置拉起（插件激活变更即时生效）
• 安装过程有实时进度条（解析依赖 → 下载 → 落盘）；关闭面板后台继续装，装完托盘气泡通知

DSH Desktop 设置区

• 软件介绍：DSH Desktop 版本（同行「检查更新」）、作者、GitHub 仓库链接
• dsh 版本 + 更新管理：显示当前 dsh 版本与最新版本，提供「检查更新」「更新 dsh」「查看更新内容」「重启 dsh web」；无更新时也显示「查看更新内容」入口
• dshd 配置：端口 / DSH_HOME / dsh 入口 / node / npx 回退 / 数据目录 / 日志目录 / 下载代理——「编辑配置」弹窗统一修改，数据目录变更自动迁移旧数据

dsh 自动更新（顶部横幅）

DSH Desktop exe 在启动时后台检测 dsh 是否有新版本（结果带缓存，到设置页/横幅即读即得）。当有更新时，页面顶部出现可关闭的横幅：

• 「📦 dsh 可更新：当前 → 最新」+「更新内容」+「立即更新」
• 更新过程显示实时进度（npm install -g @deepseek-ai/dsh@latest，走 settings.NpmRegistry 镜像）
• 完成后显示「重启 dsh web」按钮；横幅关闭按最新版本记忆，出现更新的版本时再次弹出
• 横幅只在 dsh web 内（DSH Desktop 主窗口）渲染，普通浏览器访问无 host 桥时自动隐藏

「查看更新内容 / 查看更新日志」从 dsh 官方 GitHub Releases 拉取更新说明，弹窗内按 Markdown 渲染（标题 / 列表 / 加粗 / 代码 / 链接，自动过滤语言切换锚点行；输出经 HTML 消毒，仅放行 http/https/mailto 链接）。

机制与数据

• 桥接：chrome.webview.hostObjects.dshdesktop（host object，须在导航前注入）；市场目录、插件生命周期、配置读写都在 host 侧
• 激活：dsh 插件体系——声明 dsh.bundle 的走 dsh.profile.bundles，纯 dsh.client 走 DSH Desktop 激活 patch；无 dsh 标记的包不激活（dsh 拒绝加载无 dsh.bundle 的 bundle，会崩启动）
• git 安装：github:owner/repo 装后按包自身 package.json 的 name 识别真实包名，写入 bundles/patch 的是真实名而非 github: 前缀
• 下载代理：默认直连（与终端一致）；网络受限时在配置里填代理（如 http://127.0.0.1:7890），经 HTTP(S)_PROXY 环境变量传给 pnpm

安装

dsh plugin --profile web add @dshd/dshdesktop-client
# 重启 dsh web 后，侧栏设置按钮上方出现「插件市场」，设置面板出现「DSH Desktop」

DSH Desktop 首次启动会自动安装本插件（EntryInstaller：装入 + 写激活 patch + 加入 patchFiles）。

开发

# 本地目录安装（跳过 npm）
mkdir -p ~/.dsh/profiles/web/node_modules/@dshd/dshdesktop-client
cp package.json index.js client.js ~/.dsh/profiles/web/node_modules/@dshd/dshdesktop-client/
# 在 ~/.dsh/profiles/web/package.json 的 dependencies 与 DSH Desktop 的激活 patch 加入 @dshd/dshdesktop-client
# 修改后重新 cp，重启 dsh web 生效

• client.js —— dsh client 插件入口（ESM，apply/inject；市场面板 + 设置区）
• index.js —— host 侧薄入口（无 host 逻辑，桥由桌面端注入）
• publish.ps1 —— 一键发布到公共 npm（npm login 后执行）

配置

项	说明	默认
marketplaceTopics	GitHub 发现 topic 列表	dsh-plugin、dsh-plugins
marketplaceCacheHours	市场缓存小时数	24
githubToken	GitHub 令牌（提升限流），或 GH_TOKEN	—
proxyUrl	下载代理（直连留空）	—

License

MIT — Copyright (c) 2026 Ackow。