No-PRM/dsh-explorer

English ·

dsh-explorer

给 DeepSeek Harness 网页端加一个文件树侧栏。右侧边缘一个蓝色圆形按钮,点开就是当前工作区的文件抽屉 —— 懒加载加虚拟化,目录再大也不卡。

插件只加 UI 和几条只读路由,不碰 dsh 自带的包,升级一般不会出问题。

安装(两条命令 —— monorepo)

dsh plugin --profile web add "github:No-PRM/dsh-explorer#main&path:/dsh-plugins/dsh-explorer"
dsh plugin --profile web add "github:No-PRM/dsh-explorer#main&path:/dsh-plugins/dsh-client-ui-explorer"
重启 dsh

dsh-explorer 文件树

功能

- 右侧抽屉(拖边缘调宽)+ 悬浮蓝色开关,开合状态和宽度都会记住
- VS Code 那种逐行层级线,悬浮时高亮当前行的线
- git 状态一眼看:最右一列 M/A/U/D/R 字母、文件名着色、文件夹脏点、删除的文件画删除线、gitignore 的变淡
- 有改动的文件支持 git 对照:预览里直接看 HEAD 与工作区并排 diff
- 点文件直接预览:文本走 CodeMirror(Ctrl+F 是 VS Code 样式的查找条),图片/视频/音频/PDF 内嵌播放
- 把文件/文件夹(或预览里选中的代码)拖进聊天输入框,插入 XML 标签引用(),输入框上方显示可删除的引用标签
- 搜索(跳过 .git 和 node_modules)、全部展开/折叠、每 1.2 秒自动刷新

两个包

| 包 | 干什么 |
| --- | --- |
| dsh-explorer | 宿主端(Node)。提供只读 /filetree/ 接口:列目录、读文件、搜索、git 状态、媒体流。零依赖。 |
| dsh-client-ui-explorer | 浏览器端(TS/TSX)。按钮、抽屉、你能看到的一切。 |

两个都按官方插件契约写。接线和部署细节见 dsh-plugins/README.zh-CN.md。

安装

两个都要。bundle 安装(monorepo —— 每个包一条命令):

dsh plugin --profile web add "github:No-PRM/dsh-explorer#main&path:/dsh-plugins/dsh-explorer"
dsh plugin --profile web add "github:No-PRM/dsh-explorer#main&path:/dsh-plugins/dsh-client-ui-explorer"
重启 dsh

(开发机:保持 junction + cordis.patch.yml insert 行,别在同一 profile 跑 bundle 命令。)*

手动方式(开发/免重启):把两个包拷进 profile 的 node_modules,再在它的 cordis.patch.yml 加:

- insert:
- id: filetree
name: dsh-explorer-v1
- id: ui-filetree
name: dsh-client-ui-explorer

重启 dsh;不想重启就把宿主包名递增(v8、v9…)。浏览器 bundle 是自包含的,跑起来不需要 npm install。完整步骤看 dsh-plugins/README.zh-CN.md。

开发

cd dsh-plugins/dsh-client-ui-explorer
npm run dev        # watch + 同步到运行中的 profile
npm run bundle     # 一次性压缩构建
npm run types      # 生成 lib/types/*.d.ts
npm run typecheck

宿主改动写在 dsh-plugins/dsh-explorer/lib/index.js,拷进 profile 时包名递增即可免重启。

文档

- dsh-plugins — 架构、安装、部署(English)
- dsh-client-ui-explorer(English)
- dsh-explorer(English)

MIT