桌面聊天面板 JaMoLpE88/dsh-desktop-chat

dsh-desktop-chat

在 DeepSeek Harness Desktop 里打开 DeepSeek Chat 官网（chat.deepseek.com），显示在中央面板，走桌面端内置的原生浏览器。侧边栏一个入口，页面是真的，关掉应用会话也不丢。

英文摘要

在 DeepSeek Harness Desktop 里打开 DeepSeek Chat 官方网页应用（https://chat.deepseek.com/）：侧边栏一个入口，通过 shell 的原生浏览器 guest 在中央栏渲染真实页面，手动登录后重启整个应用依然有效。面板显示的是官网——没有重新实现聊天，没有智能体工具，没有模型服务商，没有网络服务。

dsh plugin --profile desktop add @jamolpe88/dsh-desktop-chat

要求：DSH Desktop >= 0.2.1-rc.3，配置档 desktop（已在 Windows 11 测试）。持久化保存页面自身的 localStorage 和非 HttpOnly cookie；HttpOnly cookie 插件拿不到。诊断：GET /api/dsh-desktop-chat/state，请求头 x-dsh-desktop-chat: 1。

做什么

- 在 DSH Desktop 侧边栏加一个「Chat DeepSeek」入口。
- 在中央面板显示 https://chat.deepseek.com/，官方界面原样保留。
- 启动时恢复会话，不用每次打开 DSH 都重新登录。
- 切换面板时页面保持存活：隐藏再回来，不重新加载，也不掉登录。
- 提供诊断（/api/dsh-desktop-chat/state），以及一条清除已保存会话的路由。

不做什么

- 不重新实现聊天，也不用自建界面替换官网。
- 不把 DeepSeek 变成模型服务商、智能体或自动化工具。
- 不碰 DSH 的模型、智能体、插件或服务商。
- 不保存密码，不读取你个人浏览器的配置档，不向任何地方发送凭据。
- 保不住 HttpOnly cookie：DSH 不向插件暴露视图的 cookie 存储。

要求

- DSH Desktop >= 0.2.1-rc.3，配置档 desktop（web 配置档不提供内置浏览器）。
- Windows 11（已测试），macOS/Linux 未测试。
- 运行时无依赖；不需要单独安装 Node。

安装

用 npm 上已发布的包：

dsh plugin --profile desktop add @jamolpe88/dsh-desktop-chat

从仓库安装：

dsh plugin --profile desktop add github:JaMoLpE88/dsh-desktop-chat

开发期间，用本地包：

dsh plugin --profile desktop add C:\ruta\a\dsh-desktop-chat

安装后重启 DSH Desktop。侧边栏会出现「Chat DeepSeek」入口。

使用

1. 点侧边栏的「Chat DeepSeek」：页面在中央面板加载。
2. 在官网里手动登录一次。
3. 之后随时回来（隐藏再显示面板，不重新加载页面，也不掉登录）。
4. 重启 DSH 后，插件会先恢复页面状态再显示：你应该仍处于登录状态。

如果重启后出现登录界面，先别急着重新登录，先看下面的诊断：可能快照没保存成功，值得查清原因。

哪些数据会保留，哪些不会

DSH Desktop 给每个浏览器视图分配一个只存在于内存中的会话分区（每次启动都换一个随机名字）。插件无法配置它，也没有公开 API 能读取其中的 cookie。所以会话只能在页面层面保留：

| 数据 | 是否保留？ | 位置 |
| chat.deepseek.com 的 localStorage（含 userToken） | 是 | %USERPROFILE%\.dsh\dsh-desktop-chat\session.json（或 $DSH_HOME） |
| 页面可见的 cookie（document.cookie） | 是 | 同一文件 |
| HttpOnly cookie（WAF/Cloudflare：cf_clearance、aws-waf-token…） | 否 | 当前 DSH 中插件无法访问 |
| 密码 | 从不 | — |

说句实话：DeepSeek 用 localStorage 里的 token 做认证，所以会话应该能保留下来。丢掉 WAF cookie 可能导致重启后触发反机器人验证；这取决于网站，不取决于插件。

诊断

打开 DSH，在界面同一 URL 下（例如 http://127.0.0.1:59863）：

curl -H "x-dsh-desktop-chat: 1" http://127.0.0.1:59863/api/dsh-desktop-chat/state

只返回计数和布尔值，绝不返回凭据：

{
"ok": true,
"panelId": "deepseek-chat",
"url": "https://chat.deepseek.com/",
"session": {
"file": "C:\\Users\\<usuario>\\.dsh\\dsh-desktop-chat\\session.json",
"exists": true,
"savedAt": "2026-10-25T09:12:44.120Z",
"hasUserToken": true,
"storageKeys": 24,
"cookieBytes": 275
},
"last": { "restore": { "...": "..." }, "save": { "...": "..." } }
}

hasUserToken 是关键信号：登录后如果它是 false，说明保存没生效，会话无法保留。

清除会话

关闭标签页/面板，在 DSH 打开的状态下执行：

curl -X POST -H "x-dsh-desktop-chat: 1" http://127.0.0.1:59863/api/dsh-desktop-chat/session/forget

这会删除快照。下次启动时页面会重新要求登录。如果你在网站里退出登录，插件会检测到并一并清理快照。

也可以在 DSH 关闭时手动删除 ~/.dsh/dsh-desktop-chat/session.json。

工作原理

- Host 侧（lib/index.js，DSH 的 Host 进程）：在 ctx.webServer 上注册四条路由，以原子方式保存快照并设置用户权限，且从不导入 electron。细节和证据见 docs/architecture.md。
- Client 侧（lib/client.js）：用同一个 id 注册侧边栏行（sidebar.panellist）和面板（main），预留一个原生 guest，并让 <webview> 保持在 React 树之外
- 隐藏面板不会销毁它。
- 恢复：加载源时，写入 localStorage 和 document.cookie，重载一次，之后每 10 秒保存一次，隐藏面板时也保存。
- 保护：会话为空时保存，不能覆盖原本有会话的快照；显式关闭会话则会清空它。

兼容性

| DSH | >= 0.2.1-rc.3（作者唯一测试过的版本） |
| Node | >= 22 |
| 操作系统 | Windows 11（已测试）；macOS 和 Linux 未测试 |
| 配置档 | desktop（web 配置档没有原生访客） |
| @jaychang1989/dsh-webchat | 不需要；不建议同时安装两者 |

验证状态：已在 Windows 11 上用 DSH Desktop 0.2.1-rc.3 测试（2026-10-25）。在面板中手动登录，完全关闭 DSH，重新打开，会话仍然有效：新启动时，插件在加载页面之前恢复了 27 个键——包括 token——页面加载后没有要求凭据。隐藏再重新显示面板，页面保持不变（访客不会被卸载）。

未验证：macOS、Linux、其他 DSH 版本，以及 DeepSeek 开始要求 HttpOnly cookie 时的行为。

开发

node --test

测试覆盖 Host 侧（路由、快照、保护、不含密钥的诊断）和 Client 侧（slot 注册、访客预留、恢复、隐藏而不卸载），使用模拟 DOM。

归属与许可

自行实现，灵感来自 jaychang1989/dsh-webchat 及其前身 xmuwenxiang/dsh-web-chat，两者均为 Apache-2.0。复用了什么（概念，而非代码）详见 NOTICE。

Apache-2.0。