侧栏内嵌对话页 WJMACTD/dsh-deepseek-site

dsh-deepseek-site

在 Harness 左侧图标栏加一个入口，点开后直接在应用窗口内部的中央面板里显示 <https://chat.deepseek.com/>，不跳系统浏览器，跨重启保留登录。

功能

左侧图标栏一个入口，点开就是中央面板里的完整页面：

- 切走不卸载：页面常驻在 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-<uuid>，没有 persist: 前缀），所以 guest 自己的 localStorage 在应用重启后就空了。插件用「快照 + 回放」绕开：

1. guest 在站点文档上每次 did-finish-load、站内路由变化、以及每 15 秒（且仅在窗口可见时）执行 CAPTURE_SCRIPT，只读 userToken / __appKit_userInfo 两个键；
2. 有 token 就写进应用文档自己的 localStorage（deepseek-site:sign-in:v1）。应用文档是 dsh-app://app/（registerSchemesAsPrivileged 里 standard: true），默认 session 持久化，所以快照能跨重启保留；
3. 下次打开面板，did-finish-load 时先 executeJavaScript(restoreScript(...)) 把快照写回 guest 的 localStorage，写过就 reload() 一次，站点启动时直接看到有效 token；
4. 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 沙箱 + 这个配置档）踩过的环境坑速查 |