Basic Right Sidebar（DSH 基础右侧边栏）

English · 简体中文

面向 DeepSeek Harness 的右侧边栏基础插件：功能区/会话管理双栏导航与面板切换、会话顶栏工作区/会话面包屑、会话概览与日志下载、原生轨迹视图，以及可配置的顶栏整理——纯 UI 增强，不引入新能力，不改任何系统源码。

支持 Windows · macOS · Linux（DSH Web GUI）——纯 JavaScript，无原生依赖。

dsh plugin --profile web add basrs-sidebar

快速上手 · 为什么做这个插件 · 主要功能 · 截图 · 安装 · 配置 · 与官方项目的关系 · 二次开发 · 社区交流 · 许可证

---

为什么做这个插件

Basic Right Sidebar 旨在仅对 DSH 做 UI 增强：不引入任何新能力，而是把 DSH 的原生能力搬进右侧边栏展示；定位为所有功能增强右侧边栏的基础插件。

DSH 原生左侧边栏功能完备，但一旦收起——或者你更习惯右侧工作流——会话、工作区与面板切换就需要额外的点击才能触达。Basic Right Sidebar 把这些原生操作带到屏幕右缘。

两个面包屑

对照原生 UI 与其它右侧边栏实现，本插件制作了两个面包屑：

• 会话顶栏 · 工作区/会话面包屑 —— 原生左侧边栏收起时，仍可方便地切换会话与工作空间。
• 侧栏顶栏 · 功能区/概览面包屑 —— 在侧栏头部直接切换右侧边栏的多种界面。

导航结构

一级分类，各自拥有二级界面：

一级分类	二级界面
会话管理	概览
功能区	概览 · 轨迹

主要功能

两级导航 —— 功能区 / 会话管理菜单切换面板（概览 · 轨迹 / 概览）。所有界面在侧栏头部一键可达。

工作区/会话面包屑 —— 直接在会话顶栏切换工作区与会话，无需展开左侧边栏。

会话概览 —— 会话信息、日志统计（时间跨度 / 事件计数 / 大小）与一键日志下载（zip）。

原生轨迹视图 —— 与 DSH 原生轨迹界面完全一致，无需改动任何系统源码。

侧栏控制 —— 顶栏展开/收起与全屏；启动后默认展开（手动收起永远不会被打断）。

可配置顶栏整理 —— 逐项隐藏顶栏重复元素：会话日志 · 会话模式 · 子代理 · 后台任务 · 对话/轨迹 Tab 栏。

内置基础库 —— 图标库（原生优先）与可复用组件库随插件自带：扩展侧栏只需要写组件，不需要对抗 DOM。

截图

会话界面右侧边栏 UI 展示：

功能区/概览（非全屏）

功能区/轨迹（非全屏）

会话管理/概览（非全屏）

功能区/轨迹（全屏）

右侧边栏收起

插件配置 UI

安装

basrs-sidebar 是一个组合包（bundle）——以 npm 包形式分发的配置层（见官方插件文档）。用 dsh plugin 命令安装进 profile：它会自动链接包并追加到 dsh.profile.bundles：

# 从 npm 注册表
dsh plugin --profile web add basrs-sidebar

# 或本地目录 / 打包好的 tarball
dsh plugin --profile web add ./basrs-sidebar
dsh plugin --profile web add ./basrs-sidebar-1.0.0.tgz

# 或直接从 git（纯 JS 包无需构建步骤，无需构建授权）
dsh plugin --profile web add github:xinspark/DSH-Basic-Right-Sidebar#<sha>

然后启动 Web UI：dsh web（或 dsh --profile web）。首次 add 会自动用 @deepseek-ai/dsh-base 初始化 profile。

卸载：dsh plugin --profile web remove basrs-sidebar（同时移除依赖与组合层）。

插件的 bundle 补丁（cordis.patch.yml）会自动注册 host 与 client 两半。客户端按请求加载：客户端改动刷新页面即可，host 改动需要重启。

配置

打开 设置 → 插件 → Basic Right Sidebar：

选项	说明
默认展开右侧边栏	启动后自动展开侧栏；手动收起不会被重新打断。
隐藏会话顶栏重复部分	总开关；开启后可按下方列表逐项勾选隐藏：会话日志 · 会话模式 · 子代理 · 后台任务 · 对话/轨迹 Tab 栏。
启用会话顶栏工作区/会话面包屑	在会话顶栏左侧显示面包屑；关闭后恢复原生顶栏。

设置持久化到 $DSH_HOME/plugins/basrs-sidebar/settings.json。插件自带持久化端点（/bsrs-settings）：DSH 官方设置线只暴露白名单内的命名空间，第三方命名空间无法使用。

与官方项目的关系

Basic Right Sidebar 是构建在官方 deepseek-ai/deepseek-harness 之上的社区插件，并非 DeepSeek 官方产品。

它展示的一切都是 DSH 自己的数据与界面，只是重新组织：

• 侧栏渲染进官方 details 插槽；面包屑与开关注册进 conversation.session.header.actions / conversation.session.header.utilities；配置卡片注册进 settings.plugin.item。
• 轨迹视图是 DSH 官方轨迹组件，内嵌并懒加载——逐像素一致，零系统源码改动。
• 图标库原生图标优先，侧栏与官方 UI 放在一起毫无违和感。

如果你更习惯命令行，或想参与核心功能开发，请优先使用官方仓库。

二次开发

• index.js —— host 半：会话日志统计、任务快照、设置持久化（GET/POST /bsrs-settings）。
• lib/client.js —— 浏览器半（UMD，注册进 DSH clientModules）。结构自上而下：
  1. 内嵌的 DSH 官方轨迹视图（懒加载，一般不用碰）。
  2. 图标库（createIconLibrary）—— 原生图标优先；新增图标按库头部规则注册。
  3. 组件库（createComponentLibrary）—— SectionCard、下拉菜单、Tag、StateDot、TodoList/TodoGlyph/ProgressGlyph、任务状态归一化、时间格式化、共享样式。
  4. apply(ctx) —— 注册插槽：details（侧栏）、conversation.session.header.actions（面包屑）、conversation.session.header.utilities（侧栏开关）、settings.plugin.item（配置卡片）；内置 zh/en 双语字典，跟随 DSH 语言切换。

扩展速查：

• 新增面板 —— 在 apply 的 panels 列表加一项，并写对应渲染组件。
• 新增文案 —— 在 BSR_ZH / BSR_EN 字典加 key。
• 新增图标 —— 在图标库注册（原生优先，无原生对应时用自定义）。

社区交流

• GitHub Issues —— 提交 Bug、功能请求与问题咨询。
• GitHub Discussions —— 讨论侧栏扩展思路与使用心得。
• 主题 dsh-plugin —— 本插件所属的社区插件主题。

友情链接

我们觉得有用的 DeepSeek Harness 生态项目与资源：

项目	简介	链接
DeepSeek Harness	官方项目：Everything is a Plugin。	GitHub
dsh-TUI	DSH 全屏交互式终端界面。	GitHub
Awesome DSH Plugin	DSH 社区插件精选列表。	GitHub
dsh-market	收录 1500+ DSH 插件的市场。	GitHub
DSH-Plugins-Marketplace	基于 dsh-plugin 主题的 GUI 内插件市场。	GitHub

想让你的项目也出现在这里？欢迎提 PR 或在 Discussions 里告诉我们。

许可证

MIT —— 完全开源免费。

Basic Right Sidebar 是 DeepSeek Harness 的社区插件，并非 DeepSeek 官方产品。如果有人向你以任何形式出售此插件，请拒绝交易。