前言¶

在 DeepSeek Harness（DSH）里写代码或调智能体时，如果团队习惯用 XEChat 做即时沟通，常见做法是另开浏览器标签或 IDE 插件窗口。窗口一多，上下文切换频繁，鱼塘消息也容易漏看。原版 xechat-web 绑定 IntelliJ 或 VSCode 宿主；若你主要用 DSH Web UI，就需要一个不依赖 IDE 插件宿主、只通过 WebSocket 连服务端的客户端。下面介绍社区插件 xechat-dsh（维护者 chargeduck），它是 xechat-web 的 DSH 移植版，以可停靠侧边栏的形式嵌在 DSH Web 里。

这是什么¶

xechat-dsh 是 XEChat 的 DeepSeek Harness 侧边栏客户端：可停靠的聊天面板，写代码时鱼塘不断线。插件作为 DSH Web UI 的独立插件运行，与原版不同，不依赖任何 IDE 插件宿主，只用一条 WebSocket 连接 XEChat 服务端。当前 package 版本为 0.1.0，许可证 MIT。DSH Web 客户端需 >= 0.2.0-rc.1；运行时仅 Web（dsh.client.platform = "web"），TUI 不可用。

核心功能¶

侧边栏与布局¶

面板可贴靠视口左侧或右侧，一键切换；宽度可拖拽调节（280–720px）。停靠位置、宽度、可视状态写入 localStorage，刷新后恢复。关闭面板会卸载 Vue 应用，重新打开会重建 store；登录态保留在 localStorage，当前会话需重连。

聊天与鱼塘¶

支持 Markdown 渲染、图片消息、表情、@ 提醒分级通知、跨塘邀请。鱼塘管理：#showServer 拉取鱼塘列表并探测 TCP/WS 存活，#login 登录指定服务器。可查看当前鱼塘在线用户及状态。

游戏与内置浏览器¶

从 manager 游戏大厅加载；单机游戏在 iframe 中运行，联机游戏由 MatchLobby SDK 承载房间。内置浏览器在受限站点可切到系统浏览器打开；容器配色跟随主题，可叠加降亮遮罩。游戏与浏览器依赖 manager 侧接口，离线环境不可用。

摸鱼防护¶

紧急模式快捷键全屏显示伪装内容、面板透明度调节、主题切换。常用命令还包括 #mode、#notify、#alive 等，完整列表见 #help。

安装与启用¶

插件以当前 dsh 进程权限运行，安装前建议阅读仓库源码与 MIT 许可证。安装命令须以官方 README 为准。

一键脚本（推荐，会校验环境并验证安装结果）：

# macOS / Linux
./install.sh

# Windows
install.bat

或直接用 dsh 命令：

# 预构建包，跳过构建授权步骤
dsh plugin --profile web add https://github.com/chargeduck/xechat-dsh/releases/latest/download/xechat-dsh.tgz

# 从源码安装
dsh plugin --profile web add https://github.com/chargeduck/xechat-dsh

# 本地开发时链接源码目录
dsh plugin --profile web add link:/absolute/path/to/xechat-dsh

安装后重启 dsh web 并刷新页面。侧边栏出现在视口右侧，点击活动栏第一条图标开合。

典型用法¶

登录需要一个可达的 XEChat 服务端。WebSocket 连接地址为 ws://<host>:<port+1>/xechat（由 #login 或鱼塘列表指定）。拉取鱼塘列表默认请求 https://dld.lesscoding.net/api/server/list。

先做鱼塘发现或直接指定地址，再登录：

# 直接指定地址
#login <用户名> -h <host> -p <port>

# 或先从鱼塘列表选
#showServer
#login <用户名> -s 0

常用命令：#exit 断开、#showStatus 查看状态、#help 查看全部。插件不收集、不外传凭据；管理员 Token 仅存本地并在登录时随 LOGIN 帧上报。插件不含遥测。

与 xechat-web 的差异¶

适用场景与注意¶

适合主要使用 DSH Web、又需要 XEChat 侧边栏聊天的开发者。桌面端若要用，需装到 desktop profile。DSH 处于 developer preview，接口可能变动；宿主升级后请重新验证。已知限制包括：自动隐藏（edge 模式）仅在布局层预留、未在 UI 暴露；移动端窄视口下面板宽度受 calc(100vw - 44px) 限制。

DeepSeek Harness 社区插件目录在 SkillHub 等独立站点维护，与 DeepSeek / 幻方无官方从属关系；xechat-dsh 为社区贡献，非官方应用商店条目。

结尾¶

经过上面的步骤，你可以在 DSH Web 里用可停靠侧边栏维持鱼塘会话，而不必再单独开 IDE 插件或额外标签。更多安装细节见仓库 INSTALL.md。

• 目录页：https://www.skillhub.cn/plugins/chargeduck/xechat-dsh
• GitHub：https://github.com/chargeduck/xechat-dsh