deepseekplugins

DeepSeek Harness plugin

dsh-ymc-sidebar

VSCode-style file explorer for the DeepSeek Harness web client: virtualized, lazily loaded file tree in the right details column with text / Markdown / image preview.

UI Enhancements
Jump to install

Source facts

Repository
kaijia323/dsh-ymc-sidebar
Latest update
Aug 20, 2026
Category
UI Enhancements
GitHub stars
0
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/kaijia323/dsh-ymc-sidebar
Plugin: dsh-ymc-sidebar
Author: kaijia323

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

dsh-ymc-sidebar

DSH Web Client 的 VSCode 风格文件树侧栏。作为 #root 的兄弟节点挂载在 document.body 上，通过 CSS layout push 让 DSH 原生界面让出右侧空间；不占用 DSH 原生 details slot，因此 blank 会话也能打开。特性：

  • 以当前会话工作区目录（session cwd）为根展示文件树
  • 目录按需懒加载，树与代码视图都做了虚拟滚动
  • 默认不显示内容预览区；点击文件后，在右栏下方预览内容（上方为文件树）
  • 支持多文件 tabs：可同时打开多个文件、横向滚动、点击 × 关闭
  • 支持文本/代码（带行号与基础语法高亮）、Markdown 渲染 / 源码切换、常见图片预览
  • 不预置目录忽略规则，文件系统里有什么就展示什么（node_modules 等大目录靠懒加载 + 虚拟化抗压）

架构

插件分两半：

  • Host half（src/index.ts）：注入 fs 与 connection，在 /dsh-ymc-sidebar 注册一个仅 loopback 可访问的 Connection RPC channel，提供 meta / list / read 三个端点。
  • Browser half（src/client.tsx）：注入 sessions、workspaces、connection，在 document.body 上创建自己的 React root 并挂载右侧栏。右侧栏是 #root 的兄弟节点，不注册任何 DSH slot：

- 打开时通过 --dsh-ymc-sidebar-width 让 #root 让出宽度，形成“真占位”的 VSCode 式侧栏，而不是 overlay； - 面板本身可拖拽调整宽度（280–640px），宽度与开关状态按 localStorage 持久化； - 不依赖 ctx.layout.openDetails()，所以 blank / 无消息会话也能打开。

> 不修改 DSH 源码，也不替换 DSH 原生 details 面板；原生 details 是否打开与本插件互不影响。

源码按职责拆分，入口文件只保留插件注册逻辑：

  • src/index.ts：Host 插件入口；RPC、文件系统、配置等逻辑在 src/host/（config / fs / handlers / rpc / result / utils）。
  • src/client.tsx：Browser 插件入口；React 组件、状态与 API 封装在 src/client/（api / tree / preview / sidebar-shell / styles 等）。
  • src/client-model.ts：与 React 无关的纯模型（路径、扁平化、树交互 reducer），可独立单测。

前端样式直接消费 DSH 的主题 alias token（--dsw-alias-*），不维护独立色板；组件使用 Tailwind CSS 编写，构建时由 tailwindcss 从 src/client.css 生成 utility CSS 并内联进客户端 bundle。

安装 / 开发

要求 DSH 0.1.0-rc.7、pnpm 10+ 与 Node.js 20+。

pnpm install
pnpm build
dsh plugin --profile web add .

重启 dsh web 后，右侧文件树会自动作为 body 兄弟节点打开并展示；即使当前会话是 blank 也能打开。可通过面板右上角 × 收起，收起后右上角按钮可重新展开，左侧边缘可拖拽调整宽度。

本地开发时修改源码后重跑 pnpm build，然后重启 dsh web。只改 cordis.yml 里的 config 时 DSH 会热替换插件实例。

Tailwind 与主题

  • src/client.css 是 Tailwind 入口：只开启 components + utilities，不注入 base preflight，避免污染 DSH 宿主样式。
  • 颜色、边框、背景、状态色全部使用 var(--dsw-alias-*)，随 DSH 明暗主题自动切换。
  • pnpm build 会优先调用 Tailwind CLI 生成 lib/client.css 并内联到 lib/client.js；如果当前环境尚未安装 Tailwind（如未执行 pnpm install），会自动回退到 src/client.fallback.css，保证本地构建可用。

热插拔 / HMR

  • Host 半的 RPC channel 注册和 Browser 半的 slot 注册都挂在 Cordis fiber 上，插件卸载/HMR 时自动撤销。
  • 每个插件 fiber 都会创建自己的 <style data-dsh-ymc-sidebar-style> 节点，disposer 只移除自己创建的那个，因此热替换重叠期间不会互相删除样式，也不会残留旧样式。

配置

- insert:
    - id: dsh-ymc-sidebar
      name: dsh-ymc-sidebar
      config:
        maxTextBytes: 2097152
        maxImageBytes: 8388608
        maxEntriesPerDirectory: 2000
        maxTreeRows: 100000
配置默认值说明
maxTextBytes2097152单次文本预览上限（UTF-8 字节）
maxImageBytes8388608单张图片预览上限（字节，经 base64 返回）
maxEntriesPerDirectory2000单目录最多返回的条目数；超出时截断并在树上提示
maxTreeRows100000客户端展开后可扁平化的最大树行数，防止超大目录打爆内存

测试

pnpm test

覆盖：

  • 客户端纯模型：路径处理、根目录解析、懒加载扁平化、行数上限、循环引用保护
  • Host RPC：meta / list / read 成功路径、截断、二进制回退、超大文件、非法路径
  • 客户端契约回归：标准 hooks 必须传 selector、侧栏必须作为 body 兄弟节点挂载且不注册 details / shell.overlay、必须通过 #root margin-right 做 layout push、lazy-CJS bundle 可物化
  • 前端契约：样式必须使用 DSH alias token + Tailwind 入口（且不注入 preflight）、style installer 必须按 fiber 独立创建/移除（热插拔安全）

常见问题

  • 右侧看不到文件树内容？ 当前会话必须带工作区 cwd；无 cwd 时右栏会显示提示。右栏会保持打开。
  • 点了文件显示“二进制文件”？ 非 UTF-8 文本会回退为二进制提示，这是 dsh-fs 的文本语义。
  • 图片看不到？ 仅支持 png / jpg / jpeg / gif / webp / bmp / ico / avif，且大小不能超过 maxImageBytes。
  • 升级 DSH 后布局异常？ 本插件依赖 #root 作为 DSH 原生根节点和 --dsh-ymc-sidebar-width 做 layout push；升级后若 DSH 调整根节点结构，先检查 #root 的 margin-right 是否仍生效。

License

MIT

Back to searchOpen GitHub repository

More related plugins

View category