前言¶
DeepSeek Harness (DSH) 插件生态强调模块化与能力扩展。在开发或使用过程中，经常需要在对话中引用本地文件或查看项目目录结构。fexp-file-explorer 是一个动态 Cordis 插件，它将文件浏览能力集成到 DSH 的左侧工作区，提供独立的文件管理面板，方便在对话流中直接操作文件系统。
核心功能¶
该插件通过双入口设计提供文件访问能力：
* 双入口：侧栏顶部「文件浏览」胶囊按钮，以及会话标题栏「打开目录」按钮。
* 浏览面板：点击任意入口滑出 320px 面板，自动定位到当前工作区目录（cwd）。面板支持目录/文件切换、面包屑导航及工具栏操作（上一级、回到根目录、刷新）。
* 文件预览：点击文件在面板底部预览文本内容。预览有大小限制，默认 256KB 上限，最大 1MB，超限会报错 FS_TOO_LARGE。
* 系统集成：支持在系统资源管理器中打开当前目录，以及将文件引用添加到聊天输入框（使用 DSH @ 命令语法）。
* 技术特性：v1.5.0 起为静态 bundle 插件，随 profile 层栈自动加载；支持深浅色主题，使用 CSS 变量适配。
安装与启用¶
安装前请确保已安装 @deepseek-ai/cordis (^4.0.1)。
dsh plugin --profile web add fexp-file-explorer
安装完成后，需重启 dsh web 进程才能使插件生效。静态 bundle 形式安装后，每次启动 DSH 即自动加载。
典型用法¶
- 打开面板：点击侧栏顶部的「文件浏览」胶囊，或会话标题栏的「打开目录」按钮，320px 面板会从左侧滑出并定位到当前工作区目录。
- 浏览目录：点击目录进入下一级，使用工具栏按钮「上一级」、「回到根目录」或「刷新」进行导航，或通过面包屑快速跳转。
- 预览文件：点击文件，面板底部会显示文本内容预览。
- 添加到聊天：在预览模式下，点击「添加到聊天」按钮。DSH 会将文件引用（使用
@命令语法）追加到输入框草稿中，支持连续添加多个文件（空格分隔）。 - 在资源管理器中打开：使用工具栏最右侧按钮，直接在系统资源管理器中打开当前浏览的目录。
注意事项¶
- 文件大小限制：文件预览默认上限为 256KB，最大支持 1MB。超过限制会报错
FS_TOO_LARGE，需在对话中让助手直接读取。 - 静态 bundle 行为：静态 bundle 形式随 profile 加载，无进程存续限制。动态回退形态不跨 DSH 进程存续，重启后需重新加载。
- 安全审查：该插件的安全审查等级为 WARN（38/300），依赖
fs和rpc能力，无网络请求或进程启动能力。 - 适用场景：适合需要在 DSH 工作区中快速浏览文件、引用文件内容或跳转系统目录的场景。
生态背景¶
DSH 插件目录独立于 DeepSeek 官方应用，由社区维护。使用第三方插件前，建议查阅源码与许可证。
