dsh-deepseek-sidebar
把 DeepSeek 网页对话放进 DeepSeek Harness 侧边栏。
左侧栏点一行，DeepSeek 免费网页对话（chat.deepseek.com）就在右侧栏打开；你在主区域继续聊，
它不被打断；需要时一键全屏；配合下面的脚本，重启后也不用重新登录。
English | 中文
你会得到什么
| 操作 | 结果 |
|---|---|
| 点左侧栏的 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。
手动安装（所有版本都适用）
- 在
/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 "\node_modules\dsh-deepseek-sidebar" "E:\path\to\dsh-deepseek-sidebar"
- 整机重启应用。客户端 bundle 在启动时定清单，刷新页面不够。
托管安装
dsh plugin --profile add github:/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-（没有 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。
