AgentMatter
EN/中文
提交项目GitHub
DSH 插件 · 社区项目

DSH-better-sidebar

为 DeepSeek Harness Web 增加文件编辑预览、真实终端、Git 变动和侧边对话，支持右侧栏、底部面板、浮动窗口，以及第三方页面和预览器扩展。

3.4k StarsMITTypeScript26 天前更新
安装与使用 GitHub
01

项目介绍

DSH-better-sidebar 把查看文件、编辑代码、运行命令和检查改动放在 DSH 主会话旁边。它既有现成的工作台，也向其他插件提供 registerTab 和 registerFileViewer 接口。右侧栏、底部面板及浮动窗口可以按任务调整，布局随会话保存。需要注意它包含真实 shell 和文件写入功能，并不是只改变外观的皮肤。

DSH-better-sidebar 工作台展示文件树、README 预览、底部终端和浮动窗口
作者 README 的工作台截图，包含生态扩展演示；不表示图中所有面板都由核心插件内置。查看仓库原图
02

核心功能

01

文件编辑与预览

懒加载文件树配合 CodeMirror 编辑器；支持图片、Markdown、Mermaid、HTML 和 PDF，Office 三件套需另装生态预览插件。

02

真实终端与 Git

xterm.js 和 node-pty 提供真实 shell；Git 视图显示差异、历史、暂存、提交和还原，但不内置 push/pull/fetch。

03

多面板和侧边对话

标签页可拆分、跨面板移动或浮动；beta 侧边对话继承主会话上下文后独立运行，并可保存为新会话。

04

开放扩展接口

第三方插件通过 ctx.betterSidebar 注册页面和文件预览器，内置功能也走同一套服务。

03

安装与使用

先匹配 DSH 与插件版本，再安装到 web profile。若 pnpm 拦截 node-pty 构建，审核并批准相关构建脚本后重跑；完成后硬刷新浏览器。

AI AGENT INSTALL

让 AI Agent 帮你安装

把这段话发送给 Codex、Claude Code 或其他可以操作本地环境的 AI Agent。

请安装 DSH-better-sidebar，项目 https://github.com/omdsh-dev/DSH-better-sidebar 。先阅读 README、package.json 和 LICENSE，检查 DSH、Node.js、pnpm 版本。0.18.0 要求 DSH 0.1.2-rc.1+；若是 README 列出的旧宿主，先说明固定 0.17.1 或升级宿主的取舍，不擅自升级 DSH。在兼容宿主执行 `dsh plugin --profile web add dsh-better-sidebar@latest`。若 node-pty 构建被拦截，列出待批准脚本；README 的 `pnpm approve-builds --all` 会放行全部待批准构建，必须先取得确认。完成后硬刷新浏览器，验证文件树、README 预览和空白终端。涉及凭据、额外权限、覆盖文件、删除旧挂载或 Git 写操作时先询问。不要自动关闭网页沙箱或开启模型终端工具。报告改动和实际验证结果。
01开始前准备
  • DSH Web 可正常运行；安装 0.18.0 时需 DSH 0.1.2-rc.1+
  • Node.js ≥20、pnpm ≥10，同时满足宿主本身更高的版本要求
  • 终端需要 node-pty；缺少预编译时可能需系统编译工具链
02复制安装命令或配置
dsh plugin --profile web add dsh-better-sidebar@latest
03按步骤完成安装
  1. 1
    匹配版本和 profile

    确认 `dsh web` 正常运行，Node.js ≥20、pnpm ≥10。当前 latest 为 0.18.0，适用于 DSH 0.1.2-rc.1+；旧版宿主先决定固定 0.17.1 还是升级。

  2. 2
    安装匹配的插件包

    兼容新宿主执行 `dsh plugin --profile web add dsh-better-sidebar@latest`。不要把这条 latest 命令直接套到 README 标出的旧宿主。

  3. 3
    审核被拦截的构建

    若 pnpm 11 提示 node-pty 构建被阻止，先审查待批准依赖。确认后，在默认 Web profile 中采用 README 命令： ```sh cd ~/.dsh/profiles/web && pnpm approve-builds --all dsh plugin --profile web add dsh-better-sidebar@latest ``` 路径为类 Unix shell 写法；Windows 原生环境可用仓库的 install.ps1，不能将 && 路径命令无差别复制到所有 shell。

  4. 4
    刷新并检查工作台

    按 Cmd/Ctrl+Shift+R 硬刷新，选择会话后打开文件树与 README 预览，再开一个空终端。宿主更新或终端依赖修复后重启 DSH；验证阶段不提交、还原或执行项目脚本。

如何确认安装成功

打开已有会话，确认侧栏能够显示文件树并预览一个非敏感 README。再新建终端确认 shell 能启动，不执行修改命令。若只更新客户端，硬刷新即可；宿主部分变化或 node-pty 修复后重启 DSH 再验证。

使用前注意
  • 旧宿主 0.1.0-rc.8 至 0.1.1-rc.2 使用 dsh-better-sidebar@0.17.1；0.1.2-alpha.x 需先升级或使用 README 指定的 alpha 通道。
  • README 的 `pnpm approve-builds --all` 会批准全部待处理构建；先审核范围，不要盲目复制。
  • 不要同时通过 registry 和普通安装通道重复挂载同一个侧栏。
  • HTML 预览显示已保存内容；Office 预览不属于当前内置功能。
04

使用场景

SCENARIO 01

边对话边检查代码改动

在主会话旁查看文件、diff 和终端输出，缩短修改与审查之间的切换。

SCENARIO 02

扩展专用工作面板

将项目专属页面或预览器注册进已有工作台，而不用另造一套侧栏布局。

05

使用评价

依据 README、包文件、许可证和近期提交判断，它适合把 DSH 当作日常开发入口的人，价值在于文件、命令与对话的并排呈现，以及可扩展的页面服务。代价是安装和权限不再像纯界面插件那么简单：要匹配 DSH 基线，处理 node-pty，谨慎对待真实 shell 和沙箱关闭选项。本站未执行插件安装或终端实测。

值得一试的地方

  • 编辑、预览、终端和差异检查在同一工作台
  • 第三方页面与内置页面使用同一扩展服务

使用前要知道

  • 0.18.0 与旧 DSH 宿主不兼容，安装前必须匹配版本
  • node-pty 构建脚本被拦截或预编译不可用时，终端需额外修复
  • 内置 Git 无 push/pull/fetch；Office 预览需独立插件
  • 窄屏无独立底部面板；部分网页不允许 iframe 嵌入
06

README

DSH-better-sidebar

Overview

为 DeepSeek Harness Web 增加文件编辑预览、真实终端、Git 变动和侧边对话，支持右侧栏、底部面板、浮动窗口，以及第三方页面和预览器扩展。 为 DeepSeek Harness Web 增加文件编辑预览、真实终端、Git 变动和侧边对话，支持右侧栏、底部面板、浮动窗口，以及第三方页面和预览器扩展。

Getting started

  • 先匹配 DSH 与插件版本，再安装到 web profile。若 pnpm 拦截 node-pty 构建，审核并批准相关构建脚本后重跑；完成后硬刷新浏览器。
  • 当前工作台覆盖文件、终端、Git 变动、后台任务和侧边对话，并支持第三方标签页与预览器。
  • 0.18.0 将基线改为 DSH 0.1.2-rc.1+，旧宿主需要固定旧插件版本或先升级宿主。
  • 打开已有会话，确认侧栏能够显示文件树并预览一个非敏感 README。再新建终端确认 shell 能启动，不执行修改命令。若只更新客户端，硬刷新即可；宿主部分变化或 node-pty 修复后重启 DSH 再验证。

Configuration

dsh plugin --profile web add dsh-better-sidebar@latest
在 GitHub 阅读完整 README →