前言¶

在 DeepSeek Harness（DSH）里做智能体或日常开发时，主界面往往留给当前会话；若还要打开 chat.deepseek.com 查资料或试 prompt，常见做法是切浏览器或另开窗口，对话状态和登录态也容易和桌面壳脱节。社区插件 dsh-deepseek-sidebar（维护者 Dcmwfg，分类：客户端）把免费网页版 DeepSeek Chat 嵌进 DSH 左侧栏一行入口：点开后在右侧分栏加载，需要时可全屏，并复用侧栏浏览器分区以共用 Cookie。DSH 生态主张「一切皆插件」；插件目录站 skillhub.cn 为社区收录，与 DeepSeek / 幻方无官方从属关系。

这是什么¶

dsh-deepseek-sidebar 是一个面向 DSH 桌面端（Electron）的 bundle 插件（当前资料中版本 1.1.0，许可证 MIT）。它在左侧边栏增加 DeepSeek 一行，点击后在右侧边栏打开带标签页的 chat.deepseek.com WebView，主区域仍可继续当前 Harness 会话；标签工具栏支持全屏与收回侧栏。WebView 使用分区 persist:zcodebrowseruse，与内置侧栏浏览器同一 Cookie 罐，无需第二套账号或自行搬运 token。

核心功能¶

下面行为均来自项目 README 中的说明表。

实现上，左侧行挂载在 sidebar.panellist（id deepseek-chat）；右侧标签类型为 deepseek-chat，id 为 dsh-deepseek-sidebar/chat，并设置 keepMounted 以保持 WebView 存活。全屏时使用主区域键 deepseek-chat-full。插件通过拦截 selectPanel("deepseek-chat") 打开右侧标签并展开右列，而不是用 main 入口跳转——否则会在会话表面卸载后再打开侧栏，导致「无 session surface」类失败（细节见仓库 docs/architecture.md）。

诊断方面，宿主提供同源路由：GET/POST /deepseek-sidebar/report；日志默认写入 %TEMP%\dsh-deepseek-sidebar\diag.log，可用环境变量 DSH_DEEPSEEK_SIDEBAR_LOG 覆盖。

环境与依赖¶

• DSH 桌面 UI 需暴露 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。

托管安装（构建支持第三方 bundle 时）¶

在资料给出的命令中，将 <profile> 换成你的 profile 名：

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

若当前构建不接受该 profile 的第三方 bundle，请用手动方式。

手动安装（各构建通用）¶

1. 在 <profile>/package.json 中加入依赖与 bundle 条目（路径改为本机实际目录），文件须为 UTF-8 无 BOM：

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

2. 建立目录联接，便于 loader 解析包（Windows 示例）：

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

3. 完全重启 DSH。客户端 bundle 在启动时解析，仅刷新页面不够。

安装前请自行查看 GitHub 仓库 源码与 MIT 许可证；插件以当前 DSH 进程权限运行，第三方 bundle 需按组织安全策略评估。

持久登录（一次性补丁）¶

默认情况下，部分 DSH 构建为每个侧栏 WebView 使用随机、仅内存分区，进程退出后 Cookie 丢失，每次启动都要重新登录网页聊天。插件无法单独改分区：主进程会拒绝与下发分区不一致的 guest。

仓库提供 tools/apply-persist-patch.ps1，原地改写决定分区的那条语句（与 persist: + workspace 相关，长度不变、可重复执行）：

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 # 回滚

DSH 升级会替换 app.asar，每次升级后需重新执行补丁脚本，否则登录态会再次失效。

典型用法¶

1. 按上文完成安装并完全重启 DSH。
2. 在左侧边栏点击 DeepSeek，在右侧标签页完成 chat.deepseek.com 登录（首次）。
3. 需要大屏输入时，在标签工具栏使用 Fullscreen；结束后用 Dock to sidebar 收回。
4. 若在 Windows 上希望重启后仍保持网页登录，执行持久化补丁脚本一次，并在每次 DSH 升级后复查。
5. 排障时可访问 GET /deepseek-sidebar/report（?clear=1 可清空），或查看诊断日志中的 patch:layout、openTab:ok|error、guest:did-finish-load 等事件。

卸载时从 profile 的 dependencies 与 dsh.profile.bundles 移除包、删除联接并重启；若曾打补丁，可用 -Restore 恢复 asar。

适用场景与注意¶

适合：希望在 DSH 同一窗口内并排使用 Harness 会话与官方网页聊天、且接受侧栏 WebView 方案的用户。

限制（README 已写明）：

• 无 sidebarRight 服务时，左侧行仍可打开全屏页，但右侧标签不会出现。
• 全屏与侧栏标签可能短暂共存两个 WebView（keepMounted: true）。
• DSH 平台账号登录不能直接给网页聊天复用；可复用的是侧栏分区上的网页会话。
• 无持久补丁时，重启后仍需重新登录网页。

GitHub 仓库当前公开星标为 1（以目录页与仓库页为准）。

结尾¶

dsh-deepseek-sidebar 用一行侧栏入口把 chat.deepseek.com 放进 DSH 右栏与全屏流程，并通过对内置浏览器分区的复用降低重复登录成本；Windows 用户还可选用官方文档中的 asar 补丁保留 Cookie。进一步了解与安装：

• 社区目录：https://www.skillhub.cn/plugins/Dcmwfg/dsh-deepseek-sidebar
• 源码与文档：https://github.com/Dcmwfg/dsh-deepseek-sidebar