# dsh-deepseek-sidebar

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

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

[English](README.md) | 中文

---

## 你会得到什么

| 操作 | 结果 |
| --- | --- |
| 点左侧栏的 **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 登记：

   ```json
   {
     "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，让加载器解析得到这个包：

   ```bat
   mklink /J "<profile>\node_modules\dsh-deepseek-sidebar" "E:\path\to\dsh-deepseek-sidebar"
   ```
3. **整机重启**应用。客户端 bundle 在启动时定清单，刷新页面不够。

### 托管安装

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

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

## 免登录补丁（一次性）

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

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

```powershell
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`](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](LICENSE)。