---
title: "安装 DSH Better Sidebar 0.30.1 并核对配置与权限"
seo_title: "DSH Better Sidebar 0.30.1 教程：配置、迁移与权限"
description: "在 DeepSeek Harness（DSH）0.2.2-rc.1 使用 DSH Better Sidebar 0.30.1，了解固定安装、旧配置迁移、持久化、权限与失败回退；仅静态审阅，未运行验证。"
canonical: https://52dsh.com/tutorials/omdsh-dev-dsh-better-sidebar-install-config/
authors: ["52DSH 编辑部"]
audience: []
outcomes: []
prerequisites: ["Node.js 与 pnpm","独立 web Profile","可丢弃测试工作区"]
difficulty: advanced
estimated_action_time: null
next_steps: null
published_at: 2026-08-22
updated_at: 2026-11-06
verified_on: 2026-11-06
maintenance_status: community
verification_level: source_reviewed
risk_level: high
dsh_version: 0.2.2-rc.1
plugin_id: omdsh-dev-dsh-better-sidebar
tutorial_kind: plugin_configuration
related_plugin_url: https://52dsh.com/plugins/omdsh-dev-dsh-better-sidebar/
---

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

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

## 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 升级检查](/tutorials/dsh-update-uninstall/#022-rc1默认版本升级检查)。

## 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](https://github.com/omdsh-dev/DSH-better-sidebar/blob/0b6293f05145d6852428a05035d5ea0f370992be/package.json)、[固定证据 2](https://github.com/omdsh-dev/DSH-better-sidebar/blob/0b6293f05145d6852428a05035d5ea0f370992be/dsh.plugin.json)、[固定证据 3](https://github.com/omdsh-dev/DSH-better-sidebar/blob/0b6293f05145d6852428a05035d5ea0f370992be/src/sidechat-routes.ts)、[固定证据 4](https://github.com/omdsh-dev/DSH-better-sidebar/blob/0b6293f05145d6852428a05035d5ea0f370992be/src/client/editor-draft-backup.ts)。

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

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

> 对应插件：[查看 DSH-better-sidebar 的功能、权限与兼容性说明](/plugins/omdsh-dev-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 使用目录中记录的精确安装目标，避免直接跟随可能变化的默认分支：

```bash
npx --yes @deepseek-ai/dsh@0.2.2-rc.1 plugin --profile web add dsh-better-sidebar@0.30.1
```

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



## 插件专属配置

### 配置目标

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

### 现行部署限额与保守偏好

证据：[固定来源](https://github.com/omdsh-dev/DSH-better-sidebar/blob/0b6293f05145d6852428a05035d5ea0f370992be/src/config.ts)。按上方配置目标使用本段内容；如有占位符，替换为测试值。

```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：

```bash
npx --yes @deepseek-ai/dsh@0.2.2-rc.1 --profile web --dump-config
npx --yes @deepseek-ai/dsh@0.2.2-rc.1 web
```

1. **核对精确宿主、包版本和唯一挂载行；导出配置成功不算运行验证。**

   ```bash
   npx --yes @deepseek-ai/dsh@0.2.2-rc.1 --profile web --dump-config
   ```

   期望结果：配置引用 dsh-better-sidebar@0.30.1 对应包，未出现重复挂载；继续验证前先核对权限。

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 移除包：

```bash
npx --yes @deepseek-ai/dsh@0.2.2-rc.1 plugin --profile web remove dsh-better-sidebar
```

1. 停止同一 Profile 的 DSH，再运行 npx --yes @deepseek-ai/dsh@0.2.2-rc.1 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、保留日志并回退插件。

## 固定来源证据

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

- [README.md](https://github.com/omdsh-dev/DSH-better-sidebar/blob/0b6293f05145d6852428a05035d5ea0f370992be/README.md)
- [docs/external-plugin-guide.md](https://github.com/omdsh-dev/DSH-better-sidebar/blob/0b6293f05145d6852428a05035d5ea0f370992be/docs/external-plugin-guide.md)

继续查看：[返回 DSH-better-sidebar 插件详情页](/plugins/omdsh-dev-dsh-better-sidebar/)，重新核对兼容性、权限、同类插件和来源状态。

## 原始来源

- https://github.com/omdsh-dev/DSH-better-sidebar
- https://github.com/omdsh-dev/DSH-better-sidebar/blob/0b6293f05145d6852428a05035d5ea0f370992be/package.json
- https://github.com/omdsh-dev/DSH-better-sidebar/blob/0b6293f05145d6852428a05035d5ea0f370992be/LICENSE
- https://github.com/omdsh-dev/DSH-better-sidebar/blob/0b6293f05145d6852428a05035d5ea0f370992be/cordis.patch.yml
- https://github.com/omdsh-dev/DSH-better-sidebar/blob/0b6293f05145d6852428a05035d5ea0f370992be/README.md
- https://github.com/omdsh-dev/DSH-better-sidebar/blob/0b6293f05145d6852428a05035d5ea0f370992be/src/index.ts
- https://github.com/omdsh-dev/DSH-better-sidebar/blob/0b6293f05145d6852428a05035d5ea0f370992be/src/config.ts
- https://github.com/omdsh-dev/DSH-better-sidebar/blob/0b6293f05145d6852428a05035d5ea0f370992be/src/path-security.ts
- https://github.com/omdsh-dev/DSH-better-sidebar/blob/0b6293f05145d6852428a05035d5ea0f370992be/src/fs-operations.ts
- https://github.com/omdsh-dev/DSH-better-sidebar/blob/0b6293f05145d6852428a05035d5ea0f370992be/src/open-external.ts
- https://github.com/omdsh-dev/DSH-better-sidebar/blob/0b6293f05145d6852428a05035d5ea0f370992be/src/client/api.ts
- https://github.com/deepseek-ai/deepseek-harness/blob/66491b05e3f05ad35bcdd4f6cd7ed26041d9e3db/packages/boot/app-boot/src/plugin-compatibility.ts
- https://github.com/omdsh-dev/DSH-better-sidebar/blob/0b6293f05145d6852428a05035d5ea0f370992be/docs/external-plugin-guide.md
- https://github.com/omdsh-dev/DSH-better-sidebar/blob/0b6293f05145d6852428a05035d5ea0f370992be/dsh.plugin.json
- https://github.com/omdsh-dev/DSH-better-sidebar/blob/0b6293f05145d6852428a05035d5ea0f370992be/src/sidechat-routes.ts
- https://github.com/omdsh-dev/DSH-better-sidebar/blob/0b6293f05145d6852428a05035d5ea0f370992be/src/client/editor-draft-backup.ts
