dsh-better-sidebar

[!IMPORTANT] v0.19.0 起接入 DSH 原生侧边栏：右列就是 DSH 自己的右侧栏，插件把每个 tab 类型注册为原生 tab（不再自绘右侧面板），只保留自绘的底部工作台与开放给所有插件的 ctx.betterSidebar 服务。

v0.21.1 起要求 DSH 0.1.7-rc.1+（peer 下限 ^0.1.7-rc.1；本版即 npm latest）。DSH 0.1.7 自带完整文档预览，插件把只读预览（表格 / PDF / 图片 / Office）整体让给内置，只保留 Markdown / HTML 与可编辑的代码编辑器。0.1.6-alpha.2 及更早的用户请固定 [email protected]；按 DSH 版本选插件版本的对照表见安装。

<b style="font-size: 1.15em;">一个服务化的侧边栏框架，一套开箱即用的完整工作台</b><br /><br /> <b>右侧栏 + 底部面板双工作台</b>，并把 <code>ctx.betterSidebar</code> 服务开放给所有插件——<br /> 通过 <code>registerTab</code> / <code>registerFileViewer</code> 注册新的侧边栏页面与文件预览器。

🌏 <a href="./README.md"><b>中文</b></a> · <a href="./README_EN.md">English</a>

<video src="https://github.com/user-attachments/assets/23187822-047e-45cc-b480-fe997bd55b86" muted autoplay loop playsinline controls width="100%"></video>

📑 目录

• ✨ 功能一览
• 🚀 安装
• 🖼️ 特性巡礼
• 💬 社区
• 🆕 最近更新
• ⌨️ 快捷键
• 🔌 服务化扩展
• 🛠️ 开发与构建
• 🔐 安全 · ⚠️ 已知限制 · 🖥️ 平台支持
• 🌐 插件生态 · 🤝 参与贡献 · 👥 贡献者 · 🔗 友情链接

✨ 功能一览

相比 DSH 官方侧边栏，本插件补上的关键能力：

• 🖥️ 可编辑的代码编辑器：官方文档预览是只读的 → 插件保留可编辑的 CodeMirror 编辑器（保存、语法高亮、预览切换）；Markdown / HTML 也走插件自有渲染（Mermaid 图表安全渲染 + 点击放大、README 级内嵌 HTML、浮动目录大纲、HTML 沙箱预览）
• 🗂️ 增强文件树：接管内置「文件」页——懒加载目录树、展开的目录实时 watch 自动刷新、软链接识别、全局文件名搜索、拖拽上传、悬浮 @文件 一键引用进输入框
• 🌿 文件变动（官方侧栏没有 Git 面板）：Git 视角（diff / 历史 / 暂存·提交·还原）+ 本轮 AI 改动视角双合一，统一 diff 渲染（行内字符级高亮、语法着色、敏感内容脱敏）
• 🧩 任务管理（官方没有）：子代理拓扑实时预览 + 后台任务清单（退出码 / 实时输出 / 强制终止）
• 💬 侧边对话（官方没有，beta）：Codex 风格侧边线程——继承主会话完整上下文独立运行，可持续追问，一键提升为顶层会话
• 🖥️ 底部工作台（官方没有）：右列交给 DSH 原生右侧栏，插件另加自绘底部工作台（拖拽分栏 / 按会话持久化），可与原生栏同时展开
• 📂 模型打开侧边栏（可选）：sidebar_open 工具让模型主动在侧边栏打开文件 / 文件夹 / 网页
• 🔌 服务化扩展：ctx.betterSidebar 向所有插件开放（registerTab / registerFileViewer），内置 5 tab + 3 viewer 走同一套 API，已有 28+ 生态插件（见「🌐 插件生态」）
• ⚡ 按需加载：启动只拉 ~325KB 核心，编辑器 / Mermaid / 第三语言词典按需加载 · 🌏 多语言跟随 DSH · 🔁 会话隔离按会话持久化布局

🚀 安装

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

支持的 DSH 版本：

📌 通道与支持线：v0.21.1 是正式版（npm latest），仅适配 DSH 0.1.7-rc.1+。装 DSH 请写精确版本号：npm i -g @deepseek-ai/[email protected]（rc.1 走 npm next 通道）。DSH 0.1.6-alpha.2 及更早的用户请固定 [email protected]——0.1.7 的破坏面（设置服务重写、图标导出改名、会话格式 v3→v4）大到本版不写兼容层。

🧭 按你的 DSH 版本选插件版本：

你的 DSH 版本	安装命令	版本 / peer 声明
0.1.7-rc.1+（含之后的 0.1.7 正式版）	dsh plugin --profile web add dsh-better-sidebar@latest	0.21.1，^0.1.7-rc.1
0.1.7-alpha.1 / 0.1.7-alpha.2	没有可装版本——先把 DSH 升到 rc.1，再跑上一行：<br>npm i -g @deepseek-ai/[email protected]	—
0.1.6-alpha.2 及更早、0.1.5-rc.*（含 npm latest 的 0.1.5-rc.3）	dsh plugin --profile web add [email protected]	0.19.1，^0.1.5-rc.1
0.1.5-alpha.2	dsh plugin --profile web add [email protected]	^0.1.5-alpha.2
0.1.2-rc.*	dsh plugin --profile web add [email protected]	^0.1.2-rc.1
0.1.2-alpha.2	dsh plugin --profile web add [email protected]	^0.1.2-alpha.2
0.1.0-rc.8 / 0.1.1	dsh plugin --profile web add [email protected]	^0.1.0-rc.8

命令里的 web 换成你自己的 profile 名即可。旧版本一律写精确版本号（@0.19.1 而不是 @latest），因为 latest 会随新正式版前移；反过来也不要在 0.1.7 的 alpha 上装 0.19.1，装上只会坏。

…