dsh-deepseek-web-sync

DeepSeek 网页版侧栏 · 同步

把 DeepSeek 网页版常驻在 DeepSeek Harness 主对话右侧。
左边用 Harness 的 DeepSeek API 对话，右边用 DeepSeek 网页版；主题、登录和提问都尽量连在一起。

技术来源 / Author：ZCFE327

一个面向 DeepSeek Harness Desktop 的右侧栏插件：不使用 iframe、不弹外部链接、不代理聊天内容，用 Electron 隔离 webview 承载真实网页版，并把主题、登录态和提问文本接入 Harness。

3.1.0 更新：新增“上下文”抓取、抓取后自动填入、填入并发送（若 inputActions 暴露发送方法）、主题手动重同步和登录恢复失败提示；抓取预览会标注来源与读取边界。

GitHub 仓库 · 快速开始 · 详细设计文章

---

目录

• 为什么做这个插件
• 功能一览
• 安装
• 使用
• 同步机制
• 架构
• 安全边界
• 已知限制
• 开发
• 技术来源

---

为什么做这个插件

DeepSeek API 适合在 Harness 里执行任务，DeepSeek 网页版则保留了完整的聊天体验、历史会话和网页端能力。过去要在两者之间切换，通常需要：

• 在 Harness 和浏览器之间来回切窗口；
• 把网页里的问题复制出来，再粘贴到 Harness；
• 手动把 Harness 的深色模式、主题色和网页版对齐；
• 每次启动重新登录网页版；
• 处理网页的 X-Frame-Options、弹窗和外部浏览器跳转。

这个插件把上述动作收进一个右侧栏标签：打开 Harness 时网页版自动出现，主题跟随 Harness，网页登录只需一次，选中的提问可以直接进入 Harness 输入框。

功能一览

安装

换电脑安装、首次登录和常见问题，见 QUICKSTART.md。

环境与兼容性

• 必须使用 DeepSeek Harness Desktop（Electron 外壳），并启用右侧栏和 Web Client；
• 插件没有 Host 资源、原生依赖或构建步骤；
• 普通浏览器中的 Harness Web 没有隔离 webview 能力；面板会明确显示“仅桌面版”，不会偷偷打开外部浏览器。

从本地目录安装

1. 下载或克隆本仓库到本地目录：

   git clone https://github.com/S-anZZz/dsh-deepseek-web-sync.git
   

2. 在 Harness 的 插件管理 中选择从本地目录安装，或调用：

   plugin_manager install_bundle <本仓库绝对路径>
   

3. 安装完成后插件会自动启用；每个会话第一次打开时，右侧栏会出现 DeepSeek 网页版。

4. 若标签被手动关闭，点对话标题栏右侧的 网页版 按钮，或在右侧栏标签条的 + 中选择 DeepSeek 网页版。

本插件没有构建步骤，也没有 npm 运行时依赖；package.json 直接声明 dsh.bundle.patch 和 dsh.client。

使用

1. 首次登录：在右侧网页中用你平时使用的 DeepSeek 账号登录一次。
2. 正常提问：右侧网页版可以像浏览器一样使用；左侧 Harness 继续使用 DeepSeek API。
3. 抓取内容：
   • 在网页中选中文字 → 顶部 选区；
   • 或点 输入框 抓取网页输入框里的内容；
   • 或点 最近提问 尝试读取最后一条用户消息；
   • 或点 上下文，读取网页版当前可见的最近几条消息，整理成一段可编辑的对话摘录，方便左侧 API 接着同一个话题继续。
4. 检查并带入：
   • 默认进入可编辑预览，确认后点 填入当前对话；
   • 打开 抓取后自动填入 后，抓取成功会直接填入左侧输入框，发送仍由你手动完成；
   • 需要一步到位时，点 填入并发送；如果当前 Harness 版本没有通过 inputActions 暴露发送方法，插件会退回为仅填入，并提示你在输入框按 Enter。
5. 再次打开：关闭标签后，点标题栏 网页版，或右侧栏 + → DeepSeek 网页版。

预览顶部会标注来源（选区 / 输入框 / 最近提问 / 上下文），底部会说明读取边界。插件只读取你点的那一处，或你主动点“上下文”时页面中可见的最近消息；不会读取整页，也不会上传内容。

同步机制

1. 主题 token 同步

DeepSeek 网页版和 Harness 使用同一套 --dsw-* 设计变量命名。插件在 Harness 侧读取当前 :root、body、#root 上的实际计算值，并把它们以内联 !important 自定义属性写入 guest 的 <body>：

• 背景、层级背景、边框、文字、品牌色、状态色、滚动条；
• 字体族、字号、行高；
• --dsw-specific-* 之类的页面专用 token。

同时根据 Harness 当前主题的 colorScheme 切换网页自己的 body[data-ds-dark-theme] 属性，并监听 theme/change 事件。切换主题、切换明暗模式或启用/禁用美化插件时，网页会重新同步。

2. 壁纸与视觉衔接

Harness 的美化插件可能通过 shell.overlay 给 body 设置壁纸。插件读取当前页面的 background-image，将其以低透明度水印叠加到 guest 页面，并在插件标签顶部绘制一条同款纹理细条。它不改变网页布局，也不牺牲正文可读性。

3. 登录保持

DeepSeek 网页版把登录态存在自己的版本化 localStorage 包装里：

{ "value": "<token>", "__version": "0" }

插件只读取包装里的逻辑值，不保存包装文本本身。登录后把 token 和账号信息写入 Harness 本机数据；下次打开页面时，如果 guest 还没有登录态，就把 token 写回同样的版本化包装并刷新一次页面。登录、退出和账号切换通过 Storage.prototype.setItem 钩子与轮询共同感知。

4. 自动打开与无弹窗

• 插件通过右侧栏控制器的 openTab('deepseek-web') 打开标签；
• 当前会话用 sessionStorage 标记“本次运行已自动打开”，因此手动关闭不会被反复拉起；
• 不设置 allowpopups，不注册外部打开入口；网页的新窗口请求被忽略，右侧视图保持不变。

架构

┌──────────────────────────── Harness Desktop ────────────────────────────┐
│                                                                          │
│  ┌──────────────┐      ┌────────────────────────────┐                   │
│  │ Conversation │      │ Right Sidebar              │                   │
│  │  (API chat)  │      │  ┌──────────────────────┐  │                   │
│  │              │      │  │ DeepSeek Web tab     │  │                   │
│  │  composer ◄──┼──────┼──┤ capture preview      │  │                   │
│  │              │ text │  │ isolated <webview> ──┼──┼──► chat.deepseek  │
│  └──────────────┘      │  └──────────────────────┘  │      .com         │
│         ▲              └────────────────────────────┘                   │
│         │ theme/change + tokens         ▲ auth token restore             │
│  ┌──────┴───────┐              ┌────────┴─────────┐                      │
│  │ Theme service│              │ local auth store │                      │
│  └──────────────┘              └──────────────────┘                      │
└──────────────────────────────────────────────────────────────────────────┘

组成

• Host 半部 index.js
  • 只导出空 apply()；本插件不需要 Host 资源、模型工具或额外服务。
• Client 半部 client.js
  • 注册右侧栏 tab 类型 deepseek-web；
  • 在 sidebar.right.pane.tab 注册面板组件；
  • 通过 window.dshDesktop.browser.acquire() 获取隔离 guest lease；
  • 管理主题桥、登录保持、抓取、预览和 inputActions 插入；
  • 在会话标题栏 utilities 注册“网页版”入口。

关键接入点

安全边界

• guest 由 Desktop 主进程强制为 nodeIntegration: false、contextIsolation: true、sandbox: true；
• 插件页面不能读取 guest 的 DOM，只有 executeJavaScript 返回的纯文本/JSON 进入 Harness renderer；
• 不注入 preload，不把 Harness 的 Node 能力暴露给 chat.deepseek.com；
• 不代理、不转发整页内容；抓取只发生在用户点击按钮时；
• “上下文”只在用户点击时读取当前页面可见的最近几条消息，读取结果先进入可编辑预览；不会后台定时抓取；
• “自动填入”是显式开关，默认关闭；“填入并发送”是显式按钮，不会在后台自动发送；
• 不把 Harness 的 API 凭证写入网页；
• 不启用 guest 弹窗，不打开系统浏览器；
• 登录 token 只写入本机 Harness localStorage，并只在恢复 chat.deepseek.com 登录态时使用。

已知限制

1. 仅 Desktop：依赖 Electron 的隔离 webview 和 Desktop preload 桥；普通 Web 页面无法使用。
2. 账号体系独立：Harness 的 API 授权与 chat.deepseek.com 的网页登录不是同一套 token。插件不会读取或转发 Harness 账号凭据；实际体验是“同一个 DeepSeek 账号在网页里登录一次，之后自动保持”。真正的静默 SSO 需要 DeepSeek 提供网页 token 兑换接口。
3. 网页结构可能变化：DeepSeek 调整 DOM 或登录存储格式后，“最近提问”可能失效；选区抓取是最稳定的路径。
4. 登录令牌保存在本机：这是“登录一次”的代价。若在网页里退出登录，插件会在轮询确认后清除保存的令牌；如果令牌过期，重新登录一次即可。
5. 视觉同步是 token/壁纸级别：它不会复制 Harness 的 React 组件或第三方主题专属插画；网页仍保留 DeepSeek 自己的信息架构。网页版新增的样式变量或组件结构可能没有对应 token，顶部提供“重新同步主题”按钮做手动补偿。
6. 上下文不是 AI 摘要：它是页面可见最近消息的摘录，不做模型总结；需要真正的摘要时，请在左侧让模型处理。
7. 版本与网页结构会漂移：DSH 右侧栏 API、webview 行为，或 DeepSeek 网页版 DOM / 登录存储 / 样式变量变化，都可能让某条路径失效。升级 DSH 后建议做一次回归：标签打开、主题同步、登录恢复、选区/输入框/最近提问/上下文抓取、填入与发送。
8. 登录恢复失败会提示：如果保存的 token 无法写回，或网页版改变了存储结构，面板会显示“保存的网页登录态恢复失败”，重新登录一次即可；不会静默失败。

开发

.
├── client.js           # 浏览器半部：标签、webview、主题、登录、抓取
├── index.js            # Host 半部：空实现
├── cordis.patch.yml    # bundle patch
├── locale/en.json      # 插件显示英文
├── locale/zh.json      # 插件显示中文
├── icon.svg            # 插件图标
└── docs/ARTICLE.md     # 详细设计与实现文章

没有构建步骤。修改 client.js 后：

1. 用 node --check client.js 做语法检查；
2. 通过插件管理重新安装/重载 bundle；
3. 在 Desktop 里确认右侧栏标签、主题同步、抓取和填入输入框。

技术来源

技术来源：ZCFE327

本项目由 ZCFE327 设计与实现。插件建立在 DeepSeek Harness 公开的 Cordis 插件体系、右侧栏 Tab 域、槽位系统和 Electron 隔离 webview 桥之上；DeepSeek 网页版、Harness 及其相关商标归各自权利人所有。