dsh-sidebar-files

A sidebar file tree for DeepSeek Harness. Adds a Sessions / Files tab strip to the left sidebar and an inline, lazy-loaded file tree over the active workspace — with per-extension brand icons, copy-path, and send-to-agent actions.

Plugin status. Built and verified against the published harness (0.1.0-rc.6, the web profile). It runs entirely as an out-of-tree bundle: the node half serves directory listings through its own HTTP route, the browser half renders the tree. No core changes required.

Features

• Sessions / Files tab strip injected below the New Session button (wide sidebar). The tree renders inline in the sidebar region — same presentation as the harness's own browsing surfaces.
• Lazy listing: one directory level is fetched on demand (the workspace root on open, a directory on first expand), through the plugin's own GET /dsh-sidebar-files/list?path=… route. Wire cost follows what you actually open.
• Per-extension icons: 47 brand-style glyphs for common extensions (ts/js/json/yml/yaml/css/html/md/ico/png/zip/log/…), plus a generic document fallback. Icon path data from Material Icon Theme (MIT, © Material Extensions 2025) — see LICENSE.
• Hidden by default: dot-led names, node_modules, and .git are filtered out; the 显示隐藏项 toggle reveals them. node_modules/.git stay hidden until the toggle is on.
• Row actions (hover): copy path (with one-second "copied" feedback) and send the file to the current session's agent (a queued "please read this file" prompt).
• Resilient fallback: if the shell's sidebar structure is ever unrecognizable, the plugin degrades to a footer action button + centered modal instead of the tab strip — never a blank screen.
• Bilingual (中文 / English), following the harness locale.

Install

Requires the dsh CLI (npm i -g @deepseek-ai/dsh) and pnpm.

# from any directory
dsh plugin --profile  add dsh-sidebar-files

Or add a local checkout / tarball:

dsh plugin --profile  add ./dsh-sidebar-files          # local checkout (uses prepare)
dsh plugin --profile  add ./dsh-sidebar-files-0.1.0.tgz # prebuilt tarball

Restart the harness (dsh --profile ) and the 会话 / 文件 tabs appear in the sidebar. If the profile is a fresh one, first dsh plugin --profile add @deepseek-ai/dsh-web-app@0.1.0-rc.6 (or use the built-in web profile template).

Installing from GitHub (git installs build from source)

dsh plugin add github:you/dsh-sidebar-files fetches sources; the package's prepare script then builds lib/ from source, self-contained (no monorepo checkout needed). pnpm ≥10 refuses to run a git dependency's prepare script until you allowlist it — copy the exact package key pnpm printed into the profile's pnpm-workspace.yaml:

allowBuilds:
  dsh-sidebar-files: true

and re-run the add. Only allow packages whose source you trust, and prefer pinning a commit (github:you/dsh-sidebar-files#). Installing from npm or a tarball needs no build permission.

Development

pnpm install
pnpm test        # unit tests: listing logic, sidebar-host probing/injection, panel behavior
pnpm run typecheck
pnpm run build   # lib/index.js (node) + lib/client.js (browser bundle)

The browser bundle is a CommonJS closure-factory artifact (window.__ModuleLoader__.load({…})) with the harness's platform modules external, so it loads through the web shell's module table; CSS modules are compiled in with lightningcss.

How it works

• cordis.patch.yml inserts one host row (id: sidebar-files) that mounts the node half.
• The node half (src/index.ts) registers a web-server route prefix /dsh-sidebar-files; GET /list?path= lists one directory level (directories first, then files; bounded to the first 1000 entries) and returns { path, entries, truncated } — errors are 400 with a machine-readable code.
• The browser half (dsh.client declaration, ./client export) registers into the harness's sidebar.footer.action slot, then locates the sidebar column at runtime from its own trigger button and injects the Sessions/Files tab strip and the inline tree region (see src/client/sidebar-host.ts). When the shell structure is unrecognizable, the footer button + modal fallback takes over.
• The active workspace path is derived from the session/workspace stores (current session's workspace, else recent, else first) through selector hooks, exactly like the harness's own browsing surfaces.

License

MIT — see LICENSE. File-type icon glyphs are derived from Material Icon Theme (MIT, © Material Extensions 2025); the attribution and copyright notice are preserved in src/client/file-type-icons.tsx.