dsh-explorer

1. 安装并启动 DeepSeek Harness：npx @deepseek-ai/dsh web
2. 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
3. 用 dsh plugins list 确认已安装，必要时重启 Harness 生效

插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。

事实信息来自公开插件目录快照（2026-10-03），介绍文案由本站再加工。

以下为插件仓库 README 全文（原始内容，由公开目录抓取整理）。

[English](README.md) · [中文](README.zh-CN.md)

# dsh-explorer

A file-tree sidebar for the DeepSeek Harness web UI. A blue round button on the right edge opens a drawer with the current workspace's files — lazy-loaded and virtualized, so even big directories stay responsive.

The plugins only add UI and a few read-only routes. Nothing in the shipped dsh packages is touched, so dsh updates shouldn't break anything.

## Install (two commands — monorepo)

```bash
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"
# restart dsh
```

![dsh-explorer file tree](assets/screenshot.png)

## What you get

- A right-side drawer (drag the edge to resize) with a floating blue toggle; open state and width are remembered
- VS Code-style indent guides, hover highlights the active line
- Git status at a glance: M/A/U/D/R letters in a right-aligned column, tinted filenames, dirty dots on folders, struck-through rows for deleted files, gitignored entries dimmed
- Modified files get a **git diff view** (HEAD vs working tree, side-by-side) right in the preview
- Click a file to preview it — text opens in CodeMirror (Ctrl+F gives a VS Code-like find bar), images/video/audio/PDF play inline
- Drag any file/folder (or selected code from the preview) into the chat input — inserts an XML-tagged reference (``) and shows a removable chip above the composer
- Search (skips .git and node_modules), expand/collapse-all, auto-refresh every 1.2 s

## Two packages

| package | what it does |
| --- | --- |
| `dsh-explorer` | Host side (Node). Serves the read-only `/filetree/*` API: directory listing, file read, search, git status, raw media streaming. No dependencies. |
| `dsh-client-ui-explorer` | Browser side (TS/TSX). The toggle, the drawer, and everything you see. |

Both follow the official dsh plugin contract. Wiring and deployment details live in [dsh-plugins/README.md](dsh-plugins/README.md).

## Install

You need both halves. Bundle install (monorepo — one command per package):

```bash
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"
# restart dsh
```

*(Dev machine: keep the junction + `cordis.patch.yml` insert-row setup — don't run the bundle commands in the same profile.)*

Manual (dev, no restart): copy the two packages into the profile's `node_modules` and add them to its `cordis.patch.yml`:

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

Restart dsh — or bump the host package name (v8, v9…) to avoid the restart. The browser bundle is self-contained; no `npm install` needed to run it. Full steps: [dsh-plugins/README.md](dsh-plugins/README.md).

## Development

```bash
cd dsh-plugins/dsh-client-ui-explorer
npm run dev        # watch + sync into the running profile
npm run bundle     # one-shot minified build
npm run types      # generate lib/types/*.d.ts
npm run typecheck
```

Host changes go into `dsh-plugins/dsh-explorer/lib/index.js`; copy it into the profile under a bumped package name to reload without restarting.

## Docs

- [dsh-plugins](dsh-plugins/README.md) — architecture, install, deploy (中文: [README.zh-CN.md](dsh-plugins/README.zh-CN.md))
- [dsh-client-ui-explorer](dsh-plugins/dsh-client-ui-explorer/README.md) (中文: [README.zh-CN.md](dsh-plugins/dsh-client-ui-explorer/README.zh-CN.md))
- [dsh-explorer](dsh-plugins/dsh-explorer/README.md) (中文: [README.zh-CN.md](dsh-plugins/dsh-explorer/README.zh-CN.md))

MIT