Harness 内置文件夹浏览 / Internal Folder Browser

在 Harness 内浏览工程文件所在目录，不启动外部资源管理器。点击聊天中的 Blender、FBX、PSD、压缩包等本地文件链接，会显示文件夹并高亮目标文件。图片和文本链接保留原有预览。

功能

• 文件名称、大小、修改时间，文件夹优先排序。
• 双击进入子文件夹，上一级和刷新；图片、文本可继续使用 Harness 预览。
• Windows 实际文件关联图标；PNG/JPEG/BMP/GIF/TIFF 图片缩略图。
• 查看：超大图标、大图标、中等图标、小图标、列表、详细信息、平铺、内容。
• 顶部查看按钮与面板右键菜单，当前客户端记住查看模式。
• 不移动或修改浏览的文件，不产生聊天命令执行记录。

安装

适用于 Harness Desktop 0.2.1-rc.5。Windows 原生图标依赖系统自带 Windows PowerShell 和 System.Drawing；其他平台回退到扩展名标识。此版本只在上述 Windows Harness 版本验证。

下载 Release 附件 local-internal-folder-browser-1.2.0.tgz，在 Harness 插件管理中安装本地 bundle。也可让 Harness 助手调用：

{"action":"install_bundle","target":"C:/Downloads/local-internal-folder-browser-1.2.0.tgz"}

安装后重新打开文件夹标签；如果客户端仍使用旧模块，刷新 Harness。不要同时启用旧的 @local/file-folder-open 外部资源管理器方案。

权限与限制

此插件的 Host 只读服务允许已连接客户端列出本机绝对目录，包括工作区外目录。只应安装在你信任客户端的本地 Harness 上；不要暴露给不受信任的远程用户。列表上限 2000 项；每次最多生成 120 个新图标，缓存上限 512 项。图片缩略图仅处理小于 16 MiB 的常见格式，192px；关联图标清晰度取决于系统提供的图标。

内置目录页是本插件提供的界面，不是嵌入 Windows Explorer；不包含 Explorer 的文件操作、拖放或所有右键菜单。

验证

node --check index.js
node --check client.js
node verify.mjs

回归覆盖目录跳转、中文路径、高亮、父目录、原预览保留、图标元素、8种模式切换、偏好保存和卸载恢复。Windows 本地版本已实际通过 Host RPC 列目录并获取图标，内部列表已获用户确认；发布包的完整跨机器安装与8种布局视觉效果尚未逐一实测。

回退

禁用或卸载 @local/internal-folder-browser 即恢复 Harness 原文件链接行为；不会更改工程文件。

License

MIT