跳到主内容

dsh-plugin-desktop 使用指南

把 DSH Web 界面打包成原生桌面客户端,提供 Electron 壳、托盘菜单、IM 远程遥控、手机 PWA、Zero-Token 免费模型通道和插件市场。

本文为派生内容(基于 wiki / faq / compatibility_json 自动组装),非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生(wiki / faq / compatibility_json / readme),非 AI 即时创作。每节末尾标源字段。

快速上手

DeepSeek-Harness-Token-Free

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-plugin-desktop

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

  • 欢迎通过 GitHub Discussions 提交反馈或 bug 报告。
  • 为你的插件仓库添加 dsh-plugin 话题,便于被发现。
  • 欢迎加入 DeepSeek Harness 企微群:扫码添加企微小助手并填写入群问卷,完成后小助手会邀请你入群。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

这个插件和官方 DSH CLI 的 dsh web 有什么区别?

官方 dsh web 只能跑在浏览器里、需要手动起 Node。这个插件基于 Electron 把它做成原生窗口、托盘菜单和系统集成,并自动管理本地 profile、pnpm、下载更新。两者共享同一套上游 DSH 业务逻辑,只是把外壳换成了桌面应用。

一定要装 Zero-Token 才能用吗?

不是。安装并填写官方 API Key(DeepSeek、Anthropic、OpenAI 等)就能用全部功能;Zero-Token 是可选的免费通道,让你不消耗 Token 也能调用 DeepSeek / Claude / Gemini / ChatGPT 等网页模型,需要先用官方 API Key 切换一次。

支持哪些操作系统?

兼容模式(默认)支持 macOS / Windows / Linux;高级模式(带隐藏标题栏与 Mica/vibrancy 原生质感)只支持 macOS 和 Windows,Linux 拒绝并强制走兼容模式。README 明确指出社区版 Windows 安装包未签名、macOS DMG 未签名未公证,可能需要右键打开。

怎么用 Telegram / 飞书 / 微信控制电脑里的 DSH?

在设置里填入对应 Bot Token(Telegram、Discord、Feishu App ID+Secret、WeChat iLink Token),托盘会出现 Channels 状态条目;WeChat 不填 token 也行,可以走 QR 扫码绑定。所有渠道共用同一个配对码和会话队列。

局域网手机 PWA 怎么用?

默认开启,端口 8787,手机连同一 Wi-Fi 后用 tray 里展示的配对 URL(含二维码)打开网页,加到主屏幕即可。所有通信仍走 loopback / LAN,不会暴露到公网。

怎么装第三方插件?能从市场装吗?

托盘 Marketplace 默认带一个 3 项的精选目录,可以从 tray 一键安装;也可以在 settings 填入自己的 HTTPS 目录 JSON,或通过 dsh plugin --profile desktop add <spec> 走官方 CLI。[email protected] 不会被内置,因为 license notice 不全。

怎么切换"兼容"和"高级"两种界面模式?

在 DSH home 的 settings.yaml 里改 dsh-desktop.mode 字段,或者从托盘里点选。改完会触发一次有序重启,不会热切换,原生窗口材质、Loader row 都会重建。

切换 profile 后数据会丢吗?

不会。官方 profile 共用同一份 DSH home 里的 sessions、settings 和 storage,切换不会复制或迁移;只有自定义 profile patch 主动重定向持久化目录时,数据才会落到新位置。

— 源: plugin_wiki.faq_json

兼容性

  • DSH: 0.1.0-rc.6(package.json 依赖全部钉在该 family)
  • Node: ^22.19.0 || >=24.0.0

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。

— 来源:通用规则