前言¶
在 DeepSeek Harness（DSH）里做智能体或日常开发时，工作区里常混入各类附件：压缩包、日志、模型权重、视频片段等。DSH 自带侧栏预览并不能覆盖所有这些格式，大体积表格或日志也往往不如专用查看器顺手。为此需要切换外部应用，打断当前对话与编辑节奏。
下面介绍社区插件 dsh-any-preview（维护者 actcwlf）。它为 DSH 右侧栏提供通用文件预览渲染，专门补齐 DSH 未覆盖的格式，并改善大文本文件的浏览体验。当前公开版本为 0.1.0-beta.1，以 npm 渠道 dsh-any-preview@beta 分发，许可证为 MIT。GitHub 仓库见文末链接；插件目录页与 DeepSeek / 幻方无官方从属关系，属于 DSH「一切皆插件」生态中的独立条目。
这是什么¶
dsh-any-preview 是面向 DSH 侧栏文档预览（@deepseek-ai/dsh-client-ui-sidebar-documentpreview）的 Web 侧插件：package.json 中 dsh.client.platform 为 web，通过 Cordis bundle patch 注入客户端能力。
一句话定位：在侧栏内直接打开多种文件，不必为「看一眼结构或内容」离开 DSH。
核心功能¶
以下能力均来自仓库 README 与说明图，按类别归纳。
视频与音频¶
支持常见媒体扩展（如 mp4、mkv、mp3、wav 等）。可在侧栏播放并拖动时间轴定位到需要的片段。
压缩包¶
支持 zip、tar、tar.gz、tgz、7z 等。可浏览归档内条目，并直接打开成员文件。
大文件表格与日志¶
对 csv、tsv 等大表支持浏览、搜索、定位单元格；对 log 可按级别阅读、搜索并跟进最新输出。对 jsonl、ndjson 可逐条浏览并定位畸形行。
差异与结构化阅读¶
diff、patch 可查看变更及增删统计；rst、ipynb、epub、eml 等分别按各自文档结构阅读（章节、笔记本单元、邮件头与正文等）。
3D 与字体¶
glb、gltf、obj、stl 可在预览窗格内旋转、缩放并播放动画；ttf、otf、woff、woff2 可预览字形。
模型权重与数据库（只读）¶
safetensors、gguf 用于查看结构、规模、量化等元信息；sqlite、sqlite3、db、db3 可浏览表、视图与索引，README 明确为不修改数据的只读访问。
对话中的文件摘要¶
在深入阅读前，可在对话侧看到文件结构、大小与关键信息，再决定是否继续打开侧栏预览（README 示意图 preview_inspect）。
完整扩展名与能力对照见下表（与 README 一致）：
| 类别 | 扩展名 | 侧栏中可做的事 |
|---|---|---|
| 表格 | csv tsv |
浏览大表、搜索、定位单元格 |
| 差异 | diff patch |
查看变更与增删数量 |
| 日志 | log |
按级别阅读、搜索、跟进最新输出 |
| 结构化数据 | jsonl ndjson |
浏览记录、定位畸形行 |
| 媒体 | mp4/mkv/… mp3/wav/… |
播放并拖动时间轴 |
| 3D | glb gltf obj stl |
旋转、缩放、播放动画 |
| 字体 | ttf otf woff woff2 |
预览字体与字形 |
| 归档 | zip tar tar.gz tgz 7z |
浏览条目并直接打开成员 |
| 邮件 | eml |
正文、发件人/收件人、附件名 |
| 电子书 | epub |
按章阅读 |
| 笔记本 | ipynb |
阅读叙述、代码与输出 |
| reST | rst |
标题、正文、admonition |
| 模型权重 | safetensors |
结构、参数量、元数据 |
| 模型权重 | gguf |
版本、架构、量化信息 |
| 数据库 | sqlite sqlite3 db db3 |
只读查看表、视图、索引 |
运行环境：Node >= 20.9（package.json engines）；包管理器构建侧要求 pnpm >= 11（面向贡献者，终端用户通过 DSH 安装插件即可）。
安装与启用¶
安装方式以 README 原文为准，分 GUI 与命令行两种。
方式一：DSH 图形界面
在插件安装界面输入包名：
dsh-any-preview@beta
按界面提示完成安装。
方式二：DSH Web profile 命令行
dsh plugin --profile web add dsh-any-preview@beta
卸载在同一插件页面使用卸载按钮。README 要求：安装或移除插件后重启 DSH。
典型用法¶
README 未给出逐步 CLI 示例，典型路径是「在 DSH 工作区选中或打开上述扩展名的文件 → 侧栏自动走 any-preview 渲染器」。可按场景理解：
- 打开大型
csv或log：在侧栏内搜索、翻页或跟进尾部，避免整文件拖入对话上下文。 - 收到
zip或7z：在侧栏浏览条目，对单个成员再预览，无需先解压到系统临时目录再开其他工具。 - 查看
gguf/safetensors：在侧栏核对架构与量化信息，再决定是否把权重纳入后续任务。 - 预览
glb或视频：在时间轴或 3D 视图中定位细节，保持与 Agent 对话同一窗口。
若需先了解文件是否值得深读，可依赖插件提供的「对话中文件摘要」能力（见 README 截图说明）。
适用场景与注意¶
适合谁
- 经常在 DSH 工作区内处理混合格式仓库、数据集、构建产物或交付物的开发者。
- 希望减少「为预览一个文件切换应用」次数、把查看动作收拢到侧栏的人。
注意事项
- 插件随 当前 DSH 进程权限 运行；安装前建议阅读 GitHub 源码 与 MIT 许可证，第三方组件声明见仓库
licenses/README.md。 - 当前为 beta（
0.1.0-beta.1），行为与格式支持以 README 与 CHANGELOG 为准。 - 仅声明支持 Web profile 注入；安装命令中使用
--profile web与package.json中platform: "web"一致。
结尾¶
dsh-any-preview 把 DSH 侧栏预览从「常见代码与文档」扩展到归档、媒体、3D、权重与 SQLite 等场景，并针对大表与大日志做了侧栏内浏览。若你的工作流已固定在 DSH 中，可用官方包名 dsh-any-preview@beta 安装，重启后即可在侧栏验证所关注的扩展名。
- 插件目录页：https://www.skillhub.cn/plugins/actcwlf/dsh-any-preview
- GitHub：https://github.com/actcwlf/dsh-any-preview
- npm：https://www.npmjs.com/package/dsh-any-preview
