DeepSeek Harness plugin

dsh-plugin-vscode-sidebar

DSH web plugin: a VSCode-like right sidebar (explorer / editor / terminal / git / browser), isolated per conversation session. Exposes a service for other plugins to register sidebar tabs and file

Jump to install

Source facts

Repository
gameswu/dsh-plugin-vscode-sidebar
Latest update
Aug 16, 2026
Category
Tools & Capabilities
GitHub stars
8
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/gameswu/dsh-plugin-vscode-sidebar
Plugin: dsh-plugin-vscode-sidebar
Author: gameswu

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

dsh-plugin-vscode-sidebar

VSCode 风格的 DSH Web 侧边栏插件(fork 自 dsh-plugin-vscode-sidebar v0.12.1)。

项目简介

为 DSH(DeepSeek Harness)Web 界面提供右侧栏 + 底部面板双工作台:

  • 文件浏览器:懒加载目录树 + vscode-icons 按文件类型图标;支持新建文件/文件夹、重命名、删除(删除需确认);在 git 仓库中按 .gitignore 将被忽略的文件低亮度灰显(类似 VSCode,仍保留在列表中),并显示 git 状态字母徽章
  • 编辑器:Monaco(VSCode 同源编辑器)文本编辑,全语言语法高亮;tab 标题显示未保存圆点,Ctrl+S 保存;关闭含未保存改动的 tab 时询问保存(可在设置中改为自动保存);图片 / Markdown / HTML / PDF 内联预览
  • Markdown 预览:DSH 渲染器 + KaTeX 数学公式与图片渲染;文档内的相对链接与文件提及可直接跳转打开对应文件
  • 源代码管理:类 VSCode Git 面板——彩色状态徽章、+a −d 行数统计、行内 diff、提交、分支切换(含 ahead/behind)、历史记录泳道轨迹图;自动探测子目录中的 git 仓库(可配置排除目录)
  • 终端:xterm.js + node-pty 真实 shell,可选为模型注入 terminal_* 工具
  • 内嵌浏览器:沙箱 iframe 多开网页 tab
  • 任务管理:subagent 拓扑 + 后台任务卡片;点击卡片展开终端风格流式输出(可设置新任务自动展开),代理创建的终端同样在此流式展示
  • 全部设置接入官方插件配置页,修改后即时生效,无需重启

界面文案跟随 DSH 语言(zh/en)实时切换;面板布局按会话持久化。

仓库结构

├── src/
│   ├── index.ts            host 半入口:/sidebar API 路由、挂载、设置
│   ├── git.ts              仓库探测 / 状态 / numstat / check-ignore 等 git 操作
│   ├── fs-tree.ts          目录列举(.git 元数据过滤)
│   ├── bundle-route.ts     /sidebar/bundle 懒加载 chunk 与 /sidebar/icons 图标路由
│   ├── wire.ts / config.ts / prefs-shared.ts / trust-fence.ts / ...
│   └── client/
│       ├── index.tsx       client 半入口:portal 侧边栏外壳
│       ├── Sidebar.tsx     面板外壳 / 工作台 / tab 图标解析
│       ├── GitView.tsx     源代码管理面板(含历史轨迹图渲染)
│       ├── git-graph.ts    历史泳道图纯构建器
│       ├── ExplorerView.tsx / file-icons.tsx / DiffView.tsx / DiffTab.tsx / EditorHost.tsx / ...
│       ├── builtins/       7 个内置 tab 注册
│       ├── locales.ts / sidebar.module.css / ...
│       └── chunks/         终端 / 编辑器懒加载入口
├── assets/vscode-icons/    vscode-icons SVG 图标集(含 LICENSE)
├── tests/                  vitest 单元/组件测试
├── scripts/                check-consumer-types.sh(消费者类型面守卫)
├── cordis.patch.yml        bundle 挂载补丁(dsh.bundle.patch,安装必需)
├── tsdown.config.ts        host/client/chunk 三组构建配置
└── package.json            dsh.bundle.patch 声明 + peer 依赖

安装

本插件是一个自带补丁层的组合包dsh.bundle + cordis.patch.yml)。用 dsh plugin 安装即可——它把参数转发给 profile 的 pnpm,并自动把包挂载进 dsh.profile.bundles,无需手动编辑任何配置文件:

# 从本地路径安装(<路径>/dsh-plugin-vscode-sidebar 为本仓库目录)
dsh plugin --profile web add <路径>/dsh-plugin-vscode-sidebar

# 或从 GitHub 安装(建议锁定 commit)
dsh plugin --profile web add github:gameswu/dsh-plugin-vscode-sidebar#<sha>

从 GitHub 安装时,pnpm 会在安装后运行本包的 prepare 脚本构建 lib/;pnpm ≥10 默认拒绝执行,首次 add 会失败并提示把包键加入该 profile 的 pnpm-workspace.yaml 后重试:

allowBuilds:
  dsh-plugin-vscode-sidebar: true
  node-pty: true
  protobufjs: true

> 授权构建意味着安装时会在你的机器上执行本包的构建脚本——请只对可信来源授权。

安装完成后重启 Web 界面(dsh web)即可生效。

卸载:dsh plugin --profile web remove dsh-plugin-vscode-sidebar(插件行随 bundle 一并移除)。

更新与开发

pnpm install        # 安装依赖
pnpm build          # 打包 → lib/(host/client/chunk 三组构建)
pnpm test           # vitest 单元/组件测试

本地路径安装(pnpm link)会直接使用本仓库的构建产物:host 半改动需重启 dsh web;仅 client 半改动重新构建后硬刷新浏览器(Ctrl+Shift+R)即可。

License

[MIT](LICENSE)