dsh-ymc-sidebar
适用于 DeepSeek Harness 网页客户端的 VSCode 风格文件浏览器：一个挂载于 body、可拖动的右侧边栏，提供虚拟化的延迟加载文件树以及文本 / Markdown / 图片预览。不依赖原生 details 插槽，因此可在空白会话中使用。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:kaijia323/dsh-ymc-sidebar#2b205c435ed8de13a2cf0b9ad713e1eca99059aeYmc Sidebar 以 dsh-ymc-sidebar 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →DSH Web Client 的 VSCode 风格文件树侧栏。作为 #root 的兄弟节点挂载在 document.body 上，通过 CSS layout push 让 DSH 原生界面让出右侧空间；不占用 DSH 原生 details slot，因此 blank 会话也能打开。特性：
× 关闭node_modules 等大目录靠懒加载 + 虚拟化抗压）插件分两半：
src/index.ts）：注入 fs 与 connection，在 /dsh-ymc-sidebar 注册一个仅 loopback 可访问的 Connection RPC channel，提供 meta / list / read 三个端点。src/client.tsx）：注入 sessions、workspaces、connection，在 document.body 上创建自己的 React root 并挂载右侧栏。右侧栏是 #root 的兄弟节点，不注册任何 DSH slot：
--dsh-ymc-sidebar-width 让 #root 让出宽度，形成“真占位”的 VSCode 式侧栏，而不是 overlay；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 会热替换插件实例。
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，保证本地构建可用。<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
| 配置 | 默认值 | 说明 |
|---|---|---|
maxTextBytes | 2097152 | 单次文本预览上限（UTF-8 字节） |
maxImageBytes | 8388608 | 单张图片预览上限（字节，经 base64 返回） |
maxEntriesPerDirectory | 2000 | 单目录最多返回的条目数；超出时截断并在树上提示 |
maxTreeRows | 100000 | 客户端展开后可扁平化的最大树行数，防止超大目录打爆内存 |
pnpm test
覆盖：
meta / list / read 成功路径、截断、二进制回退、超大文件、非法路径details / shell.overlay、必须通过 #root margin-right 做 layout push、lazy-CJS bundle 可物化dsh-fs 的文本语义。maxImageBytes。#root 作为 DSH 原生根节点和 --dsh-ymc-sidebar-width 做 layout push；升级后若 DSH 调整根节点结构，先检查 #root 的 margin-right 是否仍生效。MIT