DSH-better-sidebar

Better Sidebar 0.30.1 提供文件树、编辑器、Git 图、任务与侧边对话,侧边对话支持图片输入,编辑器选区可作为引用加入对话,并在底部工作台复用宿主终端;文件操作仍可访问宿主账号可及路径。

快速判断

安装前先看这几项

配置资料
配置资料完整
配置难度
较高
适合新手
建议具备相关经验
兼容状态
声明兼容,尚未实测
验证状态
源码已审阅,未标记运行实测
你正在查找符合当前筛选条件的插件
← 返回原筛选结果
本页目录(9)
中文教程

按照固定来源完成安装、配置与验证

教程包含独立 Profile、精确安装目标、配置证据、最小验证任务、回退和数据清理。

查看 DSH-better-sidebar 安装与配置教程 →
功能

这个插件能做什么

Better Sidebar 0.30.1 提供文件树、编辑器、Git 图、任务与侧边对话,侧边对话支持图片输入,编辑器选区可作为引用加入对话,并在底部工作台复用宿主终端;文件操作仍可访问宿主账号可及路径。

适合谁

需要Git、版本控制、提交能力的用户。

使用门槛

该插件涉及较高配置难度或敏感权限,不建议在生产工作区直接试装。

准备

安装前准备

  • DSH 0.2.2-rc.1(必需):0.30.1 的 14 项 DSH peer 均为 ^0.2.2-rc.1,dsh.plugin.json 的 engines.dsh 为 >=0.2.2-rc.1:只接受 0.2.2-rc.1 及以上的 0.2.x,会被 0.2.1-rc.5 拒绝;仍在 0.2.1 线的环境继续固定 0.28.2,不要混装。cordis peer 仍为 ^4.0.5。插件 Node >=20,但 DSH 0.2.2-rc.1 宿主要求 Node.js ≥24.9.0。仅静态复核,不代表运行兼容;可选 Better Locale 集成另行核对。
  • 独立环境与备份(必需):使用独立 web Profile、可丢弃工作区和受限系统账号,升级前保存依赖、锁文件、补丁和插件状态。
安装

如何安装 DSH-better-sidebar

本页命令固定使用 DSH 0.2.2-rc.1,与 npm 默认版本分别维护。切换 DSH 前核对本插件的兼容记录;新版 Session API 与格式变化见0.1.3-alpha.1 升级说明。源码审阅不等于运行验证。

下面的命令使用本站核验的 DSH 基线,并锁定插件版本或 Git commit,避免默认分支变化导致安装内容漂移。本站已核对安装目标,但尚未在你的系统和 Profile 中实际执行。

安装到
web Profile
DSH 基线
0.2.2-rc.1
安装来源
npm 预构建包(锁定版本)
固定目标
[email protected]

E1 已静态复核 0.30.1(0b6293f05145)的固定源码与发行物,本文命令固定 DSH 0.2.2-rc.1;只代表静态审阅,不是插件运行通过。仍在 DSH 0.2.1-rc.5 的环境保留升级前组合,不与新版交叉混装。

  1. 01
    检查 Node.js 与 pnpm

    DSH 当前基线需要 Node.js 22.19 或 Node.js 24 及以上,并且 pnpm 必须已在 PATH 中。先运行:

    环境检查
    node --version && pnpm --version
  2. 02
    安装到 Web Profile

    这条命令会把插件加入 web Profile,并在插件声明 DSH Bundle 时自动加入配置层。

    npm 预构建包(锁定版本)
    npx --yes @deepseek-ai/[email protected] plugin --profile web add [email protected]
  3. 03
    确认 Bundle 已进入配置

    安装成功后先导出组合配置,不启动 Agent。输出中应能找到包名 dsh-better-sidebar或对应 Bundle 层。

    检查配置
    npx --yes @deepseek-ai/[email protected] --profile web --dump-config
  4. 04
    启动并完成最小验证

    启动 Web Profile 后,只测试一个与插件功能直接相关的最小任务,并检查日志、文件、网络和凭据访问是否符合预期。

    启动 DSH Web
    npx --yes @deepseek-ai/[email protected] web
卸载与回退

测试不通过时先停止 DSH,再从同一 Profile 移除插件。移除后重新运行配置检查,确认对应 Bundle 层已经消失;插件自己创建的数据和外部账号配置可能需要另行清理。

从 Web Profile 移除
npx --yes @deepseek-ai/[email protected] plugin --profile web remove dsh-better-sidebar
配置

插件专属配置

$DSH_HOME/profiles/web/cordis.patch.yml
用户覆盖层;与依赖清单、锁文件和 pnpm-workspace.yaml 一同备份。

现行部署限额与保守偏好 · yaml。示例中的账号、路径和凭据占位符必须替换,不要提交真实密钥。

复制 现行部署限额与保守偏好 配置
- id: better-sidebar
  config:
    listLimit: 1000
    agentOpenTools: false
    htmlViewerNoSandbox: false
    htmlViewerDefaultUnsafe: false

核对配置证据(外部链接,在新标签页打开)

  1. 以下为可自行执行的隔离验证步骤;52DSH 本轮未安装或启动插件。
  2. 停止旧进程后用固定版本安装命令更新,同一 Profile 不混用全局启动器与不同 DSH 版本。
  3. 检查只有一条启用的 better-sidebar 行,硬刷新浏览器;清理旧字段并保留默认 HTML 沙箱。
  4. 确认宿主 Connection 认证与执行账号;cwd 与 workspaceFence 都不能隔离文件访问。
验证

配置检查与成功结果

  1. 01
    核对精确宿主、包版本和唯一挂载行;导出配置成功不算运行验证。
    复制验证命令
    npx --yes @deepseek-ai/[email protected] --profile web --dump-config

    期望结果:配置引用 [email protected] 对应包,未出现重复挂载;继续验证前先核对权限。

  2. 02
    在隔离仓库打开一个测试文本并查看 Git 差异,不保存、不删除、不执行 Git 写操作。

    期望结果:文件树与 Git 只读信息可见;权限与连接失败有明确提示。52DSH 未执行插件验证。

使用

第一次使用建议这样验证

  • 只读查看测试仓库文件及未提交 diff,不使用删除、上传覆盖、提交、丢弃或终端命令。
权限

它可能接触哪些数据和能力

执行本机命令控制浏览器使用服务凭据

文件读写、上传和永久删除不限会话工作区,也可使用绝对路径和 ~;OS 权限仍是边界,workspaceFence 已无效。路由调用宿主 Connection.requestRejection,不再沿用旧版“只有 Host/Origin、无登录”的描述;认证不会缩小文件权限。Git 写操作、宿主终端执行本机命令、外部编辑器与不安全 HTML 预览仍需分别确认。新增 GET /sidebar/sidechat-image 读取侧边对话图片,同样经宿主 Connection 放行,只校验线程类型、不按用户区分归属;HTML 预览现在会在沙箱内加载并执行同目录的相对 .js/.css/.wasm。

数据存储:偏好保存在 Profile Loader 行;文件与 Git 操作直达宿主磁盘,侧边对话由 DSH 会话存储保留,侧边对话图片进入宿主附件存储;浏览器 localStorage 另存 dsh-better-sidebar:draft:*(未保存的编辑器正文,最多 8 条)和 dsh-better-sidebar:quote-refs(最多 200 条引用记录),卸载插件不会清除;流式传输不再使用旧容量上限。

请注意:“源码已审阅”说明本站检查到的证据范围,不等于安全认证。重要工作区应锁定版本、备份数据并在最小权限下测试。

排查

故障排查与数据清理

旧容量设置无效
readLimit/mediaLimit/uploadLimit 已移除;listLimit 只限制列表条数,需要容量或隔离时在宿主系统部署层实现。
底部终端不可用或 Remote 打不开
核对 DSH 终端 controller 与客户端 SSH 编辑器配置;恢复旧 shell 字段无效,Remote 链接也不替代 Web 认证。
升级后宿主启动报 DesktopHostFatalError:required plugins did not activate
通常是 Profile 自带的 @deepseek-ai/dsh-* 副本(写在 Profile 的 package.json 或 overrides 中)与宿主版本混用。删除这些副本后重新安装,或把两边对齐到同一 DSH 版本;不要用旧宿主加载 0.30.1。
卸载后的清理步骤
  1. 停止同一 Profile 的 DSH,再运行 npx --yes @deepseek-ai/[email protected] plugin --profile web remove dsh-better-sidebar;导出配置确认已移除。
  2. 卸载后在同一浏览器清除该站点的存储,删除 dsh-better-sidebar:draft:* 与 dsh-better-sidebar:quote-refs;侧边对话图片与子会话按宿主方式另行清理。
  3. 恢复升级前整套 Profile 和插件状态备份,不混用新旧状态;卸载不会撤销文件修改、子会话或外部授权。
深入审计:兼容性、数据流与来源
证据

兼容性与审阅记录

兼容性说明

0.30.1 的 14 项 DSH peer 均为 ^0.2.2-rc.1,dsh.plugin.json 的 engines.dsh 为 >=0.2.2-rc.1:只接受 0.2.2-rc.1 及以上的 0.2.x,会被 0.2.1-rc.5 拒绝;仍在 0.2.1 线的环境继续固定 0.28.2,不要混装。cordis peer 仍为 ^4.0.5。插件 Node >=20,但 DSH 0.2.2-rc.1 宿主要求 Node.js ≥24.9.0。仅静态复核,不代表运行兼容;可选 Better Locale 集成另行核对。

数据流

文件与 Git 直接作用于宿主磁盘;偏好写入 Profile Loader 行,侧边对话保存在 DSH 子会话;侧边对话可附带图片(每条最多 8 张、单张 10 MiB、合计 20 MiB),经宿主附件服务保存并随消息发给所选模型服务商;编辑器选区会以引用形式在发送时进入主会话;已安装的 GenUI 类插件可经 registerSidechatSurfaceAdapter 渲染回复并替用户发送消息。上传/下载/HTML 预览采用流式处理,旧 readLimit/mediaLimit/uploadLimit 不再限制传输;Remote SSH 编辑器链接在浏览器端打开本机编辑器,不是由插件建立 SSH 服务或同步文件。

源码审阅结论

2026-11-06 E1:从 b0e0fab50e68 升级到 0b6293f05145,逐文件对照两版源码差异。npm SHA-512 与 integrity 一致,2 条 registry ECDSA 签名验证通过,provenance 声明的摘要与提交匹配,但未验证完整 Sigstore 信任链;258 个发行文件与固定提交一致,package.json 只去掉 packageManager 与 prepare/prepublishOnly、没有安装期脚本;另有 241 个构建产物不在 Git 中,其中位于 src/ 下的 mermaid-frame-asset.generated.ts(约 3.7 MB,内联 mermaid)无法对照提交核验。固定源码 674 个文件经 Git blob 校验。仅静态源码审阅,未安装或运行插件、未使用真实凭据,未独立重建产物。此前记录:2026-11-01 B1:重新取得 npm 0.28.2,SHA-512 与 npm integrity 一致,两个 registry ECDSA 签名验证通过,发行 tag 解引用至固定提交。provenance 声明的摘要与工作流提交匹配,但未完成 Sigstore 信任链验证;未独立重建发行产物。已按固定源码复核配置、授权、持久化与恢复边界,批准带风险说明的 source_reviewed;未安装或执行插件、未用真实凭据。

来源与维护信息

本页根据固定提交的仓库、包清单和本站审阅资料生成。版本变化后,请重新核对作者说明。

来源快照
08f3df46cca1
固定提交
0b6293f05145
许可证
MIT
主要语言
TypeScript
中文资料
有完整中文配置资料