前言¶
在 DSH Desktop 里做智能体或长会话时,经常需要对照 chat.deepseek.com 上的对话:一边在 Harness 里写提示、跑工具,一边在网页里追问或核对回答。手动切窗口、复制粘贴既慢,也容易漏掉上下文。社区插件 dsh-deepseek-chat(维护者 Lumos0121)在侧边栏底部增加一个入口,把「打开网页版」和「把那边对话送进当前会话」收成五个固定选项,并针对 Desktop 右侧栏与系统浏览器两条路径分别做了兜底。
下面按定位、功能、安装与用法、注意事项说明;事实以 GitHub 仓库 README 为准。这不是 DeepSeek 官方项目。
这是什么¶
dsh-deepseek-chat 是 DSH Desktop 的客户端插件(分类:客户端)。它在侧边栏底部加一个气泡按钮,展开后提供五项操作:在右侧边栏内嵌打开、用系统浏览器打开 https://chat.deepseek.com/、读取右侧边栏内对话、读取系统浏览器对话、自定义各选项的鼠标悬停提示词。
插件当前版本为 1.0.0(见 package.json),许可证 MIT,仓库约 1 star,自带 91 条离线测试(npm test,不联网、不依赖已安装的 DSH)。
核心功能¶
打开 chat.deepseek.com¶
- 在右侧边栏内打开:调用 DSH 第一方 API
ctx.sidebarRight.openTab('browser', { params: { url } }),在 Desktop 右侧栏用 Electron<webview>加载聊天站。若当前环境没有右侧栏浏览器能力(例如在 Web 版 DSH 里用 iframe,会因站点Content-Security-Policy: frame-ancestors 'none'无法内嵌),插件不会假装成功,会退回系统浏览器并在状态里说明「右侧栏不可用」。 - 在系统浏览器打开:通过
window.open经 Electron 主进程setWindowOpenHandler转给shell.openExternal,由系统默认浏览器打开;登录态由浏览器自己保存。
把网页对话送进当前 Harness 会话¶
- 读取右侧边栏内对话:在 Desktop 上定位
webview[data-sidebar-browser-frame],在 guest 页面内优先用网页版 IndexedDB 缓存或内部接口GET /api/v0/chat/history_messages拉取全文,再经POST /api/v0/share/create生成分享链接(与网页上手动「分享」同一路径);接口不可用时再尝试 DOM 点击分享流程。正文会按角色拼成【我】/【DeepSeek】等形式写入当前会话。 - 读取系统浏览器对话:系统浏览器没有可编程接口,此选项为半自动——从剪贴板读取你复制的分享链接或整段正文,再送入当前会话。
自定义悬停提示¶
- 自定义提示词:修改上述几项菜单的悬停说明,保存在本机
localStorage(键dsh-deepseek-chat:texts),保存后即时生效,不随插件包分发。
插件不做什么(使用前建议读完)¶
- 插件不连接除
https://chat.deepseek.com/以外的服务器,无遥测、无第三方依赖;/api/v0/...请求由该网页在你登录态下自行发出。 - 两个「读取」选项会走网页版分享流程:会为对话创建公开分享链接(若已有属于当前会话的链接则复用)。不需要留链接时请勿使用,或事后在网页版分享记录中删除。
- 登录令牌仅在 chat 页面或
<webview>上下文中使用(如localStorage.userToken或 cookie),不写文件、不写日志;右侧栏分区在应用重启后不保留 Cookie/Web 存储(官方文档所述),需要持久登录时请用系统浏览器路径。
安装与启用¶
官方 README 给出的安装方式如下(不是 dsh plugin add 一类命令):
- 到 Releases 下载
dsh-deepseek-chat-1.0.0.zip。 - 解压到本机磁盘(避免 OneDrive 或网络盘路径)。
- 双击解压目录中的
install.cmd。 - 完全退出并重新打开 DSH Desktop。
修改插件源码后,变更在 lib/client.js 中生效需要重启 DSH——客户端脚本在页面启动时编入 window.__DSH_BOOT__,热重载看不到客户端产物。
典型用法¶
- 在 DSH Desktop 中打开任意会话,点击侧边栏底部的气泡图标,展开菜单。
- 若希望在 Harness 同屏对照,选 在右侧边栏内打开,在右侧完成登录与对话;需要长期登录态时选 在系统浏览器打开。
- 对话准备好后,选 读取右侧边栏内对话(侧栏路径)或先在浏览器中复制分享链接再选 读取系统浏览器对话(浏览器路径),将内容注入当前会话继续编排或总结。
- 需要改菜单说明时,选 自定义提示词,编辑后保存即可。
再点一次气泡或按 Esc 可收起菜单。任一步失败时,插件会在无障碍状态区域如实报错,不假装成功。
适用场景与注意¶
适合谁:主要在 DSH Desktop 上使用 Harness、又习惯在 DeepSeek 网页版聊天、希望减少窗口切换与手工粘贴的开发者。
权限与信任:插件以当前 DSH 进程权限运行;安装前请阅读 源码 与 MIT 许可证,并理解「读取」会创建公开分享链接的行为。
稳定性:读取能力依赖网页版内部接口与 DOM 启发式,站点改版可能导致失效;README 中有「失败怎么表现」的说明。
开发与自测(维护者或二次开发者):在已 clone 的仓库中执行 npm test 可跑 91 条离线用例;需 Node >=22。
结尾¶
dsh-deepseek-chat 把 DeepSeek 网页版打开方式与对话回读收敛到侧边栏五个选项,并明确区分 Desktop 右侧栏与系统浏览器、自动读取与剪贴板半自动路径。目录与元数据可在 SkillHub 查看:lumos0121/dsh-deepseek-chat;源码与安装包见 GitHub。