前言¶
在 DeepSeek Harness（DSH）里做智能体或会话编排时，右侧栏往往留给工具、文档或辅助界面。若还要单独开浏览器访问免费的 DeepSeek 网页聊天，窗口会在 DSH 与浏览器之间来回切换，登录态也不跟桌面客户端走。社区插件 DeepSeek Web Dock（仓库 AJYDX-swj/dsh-deepseek-web-dock）的做法是：在 Desktop 左侧「工作区」标题上方增加一个按钮，用 Electron 隔离 webview 把 https://chat.deepseek.com/ 放进原生右侧栏，单击半屏、双击全屏，收起时保留标签与页面状态。下文介绍其定位、能力与安装方式；事实以仓库 README 与 package.json 为准。该插件为非官方社区作品，与 DeepSeek 官方无关。
这是什么¶
DeepSeek Web Dock for DSH 由维护者 AJYDX-swj 发布，SkillHub 分类为客户端，简介为「网页端 ds 接入 dsh」。本地 bundle 标识为 @local/dsh-deepseek-web（当前版本 1.0.3，MIT 许可），不发布 npm；GitHub 仓库名可为 dsh-deepseek-web-dock。
插件不实现 Host 路由、不读取 Harness API Key、不提供模型工具；Harness 凭证不会进入内嵌网页。网页运行在 sandbox 化的 webview 中，不是 iframe，因此不受 X-Frame-Options 限制。
核心功能¶
打开与关闭¶
| 操作 | 行为 |
|---|---|
| 单击（关闭状态） | 等待 175 ms 判定后，以普通半屏宽度打开 |
| 双击（175 ms 内） | 直接全屏打开，不会先闪半屏 |
| 单击（已打开） | 判定后以原生收起动画关闭右侧栏 |
| 全屏时点击会话 | 先切换会话，再收起 DeepSeek 网页栏；标签和网页保持 |
| Esc | 立即收起；同时取消尚未执行的单击动作 |
| Tab 上的 × | 真正关闭 DeepSeek 标签页 |
按钮使用 DSH 侧栏主题变量，并自动跟随 DSH 明暗主题（同步到网页的 data-ds-dark-theme 与 color-scheme）。
登录与状态¶
首次在网页中登录后，插件会把 DeepSeek 使用的 userToken / __appKit_userInfo 保存到本机 DSH 渲染进程 localStorage 的 dsh.deepseek-web.auth.v1，下次进入主页面前预注入登录态，减轻已登录时先闪登录界面的情况。关闭右栏时 webview 保持挂载，再次打开回到原页面；要销毁页面需点标签上的 ×。
进入主页前，插件会在 DeepSeek 同源页面写入其 closeUnsafeEnvWarn 关闭偏好，用于规避重复弹出的「使用环境异常」提示；不修改 User-Agent，也不改变实际隔离。该提示是 DeepSeek 对非官方嵌入环境的风险提醒；若不接受，应使用官方网页或应用。
系统要求与限制¶
- 需要 DeepSeek Harness Desktop，且具备右侧栏与 Electron
webview支持。 - README 写明在 DSH Desktop 0.2.1-rc.3（Windows） 上实测；普通浏览器中的 Web 版 DSH 不可用，按钮会被禁用。
- 右栏宽度低于 768 px 时，DSH 会自动全屏展示，此时无法强制半屏。
- 插件无构建步骤、无运行时 npm 依赖；只提供网页承载，不包含对话抓取、回填输入框或自动发送。
安装与启用¶
资料中的安装方式以本地目录为主，未提供 dsh plugin add github:... 一类一键命令。核心步骤如下。
- 将仓库下载或放到本机稳定目录（README 亦提到可在插件管理中使用「从本地目录安装」，视 DSH 版本是否提供该入口）。
- 手动安装时，把插件目录链接到 Desktop profile 下的路径，并把 bundle 写入 profile 配置：
<DSH_HOME>/profiles/desktop/node_modules/@local/dsh-deepseek-web
同时在对应 profile 的 dsh.profile.bundles 中加入 @local/dsh-deepseek-web。完整步骤见仓库 docs/INSTALL.md。
- 完全退出 DSH Desktop 后重新启动（仅最小化到托盘不会重新加载 Host 插件）。
- 打开任意会话，点击左侧「工作区」上方的 DeepSeek 网页版 按钮。
典型用法¶
经过上面的安装与重启，可按 README 中的顺序操作：
- 打开任意会话；没有会话时会先创建一个空会话。
- 单击按钮：半屏打开；双击按钮：全屏打开（两次点击须在 175 ms 内，否则按两次单击处理；单击有 175 ms 判定延迟，属预期行为）。
- 第一次使用时，在右侧网页里登录 DeepSeek 账号；之后插件会尝试恢复网页登录态。
- 再次单击按钮或按 Esc：收起右栏，动画与点击右栏右上角收起按钮一致。
- 再点按钮会回到之前的网页页面，不会重新加载。
实现上，Client 在工作区区头前插入按钮，注册 deepseek-web 右侧栏 Tab，通过 Desktop browser bridge 申请隔离 guest；about:blank#<lease> 启动 webview，dom-ready 后加载 https://chat.deepseek.com/。更完整的生命周期见 docs/ARCHITECTURE.md。
适用场景与注意¶
适合谁：已在 DSH Desktop 中工作、希望在不离开客户端的前提下使用免费 DeepSeek 网页聊天，并需要半屏/全屏、主题一致与登录态本机保存的用户。
安装前建议：插件以当前 DSH 进程权限在客户端侧运行；安装前应阅读仓库源码与 MIT 许可。登录 token 仅保存在本机 localStorage；内嵌网页不具备 Node、preload 或 Harness 权限。DeepSeek 若改版 localStorage 结构，登录恢复可能失效，需重新登录一次。macOS/Linux 与 README 中 Windows 实测环境不同，大版本 DSH 升级后建议回归测试。
故障排查要点：按钮未出现——确认 Desktop、侧栏展开、dsh.profile.bundles 含 @local/dsh-deepseek-web 并完全重启。右侧栏空白——确认网络可访问 https://chat.deepseek.com/ 且非普通浏览器环境。
结尾¶
DeepSeek Web Dock 把免费 DeepSeek 网页版收进 DSH Desktop 原生右侧栏，用单击/双击区分半屏与全屏，收起时保留页面，并在本机恢复网页登录态；仅支持 Desktop，与官方无从属关系。
