dsh-file-panel

面向 DeepSeek Harness（dsh Web 图形界面）的插件：实时追踪会话中 Agent 创建或下载到本地的文件与图片，并在右侧弹出面板中展示——类似 Codex 的文件查看器。

会话期间只要有文件或图片写入本地磁盘，面板就会自动在右侧弹出。每个文件条目支持：

• 👁 预览 — 图片直接内联显示；文本文件显示前 256 KB 内容；其他类型显示元信息。
• 📂 所在位置 — 在系统文件管理器中定位该文件（Windows 用 explorer.exe /select，macOS 用 open -R，Linux 用 xdg-open）。
• ↗ 打开 — 用系统默认程序打开文件（复用 Harness 内置的 host.openPath RPC）。
• 📋 复制路径 — 复制绝对路径到剪贴板。

面板底部还提供「打开工作目录」快捷入口。

English

截图

本地运行后补充截图（见开发）。

安装

需要已安装 DeepSeek Harness 的 dsh 命令行（npm 包 @deepseek-ai/dsh）以及 pnpm。

从本地源码安装

cd dsh-file-panel
npm install          # 仅安装开发依赖 esbuild
npm run build        # 生成 lib/index.js 与 lib/client.js（已提交进仓库）

# 注册到 web 配置（link: 方式会实时跟踪你的源码目录）
dsh plugin --profile web add link:.

从 GitHub 安装

dsh plugin --profile web add github:yu2025-luo/dsh-file-panel

构建产物已随仓库提交，安装时无需执行任何构建脚本。

启用

重启 dsh web 服务（插件集合在重启时生效），然后刷新 http://127.0.0.1:3080。无需任何配置。

卸载：

dsh plugin --profile web remove dsh-file-panel

使用说明

操作	效果
Agent 创建/下载文件	面板自动弹出（新文件带 新 徽标）
单击条目	内联预览（图片 / 文本 / 元信息）
悬停条目上的按钮	预览、打开、所在位置、复制路径
🔔 铃铛	开关「新文件自动弹出」
– / ×	收起为右下角悬浮按钮（带新文件角标）或完全隐藏
底部「打开工作目录」	打开当前会话的工作目录

面板状态（打开/收起）与自动弹出偏好保存在 localStorage。自动弹出的 基线按会话计算：面板首次看到该会话时已存在的文件不会再次触发弹出。

工作原理

一个 npm 包包含两个半边，通过一条 loader 行（cordis.patch.yml → 行 ）注册：