dsh-plugin-file-manager

面向 DeepSeek Harness（DSH） Web 界面的会话文件管理器插件。它在会话标题栏增加“文件”入口，打开后展示该会话工作区的文件树、Git 状态，并支持直接预览文本、图片和视频。

功能

• 会话感知：使用当前会话的 sessionId 在 Host 端解析其固定 cwd，切换会话时自动关闭旧面板，不接受浏览器传入任意目录。
• 文件树：所有目录默认折叠，可逐级展开/折叠，并支持按名称或相对路径搜索；不跟随符号链接。
• 独立预览窗口：文件内容在居中的大型模态弹窗中展示，侧栏继续保留文件树与 Git 变更视图。
• 文本预览：点击普通文件即可查看 UTF-8 文本内容；空文件有明确提示，超过 512 KB 时仅显示安全截断的前部内容。
• 图片预览：支持 PNG、JPEG、GIF、WebP、AVIF、BMP 和 ICO，最大 50 MB。
• 视频预览：使用浏览器原生播放器预览 MP4、M4V、MOV 和 WebM，加载后自动播放，最大 2 GB，并支持 HTTP Range 拖动与续播。
• Git 变更视图：通过独立标签页集中展示已修改、已暂存、新增、删除、重命名、未跟踪和冲突文件，并保留分支与变更数量摘要。
• 删除项可见：已被 Git 记录但已从磁盘删除的文件仍会以删除线节点显示。
• 大目录保护：默认隐藏 .git 与 node_modules，最多读取 4,000 个节点、20 层深度；达到限制时面板会提示结果已截断。
• 安全执行：Git 通过 execFile 直接调用，不经过 shell；文件读取只接受会话工作区内的相对路径，逐级拒绝符号链接和隐藏目录，不返回工作区绝对路径。文本做大小与 UTF-8 校验，媒体同时校验扩展名、magic bytes 和容器标识。

安装

需要 DSH、Node.js 与 pnpm。

pnpm install
pnpm typecheck
pnpm build

dsh plugin --profile web add "$PWD"

dsh plugin add 会把本包作为普通依赖安装到 web profile；随后把仓库中的 cordis.patch.yml 内容合并到 $DSH_HOME/profiles/web/cordis.patch.yml：

- insert:
    - id: file-manager
      name: dsh-plugin-file-manager

确认依赖与插件行：

dsh plugin --profile web list
dsh --profile web --dump-config

首次安装后重启 dsh web，并刷新现有 http://127.0.0.1:3080 页面一次。进入任意带工作区的会话，标题栏右侧会出现“文件”按钮。

使用

1. 打开一个已有工作区的会话。
2. 点击会话标题栏的“文件”。
3. “文件树”视图中的目录默认全部折叠；点击目录行展开或折叠，存在 Git 变更的目录会显示黄色圆点。
4. 切换到“Git 变更”视图，可集中查看所有变更文件及其状态。
5. 点击普通文件会在居中的大型弹窗中打开文本、图片或视频预览；视频可使用原生控制条播放和拖动。
6. 点击弹窗关闭按钮、弹窗外遮罩或按 Esc 关闭预览，侧栏中的当前视图和搜索状态保持不变。
7. 在搜索框输入文件名或相对路径筛选当前视图；侧栏和预览弹窗各自提供刷新按钮。

Git 状态徽标采用两列 porcelain 语义：M· 表示暂存区修改，·M 表示工作区修改，?? 表示未跟踪。悬停徽标可查看中文说明。

HTTP 接口

Host 半包注册三个同源只读接口：

GET /file-manager/tree.json?sessionId=
GET /file-manager/content.json?sessionId=&path=
GET|HEAD /file-manager/media?sessionId=&path=