omdsh-dev/DSH-better-sidebar

开放的侧边栏底座，支持三方拓展注册新侧边栏页面。内置文件渲染编辑/终端/Git/子代理页面 ｜ Open sidebar foundation, supports third-party extensions to register new sidebar pages. Built-in file rendering/editing, terminal, Git, and sub-agent pages.

Bundle verified MIT TypeScript v0.13.0
Bundle verified

Listed

2046

Ui

Bundle verified

★ 2,046 View on GitHub
Versionv0.13.0
LanguageTypeScript
LicenseMIT
View on GitHub

Preview

Preview 1 of 2: omdsh-dev/DSH-better-sidebar
Preview 2 of 2: omdsh-dev/DSH-better-sidebar

What it does

Full sidebar workbench with file rendering and editing, terminal, Git, and subagents; third-party plugins can register new tabs.

Best for

  • DSH Web users who want files, editing, previews, terminal, Git, and subagent activity in one integrated workbench.
  • Plugin developers who need a shared sidebar API for registering custom tabs or file viewers.
  • Multi-session workflows that benefit from session-specific persisted layouts, tabs, and panels across desktop and mobile.

Not ideal for

  • Git workflows requiring push, pull, or fetch, since the built-in Git panel does not provide those operations.
  • Users expecting built-in DOCX, XLSX, or PPTX preview; those viewers have moved to a separate recommended plugin.
  • Mobile workflows that require a distinct bottom panel, because viewports below 768 px merge its tabs into the right sidebar.
  • Sites requiring shared login state or permitting no iframe embedding, because the sandbox restricts cookies and some sites reject embedding.

README

dsh-better-sidebar



License: MIT dshfind

文件管理 编辑预览 内嵌浏览器 真实终端 Git 面板 后台任务 插件接入

，并把 ctx.betterSidebar 服务开放给所有插件——
通过 registerTab / registerFileViewer 注册新的侧边栏页面与文件预览器。

🌏 · English

dsh-better-sidebar 工作台截图

✨ 功能一览

  • 🗂️ 文件工作台：资源管理器（懒加载目录树；软链接按目标类型展示——目录软链接可展开、失效链接标红）+ CodeMirror 编辑器；图片 / Markdown（含 Mermaid 图表，strict 安全渲染 + 点击放大）/ HTML / PDF / Office 内联预览
  • 🌐 内嵌浏览器：多开网页 tab，后退 / 前进 / 刷新；内容运行在沙箱 iframe；外链默认按协议分流——HTTP 在侧边栏打开、HTTPS 走系统浏览器（设置页可分别调整）
  • 💻 真实终端：xterm.js + node-pty 真实 shell，断线重连回放；可选为模型注入 terminal_* 工具
  • 🌿 Git 面板：真 diff + VSCode 式 diff tab、历史、右键暂存 / 提交 / 还原
  • 🧩 后台任务页：subagent 拓扑 + 后台任务（退出码 / 实时输出 / 强制终止）
  • 🪟 双工作台：右侧栏 + 底部面板；拖 Tab 拆分 / 合并分栏（可跨面板），移动端自动合并全宽抽屉
  • 🔁 会话隔离：布局 / Tab / 面板按会话持久化，陈旧状态自动净化
  • ⚙️ 声明式设置：设置页「侧边卡片」逐项独立开关，二级设置经齿轮弹窗
  • ⚡ 按需加载：启动只拉 ~325KB 核心，终端 / 编辑器 / Mermaid 图表等重依赖用到才按需拉取（设计文档）
  • 🌏 多语言：界面文案跟随 DSH 语言（zh / en）实时切换

🔌 核心理念：服务优先——内置的 7 tab + 6 viewer 与第三方插件通过同一套 ctx.betterSidebar API 注册，能力完全对等；官方不再内置、可由生态提供的功能，交由生态插件实现。接入文档见下方「🔌 服务化」与 外部插件接入指南。

🆕 最近更新

侧边栏 服务化基座截图 添加插件截图

v0.14.0

⚠️ 本版适配 DSH 0.1.0-rc.8：全部 @deepseek-ai/* peer / devDependencies 升至 ^0.1.0-rc.8（含传递依赖，lockfile 零 rc.7 残留），cordis 同步 ^4.0.0-rc.8，CI 挂载冒烟钉版 @deepseek-ai/dsh@0.1.0-rc.8。rc.7 及更早的 DSH 环境将无法解析本版依赖，请先升级 DSH。自 v0.13.1 以来的全部更改：

✨ 新功能

  • 🖼️ 统一面板宿主注入重构（#232）：面板/开关簇迁入 [data-dsh-panel-host] 固定含块层（fixed inset-0 z-40），免疫桌面套壳中间层 transform 对 fixed 含块的劫持；挂载自检（页面级 transform → data-dsh-panel-host-degraded 降级同步，按未修正几何判定、祖先变换消失才退出）；推挤锚点改 #root [data-dsh-frame] > [data-pane="conversation"] + #root calc 宽度防桌面壳加性溢出；chunk 激活重验证（HEAD+ETag 保留未变 chunk，5s 超时兜底 fail-open）；桌面信号自动探测（win32 advanced 标题栏兼容 32px 避让，手动 pref 可覆盖）；visualViewport 键盘 inset + env(safe-area-inset-*) 移动端适配
  • 📂 文件打开方式默认独立（#232）：editorExplorer 默认从「合并」改为「独立」——新会话树点击 / 打开文件按路径新开文件 tab，无路径窗口即纯资源管理器；合并模式保留为可选手动开启
  • 🖥️ 终端 shell / shellArgs 设置页可配（#232）：终端卡齿轮二级页面新增「Shell 路径」「Shell 参数」两行配置（此前只能通过 cordis.patch.yml 配置）——设置页写入后对之后打开的 UI 终端与模型终端（terminal_create）即时生效；留空保持 yaml → $SHELL / 登录 shell / powershell.exe 的既有解析顺序
  • 🏷️ 设置页版本徽标（#232）：侧边卡片设置页顶部新增 DSH-better-sidebar v0.14.0 身份徽标（版本与服务实例同步，由测试守护）
  • 🔍 添加插件目录搜索 / 分组 / 独立滚动（#232）：为插件生态增长做准备——目录列表顶部加实时搜索（按名称 / id / 描述过滤），条目支持可选 category 分组渲染，列表独立滚动（弹窗不再随条目数无限增长）

🐛 修复

  • 🔧 适配 DSH 0.1.0-rc.8（#232）：13 个 @deepseek-ai/* peer / devDependencies 升至 ^0.1.0-rc.8（含传递链，lockfile 零 rc.7 残留），cordis 同步 ^4.0.0-rc.8；移除随 rc.8 消失的 dsh-client-web-react / dsh-client-schema-form（壳模块表不再提供、插件零引用）；CI 挂载冒烟钉版 @deepseek-ai/dsh@0.1.0-rc.8；pnpm 11.8 supply-chain 校验适配
  • 🧩 rc.8 模块系统迁移（#232）：rc.8 不再暴露 window.__DSH_MODULES__ 页面全局（改由 ctx.modules 服务提供），懒加载 chunk 的外部依赖解析全面失效——client 注入 modules 服务 + 插件自有全局共享给 chunk 副本（终端 / 编辑器 / Mermaid 恢复正常按需加载）
  • 🧩 chunk 重验证屏障健壮性（#232）：HEAD 重验证加 5s 超时兜底（路由挂起时 fail-open 重取，屏障不再可能无限期阻塞懒加载）；resetChunks 清挂起的重验证屏障
  • 🖱️ 拖拽健壮性（#232）：快速释放（浏览器合并 / 丢失 pointermove 突发）时提交最后已知拖动位置而非回退；pointercancel / 捕获丢失中断同样保留拖动结果；提交后立即重测中心列（消除底栏宽度中间帧抖动）；HMR 重激活后中心列重定位兜底（<html> 样式观察 + 底栏打开重测），修复热更新后底栏空白 / 输入框位移
v0.13.1

✨ 新功能

  • 📊 Markdown 预览安全渲染 Mermaid 图表（#164）：预览的 md 含 mermaid fence 时按需下发 client-mermaid.js chunk（~7MB，无 mermaid 文件零加载）；纵深防御渲染——securityLevel: 'strict' + htmlLabels: false（节点文字走真实 SVG <text>）+ SVG 注入前二次清洗（删 foreignObject/script/外来 HTML 元素、剥 @*/on*/href 属性）；点击图表在弹窗中放大（滚轮以鼠标为中心缩放、拖拽平移、工具栏与快捷键），深浅色跟随重渲、解析失败回退原码
  • 🖥️ 终端 shell 与 shellArgs 可配置（#125）：cordis.patch.yml 的 better-sidebar.config 可指定 shell / shellArgs（shellArgs 非空时完全替换默认参数；未配置维持自动解析 $SHELL / 登录 shell / powershell.exe 原行为），UI 终端与 agent 终端（terminal_create）同时生效；终端 tab 标题改用 shell 名（bash / zsh / powershell），内部标识改 UUID，同 shell 可开多个终端

🐛 修复

  • 🔗 聚合双挂载自动退让（#200）：聚合包（如 dsh-web-ui-all）以独立条目 id 挂载同包时，cordis.patch.yml 的守卫表达式自动禁用自身 better-sidebar 行，不再重复注册 /sidebar/api 导致 duplicate prefix route 整个插件树启动失败（dsh web 崩溃）；独立安装行为不变
  • 🔧 peer 依赖对齐 DSH 0.1.0-rc.7（#207，修复 #206）：全部 @deepseek-ai/* peer / devDependencies 从 ^0.1.0-rc.6 升至 ^0.1.0-rc.7，CI 挂载冒烟同步钉版——消除主框架升至 rc.7 后 rc.6 / rc.7 混用依赖树导致的 agent-presets: refusing to compose an unscoped context（选模型 / 发消息报错）
v0.13.0

✨ 新功能

  • 📁 文件窗口与资源管理器二合一（#151）：新 editorExplorer 设置（编辑器卡齿轮）——文件 tab 增加路径输入框头部 + 可开关的右侧停靠文件树（每 tab 记忆展开/宽度，左缘拖拽调宽 160~480px，全局文件名搜索走 host fs.search 路由，预算封顶并跳过 .git / 符号链接目录）；独立模式（默认）树点击 / 输入框 Enter 按路径新开文件 tab，合并模式原地切换当前 tab；新会话默认 seed 空文件窗口（Files）替代 explorer tab，无路径窗口在独立模式为纯资源管理器、合并模式为带 chrome 的空文件窗口；树右键提供「在新 Tab 中打开」「在侧边打开」（split）
  • 🎛️ 声明式设置 select 行（#151）：设置项新增 type: 'select'（options 支持 value/title/desc/icon，multi 多选存数组）；带图标的选项渲染大图标选项卡、收起态同样显示图标；editorExplorer 改为图标化下拉（合并 / 独立）；能力清单新增 settingSelect
  • 🔀 与 dsh-web-ui 家族右侧面板互斥（#181）：读取 aionui-panel 设置命名空间的提供方选择——当选择「使用 aionui-panel」时，整个 better-sidebar（右侧栏 / 底部面板 / 浮动入口 / 各类接管）不再挂载；选择 DSH-better-sidebar（或未安装 aionui）时正常。设置页保存后实时生效（settings-document 推送），无需刷新
v0.12.3

✨ 新功能

  • 🎨 皮肤兼容（令牌驱动）：全面消费 DSH 设计令牌，与 dsh-web-ui 皮肤中心 10 款皮肤兼容，换肤自动跟随；终端/编辑器表面在透明/半透明玻璃值下回退不透明底色，文字不叠在皮肤背景上（#110，修复 #106 #105 #90 #60，附带 #52 #57 #92）
  • 🗂️ 统一路径处理：UNC 路径 / 软链接分类（目录软链接可展开、失效链接标红）、HTML 路由平台守卫（#134，#65 #67 #43 #79 #115）
  • 🖥️ 终端 shell 可配置：设置项自定义 shell，Windows 自动探测 pwsh（#95）
  • 📝 编辑器新增语言：C# / Kotlin / Swift 语法高亮（#120）
  • 🧭 设置页导航图标：设置页导航图标与布局优化（#114）
  • ➕ 推荐插件目录新增：dsh-git-remotes——Git 远程 Tab（分支/上游/ahead-behind、fetch 可 prune、ff-only pull、确认后才 push，不替换内置暂存/提交）（#91）；dsh-video-preview——视频内联预览（.mp4/.webm/.mov/.mkv/.avi 等，自带 /video 宿主路由支持 HTTP Range 206 拖进度条，不受 20MB mediaLimit 限制）（#126）

🐛 修复

  • 🔧 xterm 依赖迁移：弃用的 xterm 迁移至 @xterm/xterm（Closes #122，#128）
  • 📝 Markdown 编辑器：选区转对话弹窗恢复可用（#24）
  • 🐛 node-pty 加载失败不再拖垮 server（#140）：宿主半改为懒加载 node-pty，缺失时插件照常挂载，终端以修复提示横幅（可复制命令 + 重试按钮）呈现，agent 终端工具自动跳过
  • 🧪 测试工程：单元测试拆分（#141）+ smoke 偶发失败修复

🚀 安装

前置：已装好 DSH（dsh web 能正常运行），Node.js ≥ 20、pnpm ≥ 10。

dsh plugin --profile web add dsh-better-sidebar@latest

装完硬刷新浏览器（Cmd/Ctrl+Shift+R）即可看到侧边栏（DSH 对 client 改动热加载，无需重启；仅 host 半更新时需要重启）。

Frequently Asked QuestionsFAQ

Use the verified command dsh plugin --profile default add github:omdsh-dev/DSH-better-sidebar in a DSH-enabled shell. The command resolves the public package metadata and keeps the plugin attached to the catalog identity shown on this page.

zhu1090093659/dsh-web-ui#packages/dsh-web-ui-all★ 4,306

Plugin and skin collection for the DSH Web UI: task board, Git graph, right-side panel, remote mobile UI, pet, live token stats, and a skin center.

Apache-2.0
ccch1mneyyy/dsh-TUI★ 1,892

Claude Code-style full-screen terminal UI: pixel-whale header, live status line, and streaming thought expansion.

MIT
omdsh-dev/dsh-at-file★ 354

Codex-style `@file` mentions: search workspace files in the composer and attach their contents to prompts.

MIT
huiliyi37/dsh-tianshu-tui★ 211

A terminal UI (TUI) for DeepSeek Harness.

Apache-2.0