工作区文件树

右侧抽屉「文件」，浏览当前会话所属工作区的目录树并预览文件。

功能

• 按深度缩进的树：目录在前、懒展开（每次展开一次 files.list）；失败节点可重试，超限列表有标记。
• 点击文件在树旁打开右侧预览栏，树保持可浏览、抽屉自动加宽；预览栏吸顶显示路径与「关闭预览」。
• 预览按格式渲染：Markdown 走渲染器；PDF 用浏览器原生查看器（blob URL）；docx/xlsx 提取段落/行文本；其余按 UTF-8 文本。二进制、空文件、文本过大、PDF 截断各有提示。
• 抽屉从右侧弹出，左缘可拖动宽度（最小 320 px）；Esc、点外或头部按钮关闭。

组成

包	角色
dsh-plugin-workspace-files	组合包（dsh.bundle），patch 插入 files 与 ui-files 两行
@deepseek-ai/dsh-files	主机服务 ctx.files：目录列表与有界预览（node:fs 直读；docx/xlsx 用 fflate 只解压文本部件；预算 maxPreviewBytes/maxBinaryBytes/maxListEntries 可配置）
@deepseek-ai/dsh-client-ui-files	浏览器 UI：conversation.session.header.utilities 槽位入口，数据经注入的 files 钩子到达

安装

见仓库根 README。使用仓库根目录 dist/*.tgz，不要传入 harness 源码目录或 file: 路径。

限制

• 树只读且有缓存：无「用编辑器打开」或刷新动作。
• 预览是有界头部：超限文本/PDF 只显示开头；归档提取只有文本（不含排版、图片、首个工作表之外的内容）。
• 无搜索与过滤；目录符号链接列为文件、不可浏览。