dsh-markdown-preview

DeepSeek Harness Web 产物文件浏览器内预览插件。

默认情况下，点击 DSH Web 里的产物文件 chip，会把文件交给操作系统默认应用打开（macOS 上 open → 很多扩展名落到 Xcode）。本插件接管产物行，让点击直接在聊天内渲染文件：Markdown 由宿主侧 markdown-it + highlight.js 渲染，图片内联预览，其他文本文件以纯文本展示。原行为仍然一键可达：在系统应用中打开、在文件夹中显示。

功能

• 点击产物文件 chip → 聊天内联预览，不再弹出系统应用、不新开标签页。
• Markdown 完整渲染（GFM 表格、围栏代码、引用、链接、硬换行）+ 代码块语法高亮（highlight.js 常用语言集）。
• 图片预览（PNG / JPEG / GIF / WebP）以 data URL 内联展示，无需额外路由。
• 其他文本文件回退为纯文本；二进制文件通过 NUL 字节嗅探识别并明确拒绝。
• 面板头部：文件大小、复制内容、在系统应用中打开、收起。
• 文本 1 MiB / 图片 4 MiB 上限，超出显示截断提示。
• 保留原有体验：chips、「+ N 个文件」、「在文件夹中显示」，行内代码提及的产物文件仍然可点击。

安装

dsh plugin --profile web add dsh-markdown-preview

重启 dsh web 生效。需要 PATH 中有 pnpm（dsh plugin 会转发给 pnpm），DSH 版本 >= 0.1.0-rc.6。

使用

无需配置。重启后，任何产出了文件的回合都会显示熟悉的产物行；点击 chip 即展开/收起预览面板。

工作原理

• 宿主侧（lib/index.js）：在 ctx.connection 上注册 /preview RPC 通道，使用 loopback 信任权限（与 /api 相同的 DNS-rebinding / 跨站围栏）。read 返回文件内容——Markdown 渲染为转义后的 HTML（markdown-it 开 html:false、安全链接策略），图片转 base64 data URL，其他文本 1 MiB 截断并做 NUL 字节二进制嗅探；open 代理官方 host.openPath，系统应用打开与官方行为完全一致。
• 浏览器侧（lib/client.js）：标准 dsh.client bundle。拥有 deliverables 会话事件类型与 conversation.chat.turnTail 插槽（本 bundle 的 patch 禁用了官方 ui-deliverables 行，并补回其提示词段与 chatFileMentions 服务），因此是行为兼容的原生接管，而非 DOM hack。
• 渲染发生在宿主进程，浏览器 bundle 保持轻量、零依赖。

与相似插件对比

插件	形态	区别