手机聊天镜像 · dsh-im-phone-chat
配套 dsh-im（@xmanrui/dsh-im）的 DSH 桌面端插件：
把手机 IM 通道（QQ / 微信 / 飞书 …）经 dsh-im 桥接进 DSH 的会话，以只读聊天镜像的形式显示在 DSH 界面里。
- 左侧栏入口 → 主区域聊天面板
- 手机消息 / 助手流式回复实时同步，顺序正确
- Markdown + LaTeX 公式渲染（KaTeX → MathML）
- 手机图片内联显示，点击放大、可旋转
- 多个手机会话可切换，支持加载更早历史
只读镜像：不写入会话，也不修改 dsh-im 安装包，dsh-im 升级/重装不影响本插件。
已在 DSH 0.2.1-rc.2 + dsh-im 5.0.3（Windows 桌面端）实测可用。
安装
前置条件
- 已安装 DSH（Web / 桌面端均可）
- 已安装并启用
@xmanrui/dsh-im，且至少一个 IM 通道（如 QQ）已连接
- 如果用命令行安装：
dsh 命令可用；用插件管理器安装则不需要
方式一：npm（推荐）
# <profile>：桌面端一般是 desktop，Web 端一般是 web
dsh plugin --profile <profile> add dsh-im-phone-chat
安装后刷新一次页面（桌面端 Ctrl+R / F5），左侧栏底部、设置按钮上方出现「聊天气泡」图标。
方式二：插件管理器（本地目录）
-
克隆或下载本仓库到本地任意目录（目录之后不要删/移动，插件以本地链接方式安装）：
git clone https://github.com/FST-EchoFly/dsh-im-phone-chat.git
-
打开 DSH：设置 → 插件 → 安装本地插件，选择克隆下来的目录（包名 dsh-im-phone-chat）
-
启用「手机聊天镜像」插件
-
刷新一次页面（桌面端按 Ctrl+R / F5）
-
左侧栏底部、设置按钮上方出现「聊天气泡」图标，点击即可打开面板
方式三：命令行（本地 link）
git clone https://github.com/FST-EchoFly/dsh-im-phone-chat.git
# <profile> 换成你正在使用的 profile：桌面端一般是 desktop，Web 端一般是 web
# <克隆目录> 换成克隆出来的绝对路径，例如 D:\tools\dsh-im-phone-chat
dsh plugin --profile <profile> add link:<克隆目录>
更新
卸载
- 插件管理器里停用/移除「手机聊天镜像」；或
- 命令行：
dsh plugin --profile <profile> remove dsh-im-phone-chat
以 link: 方式安装的包指向克隆目录，卸载插件不会删除源码目录。
使用
- 从手机给已连接的 IM 机器人发一条消息
- 打开左侧「手机聊天」面板：顶部会列出发现的手机会话（如
QQ · 问候、QQ · 你好，带日期便于区分），默认选中最新的手机通道会话
- 面板会实时显示你的消息与助手回复；助手回复中的 Markdown / LaTeX 公式会自动排版，手机图片会内联显示，点击图片可放大并旋转
- 想看更早的消息，点顶部「加载更早消息」
- 需要继续对话：点「在会话中打开」跳到真实会话，或直接在手机上回复
配置
一般情况下无需配置：插件会通过 dsh-im 的管理 RPC（connection.status 返回的 bot.workspace）自动发现手机通道工作区，并结合「标题带 IM 通道前缀」的会话兜底。
只有在以下情况才需要改：
- dsh-im 的管理 RPC 不可用，且手机机器人的工作区不是默认路径
- 这种情况下，修改
src/plugin.js 顶部的 FALLBACK_WORKSPACES 数组（填你的工作区绝对路径），然后重新构建（见下）
开发
仓库里已提交构建好的 client.js，普通使用无需构建；只有改源码时才需要：
# 安装构建依赖（esbuild / katex / markdown-it）
pnpm install
# 重新构建 client.js
pnpm run build
- 源码：
src/plugin.js
- 构建：
build.mjs（esbuild 打包后包一层 DSH 的 window.__ModuleLoader__ 注册格式）
- 包结构说明：见下方「结构」
结构
| 文件 | 作用 |
|---|
package.json | bundle 与 dsh.client 声明（platform: web、immediately: true） |
cordis.patch.yml | 向 DSH 宿主插入插件行 |
index.js | 宿主侧空实现（本插件是纯客户端 UI） |
src/plugin.js | 客户端插件源码：UI、事件折叠、Markdown / KaTeX 渲染、图片预览 |
client.js | 构建产物：window.__ModuleLoader__ 客户端 bundle（内置 KaTeX、markdown-it） |
build.mjs / wrap.mjs | esbuild 构建脚本；wrap.mjs 是在受限环境里先手动跑 esbuild 再包装的兜底脚本 |
locale/zh.json / locale/en.json | 插件管理器展示用的标题/描述 |
icon.svg | 插件图标 |
LICENSE | MIT |
THIRD_PARTY_NOTICES.md | 内置第三方库（KaTeX、markdown-it）的 MIT 声明 |
原理（简述）
- 面板注册到 DSH 的
main 全局面板槽位，图标注册到 sidebar.panellist，两者使用同一个 id，点击图标即切换到该面板
- 会话数据走 DSH 客户端公开接口：
ctx.sessions.retain() 拿到会话绑定，订阅 binding.eventSource 的连续事件窗口（用户消息、助手流式 chunk、结算消息）
- 按事件顺序折叠气泡：用户消息把上一条助手气泡收尾，助手回复出现在其真实位置；流式文本结算后替换为正式消息
- 公式：消息文本中的 Markdown 与
$...$ / $$...$$ 用 KaTeX 渲染成 MathML（Chromium 原生渲染，无需字体文件）；流式中的半成品按纯文本显示，结束后排版
- 图片：
session.readAttachment() 取原图字节 → Blob URL 渲染，滚动到附近才懒加载，卸载释放
与同类插件的区别
截至 2026-11，在 GitHub 与 npm 的 DSH 插件生态里没有找到功能完全相同的实现。下面是最接近的几类，以及本插件的差异：
本插件的差异点：dsh-im 配套 + 左侧栏入口 + 实时气泡镜像 + Markdown/LaTeX/图片渲染，只读、不改 dsh-im 本体。
如果你发现了同类插件，欢迎开 issue 补充。
已知限制
- 纯只读：发送消息仍需在手机或真实会话中进行
- 手机会话的发现是启发式规则；若 DSH 把一次手机对话拆成多个会话，可在顶部下拉里选择
- 历史只加载当前事件窗口（约 500 条消息），更早内容用「加载更早消息」
- 首次安装后需要刷新页面一次（Electron 桌面端限制）
- 依赖 dsh-im 的公开管理 RPC 做工作区发现；dsh-im 若改私有协议可能影响自动发现，此时用
FALLBACK_WORKSPACES 兜底
License
MIT，见 LICENSE。内置第三方库许可见 THIRD_PARTY_NOTICES.md。
English quick start
A read-only chat mirror for DSH desktop: shows the phone IM conversation bridged by
dsh-im, with live assistant streaming, Markdown + LaTeX,
and inline images.
Requirements: DSH (web or desktop), @xmanrui/dsh-im installed and enabled with a connected channel.
Install (from npm, recommended)
dsh plugin --profile <your-profile> add dsh-im-phone-chat
Or clone this repo and install the local directory via DSH Settings → Plugins → Install local plugin,
or dsh plugin --profile <your-profile> add link:<absolute-path-to-clone>.
Then refresh the page once (Ctrl+R / F5). A chat-bubble icon appears in the left sidebar; click it to open the mirror panel.
Update: dsh plugin --profile <your-profile> add dsh-im-phone-chat (npm) or git pull in a local clone.
Uninstall: disable/remove the plugin in DSH, or
dsh plugin --profile <your-profile> remove dsh-im-phone-chat.
Built with KaTeX (MIT) and markdown-it (MIT); see third-party notices.
How it differs from related plugins: as of 2026-11 there is no other DSH plugin that
mirrors the phone IM conversation itself in a desktop panel. The closest ones are dsh-im's
own sidebar panel (bot management, not chat content), dsh-im-connect's "Channels" tab
(IM sessions shown as ordinary DSH sessions), dsh Chat (DSH↔DSH chat rooms) and
dsh-desktop-chat (official DeepSeek Chat, not IM). This plugin is the dsh-im companion that
adds a real-time, read-only chat mirror with Markdown/LaTeX and inline images.
