DSH侧边栏插件

DSH-better-sidebar

一个服务化的侧边栏框架，一套开箱即用的完整工作台——DSH 生态最活跃的插件之一。

📖 介绍

DSH-better-sidebar 是一个功能极其强大的 DSH 侧边栏插件，由 omdsh-dev 组织维护。它提供了右侧栏 + 底部面板双工作台，内置文件管理、编辑预览、内嵌浏览器、真实终端、文件变动、后台任务、侧边对话等 8 个 tab 和 6 个文件预览器，并通过 ctx.betterSidebar 服务向所有插件开放扩展点。

GitHub 星标 3.3k，MIT 开源协议，已有 55 位贡献者参与，是 DSH 生态中星标最高、贡献者最多的插件。当前版本 v0.18.0，适配 DSH 0.1.2-rc.1+。

✨ 亮点

1. 双工作台：右侧栏 + 底部面板，拖 Tab 拆分/合并分栏，移动端自动合并全宽抽屉
2. 文件工作台：懒加载目录树 + CodeMirror 编辑器 + 图片/Markdown/PDF 内联预览
3. 真实终端：xterm.js + node-pty 真实 shell，断线重连回放，可选为模型注入 terminal_* 工具
4. 文件变动：Git 视角（真 diff/历史/暂存·提交·还原）+ 本轮文件视角双视角合一
5. 内嵌浏览器：多开网页 tab，沙箱 iframe 安全隔离
6. 侧边对话：Codex 风格侧边线程，继承主会话完整上下文
7. 自由窗口：tab 可拖出为悬浮窗口，随会话持久化
8. 固定终端：跨会话虚拟 Tab，切换会话不消失
9. 插件生态：28+ 生态插件，通过统一 API 注册 tab 和 viewer
10. 按需加载：启动只拉 ~325KB 核心，重依赖用到才按需拉取

🎯 核心功能

📦 安装方式

# 安装到 web profile
dsh plugin --profile web add dsh-better-sidebar@latest

# 首次会因 pnpm 11 拦截 node-pty 构建脚本而失败（依赖已写入）
cd ~/.dsh/profiles/web && pnpm approve-builds --all  # 放行构建脚本

# 重跑安装
dsh plugin --profile web add dsh-better-sidebar@latest

# 硬刷新浏览器（Cmd/Ctrl+Shift+R）

一键脚本：

git clone https://github.com/omdsh-dev/DSH-better-sidebar.git
cd DSH-better-sidebar
bash scripts/install.sh  # macOS / Linux / Windows Git Bash

🌐 插件生态

ctx.betterSidebar 服务向所有插件开放两个扩展点：

• registerTab：注册侧边栏页面
• registerFileViewer：注册文件预览器

GitHub topic dsh-better-sidebar 下已有 28+ 生态插件，包括：

• Tab 插件：数据库、Notion、Figma、YouTube、Music 等 24 个
• 预览插件：Office、Jupyter、SVG 等 3 个
• 增强工具：图标、双语阅读器等 3 个

📊 技术栈

• 语言：TypeScript 93.8% + CSS 4.3% + Shell 1.2%
• 协议：MIT
• 贡献者：55 人
• 发布版本：24 个

📝 总结评价

DSH-better-sidebar 是一个现象级的 DSH 插件，3.3k 星标和 55 位贡献者说明了一切。它不只是一个侧边栏，而是一个完整的工作台框架——文件管理、终端、浏览器、Git、任务管理、侧边对话一应俱全。服务化架构设计很优雅，通过 ctx.betterSidebar API 让 28+ 生态插件与内置功能完全对等。双工作台 + 自由窗口 + 固定终端的组合提供了接近 IDE 的体验。对于重度 DSH 用户来说，这是必装的基础设施级插件。

GitHub： https://github.com/omdsh-dev/DSH-better-sidebar
Stars： 3.3k ⭐