@khorsheed/dsh-client-ui-file-preview

English | 中文

在 dsh web GUI 里直接预览会话产出的文件——无需打开 IDE。"产物"tab 列出会话写入或编辑过的所有文件，选中即可在页面内查看当前内容与完整改动记录。

特性

• 产物 tab——列出会话写入或编辑过的每个文件，按最近活动倒序，可切换到全部文件。
• 文档形态预览——Markdown 渲染为文档，JSON/CSV 呈现为检查树/表格，HTML 提供源码 ⇄ 沙箱渲染切换，图片内联。
• 改动记录——步进查看每一次 write/edit 的 diff，每条带所属轮次与步骤。
• 回合变更卡片——每个已完成回合末尾出现可收起的"N 个文件已修改"卡片，逐文件列出行数增减。
• 就地抽屉——预览在仅内容抽屉中打开，支持内容搜索；"复制路径"始终可用，部署可对接原生桌面时另有"在文件夹中打开"和"在 IDE 打开"。

安装

dsh plugin --profile web add @khorsheed/dsh-client-ui-file-preview

然后重启 web 实例。

dsh plugin --profile web remove @khorsheed/dsh-client-ui-file-preview

Compatibility

• npm 发布线（@deepseek-ai/[email protected]）：✅ 完整——rc.8→0.1.1-rc.1 API 审计（2026-08-21）确认本插件消费的所有面无变化或纯增量（ProjectionDefinition 重构、cacheHitPercent 返回值变更、credentials/updated 事件改名均不涉及本包），无需改动源码；rc.1→rc.2 复核（2026-08-22）：消费面无变化，全量构建测试通过。
• 源码线(deepseek-harness master):✅

已知限制

• 仅文本预览 —— 二进制、超大、缺失文件只渲染带大小的分类提示，不渲染内容。
• 仅当前会话 —— 只显示当前所选会话的文件，不是任意文件浏览器。
• 只读 —— 预览永不修改；文件变更仍归会话所有。
• mention 拦截是非官方的 —— 只有官方 mention 按钮会被改道，且依赖非官方 DOM 结构；核心改动该结构时，mention 点击会静默退回 OS 打开。

实现原理

• src/client/index.ts —— apply：注册视图/回合行/抽屉并挂载 filePreview Remote
• src/client/FilePreviewView.tsx —— 产物 tab（文件列表 + 预览区）
• src/client/FilePreviewDrawer.tsx —— 就地预览抽屉
• src/client/TurnFileRow.tsx —— 每回合的"N 个文件已修改"卡片
• src/client/structured.tsx —— 文档形态渲染器（markdown/JSON/CSV/HTML 沙箱）
• src/client/mention-intercept.ts —— 官方 mention 点击的捕获阶段改道

纯增量插件：注册一个会话视图（conversation.view）、一个回合文件行（conversation.chat.turnTail）、一个抽屉（shell.overlay），并通过 ctx.remote.$mount 自挂载 filePreview Remote——原版 dsh 核心零改动即可运行。该命名空间不声明为 inject（自挂载会让加载器死锁）；挂载被 await 之后用 ctx.get('remote.filePreview') 读回。文件列表由 @khorsheed/dsh-file-preview 在宿主侧折叠（含嵌套 Code Mode 派发）。数据单向流动：tab 激活/刷新时拉取 filePreview.list，选中时拉取 filePreview.read，过期的在途请求丢弃。回合卡片经按会话的客户端缓存读同一个宿主 filePreview.turnFiles RPC——卡片与 tab 同一事实源——并无条件认领每个回合，官方产出文件行永不挂载。

预览渲染：Markdown 走官方 MarkdownText 管线，缩放到预览专用的 14px（仅在预览范围内覆盖字体 token）；JSON 走官方 JsonTree 检查树；CSV/TSV 渲染为表格（首行作表头）；其余文本文件保持语法高亮的代码视图。HTML 文件提供源码 ⇄ 渲染切换：渲染视图是沙箱 iframe（空 sandbox——无脚本、无表单、无弹窗；相对资源无法解析），因为官方管线按设计把原始 HTML 当字面文本。内容搜索时任何文本切换为原始匹配行，命中始终可见。

抽屉手势：头部显示宿主解析后的绝对路径，"复制路径"始终可用；"在文件夹中打开"和"在 IDE 打开"走与官方行相同的 loopback + canOpenPath 门禁。"在文件夹中打开"以会话 cwd 为基准解析路径，打开所在文件夹并选中文件（Finder open -R、Explorer explorer /select，或支持选中的 Linux 文件管理器），失败时回退为打开父文件夹。官方正文 mention 由捕获阶段点击拦截器（识别 code > button[title] 结构）改道到抽屉，无法识别时放行回官方行为；两处改道都标注 TODO(official-opener-seam)，待核心提供文件打开覆盖点后退役。抽屉打开时会话区按抽屉宽度向左让位。与模型无关：本包不组装也不发送任何提供方请求（无 KV 缓存影响）。

开发

隶属 dsh-plugins monorepo（packages/ui-file-preview）。问题与贡献请移步该仓库。

变更记录

见 CHANGELOG.md。