安装 DSH Better Sidebar 0.30.1 并核对配置与权限

在 DeepSeek Harness(DSH)0.2.2-rc.1 使用 DSH Better Sidebar 0.30.1,了解固定安装、旧配置迁移、持久化、权限与失败回退;仅静态审阅,未运行验证。

社区整理已复核原始来源
DSH
0.2.2-rc.1
系统
Windows / macOS / Linux
风险
high
本页目录(13)
对应插件DSH-better-sidebar

先查看功能、兼容性、权限和同类选择,再按本文操作。

查看插件详情 →

E1 固定版本维护记录(2026-11-06)

本页从 0.28.2 升级到 0.30.1,命令改为 DSH 0.2.2-rc.1。0.30.1 的 DSH peer 只接受 0.2.2-rc.1 及以上,仍在 DSH 0.2.1-rc.5 的环境继续固定 0.28.2,不要混装。文件、删除、Git、终端与认证相关源码未变;新增侧边对话图片、浏览器 localStorage 草稿与引用记录,以及 HTML 预览执行同目录脚本,见下文数据流与清理说明。

以上为固定源码与发行物的静态审阅,没有安装或运行插件;通过 DSH 版本声明检查不代表能加载。升级宿主前先看0.2.2-rc.1 升级检查。

B1 固定版本维护记录(2026-11-01)

本页从 0.24.1 升级至 0.28.2,安装目标与 DSH 命令已同步更新。此前 11-01 的候选暂缓记录保存在批次审核历史中;本轮补齐发行包绑定与配置/权限静态审阅后,转为带风险说明的 source_reviewed,不提升为运行验证。

重新取得 npm 精确版,SHA-512 与元数据一致;registry 的两条 ECDSA 签名验证通过。发行 tag 解引用与本页 40 位提交一致。provenance 声明的摘要与工作流提交已比对,但未验证完整 Sigstore 信任链,未独立重建产物。发行包内 238 个 src 文件与固定提交一致,仍不等于构建产物可复现。

以上不是安全认证,也没有执行安装、登录、模型请求、迁移、终端、远程或更新流程。使用前按下文迁移与退出路径逐项核对。

依据:固定证据 1(外部链接,在新标签页打开)、固定证据 2(外部链接,在新标签页打开)、固定证据 3(外部链接,在新标签页打开)、固定证据 4(外部链接,在新标签页打开)。

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

如果你的目标是配置文件与 Git 工作台,并核对路径、宿主终端和 Remote 编辑器边界,本教程会说明如何在 DeepSeek Harness(DSH)中准备、安装、配置、验证和回退 DSH-better-sidebar。本文锁定作者仓库提交 0b6293f05145;已复核固定提交的原始资料,未进行运行实测。

对应插件:查看 DSH-better-sidebar 的功能、权限与兼容性说明。先确认它适合你的工作流,再执行安装。

0.28.2 → 0.30.1:只适用于 DSH 0.2.2 的新版

本页固定 Better Sidebar 0.30.1 + DSH 0.2.2-rc.1。0.30.1 的 DSH peer 只接受 0.2.2-rc.1 及以上,仍在 0.2.1-rc.5 的环境继续固定 0.28.2,不要混装。发行包 258 个文件与固定提交一致,另有 241 个构建产物,其中 src/ 下的 mermaid-frame-asset.generated.ts 不在 Git 中,无法对照提交核验。文件、删除、Git、终端与认证相关源码相对 0.28.2 逐字节未变;新增的是数据面:侧边对话可发送图片,编辑器草稿与引用记录会写入浏览器 localStorage,HTML 预览会在沙箱内执行同目录的脚本。52DSH 未启动或验证此插件。

0.24.1 → 0.28.2:认证变化与权限边界

0.28.2 起新版已移除旧 dsh-invariants 依赖,并把 HTTP/WebSocket 围栏交给宿主 Connection 的部署信任与认证策略。认证接入不等于工作区隔离;文件路由仍能触及 DSH 进程账号可以访问的任意路径。52DSH 未启动或验证此插件。

先确认是否适合你

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

如果你准备在重要工作区使用,先阅读插件详情页的权限和数据流说明;“源码已审阅”或“资料已整理”都不等于安全认证。

安装前准备

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

  • 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、可丢弃工作区和受限系统账号,升级前保存依赖、锁文件、补丁和插件状态。
  1. 安装 Node.js 24.9.0 或更高版本(本页 DSH 0.2.2-rc.1 的根包要求 >=24.9.0),并确认 pnpm 可用。
  2. 使用独立的 web Profile 和可丢弃测试工作区,不直接连接生产目录。
  3. 备份当前 Profile 配置,并记录安装前的 --dump-config 输出。
  4. 核对固定来源中的外部服务、账号、运行时和平台限制。
  5. 本页没有列出插件专属环境变量;仍需核对宿主和外部服务的凭据要求。

安装 DSH-better-sidebar

52DSH 使用目录中记录的精确安装目标,避免直接跟随可能变化的默认分支:

npx --yes @deepseek-ai/[email protected] plugin --profile web add [email protected]

GitHub 源码插件如果被 pnpm 拦截构建脚本,先检查终端提示的具体包和脚本。只在 web Profile 中放行确实需要的构建项,不要全局放行未知依赖。

插件专属配置

配置目标

  • $DSH_HOME/profiles/web/cordis.patch.yml:用户覆盖层;与依赖清单、锁文件和 pnpm-workspace.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 都不能隔离文件访问。

清理失效字段与旧配置

备份 Profile 补丁、依赖/锁文件和侧边会话后升级;只保留一条启用的 better-sidebar 挂载行。workspaceFence、旧自带 PTY 的 shell / shellArgs、标题条兼容字段 titleBarScheme / titleBarPresetId / titleBarCompat / titleBarStripPx 不再起作用。

readLimit、mediaLimit、uploadLimit 也已删除,旧值可能被容忍但不能再作为容量或安全控制。部署限额仅保留 listLimit(默认 1000);大文本转只读分页预览是编辑器内存策略,不是上传限额。HTML 预览默认保留 sandbox,htmlViewerNoSandbox / htmlViewerDefaultUnsafe 保持 false,agentOpenTools 保持 false;这些开关都不能限制已有文件路由的可及范围。

0.30.1 起 HTML 预览会加载并执行同目录的相对 .js/.mjs/.css/.wasm,预览不可信仓库的 HTML 时,仓库里的脚本也会在沙箱内运行并可弹窗、触发下载;/sidebar/html 的 CSP 沙箱头始终存在。agentOpenTools 改为只有明确写 false 才注销工具,示例继续显式写 false。

配置验证与成功结果

先导出配置,再启动同一版本的 DSH Web:

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

    npx --yes @deepseek-ai/[email protected] --profile web --dump-config
    

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

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

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

第一次使用

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

路径、删除、终端与 Remote

相对路径基于会话 cwd(0.30.1 起仓库子目录会话不再上抬到仓库顶层),绝对路径和 ~ 仍可越出该目录;改 cwd 不构成隔离。树删除是永久删除,目录递归移除,符号链接行删除链接本身;上传可能替换目标文件,临时文件与原子重命名不等于不会覆盖。Git 的提交、丢弃、revert 要逐项检查,不在首次只读任务中操作。

底部工作台可以显示终端,但 PTY/controller 由 DSH 提供,插件不自带 PTY。宿主未挂载终端能力时,不能靠恢复旧 shell 字段修复。Remote SSH 的 VSCode 系编辑器链接由浏览器端交给本机编辑器,需要用户自己配置 SSH 别名/连接;这不为 DSH Web 添加认证,也不提供独立 SSH 服务器。文件与终端操作仍发生在实际 DSH 宿主。

数据、权限与凭据

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

权限关注: 文件读写、上传和永久删除不限会话工作区,也可使用绝对路径和 ~;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 条引用记录),卸载插件不会清除;流式传输不再使用旧容量上限。

真实 Token、API Key、Cookie 和账号 ID 不应写进 Git 仓库、网页截图或公开 Issue。测试结束后撤销临时凭据。

卸载、回退与清理

停止 DSH 后,从同一个 Profile 移除包:

npx --yes @deepseek-ai/[email protected] plugin --profile web remove dsh-better-sidebar
  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 和插件状态备份,不混用新旧状态;卸载不会撤销文件修改、子会话或外部授权。

远程访问与回退

远程场景先核对宿主登录、Connection 信任策略和实际执行机器,不以 --trusted-host 或允许 Origin 代替认证。使用权限受限账号或隔离容器承载测试,保留默认 HTML 沙箱。回退恢复升级前的 Profile 与宿主版本组合;卸载无法恢复永久删除的文件、Git 写入或已产生的子会话,本轮未测试终端、远程连接或删除操作。

常见问题

旧容量设置无效

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。

安装成功但页面或命令没有出现

先运行 --dump-config 确认 Bundle 已进入 web Profile,再重启 DSH Web 并硬刷新浏览器。不要通过反复扩大权限来解决加载问题。

插件运行后没有得到预期结果

把问题缩小到本页的最小验证任务,检查作者文档要求的变量、外部服务和平台限制。保存终端错误原文,并核对当前安装目标是否仍对应本页固定提交。

作者固定资料中未识别到独立故障章节。遇到插件特有错误时,应先停止 DSH、保留日志并回退插件。

固定来源证据

以下资料是本文配置结论的依据:

继续查看:返回 DSH-better-sidebar 插件详情页,重新核对兼容性、权限、同类插件和来源状态。

来源与维护信息

本文根据以下原始资料整理。版本变化后,请以官方资料和页面标注的验证日期为准。

完成当前任务后

按结果继续,不要停在文章末尾

已成功

继续完成配置、验证或下一阶段任务。

继续下一步 →
仍未解决

保留现象和错误原文,再进入对应排障路径。

DSH 安装 Git 插件被 allowBuilds 阻止怎么办 →安装和管理 DeepSeek Harness(DSH)插件 →