dsh-im-phone-chat

手机聊天镜像 · dsh-im-phone-chat

配套 [dsh-im](https://github.com/xmanrui/dsh-im)（@xmanrui/dsh-im）的 DSH 桌面端插件：

可以把手机 IM 通道（QQ / 微信 / 飞书 …）经 dsh-im 桥接进 DSH 的会话，以只读聊天镜像的形式显示在 DSH 界面里喵。

支持

• 左侧栏入口 → 主区域聊天面板
• 手机消息 / 助手流式回复实时同步
• Markdown + LaTeX 公式渲染
• 手机图片内联显示，点击放大、可旋转
• 多个手机会话可切换，支持加载更早历史

> 只读镜像：不写入会话，也不修改 dsh-im 安装包，dsh-im 升级/重装不影响本插件。

> 已在 DSH 0.2.1-rc.2 + dsh-im 5.0.3（Windows 桌面端）实测可用。

安装

前置条件

1. 已安装 DSH（Web / 桌面端均可）

2. 已安装并启用 @xmanrui/dsh-im，且至少一个 IM 通道（如 QQ）已连接

3. 如果用命令行安装：dsh 命令可用；用插件管理器安装则不需要

方式一：npm（推荐）

# ：桌面端一般是 desktop，Web 端一般是 web
dsh plugin --profile  add dsh-im-phone-chat

使用dsh自带的插件安装功能直接输入dsh-im-phone-chat安装就可以了喵

安装后刷新一次页面（桌面端 Ctrl+R / F5），左侧栏底部、设置按钮上方出现「聊天气泡」图标。

方式二：插件管理器（本地目录）

1. 克隆或下载本仓库到本地任意目录（目录之后不要删/移动，插件以本地链接方式安装）：

   git clone https://github.com/FST-EchoFly/dsh-im-phone-chat.git

2. 打开 DSH：设置 → 插件 → 安装本地插件，选择克隆下来的目录（包名 dsh-im-phone-chat）

3. 启用「手机聊天镜像」插件

4. 刷新一次页面（桌面端按 Ctrl+R / F5）

5. 左侧栏底部、设置按钮上方出现「聊天气泡」图标，点击即可打开面板

方式三：命令行（本地 link）

git clone https://github.com/FST-EchoFly/dsh-im-phone-chat.git

#  换成你正在使用的 profile：桌面端一般是 desktop，Web 端一般是 web
# <克隆目录> 换成克隆出来的绝对路径，例如 D:\tools\dsh-im-phone-chat
dsh plugin --profile  add link:<克隆目录>

更新

• npm 安装：重新执行安装命令拉取最新版（或在插件管理器里更新）：

  dsh plugin --profile  add dsh-im-phone-chat

• 本地 link 安装：进入克隆目录 git pull，再重启 DSH 或刷新页面。

卸载

• 插件管理器里停用/移除「手机聊天镜像」；或
• 命令行：dsh plugin --profile remove dsh-im-phone-chat

> 以 link: 方式安装的包指向克隆目录，卸载插件不会删除源码目录。

使用

1. 从手机给已连接的 IM 机器人发一条消息

2. 打开左侧「手机聊天」面板：顶部会列出发现的手机会话（如 QQ · 问候、QQ · 你好，带日期便于区分），默认选中最新的手机通道会话

3. 面板会实时显示你的消息与助手回复；助手回复中的 Markdown / LaTeX 公式会自动排版，手机图片会内联显示，点击图片可放大并旋转

4. 想看更早的消息，点顶部「加载更早消息」

5. 需要继续对话：点「在会话中打开」跳到真实会话，或直接在手机上回复

配置

一般情况下无需配置：插件会通过 dsh-im 的管理 RPC（connection.status 返回的 bot.workspace）自动发现手机通道工作区，并结合「标题带 IM 通道前缀」的会话兜底。

只有在以下情况才需要改：

• dsh-im 的管理 RPC 不可用，且手机机器人的工作区不是默认路径
• 这种情况下，修改 src/plugin.js 顶部的 FALLBACK_WORKSPACES 数组（填你的工作区绝对路径），然后重新构建（见下）

开发

仓库里已提交构建好的 client.js，普通使用无需构建；只有改源码时才需要：

# 安装构建依赖（esbuild / katex / markdown-it）
pnpm install