dsh-md-overlay

DSH 里的 Markdown 预览面板：对话里点一下，报告就在可拖拽的右侧面板里渲染（可悬浮，也可 📌 钉住融入布局）。

给 DSH 一个可悬浮 / 可停靠、可拖拽调宽、多标签的 Markdown 预览面板，外加一个 md_preview 模型工具：

与 dsh-md-viewer（融合进 dsh-better-sidebar 侧边栏）互补：需要"融入布局、不遮挡"用 md-viewer；需要"随时弹出的阅读区/停靠面板"用 md-overlay。

✨ 功能

🖥️ md_preview 模型工具：读取 workspace 内 .md 并触发面板预览（Host 全局注册，所有会话可见，同一页面内标签跨对话累积）
📇 预览卡片：对话里不是小 chip，而是文件名 + 状态 + 简短渲染预览 + 目录节数 + 打开按钮
📌 浮层 / 停靠双模式：默认悬浮盖在内容上；点 📌 停靠 → 推挤页面布局融入（与 better-sidebar 的推挤 calc() 叠加共存，装不装它都能用）
📑 多标签：一次打开多个文档，点击切换，逐个关闭
📏 可拖拽宽度：左缘拖动 320px~75% 屏宽
🌈 代码块：语法高亮（js/ts/py/bash/json/yaml/html/css）、行号、语言徽标、一键复制
🧭 目录 TOC：自动收集标题层级，点条目平滑滚动到对应章节
✅ 任务清单（- [x] 复选框）与 嵌套列表（缩进层级）
🛡️ HTML 处理：<img>→图片、 剥离、实体反转义；纯 React、无 innerHTML
🔒 安全边界：只读 workspace 内文件，超 1MB 拒绝

前置：DSH（dsh web 可运行）。

dsh plugin --profile web add dsh-md-overlay@latest

装完硬刷新浏览器（Cmd/Ctrl+Shift+R）。之后在对话里让 agent 预览某个 md 文档（或你提到某个报告文件），卡片与面板即会自动打开。

Host 半（lib/index.js）：用 ctx.tools.register(defineTool(...)) 注册 md_preview 工具，经 fs 读取文件（workspace 守卫 + 1MB 上限）；文件内容通过 output.presentationMeta 随 tool/result 事件带给客户端卡片。
Client 半（lib/client.js）：tool.call.toolview 渲染预览卡片（解析 block.meta 拿到内容并写入标签页）；shell.overlay 渲染多标签面板；📌 停靠通过 #root margin-right 推挤实现（html #root + calc() 与 better-sidebar 叠加）。

markdown 相对路径图片不解析；暂不支持 LaTeX / Mermaid（better-sidebar 的强项，规划中）；
卡片 / 面板只在 md_preview 工具被调用后出现；对话内"产出文件 chips"点击走 better-sidebar 侧边栏（配 dsh-md-viewer 时用我们的渲染），不直接进本面板。

见 PUBLISHING.md（npm 发布 + dshfind 插件超市收录的完整流程）。

MIT