如何快速上手DSH-better-sidebar5分钟安装三大常见坑pnpm构建拦截/双挂载/node-pty完整教程【免费下载链接】DSH-better-sidebar开放的侧边栏底座支持三方拓展注册新侧边栏页面。内置文件渲染编辑/终端/侧边对话/Git/子代理页面 Open sidebar foundation, supports third-party extensions to register new sidebar pages. Built-in file rendering/editing, terminal, side chat, Git, and sub-agent pages.项目地址: https://gitcode.com/gh_mirrors/ds/DSH-better-sidebarDSH-better-sidebar是面向 DSHDeepSeek Harness网页端的开放侧边栏底座它在浏览器里提供一套 VSCode 风格的右侧侧边栏工作台内置文件渲染编辑、真实终端、侧边对话、Git、子代理等页面并支持三方拓展注册新的侧边栏页面。本篇 DSH 侧边栏插件安装教程带你在约 5 分钟内完成安装并逐一拆掉新手最常踩的 3 个坑pnpm 构建脚本拦截、双挂载、node-pty 加载失败。 DSH-better-sidebar 是什么侧边栏工作台功能一览装上之后DSH 的网页界面会多出一整套「侧边栏工作台」️ 文件工作台懒加载目录树 CodeMirror 编辑器图片 / Markdown含 Mermaid 图表/ HTML / PDF 均可内联预览 真实终端xterm.js node-pty 驱动的真是 shell不是模拟器断线重连还能回放 文件变动Git 视角暂存 / 提交 / 还原、历史与 diff多仓库可选 侧边对话beta每个对话一个独立 Tab继承主会话上下文独立运行 子代理 / 后台任务页子代理拓扑与后台任务实时输出 可扩展底座把ctx.betterSidebar服务开放给所有插件通过registerTab/registerFileViewer注册新页面与文件预览器生态插件已有 28右侧栏与 DSH 原生右侧栏集成底部为可拆分、可拖拽的工作台布局按会话持久化。插件接入细节见 docs/external-plugin-guide.md。⚡ DSH 侧边栏插件 5 分钟安装先核对 3 个前置条件依赖要求验证方式DSH0.1.5-rc.1dsh web能正常运行Node.js≥ 20node -vpnpm≥ 10pnpm -v⚠️ DSH 版本还比较旧对照安装0.1.5-alpha.2 用户装dsh-better-sidebar0.19.0-alpha.10.1.2-rc.1 稳定线用dsh-better-sidebar0.18.xDSH ≤ 0.1.1-rc.2 用dsh-better-sidebar0.17.1。第 1 步执行安装命令dsh plugin --profile web add dsh-better-sidebarlatest 首次执行可能会「失败」——这是 pnpm 11 拦截了 node-pty 构建脚本导致的依赖其实已经写入别慌照做第 2 步即可原因见下方坑 1。第 2 步放行构建脚本cd ~/.dsh/profiles/web pnpm approve-builds --all这条命令放行 node-pty 等原生构建脚本并自动重跑安装。第 3 步重跑安装并硬刷新浏览器dsh plugin --profile web add dsh-better-sidebarlatest这次会成功。装完硬刷新浏览器Cmd/Ctrl Shift R即可在右侧看到侧边栏——DSH 对 client 改动是热加载无需重启仅 host 半更新时才需要重启。备选一键脚本安装克隆仓库后运行官方脚本自动完成 add → 放行构建脚本 → 重跑安装git clone https://gitcode.com/gh_mirrors/ds/DSH-better-sidebar cd DSH-better-sidebar bash scripts/install.shmacOS / Linux / Windows Git Bashscripts/install.shWindows 原生 PowerShellscripts/install.ps1终端提示「node-pty 加载失败」时bash scripts/install.sh --repair一键修复依赖️ 常见坑 1pnpm 11 拦截 node-pty 构建脚本怎么放行现象执行dsh plugin add安装失败日志出现Ignored build scripts或提示 node-pty 构建脚本被跳过。原因pnpm 11 默认拦截依赖的构建脚本strict-dep-builds而 node-pty 这类原生模块必须跑构建脚本才能完成编译链接。解决在 DSH 的 profile 目录执行一条命令放行再重跑安装cd ~/.dsh/profiles/web pnpm approve-builds --all dsh plugin --profile web add dsh-better-sidebarlatest 若报minimum release age/「版本不足 24h」说明该版本发布不足 24 小时等一等或重跑一次即可pnpm 会自动补minimumReleaseAgeExclude。️ 常见坑 2页面出现两个侧边栏双挂载一步修复现象打开页面看到两个侧边栏或启动时报duplicate loader id/duplicate loader entry id。原因插件被挂载了两次——旧版手动挂载行残留老版本需要在~/.dsh/profiles/web/cordis.patch.yml里手写挂载行而 npm 包现在已内置挂载声明cordis.patch.yml旧行不删就会重复挂载两个安装通道同时启用官方 CLI 与 plugin-registry 各装了一份。解决打开~/.dsh/profiles/web/cordis.patch.yml删除包含 better-sidebar 的- insert:挂载块然后重启 DSH- insert: - id: better-sidebar name: dsh-better-sidebar 装过聚合包内含本插件时插件内置声明会自动退让、无需手动处理若仍双挂载确认聚合包的 bundle 顺序在dsh-better-sidebar之前即可。️ 常见坑 3node-pty 加载失败终端起不来现象终端页显示「node-pty 加载失败」横幅或 Windows 下终端完全无法使用。原因与解决构建脚本被拦截、安装不完整最常见在~/.dsh/profiles/web下执行然后重启 DSH、点页面「重试」即可pnpm approve-builds --all pnpm rebuild node-pty修复命令也会直接展示在终端横幅上可一键复制。Windows 缺少当前 Node 版本的预编译二进制node-pty 依赖预编译二进制缺失时需安装编译工具链VS Build Tools后重装主流 Node 版本一般已有预编译。终端的管理逻辑在 src/pty-manager.ts插件与 DSH 核心使用同一node-pty^1.1.0修复后两者同步恢复。 装完之后的 5 分钟侧边栏工作台快速上手硬刷新后按这个顺序熟悉 6 个核心页面文件树点文件即开编辑器Ctrl/Cmd S 保存文件行右键可「在新 Tab 打开 / 复制路径 / 在应用中打开」终端真实 shell 直接跑命令右键终端 Tab 可「固定到工作区 / 固定到全局」切会话不消失文件变动暂存、提交CtrlEnter、查看历史与 diff支持多仓库切换侧边对话独立 Tab 追问不污染主会话可一键「保存为新会话」子代理 / 后台任务实时查看子代理拓扑与任务输出内嵌浏览器侧边栏内多开网页内容运行在沙箱 iframe 中Tab 可拖到分栏边缘拆分、拖到中间合并每个页面的独立开关与二级设置都在设置页「侧边卡片」里逐项调整。 DSH-better-sidebar 常见坑速查表现象原因一句话修复Ignored build scriptspnpm 11 拦截构建脚本profile 目录下pnpm approve-builds --all两个侧边栏 /duplicate loader entry id双挂载删掉cordis.patch.yml里旧的better-sidebar挂载行终端「node-pty 加载失败」构建脚本未跑或二进制缺失pnpm approve-builds --all pnpm rebuild node-pty后重启 DSHdsh: command not found未安装 DSH先装 DSH或改用 npx 方式调用找不到 profile 目录profile 未初始化先跑一次dsh web完整安装命令与更多问题见 README.md 常见问题表安装部分在 README.md。✅ 总结一分钟回顾安装流程安装就 3 步add→approve-builds→ 再add最后硬刷新浏览器三大坑本质是两类问题构建脚本被拦approve-builds 放行与重复挂载删旧挂载行 / 别开双通道上手后从设置页「侧边卡片」继续探索想开发插件阅读 docs/external-plugin-guide.md【免费下载链接】DSH-better-sidebar开放的侧边栏底座支持三方拓展注册新侧边栏页面。内置文件渲染编辑/终端/侧边对话/Git/子代理页面 Open sidebar foundation, supports third-party extensions to register new sidebar pages. Built-in file rendering/editing, terminal, side chat, Git, and sub-agent pages.项目地址: https://gitcode.com/gh_mirrors/ds/DSH-better-sidebar创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
如何快速上手DSH-better-sidebar5分钟安装三大常见坑pnpm构建拦截/双挂载/node-pty完整教程【免费下载链接】DSH-better-sidebar开放的侧边栏底座支持三方拓展注册新侧边栏页面。内置文件渲染编辑/终端/侧边对话/Git/子代理页面 Open sidebar foundation, supports third-party extensions to register new sidebar pages. Built-in file rendering/editing, terminal, side chat, Git, and sub-agent pages.项目地址: https://gitcode.com/gh_mirrors/ds/DSH-better-sidebarDSH-better-sidebar是面向 DSHDeepSeek Harness网页端的开放侧边栏底座它在浏览器里提供一套 VSCode 风格的右侧侧边栏工作台内置文件渲染编辑、真实终端、侧边对话、Git、子代理等页面并支持三方拓展注册新的侧边栏页面。本篇 DSH 侧边栏插件安装教程带你在约 5 分钟内完成安装并逐一拆掉新手最常踩的 3 个坑pnpm 构建脚本拦截、双挂载、node-pty 加载失败。 DSH-better-sidebar 是什么侧边栏工作台功能一览装上之后DSH 的网页界面会多出一整套「侧边栏工作台」️ 文件工作台懒加载目录树 CodeMirror 编辑器图片 / Markdown含 Mermaid 图表/ HTML / PDF 均可内联预览 真实终端xterm.js node-pty 驱动的真是 shell不是模拟器断线重连还能回放 文件变动Git 视角暂存 / 提交 / 还原、历史与 diff多仓库可选 侧边对话beta每个对话一个独立 Tab继承主会话上下文独立运行 子代理 / 后台任务页子代理拓扑与后台任务实时输出 可扩展底座把ctx.betterSidebar服务开放给所有插件通过registerTab/registerFileViewer注册新页面与文件预览器生态插件已有 28右侧栏与 DSH 原生右侧栏集成底部为可拆分、可拖拽的工作台布局按会话持久化。插件接入细节见 docs/external-plugin-guide.md。⚡ DSH 侧边栏插件 5 分钟安装先核对 3 个前置条件依赖要求验证方式DSH0.1.5-rc.1dsh web能正常运行Node.js≥ 20node -vpnpm≥ 10pnpm -v⚠️ DSH 版本还比较旧对照安装0.1.5-alpha.2 用户装dsh-better-sidebar0.19.0-alpha.10.1.2-rc.1 稳定线用dsh-better-sidebar0.18.xDSH ≤ 0.1.1-rc.2 用dsh-better-sidebar0.17.1。第 1 步执行安装命令dsh plugin --profile web add dsh-better-sidebarlatest 首次执行可能会「失败」——这是 pnpm 11 拦截了 node-pty 构建脚本导致的依赖其实已经写入别慌照做第 2 步即可原因见下方坑 1。第 2 步放行构建脚本cd ~/.dsh/profiles/web pnpm approve-builds --all这条命令放行 node-pty 等原生构建脚本并自动重跑安装。第 3 步重跑安装并硬刷新浏览器dsh plugin --profile web add dsh-better-sidebarlatest这次会成功。装完硬刷新浏览器Cmd/Ctrl Shift R即可在右侧看到侧边栏——DSH 对 client 改动是热加载无需重启仅 host 半更新时才需要重启。备选一键脚本安装克隆仓库后运行官方脚本自动完成 add → 放行构建脚本 → 重跑安装git clone https://gitcode.com/gh_mirrors/ds/DSH-better-sidebar cd DSH-better-sidebar bash scripts/install.shmacOS / Linux / Windows Git Bashscripts/install.shWindows 原生 PowerShellscripts/install.ps1终端提示「node-pty 加载失败」时bash scripts/install.sh --repair一键修复依赖️ 常见坑 1pnpm 11 拦截 node-pty 构建脚本怎么放行现象执行dsh plugin add安装失败日志出现Ignored build scripts或提示 node-pty 构建脚本被跳过。原因pnpm 11 默认拦截依赖的构建脚本strict-dep-builds而 node-pty 这类原生模块必须跑构建脚本才能完成编译链接。解决在 DSH 的 profile 目录执行一条命令放行再重跑安装cd ~/.dsh/profiles/web pnpm approve-builds --all dsh plugin --profile web add dsh-better-sidebarlatest 若报minimum release age/「版本不足 24h」说明该版本发布不足 24 小时等一等或重跑一次即可pnpm 会自动补minimumReleaseAgeExclude。️ 常见坑 2页面出现两个侧边栏双挂载一步修复现象打开页面看到两个侧边栏或启动时报duplicate loader id/duplicate loader entry id。原因插件被挂载了两次——旧版手动挂载行残留老版本需要在~/.dsh/profiles/web/cordis.patch.yml里手写挂载行而 npm 包现在已内置挂载声明cordis.patch.yml旧行不删就会重复挂载两个安装通道同时启用官方 CLI 与 plugin-registry 各装了一份。解决打开~/.dsh/profiles/web/cordis.patch.yml删除包含 better-sidebar 的- insert:挂载块然后重启 DSH- insert: - id: better-sidebar name: dsh-better-sidebar 装过聚合包内含本插件时插件内置声明会自动退让、无需手动处理若仍双挂载确认聚合包的 bundle 顺序在dsh-better-sidebar之前即可。️ 常见坑 3node-pty 加载失败终端起不来现象终端页显示「node-pty 加载失败」横幅或 Windows 下终端完全无法使用。原因与解决构建脚本被拦截、安装不完整最常见在~/.dsh/profiles/web下执行然后重启 DSH、点页面「重试」即可pnpm approve-builds --all pnpm rebuild node-pty修复命令也会直接展示在终端横幅上可一键复制。Windows 缺少当前 Node 版本的预编译二进制node-pty 依赖预编译二进制缺失时需安装编译工具链VS Build Tools后重装主流 Node 版本一般已有预编译。终端的管理逻辑在 src/pty-manager.ts插件与 DSH 核心使用同一node-pty^1.1.0修复后两者同步恢复。 装完之后的 5 分钟侧边栏工作台快速上手硬刷新后按这个顺序熟悉 6 个核心页面文件树点文件即开编辑器Ctrl/Cmd S 保存文件行右键可「在新 Tab 打开 / 复制路径 / 在应用中打开」终端真实 shell 直接跑命令右键终端 Tab 可「固定到工作区 / 固定到全局」切会话不消失文件变动暂存、提交CtrlEnter、查看历史与 diff支持多仓库切换侧边对话独立 Tab 追问不污染主会话可一键「保存为新会话」子代理 / 后台任务实时查看子代理拓扑与任务输出内嵌浏览器侧边栏内多开网页内容运行在沙箱 iframe 中Tab 可拖到分栏边缘拆分、拖到中间合并每个页面的独立开关与二级设置都在设置页「侧边卡片」里逐项调整。 DSH-better-sidebar 常见坑速查表现象原因一句话修复Ignored build scriptspnpm 11 拦截构建脚本profile 目录下pnpm approve-builds --all两个侧边栏 /duplicate loader entry id双挂载删掉cordis.patch.yml里旧的better-sidebar挂载行终端「node-pty 加载失败」构建脚本未跑或二进制缺失pnpm approve-builds --all pnpm rebuild node-pty后重启 DSHdsh: command not found未安装 DSH先装 DSH或改用 npx 方式调用找不到 profile 目录profile 未初始化先跑一次dsh web完整安装命令与更多问题见 README.md 常见问题表安装部分在 README.md。✅ 总结一分钟回顾安装流程安装就 3 步add→approve-builds→ 再add最后硬刷新浏览器三大坑本质是两类问题构建脚本被拦approve-builds 放行与重复挂载删旧挂载行 / 别开双通道上手后从设置页「侧边卡片」继续探索想开发插件阅读 docs/external-plugin-guide.md【免费下载链接】DSH-better-sidebar开放的侧边栏底座支持三方拓展注册新侧边栏页面。内置文件渲染编辑/终端/侧边对话/Git/子代理页面 Open sidebar foundation, supports third-party extensions to register new sidebar pages. Built-in file rendering/editing, terminal, side chat, Git, and sub-agent pages.项目地址: https://gitcode.com/gh_mirrors/ds/DSH-better-sidebar创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
