前言¶
在使用 DeepSeek Harness 进行智能体开发时,查看会话生成的工作区文件(如代码、日志、Markdown 文档)是调试和验证的关键环节。dsh-file-explorer 插件在 DeepSeek Harness 的 Web 界面中增加了一个 “Files” 标签页,将会话工作区以树形结构展示,并提供针对不同文件类型的实时预览与导出功能。
核心能力¶
该插件提供以下功能:
- 文件浏览:以目录树形式展示会话工作区,支持多级展开。
- 多格式预览:
- Markdown:渲染 GFM,支持 Mermaid 图表、数学公式、表格、任务列表、引用、脚注及高亮代码块。
- HTML:在沙箱帧中预览,包含 CSS 样式和脚本。
- JSON:提供可折叠的树形查看器,支持单值复制。
- 代码:支持 24 种语法高亮(TypeScript/JavaScript, Python, Go, Rust 等)。
- 媒体:支持图片(PNG, JPEG, GIF, SVG 等)和 PDF 预览。
- Office:支持 Word (.docx)、Excel (.xlsx)、PowerPoint (.pptx) 文档预览。
- 操作功能:支持文本复制、文件下载、以及 Markdown/HTML 文档导出为 PDF 或 Word。
安装与启用¶
通过官方插件命令安装:
dsh plugin --profile web add @jaxzhou/dsh-file-explorer
安装后启动 Web profile:
dsh --profile web
使用方式¶
- 在 DeepSeek Harness 中打开一个包含工作区的会话。
- 点击界面上的 “Files” 标签页。
- 左侧显示工作区目录树,点击文件在右侧预览。
注意事项¶
- 版本要求:需要 DeepSeek Harness 0.1.5-rc.2 及以上版本的 Web 表面。
- 权限模式:插件为只读访问,通过 Harness 的
workspaceFilesRemote 命名空间读取文件,不涉及磁盘写入或凭据存储。 - 配置:无需额外配置,不需要修改
cordis.yml。 - 文件大小:支持下载超过 260 MB 的文件。