DSH-better-sidebar

DSH-better-sidebar 0.24.1 把文件树、编辑器、文件变动（Git）、任务/工作流图与侧边对话注册进 DSH 原生右侧栏；自带终端与浏览器已移除，改用 DSH 内置能力。

• 隔离 Git 仓库与系统账号（必需）：使用可回滚的测试仓库；0.24.1 不再把文件操作限制在会话目录，建议用权限受限的系统账号或容器运行 DSH，不在个人主目录或生产源码验证。
• DSH 版本组合（必需）：0.24.1 的 DSH peer 为 ^0.2.0-rc.1，本页固定 DSH 0.2.0-rc.2。仍使用 DSH 0.1.x 的用户不能安装此版本，见下方旧版说明。52DSH 未在 rc.2 上运行验证。
• 仅本机访问 DSH Web（必需）：侧栏路由只有 Host/Origin 围栏，没有登录认证；不要用 --trusted-host 或局域网地址把 DSH Web 暴露给不可信设备。

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

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

安装到

web Profile

DSH 基线

0.2.0-rc.2

安装来源

npm 预构建包（锁定版本）

固定目标

[email protected]

0.24.1 的 14 条 DSH peer 均为 ^0.2.0-rc.1，本页固定 DSH 0.2.0-rc.2。仍使用 DSH 0.1.x 的用户不能安装此版本，应保留 0.18.0（DSH 0.1.2-rc.1）或 0.17.1（DSH 0.1.1-rc.2）。仅静态复核，未在本站运行验证。

• DSH 版本组合来源 1 ↗（外部链接，在新标签页打开）
• DSH 版本组合来源 2 ↗（外部链接，在新标签页打开）

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

npx --yes @deepseek-ai/[email protected] plugin --profile web remove dsh-better-sidebar

DSH 设置 → better-sidebar 表单（Profile 中 id 为 better-sidebar 的 Loader 行）

控制 tab/预览器开关、HTML 预览沙箱、agentOpenTools（默认关闭）和任务页自动弹出等偏好。

Loader 行 config：readLimit / mediaLimit / uploadLimit / listLimit

限制单文件读取（默认 512 KiB）、媒体（20 MiB）、上传（128 MiB）和单层列表条数（1000）。

Session cwd

仍是相对路径与 Git 的基准目录，但已不是安全边界；把会话指向隔离仓库。

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

- insert:
    - id: better-sidebar
      name: 'dsh-better-sidebar'
      disabled: !!js "[...ctx.loader.entries()].some((e) => e.options.name === 'dsh-better-sidebar' && e.options.id !== 'better-sidebar' && !e.disabled)"

1. 如 Profile 的 cordis.patch.yml 里还有旧版手写的 dsh-better-sidebar 挂载行，先删除，避免双挂载；聚合包已挂载同一插件时保持聚合包在前。
2. 旧版的 config.shell / shellArgs 与 workspaceFence 已无作用，可从 Profile 中清理；插件会把旧 settings.yaml 中仍有效的偏好导入新设置表单。
3. 保持 HTML 预览沙箱开启、agentOpenTools 关闭；删除、丢弃、revert 与提交逐项确认，不向未认证远程用户开放 DSH Web。

1. 01
   确认 Profile 中只有一条启用的 dsh-better-sidebar 行。

   复制验证命令复制命令

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

   期望结果：出现 id 为 better-sidebar 的行，没有重复挂载或被禁用的提示。

2. 02
   在 DSH 原生右侧栏打开测试仓库文件树并查看一个文本文件。

   期望结果：文件在插件编辑器中打开，未修改任何文件。

3. 03
   打开「文件变动」查看测试仓库差异。

   期望结果：只展示测试仓库状态；不执行提交、丢弃或 revert。

• 在侧栏查看测试仓库的未提交差异，并让 Agent 只解释变化。
• 在任务页查看子 Agent 与工作流运行的进度图，不改动共享任务。

可信 Web 客户端可读写、重命名、上传、打包下载和永久删除宿主用户可访问的任意路径（0.23.0 起删除工作区包含检查与 workspaceFence），可执行 Git 暂存/提交/切分支/丢弃/revert/cherry-pick，并可让宿主调用系统打开器处理自定义协议 URL。Host/Origin 围栏不是登录认证。

数据存储：插件偏好保存在 DSH Profile 中该插件 Loader 行的配置里；文件、Git 与上传直接作用于本机磁盘（不限会话目录），打包下载在宿主内存中生成；侧边对话以子会话形式存入 DSH 会话存储。

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

升级 DSH 0.2.0 后侧栏消失

旧版插件的 ^0.1.x peer 在 0.2.0 上会被启动预检禁用，需改装 0.24.1；不要通过放宽预检解决。

仍使用 DSH 0.1.x

不要安装 0.24.1；按旧版说明保留 0.18.0 + DSH 0.1.2-rc.1，或 0.17.1 + 0.1.1-rc.2。

出现两个侧栏或 duplicate prefix route

删除 Profile 中手写的旧挂载行，或停用重复挂载该包的聚合 Bundle，保留一条。

找不到插件终端或浏览器 tab

0.20 线起已移除自带终端和浏览器，改用 DSH 内置右栏终端与浏览器 tab。