WJMACTD/dsh-deepseek-site ↗★ 0
dsh-deepseek-site
Embed the DeepSeek official chat site inside the app window from a sidebar entry, kept alive across panel switches, with sign-in that survives restarts. · 左侧栏直达 DeepSeek 官网:中央面板内嵌,切走不重载,重启免登录。
インストール
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:WJMACTD/dsh-deepseek-siteドキュメント
README 全文を読む ↗dsh-deepseek-site
在 Harness 左侧图标栏加一个入口,点开后在应用窗口内部的中央面板里直接显示 ,不跳系统浏览器,并跨重启保留登录。
功能
左侧图标栏一个入口,点开就是中央面板里的完整页面:
- 切走不卸载:页面常驻在
document.body上,切到别的面板再回来,对话、滚动位置、正在生成的回答都还在原处(页面不重载)。 - 面板顶部一条紧凑工具栏:标题、登录态、重新加载、在系统浏览器打开(兜底)、忘记本机登录。
- 顶部留白按平台走:Windows 的标题栏由外层框架预留,页面只留 16px;macOS 才叠加
--dsh-frame-top-clearance。 - 同一个
WORKSPACE_KEY复用同一个 guest 分区,进程内一直在。 - 应用重启后自动回填上次的登录快照,免重复登录;回填期间盖一层遮罩,看不到登录页闪烁。
- 白名单导航:
chat.deepseek.com站内跳转留在内嵌页,站外 https 链接交给系统浏览器,2 秒内同一个地址只开一次。 - UA 只去掉
Electron/这一个产品标记,平台/内核/版本原样保留;站点对「使用环境异常」的判断就是 UA 里有没有electron字样,所以这个标记必须在页面脚本跑起来之前就抹掉(挂载前写useragent属性 +dom-ready再补一次setUserAgent)。 - 运行环境没有
window.dshDesktop.browser(例如普通浏览器里打开 Web UI)时,面板显示说明卡片并给出兜底按钮,不静默跳转。
登录记忆
外壳给每个 workspace 分配的分区是进程内生命周期的(dsh-sidebar-browser-,没有 persist: 前缀),所以 guest 自己的 localStorage 在应用重启后就空了。插件用「快照 + 回放」绕开:
- guest 在站点文档上每次
did-finish-load、站内路由变化、以及每 15 秒(且仅在窗口可见时)执行CAPTURE_SCRIPT,只读userToken/__appKit_userInfo两个键; - 有 token 就写进应用文档自己的 localStorage(
deepseek-site:sign-in:v1)。应用文档是dsh-app://app/(registerSchemesAsPrivileged里standard: true),默认 session 持久化,所以快照能跨重启保留; - 下次打开面板,
did-finish-load时先executeJavaScript(restoreScript(...))把快照写回 guest 的 localStorage,写过就reload()一次,站点启动时直接看到有效 token; - guest 里已有有效 token(同一次运行内切面板)则不覆盖,避免把新登录态写回旧值。
工具栏的「已记住登录」胶囊表示快照已保存;旁边的状态文字说明最近一次打开走了哪条路:
| 状态 | 含义 |
|---|---|
| 已回填登录 | 快照写进内嵌页并重新加载了一次 |
| 登录有效 | 内嵌页本来就有 token,没有覆盖 |
| 无登录快照 | 本机还没记录过登录,或回填被拒 |
忘记本机登录
工具栏上的「忘记本机登录」(只有存在快照时才出现)会同时删掉应用文档里的快照和 guest 里的两份凭据,然后重载内嵌页,站点回到登录页。如果只删应用文档,下一次捕获会把仍然登录的 guest 里的 token 又写回去,所以两边都要清。
诊断记录
面板每次在站点文档上完成加载时,会在应用文档的 localStorage 写一条 deepseek-site:diag:v1(环形缓冲,最近 20 条,且只在结论/次数/token 长度变化时才追加)。每条只有四个字段:at(时间)、note(本次回填结论)、attempts(回填尝试次数)、tokenLen(快照里有效 token 的字符数)。这条记录不含 token、响应体、cookie 名和完整 URL。
隐私与凭据
- 快照是明文 JSON,存在本机应用数据目录里(Harness 桌面版的 Electron 用户数据目录,其下
Local Storage/leveldb)。它与 Harness 自身的登录态同等敏感:能读这个目录的人就能拿到你的 DeepSeek 账号凭据。 - 快照只保留两个键:
userToken(凭据本体)和__appKit_userInfo(站点恢复会话身份用的用户资料)。__appKit_*特性位、__ds_remote_feature_did之类的键刻意不复制——站点自己会重建,复制只会扩大暴露面。 - 快照在应用文档的 localStorage 里,与 Harness Web UI 同源,因此同源的插件代码理论上也能读到。不要装来路不明的插件。
- 不想要了:点「忘记本机登录」,或移除插件后手动清理应用数据目录。
WORKSPACE_KEY(client.js:19)刻意是固定值dsh-deepseek-site,不按工作区拆分:外壳按这个键缓存一个 guest 分区,固定值让所有工作区共用同一个内嵌浏览器容器,登录态与站点偏好不会随工作区切换而重来。代价是工作区之间不再隔离浏览容器——对本插件(只开一个固定站点)来说是划算的。
文件
| 文件 | 作用 |
|---|---|
package.json | bundle 清单:dsh.bundle.patch、exports、dsh.client |
cordis.patch.yml | 把 deepseek-site 这一行插入 profile |
index.js | 宿主侧 apply() {}(空实现,仅为满足 bundle 入口) |
client.js | 客户端模块:注册 sidebar.panellist 图标 + main 面板,一处 guest 实例的内嵌逻辑 |
locale/zh.json、locale/en.json | 插件市场展示用的 meta.title / meta.description(界面文案内联在 client.js,平台只从 locale JSON 读 meta) |
icon.svg | 128×128 原创图标 |
test-signin.cjs | 登录快照逻辑的单元测试 |
docs/architecture.md | 时序图:点开入口、切走保活、重启回填,以及容器结构与状态机 |
docs/pitfalls.md | 本机(Windows 沙箱 + 这个 profile)踩过的环境坑速查 |