侧栏网页对话 Dcmwfg/dsh-deepseek-sidebar

dsh-deepseek-sidebar

把 DeepSeek 网页对话放进 DeepSeek Harness 侧边栏。

左侧栏点一行，DeepSeek 免费网页对话（chat.deepseek.com）就在右侧栏打开；你在主区域继续聊，它不被打断；需要时一键全屏；配合下面的脚本，重启后也不用重新登录。

你会得到什么

| 操作 | 结果 |
| 点左侧栏的 DeepSeek 行 | 右侧栏打开 DeepSeek 标签页，主区域的会话原样不动 |
| 点标签工具条的 全屏 | 对话铺满主区域 |
| 点全屏工具条的 收进右侧栏 | 回到右侧栏 |
| 重启 DSH | 对话仍是登录状态（见免登录补丁） |

网页视图复用侧边栏浏览器的 partition（persist:zcodebrowseruse），和内置「自有浏览器」同一个 cookie 罐子 —— 不用第二个账号，也不用折腾 token。

环境要求

- DeepSeek Harness 桌面版（Electron），界面里要有 sidebar.panellist、main、 sidebarRightTabs、sidebar.right.pane.tab 这几处席位。
- Node.js 20+（DSH 自带，无需另装）。
- 只有 tools/apply-persist-patch.ps1 限 Windows；插件本身跨平台。

安装

本插件就是一个标准 DSH bundle：package.json + 宿主半边 index.js + 客户端半边 client.js
+ cordis.patch.yml。

手动安装（所有版本都适用）

1. 在 <profile>/package.json 里加依赖与 bundle 登记：

{
"dependencies": { "dsh-deepseek-sidebar": "link:E:/path/to/dsh-deepseek-sidebar" },
"dsh": { "profile": { "bundles": ["dsh-deepseek-sidebar"] } }
}

必须写成 UTF-8 无 BOM —— 宿主直接 JSON.parse，带 BOM 会让整个 profile 静默失效。
2. 建 junction，让加载器解析得到这个包：

mklink /J "<profile>\node_modules\dsh-deepseek-sidebar" "E:\path\to\dsh-deepseek-sidebar"

3. 整机重启应用。客户端 bundle 在启动时定清单，刷新页面不够。

托管安装

dsh plugin --profile <profile> add github:<owner>/dsh-deepseek-sidebar

仅当你的版本允许给该 profile 装第三方 bundle 时可用；否则走上面的手动流程。

免登录补丁（一次性）

DSH 默认给每个侧边栏 webview 分配随机、只在内存里的 partition，进程一退 cookie 就没了，所以每次启动都要重新登录。插件自己改不了这一点：主进程会拒绝 partition 与它签发的租约不一致的访客。

tools/apply-persist-patch.ps1 改写决定这件事的那一条语句：

pwsh -File tools\apply-persist-patch.ps1 # 打补丁（幂等，留 app.asar.orig-bak） pwsh -File tools\apply-persist-patch.ps1 -Check # 只检查 pwsh -File tools\apply-persist-patch.ps1 -Restore # 还原

| 改前 | 50 字节的模板串，生成 dsh-sidebar-browser-<uuid>（没有 persist: 前缀） |
| 改后 | partition="persist:"+workspace.replace(/\W/g,""); （同样 50 字节） |

DSH 升级会替换 app.asar，升级后必须重跑一次脚本，否则登录又会开始丢。补丁是等长、原地写入，不会破坏头部/偏移/完整性字段，且幂等 —— 跑两遍没副作用。

实现原理

左侧栏那一行（sidebar.panellist，id "deepseek-chat"）点击 -> ctx.layout.selectPanel("deepseek-chat") （ui-sidebar.js 里硬编码）我们的影子方法拦截这个 id -> sidebarRight.openTab("deepseek-chat") 右侧栏标签页 -> 右侧列没展开就展开主区域保持会话不变（不发生任何重挂载）

右侧栏标签（kind "deepseek-chat"，id "dsh-deepseek-sidebar/chat"，keepMounted）主体 = ChatBody(mode="tab")，webview 跑在 partition persist:zcodebrowseruse 工具条：后退 / 前进 / 刷新 / 主页 / 全屏全屏 -> main key "deepseek-chat-full" = ChatBody(mode="full")

那种「看起来更简单」的做法 —— 注册一个 main entry，挂载时开标签再退回会话 —— 走不通。
具体调用点见 docs/architecture.md。一句话：selectPanel(id) 会把主区域的会话整个换掉，而右侧栏 surface 是挂在会话下面的，等重定向跑起来它已经没了（sidebarRight: no session surface is mounted）。

诊断

桌面壳跑在 dsh-app:// 源上，渲染进程 console 外面读不到，所以宿主半边开了一条同源路由：

| 方法 | 路径 | 作用 |
| GET | /deepseek-sidebar/report | 取已收集条目（?clear=1 清空） |
| POST | /deepseek-sidebar/report | 客户端批量上报 { source, entries } |

条目同时追加到 %TEMP%\dsh-deepseek-sidebar\diag.log（可用 DSH_DEEPSEEK_SIDEBAR_LOG 改路径）。
值得读的事件：patch:layout、patch:intercept、openTab:ok|error、toSidebar:result、 guest:acquired|did-finish-load。

限制

- 没有 sidebarRight 服务的版本里，这一行会退化成全屏打开（标签页放不进去）。
- keepMounted: true 让标签页的 webview 在全屏出现时仍然活着，所以某一刻可能有两个 webview；因此每个 ChatBody 各自持有自己的 guest 租约。
- DSH 自身的平台登录无法被网页对话复用：那份凭据只作用于账号源，且会在关闭时清理。
侧边栏 partition 是唯一能复用的会话。

卸载

从 profile 的 dependencies 与 dsh.profile.bundles 里删掉包名，删除 junction，重启。
想连 asar 也恢复原状，用 -Restore 跑一次补丁脚本。

许可

MIT —— 见 LICENSE。