前言¶
在 DSH 里跑智能体时,经常要对照 DeepSeek 网页端:查历史、复制链接、或直接在官方界面里对话。切到系统浏览器会打断工作流,内嵌方案若每次重载还要重新登录。社区插件 dsh-webview(维护者 YokiMohan,分类:客户端)面向 DSH 桌面端,把 chat.deepseek.com 放进受控内嵌浏览器,三个入口共用同一页面实例,切走不卸载,重启后尽量保持登录;导航仅放行 deepseek.com,不注入脚本、不代发请求。
这是什么¶
dsh-webview 是 DSH 桌面端的客户端插件,当前版本 0.3.0(MIT 许可证)。宿主半侧 lib/index.js 为空插件条目,主要逻辑在浏览器半侧 lib/client.js,经 window.__ModuleLoader__ 加载。插件只做一件事:通过宿主 dshDesktop.browser 桥申请 lease 与内存分区,创建 <webview> 加载 DeepSeek 网页端。
英文说明见仓库 README.en.md。
三个入口,一个页面¶
| 入口 | 位置 | 适合 |
|---|---|---|
| 会话视图标签 | 会话区顶部「对话|轨迹|上下文」旁的 网页端 | 边聊边查,跟着当前会话走 |
| 左上角面板列 | 「插件」「自动化任务」旁的地球图标 | 全屏使用,随时进出 |
| 主区域面板 | 上面两个入口点开后的全屏面板 | 沉浸式,左侧栏仍可操作 |
三个入口共享同一个 <webview> 实例:在标签里滚到某处,切到面板再切回来,页面仍在原处;登录状态与正在输入的内容不会随切换丢失。<webview> 挂在 document.body 上的单例容器里,面板切换只改 display,DOM 不离场,页面因此不重载。
与常见「只有一个全局面板」的内嵌方案相比,README 中归纳的差异包括:会话视图标签入口、多入口共享单实例、宿主半侧零业务代码(不为搬运 HttpOnly cookie 写半侧逻辑)、导航白名单、单文件约 22KB、零运行时依赖且无构建步骤。
安全与导航¶
插件不代你发请求:不注入页面脚本、不轮询接口、不预加载、不代理任何请求。
越界链接不在内嵌里打开:导航白名单为 deepseek.com,超出范围的 URL 交给系统浏览器(2 秒内同一 URL 去重,避免重复弹窗)。
DSH 桌面端是 Electron 容器,DeepSeek 风控可能识别「非常规浏览器」。本插件仅通过 webview.setUserAgent() 去掉 UA 里的 Electron/<版本> 标记,其余 Chromium 指纹原样保留,不冒充其他浏览器、不伪造版本号。若仍出现「使用环境异常」弹窗,关掉即可,README 说明不影响登录和对话。
登录是怎么保住的¶
宿主给内嵌页面的是内存分区(随机名、无 persist: 前缀,关掉进程即清空),因此插件在页面加载完成、切换面板、关闭窗口时,读出页面 localStorage 与脚本可读的 cookie,写入 DSH 外壳的 localStorage;下次启动时在页面自身脚本初始化之前写回快照,有变化只重载一次,期间遮罩避免登录页闪烁。快照只存在本机,不上传。HttpOnly cookie 页面读不到,极少数情况仍需重新登录一次。
安装与启用¶
桌面端自带包管理器,不需要自己装 Node.js。官方安装命令:
dsh plugin --profile desktop add dsh-webview
装完重启 DSH:左上角面板列出现地球图标,会话区标签栏多一个「网页端」。
离线安装(本地已有 dsh-webview-0.3.0.tgz 时):
dsh plugin --profile desktop add "C:\path\to\dsh-webview-0.3.0.tgz"
卸载:
dsh plugin --profile desktop remove dsh-webview
兼容性:DSH 0.2.1-rc.1 及以上(desktop) 已验证可用;网页版 DSH 不支持,会显示降级提示。插件依赖公开插槽 sidebar.panellist / main / conversation.view 与 dshDesktop.browser 桥。
典型用法¶
- 任选一个入口:会话区顶部的 网页端 标签,或左上角地球图标(没有任何打开的会话时,会话视图标签栏不渲染,此时用左上角图标)。
- 第一次在页面里登录 DeepSeek 账号;之后重启 DSH 通常不必再登录。
- 顶部工具条提供 刷新 与 在浏览器打开。
适用场景与注意¶
适合:主要在 DSH 桌面端开发、调试智能体,希望少切浏览器、且希望网页端与当前会话并列查看的用户。
务必知晓:
- 仅桌面端;网页版 DSH 无 Electron 宿主,面板会提示当前环境不支持内嵌浏览器。
- 插件以当前 DSH 进程权限运行;安装前应在 GitHub 仓库 查看源码与 MIT 许可证,自行判断是否信任。
- 页面权限受宿主安全策略限制:摄像头、麦克风、剪贴板读取、下载默认不可用。
- 左上角入口按钮固定在左侧面板列末尾。
DSH 生态理念是「一切皆插件」;社区目录 skillhub.cn 为独立站点,与 DeepSeek / 幻方无官方从属关系。