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 / SVG）以 data URL 内联展示，无需额外路由。SVG 可安全内联：浏览器不会执行 <img> 元素中 SVG 的脚本。
• 其他文本文件回退为纯文本；二进制文件通过 NUL 字节嗅探识别并明确拒绝。
• 面板头部：文件大小、复制内容、在系统应用中打开、收起。
• 文本 1 MiB / 图片 4 MiB 上限，超出显示截断提示。
• 保留原有体验：chips、「+ N 个文件」、「在文件夹中显示」，行内代码提及的产物文件仍然可点击。
• 预览面板自动跟随 DSH 明暗主题：背景、正文、链接、代码块全部使用主题变量（v0.1.1 修复夜间模式白底浅字问题）。

安装

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 保持轻量、零依赖。

与相似插件对比

| 插件 | 形态 | 区别 | |---|---|---| | dsh-markdown-preview（本插件） | 接管官方产物行 | 就在官方产物行的位置点击即预览，不增加任何新界面 | | dsh-file-explorer | 右侧文件树面板 | 全局面板，非聊天内 | | dsh-file-mentions | 反引号路径提及 + 尾部 chips | 从回复文本收集路径；官方产物行存在时不接管 | | dsh-md-preview | 渲染工具 + web 抽屉 | 抽屉/独立 HTML 导出，非聊天内 | | dsh-web-preview | 侧边 web 预览面板 | 运行/标注项目，非产物文件 |

安全说明

• 通道仅限 loopback，位于连接信任围栏之后。
• Markdown 以 html:false 渲染：文档中的原始 HTML 会被转义，链接仅允许 http(s)/mailto/#（markdown-it 默认 validateLink）。
• 预览大小上限 + 二进制嗅探避免内存/UI 滥用；预览只读（无写入端点）。

卸载

dsh plugin --profile web remove dsh-markdown-preview

开发

git clone https://github.com/GitHubJiKe/dsh-markdown-preview.git
cd dsh-markdown-preview
npm install          # 宿主侧依赖 markdown-it + highlight.js
dsh plugin --profile web add file:$(pwd)
# 重启 dsh web；profile 以 symlink 指向你的工作副本，
# 修改 lib/ 后再次重启即生效（客户端 bundle 在启动时扫描）

License

MIT

变更记录

• v0.1.1（2026-08-15）：修复深色主题下预览文字不可读——预览面板此前使用不存在的 --dsw-alias-surface-raised 变量导致背景恒为白色，而正文颜色继承聊天区（夜间为浅色）。现在背景/文字/链接/错误色全部改用主题真实存在的变量（--dsw-alias-bg-layer-1、--dsw-alias-label-primary、--dsw-alias-brand-primary、--dsw-alias-state-error-primary），预览面板自动跟随明暗主题。
• v0.1.0（2026-08-15）：首发。