dsh-plugin-deepseek-chat
Verified@tianyulinfeng1/dsh-plugin-deepseek-chat · v1.1.6 · MIT · Web UI
DeepSeek Chat (chat.deepseek.com) as a DSH sidebar panel and a configurable conversation-header tab: full main-area chat that fills the conversation area, last-conversation memory, a stable login session, crash containment, a settings page (show/hide tab
Install
dsh plugin add @tianyulinfeng1/dsh-plugin-deepseek-chat Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Tags
Creators
Readme
dsh-plugin-deepseek-chat
English | 中文
当前版本:v1.1.6 |适配 DSH 0.2.2-rc.1
在 DeepSeek Harness(DSH)桌面版加入 DeepSeek 聊天:左侧栏图标入口、会话顶栏标签页(默认名「DeepSeek 聊天」,可在设置页开关 / 自定义),点开后 chat.deepseek.com 铺满会话区,记住上次所在的会话;提供设置页面(含插件基础信息与「检查更新」按钮),面板为纯网页聊天,不显示账号状态。

功能
- 两个入口并存:
- 左侧栏图标入口,排在「插件」和「自动化任务」之间,点开后占满主内容区;
- 会话顶栏标签行(「对话 / 轨迹 / 上下文 / 压缩 / 编队 / 统计」那一行)新增标签,通过官方
conversation.view槽注册(id: deepseek-chat-view、order: 100),默认显示名「DeepSeek 聊天」。
- 设置页面(v1.1.4):通过官方
settings.section槽注册「DeepSeek 聊天」设置页(左侧「设置」弹窗导航里)。两项设置:- 显示顶部标签栏(默认开启):关闭后移除顶栏标签,只保留左侧栏入口;
- 顶部标签栏名称(默认
DeepSeek 聊天):输入框默认空白,以灰色占位提示显示默认名;点进去不用删、直接输入新名字即可,留空自动恢复默认,最长 40 字。 - 配置存
localStorage的dsh-plugin-deepseek-chat:config,改完即时生效(标签行会重新注册)。
- 关于本插件(v1.1.5):设置页展示插件版本号、作者(
sweet560)、功能简介、开源许可证(MIT),以及 npm 插件页面 / GitHub 仓库两个https外链(点开由桌面壳用系统浏览器打开)。 - 检查更新(v1.1.5):设置页新增「检查更新」按钮,从 npm 优先、GitHub 兜底 两个公开 JSON 接口读取最新发布版本号(npm
dist-tags.latest、raw.githubusercontent.com上的package.json),按数字逐段比较版本:已是最新 / 发现新版本 / 检查失败都给出文字状态,并附 npm / GitHub 跳转链接。检查中禁用重复点击,网络不可用或两源都失败都有兜底,不新增 Host 路由。 - 图3 修复:网页铺满会话区(v1.1.4):选中顶栏标签时,网页现在撑满整个会话区、盖住 DSH 自己的对话消息与底部输入框;切回「对话」标签即恢复。顶栏入口用不透明绝对定位浮层(
inset: 0、z-index: 50)覆盖会话 body,header 里的标签行仍在上方、随时可点回。 - 两个入口共用同一个网页聊天组件(顶栏多一层铺满浮层包装)和同一个固定分区
panel:deepseek-chat,登录态与会话记忆通用;切走标签页会释放租约、再进入重新申请同一分区。 - 会话区全宽内嵌
https://chat.deepseek.com/(Electron<webview>,走桌面壳的 guest 租约桥window.dshDesktop.browser)。 - 记住上次会话:切到别的面板、切换会话、重启 App 后再进来,直接回到上次那条对话,而不是新对话。
- 登录/鉴权页不会覆盖记忆;记住的会话失效或打不开时自动回退到首页。
- 稳定的登录会话(v1.1.1 修复):guest 分区固定为
panel:deepseek-chat,切换面板/会话回来不会重建分区、不会重新要求扫码。 - 崩溃隔离:内嵌页进程退出、被销毁或启动超时,只在面板里显示「重试」,不会再出现整个 App 变空白窗口的问题(v0.4.0 修复,见下文)。
- 纯网页聊天(v1.1.3):已彻底移除账号状态条、账号探测、5 秒轮询与账号同步 store;面板挂载即申请租约、立即启动,不再等待任何异步账号流程。
- 纯 Web 表层(
dsh web在浏览器里打开)自动不注册——该站点frame-ancestors 'none',iframe 嵌不了,guest 租约桥也只有桌面壳提供。
v1.1.2 修复(web boot 启动失败):v1.1.1 把 npm 包名改为带 scope 的
@tianyulinfeng1/dsh-plugin-deepseek-chat后,lib/client.js里 client bundle 的工厂 id 仍是旧短名dsh-plugin-deepseek-chat,两者不一致使 DSH Host 重复执行同一 bundle、抛出duplicate factory registration,最终web boot: 1 entry did not activate、整个页面启动失败。v1.1.2 已把工厂 id 对齐为完整包名,并在离线自检中新增「工厂 id 必须等于package.json的name」回归断言。详见 docs/RELEASE_NOTES_v1.1.2.md。
v1.1.3:按用户要求移除账号状态显示、新增会话顶栏「网页聊天」标签页;旧的 main / sidebar.panellist 两处 inject 从「同一个 try/catch」改为三处各自独立 try/catch,避免单点失败连带其它入口不注册。
v1.1.4:新增设置页(开关顶部标签栏 + 自定义标签名,默认「DeepSeek 聊天」);修复选中顶栏标签时网页没有铺满会话区、DSH 输入框仍露在下方的问题;图2 红框(网页内自带会话标题胶囊)经用户确认「先不处理」,插件不改动第三方网页。
v1.1.5(本版):设置页新增「关于本插件」基础信息(版本号 / 作者 / 功能简介 / 许可证 / npm·GitHub 链接)与「检查更新」按钮(npm 优先、GitHub 兜底、语义版本比较、文字状态 + 跳转链接、失败兜底);不改动 Host 半侧。
环境要求
| 项 | 要求 |
|---|---|
| DSH | 桌面版 0.2.2-rc.1 或更新 |
| 平台 | Windows / macOS / Linux 桌面壳 |
| git | 仅「GitHub 安装」方式需要(pnpm 通过 git 拉取仓库) |
安装
npm 包名:@tianyulinfeng1/dsh-plugin-deepseek-chat(GitHub 仓库名仍是 dsh-plugin-deepseek-chat)。
方式一:npm(推荐)
dsh plugin --profile desktop add @tianyulinfeng1/dsh-plugin-deepseek-chat
插件页的「安装第三方插件」里也可以直接填包名 @tianyulinfeng1/dsh-plugin-deepseek-chat。
方式二:插件页安装(GitHub)
打开 DSH 桌面版,左侧栏点 插件。
点列表上方的 安装第三方插件。
在「包名或地址」里填入:
github:sweet560/dsh-plugin-deepseek-chat也可以填
https://github.com/sweet560/dsh-plugin-deepseek-chat。点 安装,等 pnpm 跑完(首次会拉取仓库并安装依赖)。
安装完成后插件自动启用,左侧栏出现 DeepSeek 聊天。
方式三:命令行(GitHub)
dsh plugin --profile desktop add github:sweet560/dsh-plugin-deepseek-chat
装完打开 插件 → 已安装插件,确认「DeepSeek 聊天」处于启用状态(命令行只负责装依赖,启用状态以插件页为准)。
方式四:本地目录(二次开发)
dsh plugin --profile desktop add file:"<本仓库绝对路径>"
关于「免扫码 / 与 DSH 账号同步」的真相
纯插件做不到让 chat.deepseek.com 直接复用 DSH 已登录的账号,这不是实现遗漏,而是 DSH 的架构限制(已在 0.2.2-rc.1 源码中逐项核对):
| 项 | DSH 桌面版账号 | chat.deepseek.com 网页版 |
|---|---|---|
| 凭据 | platform.deepseek.com 的 x-dsh-auth-token(Host-only getPlatformSession()) |
站点自带的 Token(api/v0/users/current 无 token 返回 40002 Missing Token) |
| 存放 | Host 进程凭据存储 | guest session 的 httpOnly cookie |
| 兑换入口 | 无;归档中 chat.deepseek.com 零引用,无 SSO、无 cookie 注入 |
— |
- 渲染层桥
globalThis.dshDesktop只有browser.acquire/release/onOpenRequested等,没有getAuthToken、写 cookie、打开 Platform 取 token 的 API;getAuthToken()只存在于桌面壳内嵌 Platform 页(usage/top_up)的专用 preload,且受主帧 + origin 限制。 browserAcquireIPC 只按 workspace 字符串分配分区/租约,configureSession()只设权限与下载拦截,不注入任何凭据;guest 被强制sandbox/contextIsolation/webSecurity。- 因此:DSH 账号与网页版登录态互不相干,首次仍需在网页里扫码一次。v1.1.3 起连「账号状态」的展示也一并删除,面板是纯网页聊天。
v1.1.0 的教训(v1.1.1 已修复,v1.1.3 已彻底移除账号逻辑):曾把 guest 分区绑到异步账号探测结果上。DSH 的 getState() 在重连/切会话时会瞬时失败,分区一变就等于换了个全新 cookie 罐 → 每次切回面板都要求重新扫码。现在:
acquire()的 workspace 恒为panel:deepseek-chat,会话记忆 key 恒为dsh-plugin-deepseek-chat:last-url;- 不再有任何账号探测、轮询、状态订阅或显示条参与 guest 生命周期;
- guest 在挂载时立即启动,不等任何异步 Remote 流程;
- 弹窗导航只放行
chat.deepseek.com与platform.deepseek.com(HTTPS、默认端口)。
想做到「重启 DSH 后也不用重新扫码」,需要按 docs/login-persistence.md 把 DSH 的随机内存分区改成确定性的
persist:分区(运行 scripts/patch-dsh-persistent-partition.cjs,属修改已安装应用,风险自负)。该脚本会同步0.2.2-rc.1的 ASAR 逐文件 SHA256 integrity,纯字节替换会让 DSH 重启崩溃,切勿使用废弃的.mjs版本。补丁要求完全退出 DSH 后才能写入app.asar,且只解决「重启后保留网页 cookie」,不能让网页复用 DSH token。
使用
- 第一次打开会停在 chat.deepseek.com 的登录页,登录一次即可。
- 本次 App 运行期间,切换面板/会话不需要重新登录(v1.1.1 起分区固定)。
- 重启 DSH 后仍需要重新登录一次:DSH 目前给内嵌浏览器的是随机内存分区(
dsh-sidebar-browser-<uuid>,没有persist:前缀),进程退出即清空 cookie。本插件不修改 DSH 的安装文件;想做到「登录一次、长期免登录」,可按 docs/login-persistence.md 做一次等长字节替换(含脚本、验证与回滚)。 - 会话链接记在 App 的 localStorage(固定 key
dsh-plugin-deepseek-chat:last-url),重启后仍会打开上次的会话(前提是已登录且该会话仍存在)。 - 会话顶栏标签(默认 「DeepSeek 聊天」)与左侧栏图标是同一份网页聊天;切到别的标签时本插件的 guest 会被卸载并释放租约,切回来重新加载(分区不变,登录态与会话记忆保留)。
- 设置页面:打开 DSH「设置」弹窗 → 左侧导航「DeepSeek 聊天」,可勾选 / 取消「显示顶部标签栏」、修改「顶部标签栏名称」。名称输入框默认是空白的,只用灰色文字提示「DeepSeek 聊天」;点进输入框即可直接输入新名字,无需先删除默认文字。关闭标签栏后顶栏入口消失,但左侧栏图标仍可用;名字留空自动恢复默认「DeepSeek 聊天」。设置即时生效并保存在本机。
- 关于与检查更新:同页下方展示版本号、作者、功能简介、许可证与 npm / GitHub 链接;点「检查更新」会从 npm(失败则 GitHub)读取最新发布版本号。本地未发版的新版本会领先远端,显示「已是最新版本」;远端更高则显示「发现新版本 x.y.z」,结果下方附有跳转链接;网络不可用会显示失败原因。
- 选中顶栏标签时网页铺满整个会话区,DSH 自己的对话消息与输入框被盖住;点回「对话」标签即恢复,不会丢失会话内容。
登录态持久化(可选,免登录)
DSH 目前给内嵌浏览器分配的是内存分区(dsh-sidebar-browser-${randomUUID()},无 persist: 前缀),所以每次重启 App 都会清空 cookie。想做到「登录一次、以后不再登录」,需要把桌面主进程里的那行分区名改成固定且带 persist: 前缀的值——两条语句字节数相同,可以直接在 resources/app.asar 里原地替换。
完整原因、脚本、验证步骤、回滚方式和各平台路径都整理在这里:
注意:这属于对已安装应用的修改,不在 DSH 支持范围内;DSH 升级会覆盖 app.asar,需要重新打补丁(Partitions 里的登录数据不会丢)。请先备份,风险自负。
已知限制
- chat.deepseek.com 会检测 Electron 内嵌环境,偶尔弹出「使用环境异常…建议使用官方产品」的提示;这是站点侧行为,与本插件无关。
- 仅桌面版有效;
dsh web在浏览器里打开时不显示入口。 - 站点若调整会话 URL 规则(当前识别
/a/chat/s/<id>形式),「记住会话」可能失效并回退到首页。 - 纯插件无法免扫码复用 DSH token;首次仍需在该网页登录一次(见上文)。v1.1.3 起面板不再显示任何账号状态。
- 重启 DSH 后仍需重新登录网页版 chat,除非按 docs/login-persistence.md 打持久分区补丁。
崩溃隔离(v0.4.0)
早期版本出现过:点开面板、聊天页正常显示 1~2 秒后整个 App 变成空白窗口(只剩原生菜单和窗口按钮),没有崩溃对话框也没有 crash-*.log。
根因是 React 卸载面板时先移除 DOM、后执行 effect 清理,而 Electron 的 <webview> 一旦脱离文档,getURL() 就会抛错;DSH 把插件里任何未捕获异常都当作 slot entry crashed in 'root',直接卸载 root slot —— 整个 App UI 因此消失。
现在的实现:
- 所有 guest 调用先判断
element.isConnected再try/catch,清理阶段「先读 URL、再移除元素」; - 每个事件处理器都包
try/catch,异常只落在面板自己的状态里; - 面板外包一层 React 错误边界;
- 监听
render-process-gone/destroyed/did-fail-load,失败时先移除失效的 guest 元素再显示「重试」,避免重试叠加 webview; - 15 秒启动看门狗,guest 一直不
dom-ready就转重试卡片; - 事件监听器若注册失败则不启动 guest;弹窗 URL 走白名单校验(v1.1.0)。
版本历史
| 版本 | 内容 |
|---|---|
| 1.1.6 | OIDC 可信发布链路测试:.github/workflows/publish.yml 启用 permissions.id-token: write、Node 22、npm@latest、npm publish --provenance,移除 NODE_AUTH_TOKEN 与 environment 声明;版本号升到 1.1.6 推送 GitHub,实测 GitHub Actions 能否经 npm Trusted Publisher 自动发布。功能与 1.1.5 相同,仅发布链路变更。 |
| 1.1.5 | 设置页新增关于信息 + 检查更新:新增插件版本号 / 作者 / 功能简介 / 许可证 / npm·GitHub 链接,以及「检查更新」按钮(npm dist-tags 优先、GitHub raw 兜底、数字逐段版本比较、文字状态 + 跳转链接、8 秒超时与失败兜底);元信息常量与 package.json 一致性断言、离线自检全部通过(RESULT: PASS)。 |
| 1.1.4 | 新增设置页 + 顶栏标签可配置 + 网页铺满会话区:新增 settings.section 设置页(开关顶部标签栏、自定义标签名默认「DeepSeek 聊天」,localStorage 持久化、即时重注入刷新标签行);顶栏标签用不透明绝对定位浮层铺满会话 body、盖住 composer 输入框;图2 网页内标题胶囊按用户确认不处理。四处槽位注册、离线自检全部通过(RESULT: PASS)。 |
| 1.1.3 | 移除账号状态显示 + 新增会话顶栏标签页:彻底删除账号状态条、账号探测、5 秒轮询、账号同步 store;新增 conversation.view 顶栏「网页聊天」标签(与左侧栏/全屏面板共用组件与固定分区);三处槽位注册改为各自独立 try/catch。离线自检全部通过(RESULT: PASS)。 |
| 1.1.2 | 修复 v1.1.1 的 web boot 启动失败(重点):工厂 id 与 npm 包名不一致 → DSH 重复执行同一 bundle → duplicate factory registration → 1 entry did not activate、整个页面打不开。已把 lib/client.js 工厂 id 对齐为 @tianyulinfeng1/dsh-plugin-deepseek-chat,并新增「工厂 id 必须等于 package.json 的 name」回归断言;离线自检 35 项全过、30 个 client bundle 扫描 0 不匹配。详见 docs/RELEASE_NOTES_v1.1.2.md。 |
| 1.1.1 | 修复每次切回面板/重启都要重新扫码的回归:guest 分区与会话 key 固定为常量,账号状态仅作展示、不参与 guest 生命周期;瞬时 unknown 被忽略;guest 不再等待异步账号探测;自检改为验证固定分区与状态抖动不重建(35 项)。明确记录「纯插件无法免扫码复用 DSH token」的源码结论。 |
| 1.1.0 | 支持 DSH 0.2.2-rc.1:新增 DSH 账号状态条;修正生成式 Remote 信封解析;收紧会话 URL 与弹窗 URL 校验;失败时移除失效 guest。此版把分区绑到账号状态,导致登录态抖动(已由 1.1.1 修复)。 |
| 1.0.0 | 首个本地版本:侧栏入口、全宽内嵌聊天、会话记忆、崩溃隔离。 |
开发
git clone https://github.com/sweet560/dsh-plugin-deepseek-chat.git
cd dsh-plugin-deepseek-chat
node test/check-client.mjs
test/check-client.mjs 是离线自检:在 node:vm 里加载 lib/client.js,用假的 React/DOM/租约桥验证四处槽位注册(左侧栏 / 全屏主面板 / 顶栏标签页 / 设置页)、配置层(默认值、类型校验、持久化、订阅通知、动态重注入)、顶栏浮层的铺满样式、工厂 id 与包名一致、Web 表层 inert、两入口共用固定分区、纯网页聊天无账号条、URL 白名单、会话记忆、租约释放、弹窗白名单和崩溃隔离;并用 mock fetch 验证基础信息常量与 package.json 一致、语义版本比较、更新载荷解析、npm/GitHub 兜底、检查更新各状态分支与设置页点击联动。
目录:
lib/index.js 宿主半侧(空实现,只为让 client bundle 有 Loader 入口)
lib/client.js 浏览器半侧:入口、网页聊天面板、顶栏铺满浮层、设置页与配置层、关于信息/检查更新、webview 生命周期、崩溃隔离
cordis.patch.yml bundle 补丁:插入本插件的 Loader 行
locale/zh.json 插件页显示名称/描述(中文)
locale/en.json 插件页显示名称/描述(英文)
icon.svg 插件页图标
docs/login-persistence.md 可选:DSH 内存分区改持久分区的字节补丁
test/check-client.mjs 离线自检
卸载
dsh plugin --profile desktop remove @tianyulinfeng1/dsh-plugin-deepseek-chat
作者
- 作者:伍悦匿匿
- 联系方式:[email protected]
- GitHub:https://github.com/sweet560
- 博客园:https://www.cnblogs.com/wuyuenini/
- CSDN:https://blog.csdn.net/weixin_42076389
- Gitee:https://gitee.com/wtt520wyl
- Gitee 镜像仓库:https://gitee.com/wtt520wyl/dsh-plugin-deepseek-chat