前言¶

DeepSeek Harness（DSH）支持通过插件扩展 Web 端能力。webkong/dsh-plugin-sidebar 是一个 DSH Web 插件，用来补上左右侧栏：左侧按工作区浏览会话，右侧在会话内浏览文件、查看 Git 状态并处理提交。

如果你的 DSH 环境需要在 Web 端管理会话、查看文件、检查 Git 变更，可以安装这个插件，按当前 dsh 版本选择配套插件版本。

这是什么¶

webkong/dsh-plugin-sidebar 是为 DeepSeek Harness 而生的左右侧栏插件。

维护者为 webkong，许可证为 MIT。插件安装后，DSH Web 界面会增加：

• 左侧栏：按工作区浏览会话，支持状态点、分组、搜索、一键操作。
• 右侧栏：文件浏览器、Git 面板、提交历史、分支切换。
• 主区域文件预览：基于 CodeMirror 6，支持语法高亮、编辑和保存写回磁盘。

核心功能¶

左侧栏：工作区与会话浏览¶

左侧栏按工作区浏览会话，适合把多个工作区下的会话集中放在一个侧栏里查看。

已核实的能力包括：

• 按工作区分组浏览会话。
• 会话状态点：用于显示会话状态。
• 顶部搜索：本地标题、cwd、工作区匹配，并合并远端内容搜索。
• 会话卡片操作：重命名、复制 fork、归档、移动到文件夹。
• 一键操作：减少在会话列表与具体操作之间来回切换的成本。

右侧栏：文件浏览与 Git 面板¶

右侧栏面向会话内工作目录，提供文件浏览和 Git 操作。

文件浏览器支持：

• 懒加载目录树。
• 按文件名搜索。
• 按文件内容搜索。
• 目录 Git 状态聚合徽标。

Git 面板支持：

• 已暂存 / 更改状态。
• 着色 diff。
• 提交框。
• 分支切换。
• 批量操作：暂存全部、取消暂存全部、放弃全部更改。
• 提交历史：时间线、提交信息、作者 / 日期、该提交改动文件列表。

文件预览¶

文件预览 tab 使用 CodeMirror 6 渲染文本文件，支持：

• 语法高亮。
• 编辑。
• 保存写回磁盘。

对二进制文件和大文件，插件会给出提示。

语言与主题¶

插件提供全中文界面 + English，并跟随 DSH 语言偏好自动切换。

插件也会跟随 DSH 主题进行浅色 / 深色自动适配。

安装与启用¶

安装前建议先确认 dsh 版本，再选择插件版本：

dsh ≥ 0.1.2：建议插件 0.3.2
dsh 0.1.1-rc.x：可用插件 0.3.0–0.3.2

从 GitHub 安装指定版本：

dsh plugin --profile web add github:webkong/dsh-plugin-sidebar#v0.3.2

如果需要安装最新主分支：

dsh plugin --profile web add github:webkong/dsh-plugin-sidebar#main

如果从本地路径安装，适合开发调试：

dsh plugin --profile web add /path/to/dsh-plugin-sidebar

注意 pnpm 的 GitHub 版本锁定语法使用 #tag，因此安装命令中使用 #v0.3.2，避免使用旧写法 @0.3.2。

安装完成后，重启 dsh web。

启用后的效果是：

1、左侧栏接管 sidebar.workspaces。
2、右侧栏接管 details 列。
3、会话头部出现右栏开关。

后续修改时的生效方式：

• Host 改动：需要重启 dsh web。
• Client 改动（lib/client.js）：刷新页面即可。

典型用法¶

下面是一个常见的安装与启用流程。

1、确认当前 dsh 版本。

2、按版本兼容选择插件版本：

dsh plugin --profile web add github:webkong/dsh-plugin-sidebar#v0.3.2

3、重启 dsh web：

# 按你的 DSH 启动方式重启 dsh web

4、打开 DSH Web 界面，左侧栏会显示工作区和会话。

5、在顶部搜索会话，搜索范围包括本地标题、cwd、工作区，并合并远端内容搜索。

6、在会话卡片上执行重命名、复制 fork、归档、移动到文件夹。

7、在会话头部打开右栏开关。

8、右侧查看文件树、Git 状态、diff、提交历史和分支。

9、点击文本文件进入文件预览，使用 CodeMirror 6 查看、编辑并保存写回磁盘。

适用场景与注意¶

适合以下场景：

• 需要在 DSH Web 端按工作区浏览会话。
• 需要在会话内查看文件目录、搜索文件和预览文本文件。
• 需要查看 Git 已暂存 / 更改状态、diff、提交历史和分支。
• 希望界面跟随 DSH 语言偏好和主题。

安装前需要注意：

• 插件以当前 dsh 进程权限运行，会执行文件、Git、会话相关操作，安装前应检查源码与许可证。
• API 路由 /dsp-sidebar/api 仅限本机 loopback，且为 POST 请求。
• fs.read 读文本时 512KB 截断，二进制返回 kind:'binary'。
• 文件预览对二进制 / 大文件给出提示。
• dsh ≥ 0.1.2 上旧版 client 因等待已移除的 dsh-client-runtime 而无法加载，因此建议按版本兼容表选择插件版本。

结尾¶

webkong/dsh-plugin-sidebar 把 DSH Web 端的会话浏览、文件预览和 Git 操作集中到左右侧栏中，适合需要把 DSH 作为 Web 端智能体工作台使用的开发者。

GitHub：https://github.com/webkong/dsh-plugin-sidebar