Dcmwfg/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。

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

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。