DeepSeek Harness (DSH) 是一个本地 AI 编程环境。在开发过程中，频繁切换窗口去网页端 chat.deepseek.com 进行对话会打断工作流。dsh-deepseek-chat-embed 插件旨在将官方聊天页面深度集成到 DSH 桌面客户端内，提供双入口的聊天面板与持久登录会话，解决多任务切换的痛点。
核心特性¶
插件采用策略模式架构，针对不同的桌面环境提供原生解决方案。
- 双入口架构
- 左侧导航主面板：在中央会话区域沉浸式全屏展开，适合进行长篇咨询或深度规划。
- 右侧边栏：以原生 Tab 形式并排展示，适合在编写代码或查看终端时即时查阅。
- 多桌面客户端适配
- 支持官方 DSH 桌面版（Electron）与 DSH Dock（Tauri v2）。
- 支持通用原生多视窗协议，第三方桌面壳（如 Wails、Qt）也可通过标准接口接入。
- 宿主与客页交互
- 实现了客页与宿主侧栏的双向互斥与平滑折叠。展开客页时，宿主侧栏自动收起；收起客页时，宿主侧栏平滑展开。
- 采用 CSS 同轨线性插值，消除布局跳动。
- 健壮性设计
- 非侵入式 DOM 适配：通过结构语义启发式查找节点，不依赖写死的类名，抵抗前端站点迭代。
- 网络隔离保护：高并发场景下管理 TCP 连接池，防止页面卡死。
- 测试保障：内置 100 项自动化契约回归测试。
安装与启用¶
可以通过命令行或 DSH 客户端图形界面安装。
命令行安装¶
使用以下命令将插件添加到当前活动 Profile：
dsh plugin add github:realguan/dsh-deepseek-chat-embed
图形界面安装¶
- 打开 DSH 客户端，进入 设置 → 插件。
- 点击页面右上角的 ＋ 添加插件。
- 粘贴 GitHub 仓库地址：
github:realguan/dsh-deepseek-chat-embed
- 阅读安全提示后点击 安装。
- 安装完成后重启客户端生效。
使用方式¶
安装完成后，插件提供两种打开方式：
- 沉浸式模式：点击左侧导航栏的
💬 聊天图标，在中央主工作区全屏展示 DeepSeek Chat。 - 协同模式：点击右上角常驻按钮，在右侧边栏以 Tab 形式并排展示。此时左侧的代码编辑器、文件列表或终端保持可见，便于边写代码边查阅。
注意事项¶
- 权限风险：插件在本机以你的权限运行，请仅安装来源可信的插件。来源不明的插件可能损坏 DSH 或泄露数据。
- 手动更新：插件安装后暂不支持自动更新。升级时需要先卸载旧版，再安装新版。
- 环境依赖：需满足
peerDependencies: @deepseek-ai/dsh >= 0.2.x。
生态链接¶
- GitHub 仓库: https://github.com/realguan/dsh-deepseek-chat-embed
- 插件目录: https://www.skillhub.cn/plugins/realguan/dsh-deepseek-chat-embed
