Better Sidebar 智能侧边栏与工作区层级导航器
@omdsh-dev/dsh-better-sidebar · v1.1.0
为复杂项目工作区提供极速目录树检索、多会话分屏管理与符号语义导览的高级侧边栏扩展。支持大仓数十万文件瞬时展开、多标签页状态保持与即时过滤定位。
侧边栏工作区导航虚拟滚动文件树
GitHub Stars
32 K+
+12.4% this month
月度调用量
131 K+
Monthly registry pulls
Reach 影响力
98.3/ 100
Top Tier Ecosystem
运行环境
Cordis v3+
Node 18+ / Bun / Deno
安装与配置
支持 CLI 一键执行、包管理器以及 Cordis 总线编排
bash
manager:
$ pnpm add @omdsh-dev/dsh-better-sidebar架构解析
「Better Sidebar」让开发者在海量工程文件中游刃有余。面对动辄包含数十个微服务包的 Monorepo 大型仓库，传统的文件列表往往加载迟钝、缺乏层级语义，令开发者在多会话之间频繁迷失上下文。
本扩展在前端渲染层深度优化了虚拟滚动（Virtual Scroll）与高效目录树索引算法。支持在微秒级过滤十万量级文件，直观展示代码符号大纲树与依赖引用关系，并允许开发者将多次并行的智能体任务固定为标签页或分屏对比，大幅提升日常研发排查的工作效率。
架构设计原则与约束
01
强类型契约隔离
基于 TypeScript 编译期深度推断，跨插件总线调用享受严格类型校验与零偏差提示。
02
毫秒级热插拔调度
支持微内核动态注册与安全平滑卸载，无需重启主宿主进程即可完成逻辑热替换。
03
确定性有限状态机
内置严谨的多阶段任务生命周期控制，防止复杂长时迭代推理场景中会话状态丢失。
04
零动态构建底层依赖
采用纯原生跨平台运行时环境设计，在 Node.js、Bun 及 Deno 容器中极速冷启动。
核心特性
01
十万级超大单体仓库虚拟滚动：零掉帧顺畅展开巨型工程的所有目录与包结构
02
全时序 Git 变更色彩高亮：一目了然看清智能体当前改动与未追踪的文件列表
03
代码符号级大纲内嵌导览：无需打开大文件即可直接在侧栏查看函数与类层级
04
支持工作区多任务分屏布局：自由拖拽分屏，多智能体协同进度一屏尽览
核心机制
01
工作区虚拟树构建
极速扫描项目目录拓扑，建立基于内存的虚拟滚动文件结构树。
02
Git 变动状态映射
实时比对 Git 工作区状态，在文件树上高亮新增、修改与冲突文件。
03
符号大纲即时解析
展开源文件时就地解析类与函数大纲，支持单文件内部结构速览。
04
分屏多会话持久化
支持双列分屏对比不同智能体的执行进度，状态保存至本地存储。
配置参数参考 (YAML / JSON)
| 参数名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| enableVirtualScroll | boolean | true | 是否开启 DOM 虚拟滚动技术优化大目录性能 |
| showGitStatus | boolean | true | 是否在侧边栏文件节点旁显示 Git 变动颜色标记 |
| defaultWidthPx | number | 280 | 侧边栏初始默认显示宽度（像素） |
应用场景
企业级生产智能体运行时
依托微内核生命周期与容错状态机，保障企业复杂 Agent 全天候稳定执行不崩溃。
基准测试标准化评测运行
深度原生集成 SWE-bench 标准流程，自动化抓取代码变更并产出规范复现指标。
全自主代码工程重构演进
精准拆解模型思考流与具体操作，跨多文件自主排查并高质量完成大型模块重构。
跨系统多工具流协同自动化
在多进程沙箱间安全并发调度事件，打通研发上下游系统实现端到端自动化流转。
最佳实践
01
权限沙箱隔离机制
严格限定子进程系统调用与外部网络范围，在生产环境中建议结合 Docker 独立容器执行。
02
配置指数退避重试
针对上游模型接口限流与偶发网络抖动，建议开启自适应退避重试并设定最大执行上限。
03
长时任务状态快照
利用内核事件总线快照功能实时固化会话节点，发生不可抗意外时支持秒级断点恢复。
04
全量结构化链路追踪
开启全量 Trace 日志输出，将大模型思考过程与具体工具入参返回值集中汇聚至监控。
常见问题
Q1:长时间执行任务超时如何正确配置？
可在配置文件中调大 timeout 阈值，并通过生命周期钩子定期向总线派发心跳信号。针对长耗时推理与工具调用，建议配合持久化会话快照机制，在任务暂停或重启后无缝恢复执行上下文，避免会话被内核提前回收。
Q2:如何捕获并流式解析模型思考过程？
框架原生提供流式回调机制，会话状态机自动拦截并剥离大模型的 <think> 思考标签。开发者只需监听 onThink 事件即可实时获取推理增量，结合前端流式渲染呈现动效，并支持将完整推导链沉淀至审计日志。
Q3:多个插件依赖冲突时如何按需加载？
Cordis 微内核基于有向无环图进行拓扑排序并解析依赖树。当插件间存在同名服务或版本冲突时，可通过命名空间隔离机制按需挂载；结合上下文注入与惰性初始化技术，仅在工具唤起时动态加载资源，保障系统稳定。
Q4:生产环境中如何实施权限与沙箱隔离？
推荐结合容器沙箱与细粒度权限管控，严密禁止插件越权访问敏感文件与未授权外部网络。可通过微内核提供的权限白名单机制严格限制系统调用，并将工具执行环境置于隔离容器内，彻底阻断潜在的代码注入与提权安全风险。
相关生态插件推荐
为你推荐同分类及高度协同的 Cordis 扩展
protocols46 K+
DSH Web Workshop 可视化调试画板与工作台
为开发者提供直观监控与交互调试环境的轻量级 Web 工作台。提供可视化会话时间轴、实时工具调用跟踪、状态机图谱呈现与即时变量注入修改功能。
View details
protocols34 K+
iPolloWork 人机协同研发工作台与断点治理器
专为企业级全自主编程智能体设计的人机交互治理工作台。提供生产代码合并审查、关键环境变更一键确认、沙箱交互式 Web 终端与多分支执行断点恢复能力。
View details
protocols23 K+
PetDex 桌面伙伴多模态状态机与伴侣系统
为桌面智能体与陪伴型机器人注入生动个性的多模态状态机。提供细腻的情绪能量数值演进、交互触发式动画状态流转、个性化语音音色包挂载与桌面悬浮微应用。
View details