npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

dsh-2sidebar

v0.1.4

Published

Split-pane file browser for the DSH right sidebar: directory tree on the left, file content on the right.

Readme

dsh-2sidebar

English | 中文

License: MIT npm DeepSeek Harness 0.2.1-rc.5 GitHub release

给 DeepSeek Harness(DSH)右侧栏用的「目录分栏」插件:目录树和文件内容在同一个页签内左右并排,两栏同时可见,切换文件时目录树原地不动。默认树在左,可一键切到右侧。

DSH 右侧栏里的目录分栏

状态:早期版本(0.1.4)。插件依赖 DSH 的客户端扩展点,这些接口仍在演进;升级 DSH 前请先看兼容性。

为什么做这个

DSH 自带的 Files 页签是把文件作为预览打开在侧栏里,浏览目录和阅读文件共用同一列。本插件把目录树和预览放进同一个页签的两栏:点文件,内容栏切换,目录树完全不动。

| | dsh-2sidebar | 自带 Files 页签 | | ---------------- | --------------------- | -------------------------------- | | 布局 | 目录树与预览并排 | 目录树;文件以预览形式占用同一列 | | 边看目录边读文件 | 两栏始终可见 | 在目录与预览之间切换 | | 文本 / 图片预览 | 内联、分页 | 原生预览,支持全部格式 | | 树的展开状态 | 页签挂载期间保持 | 由侧栏 store 保持 | | 打开方式 | 标题栏按钮 / 引导卡片 | Mod+P |

两者可以同时安装、同时使用。

功能

  • 分栏视图:中间分隔条可拖动(20%–70%),比例与「收起目录」状态保存在当前浏览器的 localStorage(同 origin 的多个窗口共享)。
  • 懒加载目录树:以会话工作区为根,展开时才读取该层;「重新读取」刷新根目录和所有已展开层;空目录与被截断有行内提示(刷新失败时保留上一次的目录内容)。
  • 文本预览:每页 2,000 行,可「加载更多」,到底显示「已到文件末尾」,并显示文件大小。
  • 图片预览:支持 png、jpg、jpeg、gif、webp、bmp、ico、avif 和 svg。
  • 收起目录:折叠成单栏预览,展开后仍保留当前选中的文件。
  • 两个入口:会话标题栏的分栏图标(紧挨原生右侧栏开关)、右侧栏开始页的引导卡片;打开后它就是普通侧栏页签。
  • 跟随主题,界面支持英文与中文。
  • 只读、离线:不发网络请求、没有 Host 业务代码、没有 npm 运行时依赖;渲染使用 DSH shell 基线 primitives(见兼容性)。文件访问全部走宿主的 workspaceFiles 服务,遵守和内建功能相同的上限。

安装

前提

  • 一个由插件管理器管理的 DSH Desktop 配置(在 0.2.1-rc.5 上验证;见兼容性)。
  • 右侧栏和客户端插件管理器(DSH 自带)。

从 npm 安装(推荐)

dsh plugin --profile desktop add dsh-2sidebar

或在 DSH Web 界面里:Plugins → Add plugin → 输入 dsh-2sidebar → Install,然后把 Split files bundle 打开。

desktop 是 DSH Desktop 的默认 profile,如果你的安装用了别的名字请替换。不需要重启:宿主会原地重载 profile(HMR)。如果已经挂载的页签还显示旧组件,按一次 Ctrl+Shift+R。

从 clone 安装(开发)

git clone https://github.com/SyaJask/dsh-2sidebar.git
dsh plugin --profile desktop add "link:C:/src/dsh-2sidebar"

也可以在 GUI 的 Add plugin 对话框里填仓库根目录的绝对路径。

打开

  • 点会话标题栏的分栏图标(原生「打开/收起右侧栏」按钮旁边)。
  • 或在右侧栏开始页选择 Split files 卡片。
  • 它就是一个正常的侧栏页签:停靠、分栏、全屏和其它页签完全一致。

卸载

  • 界面:Plugins → Split files bundle → Remove。
  • 命令行:
dsh plugin --profile desktop remove dsh-2sidebar

使用

  • 点目录展开/收起;展开时会重新读取该层。
  • 点文件在内容栏打开;目录树保持滚动位置与展开状态。
  • 拖动分隔条调整左右比例,松手时保存。
  • 重新读取刷新根目录和所有已展开目录。
  • 收起目录折叠目录栏,内容栏保留当前文件。
  • 切换左右(内容栏标题末尾的分栏图标)把目录树在分栏左侧和右侧之间切换;默认在左,选择会被记住。
  • 文本底部 加载更多 追加下一页(2,000 行),到底显示「已到文件末尾」。
  • PDF / Office / HTML 不会内联渲染,请用 DSH 原生预览页签打开。

兼容性

  • 已验证:DSH Desktop 0.2.1-rc.5,Windows(所用客户端 API 已按 0.2.1-rc.5 核对;0.2.1-rc.3 为上一验证版本)。
  • 预期可用:提供相同客户端服务(slots、sessions、locale、sidebarRightTabs、sidebarRight、remote、remote.workspaceFiles)和 shell 基线客户端 primitives(@deepseek-ai/dsh-client-ui-primitives)的其它 DSH Desktop 版本,以及 macOS/Linux 构建;bundle 本身与平台无关。
  • DSH 处于开发者预览阶段,扩展 API 可能随时变动。升级 DSH 后如果插件不再加载,请带上 DSH 版本和浏览器控制台报错开 issue。

实现要点

这是一个纯客户端 bundle:

  • index.js 是空的 Host 半侧,渲染全部在浏览器里。
  • 客户端注册一个侧栏页签类型(ctx.sidebarRightTabs),通过 sidebar.right.pane.tab 槽位注册正文、sidebar.right.pane.tab.title 槽位注册标题,通过 conversation.session.header.utilities 注册标题栏按钮,并注册自己的中英文词典。
  • 目录列举与文件读取全部走宿主已有的 ctx.remote.workspaceFiles(list / read / readBytes),工作目录通过框架标准的 useSessions prop 读取。插件不新增 Host 路由,也不申请额外权限。
  • cordis.patch.yml 只插入一行 profile 记录;keepMounted: true 让正文在切页签后继续存活,树的展开状态因此得以保留。

常见问题

装完没出现? 确认 DSH 版本在已验证范围内、bundle 已在 Plugins 里启用,并查看 DevTools 控制台里的 [split-files] 信息。bundle 加载失败时 DSH 的其它功能不受影响,只是页签和标题栏按钮不会出现。

提示「这个会话没有工作区目录」? 目录树以会话的工作目录为根;没有工作目录的会话没有可浏览的内容。换一个有工作区的会话即可。

文件提示太大或是二进制? 文本按行分页读取,遵循宿主的 maxBytes(每页 2 MiB)与 maxLines(5,000)上限;图片按完整文件读取,遵循 maxFileBytes(默认 32 MiB)。整页字节超过 2 MiB 与单行超限都会返回 too-large,无法按文本预览。

PDF / Office / HTML 能在右栏打开吗? 不能内联。请用 DSH 原生预览页签;本插件专注于代码、配置和图片。

插件会读取或上传我的文件吗? 只读:它调用宿主的 workspace 文件服务,作用范围和上限与内建界面一致。bundle 不发网络请求,也没有遥测。

分栏比例、树状态和左右方向存在哪? localStorage 的 dsh-2sidebar.ratio、dsh-2sidebar.tree-hidden 和 dsh-2sidebar.tree-side。清除站点数据或这些键即可重置。改名前的 dsh-split-files.* 键在新键缺失时仍会作为兜底读取。

为什么会有两个文件页签? 自带的 Files 页签用于把文件交给原生预览;本插件用于同时看目录和文件。两者不冲突。

路线图

  • 文件搜索/过滤、隐藏 dotfiles 开关。
  • 通过 workspace 文件变更流自动刷新。
  • 「在原生预览中打开」(PDF/Office/HTML)。
  • 键盘导航与可配置快捷键。
  • 更多界面语言。

开发

没有构建步骤:client.js 就是部署用的客户端 bundle,index.js 是空的 Host 半侧。

node --check client.js      # 语法检查
npm test                    # bundle 与 manifest 测试(无依赖)

迭代方式:用从 clone 安装的 link: 方式安装,然后直接改 client.js,宿主会重载 profile;npm 安装的是复制后的包,不会跟随源码修改。

欢迎提 PR 和 issue。涉及 DSH 内部客户端 API 的改动,请注明验证过的 DSH 版本。

仓库结构

| 路径 | 说明 | |---|---| | package.json、index.js、client.js、cordis.patch.yml、locale/、icon.svg | 插件本体,也是 npm 包和安装目标 | | AGENTS.md | 仓库与 agent 协作约定 | | README.md、README.zh.md | 英文/中文用户文档(npm 页面使用 README.md) | | CHANGELOG.md | 按 Keep a Changelog 的版本历史 | | LICENSE | MIT 许可证 | | docs/ | 截图以及逐版本发布说明(docs/release-notes/<version>.md) | | .github/workflows/ | PR 检查(ci.yml)与带 provenance 的 npm 发布(publish.yml) | | .gitignore | 忽略本地编辑器文件与仅本地保留的 .agents/ | | .agents/ | 本地 agent 笔记与 skills,已 gitignore,不随仓库分发 |

License

MIT © 2026 SyaJask