前言¶

在 DSH web UI 中，工作区加入后，开发者常需要把某个文件交给模型读取。如果缺少目录浏览入口，手动输入路径会不够方便。dsh-workspace-explorer 是一个 DSH 工作区文件资源管理器插件：它在会话头部提供 “Workspace Files” 胶囊按钮，打开当前工作区的目录树，并支持点击或拖拽把文件引用追加到 composer。下面介绍它的功能、安装方式和注意事项。

这是什么¶

@jiyr0119/dsh-workspace-explorer 是由 Jiyr0119 维护的 DSH 原生插件，许可证为 MIT。它面向 DSH web UI，解决“工作区里有文件，但会话面板中缺少可浏览、可插入的文件树”的问题。

核心功能¶

• 在会话头部提供 “Workspace Files” 胶囊按钮，点击后打开当前工作区目录树弹出面板。
• 面板顶部可切换 Files 与 Settings 标签。
• Settings 页可实时调整隐藏噪音目录、显示大小、引用格式、预览行数、面板宽度，并同步到 DSH Settings → Workspace Explorer。
• 目录按需懒加载，并自动隐藏 node_modules、.git、dist、__pycache__ 等噪音目录。
• 按文件扩展名显示彩色文件类型图标。
• 点击文件行，向 composer 追加 [file: relative-path] 引用。
• 拖拽文件到 composer 可插入引用；拖拽文件夹可插入深度有限的紧凑目录列表。
• 支持 Shift / ⌘ 多选，并批量插入文件引用或目录列表。
• 基于 DSH 的 --dsw-alias-* 设计令牌适配明暗主题。
• 可按名称跨已加载目录过滤文件，并显示匹配数。
• 支持文本文件分页预览；小文件（≤ 32 KB）可粘贴完整内容。
• 支持分栏预览，左侧为 340px 预览面板，右侧保持文件树可见。
• 预览面板内可编辑文件，保存直接写入磁盘，并检测外部修改。
• 通过 DSH locale service 注册 zh / en 词典，并跟随 DSH UI 语言。

安装与启用¶

原生安装命令如下。该命令安装 npm 包，安装后在 DSH web UI 中使用：

dsh plugin --profile web add -w @jiyr0119/dsh-workspace-explorer@latest

-w 用于规避 pnpm 9/10 默认拒绝在 workspace root 添加依赖的行为。若不使用 -w，可创建 ~/.dsh/profiles/web/.npmrc 并写入：

ignore-workspace-root-check=true

需要说明：仅列出插件不会自动安装；需要用户点击安装或运行安装命令。

也可以采用动态插件方式，适合快速验证或没有 storefront 的环境：

1、在 DSH web UI 中运行 cordis_define。
2、将 dynamic/host.js 粘贴到 Host code。
3、将 dynamic/client.js 粘贴到 Client code。
4、运行 cordis_run 激活。
5、首次运行时，在 Run card 中完成授权。

典型用法¶

1、运行安装命令，或按动态插件方式完成激活。
2、在会话头部点击 “Workspace Files” 胶囊按钮，打开面板。
3、展开目录浏览文件。
4、点击文件行，或把文件拖入 composer，然后发送。
5、如需调整隐藏目录、显示大小、引用格式、预览行数或面板宽度，使用面板顶部 Settings 标签，或进入 DSH Settings → Workspace Explorer。

适用场景与注意¶

适合在 DSH web UI 中进行本地工作区开发、调试，并需要频繁把源码、配置、文档等文件引用给模型的开发者。它把目录浏览、文件引用、预览和编辑放在同一个会话面板中，减少手动输入路径的步骤。

使用前建议检查仓库源码、依赖和当前版本。已抓取资料未展示完整 scripts、依赖和项目结构，安装前以 GitHub 仓库当前版本为准。

注意以下行为边界：

• 文件编辑保存会直接写入磁盘。
• 保存时会检测文件是否被外部修改，并给出提示。
• 插件以当前 dsh 进程权限运行，因此安装前需要确认你有权限修改对应工作区文件。
• DSH 社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系；不要把目录页理解成官方应用商店。

链接¶

• GitHub 仓库：https://github.com/Jiyr0119/dsh-workspace-explorer
• 社区目录页（来自插件线索，未包含在已抓取资料中，使用前请核实）：https://www.skillhub.cn/plugins/Jiyr0119/dsh-workspace-explorer