前言¶
在 DeepSeek Harness（DSH）里通过 Web 界面浏览项目文件时，默认文件树往往只有朴素的目录与扩展名提示，不利于快速扫一眼区分语言、框架配置和常见目录结构。VS Code 用户习惯 Material Icon Theme 那套语义化图标，但在 DSH 的 dsh-better-sidebar 探索器里并不会自动出现。
下面介绍社区插件 dsh-material-file-icons：在不改 sidebar 源码的前提下，为 Web 端文件树注入 Material Icon Theme 风格的 SVG 图标，并支持按文件夹名称匹配开/合状态。插件在 SkillHub 目录中归类为「趣味换装」，维护者标注为 modersetech；技术说明与安装命令以项目 README 为准。
这是什么¶
dsh-material-file-icons 面向 DSH Web GUI 的文件探索器（dsh-better-sidebar），提供与 Material Icon Theme 同源的图标视觉。宿主侧按固定路由提供 SVG，客户端注入样式并用轻量 DOM 观测为目录行打上属性，再由 CSS 映射图标——README 明确说明无需对 dsh-better-sidebar 打补丁。当前 package 版本为 1.1.0，许可证 MIT，运行要求 Node >= 20。
核心功能¶
依据 README 与 package 描述，已核实能力如下。
图标资源¶
- 约 350 枚 authentic SVG，主要来自
PKief/vscode-material-icon-theme（MIT），并包含来自vscode-icons/vscode-icons的 shadcn glyph。 - 覆盖 90+ 种文件类型：语言、框架、配置、媒体、压缩包等。
- 按文件名匹配：例如
component.json/components.json使用随主题变化的 shadcn 标识，tsconfig.json、jest.config.*、.editorconfig、nest-cli.json等有专用图标。
文件夹图标¶
- 约 130 个命名文件夹族（如
src、components、__tests__、.github、node_modules等）。 - 提供与上游一致的打开 / 关闭变体，通过
data-dir（文件夹名）与data-open等属性区分。
工作机制（简述）¶
- 宿主：在内存缓存中通过精确路径
/material-icons/*.svg提供每个 SVG。 - 客户端：注入一份 stylesheet，运行
MutationObserver，为探索器中的目录行设置data-dir与data-open；纯 CSS 完成图标映射。
安装与启用¶
安装命令须使用 README 原文（--profile web 与 GitHub 坐标以文档为准）：
dsh plugin --profile web add github:sarfarazstark/dsh-material-file-icons
完成上述步骤后，重启 DeepSeek Harness Desktop。README 写明无需其他配置步骤。
卸载：
dsh plugin --profile web remove dsh-material-file-icons
典型用法¶
本插件属于外观增强类扩展，没有单独的 CLI 子命令或业务 API。典型工作流即为：在 web profile 下安装 → 重启桌面端 → 打开带 dsh-better-sidebar 的文件探索器，即可在树形列表中看到按扩展名与文件夹名匹配的 Material 风格图标；展开或收起目录时，文件夹图标应随 data-open 在打开/关闭样式间切换。
若图标未出现，可先确认插件是否安装在 web profile、是否已重启 DSH，并在浏览器开发者工具中检查 /material-icons/*.svg 请求是否成功返回。
适用场景与注意¶
适合谁：长期在 DSH Web 界面里读代码、辨目录结构的智能体开发者或日常用户；希望文件树视觉与 VS Code Material Icon Theme 接近、又不愿 fork sidebar 的场景。
权限与安全：DSH 插件与当前 DSH 进程权限相同运行。安装前应自行查看仓库源码与 MIT 许可证；图标美术版权归上游 Material Icon Theme 与 vscode-icons 项目，本插件仅在其许可范围内在 DSH 内再分发 SVG 资源。
生态说明：DSH 奉行「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系，本文所称「目录页」仅作发现入口，不代表官方应用商店。
仓库坐标：SkillHub 条目指向 modersetech/dsh-material-file-icons，而 README 与 package.json 中的安装命令与 repository.url 为 sarfarazstark/dsh-material-file-icons。安装与排障请以 README 中的 dsh plugin 命令为准。
结尾¶
dsh-material-file-icons 用约 350 枚上游 SVG、命名文件夹开/合变体与纯 CSS 映射，为 DSH Web 文件树提供 Material Icon Theme 风格展示，安装后重启即可使用。
- 目录页：https://www.skillhub.cn/plugins/modersetech/dsh-material-file-icons
- GitHub（用户线索）：https://github.com/modersetech/dsh-material-file-icons
- README 安装源：https://github.com/sarfarazstark/dsh-material-file-icons
