---
name: ds-sidebar
version: 0.4.0
description: 为 DeepSeek Harness Web 提供「摘要 + 侧边栏」技能：摘要只列对话输出的文档/网页/图片与来源，侧边栏提供文件夹、终端、浏览器、文档阅读器、图片阅读器，用于预览与编辑文件。
---

# ds-sidebar

为 DeepSeek Harness（`dsh`）Web 端提供「摘要」与「侧边栏」两个能力，作为
一个可独立下载、独立部署到任意 Harness 的客户端插件。

## 何时使用

- 用户想在对话中查看「本对话输出了哪些文档 / 网页 / 图片」，并一键打开。
- 用户想在工作区里浏览 / 编辑文件、打开终端、预览 HTML 网页或图片。
- 用户提到「摘要」「侧边栏」「文件树」「终端」「预览文件」等场景。

## 功能

### 1. 摘要
- 会话头部「**摘要**」按钮 → 弹出紧凑悬浮框。
- 「输出内容」只列对话输出的 **文档 / 网页 / 图片**（不输出推导过程）。
- 「来源」列出读取的文件与链接。
- 每个条目可点击：文件 → 侧边栏对应工具打开；链接 → 浏览器；图片 → 图片阅读器。

### 2. 侧边栏（5 个工具）
- **文件夹**：浏览 / 打开 / 新建 / 重命名 / 删除。
- **终端**：PTY 终端，支持输入命令、Ctrl+C、清空、重启。
- **浏览器**：iframe 预览工作区 HTML 或外部网址（含帧检测）。
- **文档阅读器**：文本文件阅读与编辑保存。
- **图片阅读器**：查看工作区图片。

侧边栏打开时页面自适应：右侧预留 360px，对话框左移，不遮挡内容。

## 安装（部署到任意 Harness）

```sh
# 前置：dsh + web profile
dsh plugin --profile web add github:az790871109/dsh-summary-sidebar
# 或本地目录
dsh plugin --profile web add file:/path/to/dsh-summary-sidebar
```

然后在 `$DSH_HOME/profiles/web/cordis.patch.yml` 追加：

```yaml
- insert:
    - id: summary-sidebar
      name: dsh-summary-sidebar
```

重启并硬刷新：

```sh
dsh web
```

## 依赖

- Harness `web` profile（提供 `webServer`、`slots`、`layout` 服务）。
- `node-pty`（终端依赖，Harness 部署目录或 `$DSH_HOME/profiles/node_modules` 中存在即可）。

## 结构

```
dsh-summary-sidebar/
├── lib/index.js     # 宿主端 /sbs API（文件 / 终端 / 帧检测）
├── lib/client.js    # 浏览器端：摘要 + 5 标签侧边栏（无构建步骤）
├── cordis.patch.yml # bundle 补丁
└── package.json     # dsh.client 声明
```