前言¶
在 DeepSeek Harness（DSH）里和智能体协作时，聊天里经常出现指向本机的文件链接：Blender 工程、FBX、PSD、压缩包等。默认行为往往是唤起系统资源管理器，或只能做简单预览，和「在 IDE 里继续对话」的节奏不太合拍。社区插件 nuet9/dsh-internal-folder-browser（包名 @local/internal-folder-browser）把「点链接 → 看所在文件夹并定位文件」做进 Harness 客户端面板，图片和文本仍走 Harness 原有预览。下面介绍它的定位、能力与安装方式；事实以 GitHub README 为准。
这是什么¶
Harness 内置文件夹浏览 / Internal Folder Browser 由维护者 nuet9 发布，分类为 客户端 插件。一句话：在 Harness 内浏览工程文件所在目录，不启动外部资源管理器；点击聊天中的本地文件链接时，显示文件夹并高亮目标文件。
DSH 生态强调「一切皆插件」；插件目录页托管在社区站点 skillhub.cn，与 DeepSeek / 幻方无官方从属关系，不是官方应用商店。
核心功能¶
以下能力均来自项目 README 与 package.json（当前版本 1.2.0，许可证 MIT）。
目录浏览与排序¶
- 展示文件名称、大小、修改时间，文件夹优先排序。
- 双击进入子文件夹；支持上一级与刷新。
- 图片、文本链接可继续使用 Harness 预览（与纯预览行为兼容）。
图标与缩略图¶
- Windows：使用系统实际文件关联图标；对 PNG/JPEG/BMP/GIF/TIFF 生成缩略图（仅处理小于 16 MiB 的常见格式，192px）。
- 其他平台：回退到扩展名标识；Windows 原生图标依赖系统自带的 Windows PowerShell 与
System.Drawing。
八种查看模式¶
查看模式包括：超大图标、大图标、中等图标、小图标、列表、详细信息、平铺、内容。顶部查看按钮与面板右键菜单均可切换；当前客户端会记住查看模式。
行为边界¶
- 不移动或修改被浏览的文件，不产生聊天命令执行记录。
- 内置界面是本插件提供的目录 UI，不是嵌入 Windows Explorer；不包含 Explorer 的文件操作、拖放或完整右键菜单。
安装与启用¶
适用于 Harness Desktop 0.2.1-rc.5。README 写明：此版本只在上述 Windows Harness 版本上验证过。
步骤¶
- 从 GitHub Release 下载附件
local-internal-folder-browser-1.2.0.tgz。 - 在 Harness 插件管理 中安装该本地 bundle。
- 安装后重新打开文件夹标签；若客户端仍加载旧模块，刷新 Harness。
- 不要与旧的
@local/file-folder-open外部资源管理器方案同时启用。
也可让 Harness 助手执行安装（路径按你本机下载位置修改）：
{"action":"install_bundle","target":"C:/Downloads/local-internal-folder-browser-1.2.0.tgz"}
插件 Host 侧提供只读目录列表服务；客户端模块通过 dsh.client 注入右侧边栏相关 UI（@deepseek-ai/dsh-client-ui-sidebar-right），并设置 immediately: true 以便尽早挂载。
典型用法¶
用法与 README 描述一致，无需额外配置字段：
- 在 Harness 聊天中点击 Blender、FBX、PSD、压缩包等本地文件链接。
- 客户端打开内置文件夹视图，高亮该链接对应的文件，并展示同级目录内容。
- 需要深入时双击子文件夹；需要返回时走上一级；需要换布局时用八种查看模式之一（偏好会保存在当前客户端）。
- 若链接是图片或文本，仍可按 Harness 原有方式预览，文件夹浏览与预览并行不冲突。
权限、限制与适用场景¶
谁适合用¶
- 经常在 DSH 里点本地资产路径、希望在同一窗口内定位文件、又不想反复切到系统资源管理器的开发者。
- 已在 Windows + Harness Desktop 0.2.1-rc.5 环境验证过的用户（其他平台/版本需自行评估图标与布局表现）。
务必知晓的限制¶
- 插件 Host 的只读服务允许已连接客户端列出本机绝对路径目录，包括工作区外目录。只应安装在你信任客户端的本地 Harness 上；不要暴露给不受信任的远程用户。
- 列表上限 2000 项；每次最多生成 120 个新图标，缓存上限 512 项。
- 安装前建议查看 源码仓库 与 MIT 许可证；插件以当前 DSH 进程权限运行，权限范围与 Harness 本身一致。
回退¶
禁用或卸载 @local/internal-folder-browser 即可恢复 Harness 原文件链接行为；不会更改工程文件。
验证与维护信息¶
仓库提供本地校验命令（面向开发者）：
node --check index.js
node --check client.js
node verify.mjs
README 说明回归覆盖目录跳转、中文路径、高亮、父目录、原预览保留、图标元素、八种模式切换、偏好保存和卸载恢复；Windows 本地版本已通过 Host RPC 列目录并获取图标。发布包的完整跨机器安装与八种布局视觉效果，文档注明尚未逐一实测。
- 目录页：https://www.skillhub.cn/plugins/nuet9/dsh-internal-folder-browser
- GitHub：https://github.com/nuet9/dsh-internal-folder-browser
经过上面的步骤，你可以在 Harness 内完成「点链接 → 看文件夹 → 定位文件」的闭环，而不必默认依赖外部资源管理器。
