chargeduck/xechat-dsh

xechat-dsh

XEChat 的 DeepSeek Harness 侧边栏客户端：可停靠的摸鱼聊天面板，写代码时鱼塘不掉线。

xechat-dsh 是 xechat-web 的 DSH 移植版。与原版不同，它不依赖任何 IDE 插件宿主， 作为 DSH Web UI 的独立插件运行，只用一条 WebSocket 连接 XEChat 服务端。

功能

• 可停靠侧边栏：贴靠视口左侧或右侧，一键切换；面板宽度可拖拽调节（280–720px）。
• 聊天：Markdown 渲染、图片消息、表情、@ 提醒分级通知、跨塘邀请。
• 鱼塘管理：#showServer 拉取鱼塘列表并探测 TCP/WS 存活，#login 登录指定服务器。
• 在线列表：查看当前鱼塘在线用户及状态。
• 游戏：从 manager 游戏大厅加载，单机游戏 iframe 运行，联机游戏由 MatchLobby SDK 承载房间。
• 内置浏览器：受限站点可切到系统浏览器打开；容器配色跟随主题，可叠加降亮遮罩。
• 摸鱼防护：紧急模式快捷键全屏显示伪装内容、面板透明度调节、主题切换。
• 布局持久化：停靠位置、宽度、可视状态存入 localStorage，刷新后恢复。

安装

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

# 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` 并刷新页面。侧边栏出现在视口右侧，点击活动栏第一条图标开合。

详细说明见 INSTALL.md。

本地开发

npm install
npm run dev          # 独立浏览器预览 Vue 应用（无需 DSH）
npm run build        # 先构建 Vue 应用，再打包插件 bundle

npm run build 产出：

文件 · 说明 lib/xechat-app.js · Vue + Element Plus 应用（IIFE，全局 __XECHAT_DSH_APP__） lib/xechat-app.css · 应用样式 lib/client.js · 插件客户端 bundle（CJS 闭包，__ModuleLoader__.load 注册） lib/index.js · 宿主侧（空实现）

使用

登录需要一个可达的 XEChat 服务端：

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

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

常用命令：#exit 断开、#showStatus 查看状态、#mode / #notify / #alive 摸鱼相关开关、#help 查看全部。

权限与网络

项目 · 说明 WebSocket · 连接 ws://:/xechat（用户通过 #login 或鱼塘列表指定） HTTPS 请求 · 拉取鱼塘列表（默认 https://dld.lesscoding.net/api/server/list） localStorage · 保存登录信息、面板布局、快捷键等偏好 凭据 · 插件不收集、不外传任何凭据；管理员 Token 仅存于本地并在登录时随 LOGIN 帧上报

插件不含遥测，不向第三方发送数据。

兼容性

依赖 · 版本 DSH Web 客户端 · >= 0.2.0-rc.1 运行时 · 仅 Web（dsh.client.platform = "web"）；桌面端需装到 desktop profile，TUI 不可用 Node（构建期） · >= 20 react / react-dom · ^18.2.0（peer，由 DSH Web shell 提供）

DSH 处于 developer preview，接口可能变动。以上兼容性声明基于 2026-10 的公开文档， 宿主升级后请重新验证。

与原版（xechat-web）的差异

方面 · xechat-web · xechat-dsh 宿主 · IntelliJ 插件 / VSCode 扩展 · DSH Web 插件 传输 · JSBridge（JCEF）+ WebSocket · 仅 WebSocket 宿主通信 · window.xechat.*（getState/getTools/httpGet…） · 无，全部走 WS 或 fetch 工具面板 · 有（宿主下发工具列表） · 已移除（纯 WS 无数据源） 文字样式管理 · 工具面板进入 · 设置面板进入 外链打开 · 宿主原生浏览器 · window.open 新标签 图标资源 · 随插件打包 · 同左，样式与 DSH 令牌对齐

已知限制

• 面板内容区在打开时才挂载 Vue 应用；关闭面板即卸载，重新打开会重建 store（登录态保留在 localStorage 中，但当前会话需重连）。
• 自动隐藏（edge 模式）目前仅在布局层预留，未在 UI 暴露开关。
• 移动端窄视口下面板宽度受 calc(100vw - 44px) 限制。
• 游戏与浏览器面板依赖 manager 侧接口，离线环境下不可用。

许可

MIT，见 LICENSE。