deepseekplugins

DeepSeek Harness 插件

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.（英文原文）

界面增强
跳到安装方式

来源信息

GitHub 仓库
kaijia323/dsh-ymc-sidebar
最近更新
2026年8月20日
分类
界面增强
GitHub stars
0
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt，让 Agent 读 GitHub 仓库和源码；需要自己装时再切到命令。

复制这段 Prompt，发给 DSH、Codex 或其他 Agent，让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码，然后用清楚、直接的方式回答以下问题，帮助我判断它是否适合我的需求：

1. 这个插件是什么，解决什么问题；
2. 适合哪些用户和典型使用场景；
3. 安装后如何使用，并给出一个最小使用示例；
4. 有哪些已知限制，以及隐私、安全、兼容性或维护风险；
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明，不要猜测或照抄 README。

GitHub：https://github.com/kaijia323/dsh-ymc-sidebar
插件名：dsh-ymc-sidebar
作者：kaijia323

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器3 个文件
README.md来源说明 · 只读预览

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

返回搜索打开 GitHub 仓库

更多相关插件

查看分类