前言¶

DSH 社區採用插件化方式擴展能力，web profile 也可以通過插件增加瀏覽器側功能。對於使用 dsh web 的開發者來說，常見需求是把當前對話中涉及的文檔、網頁、圖片集中展示出來，並且能在右側直接查看工作區文件、運行終端命令、預覽 HTML 或圖片。

dsh-summary-sidebar 是一個面向 DeepSeek Harness（dsh）web profile 的獨立客戶端插件。它把「摘要」和「側邊欄」打包在一起：摘要負責彙總當前對話中的文檔、網頁、圖片；側邊欄提供文件夾、終端、瀏覽器、文檔閱讀器、圖片閱讀器五個工具。

這是什麼¶

dsh-summary-sidebar 是 DeepSeek Harness Web 的「摘要 + 側邊欄」插件，維護者爲 az790871109，許可證爲 MIT，當前版本爲 0.4.0。

它是一個完全獨立、可單獨部署的插件，不依賴任何其它已安裝插件。插件主要解決兩件事：

1、在會話頭部提供「摘要」，集中展示當前對話輸出的文檔、網頁、圖片。
2、在右側提供「側邊欄」，包含文件夾、終端、瀏覽器、文檔閱讀器、圖片閱讀器五個標籤。

核心功能¶

摘要¶

點擊會話頭部右上角的「摘要」按鈕後，插件會彙總當前對話輸出的文檔、網頁、圖片。摘要只輸出這些可點擊條目，不輸出推導/敘述文本。

摘要來源來自當前會話的工具調用與結果文本，例如 read / glob 工具、web_fetch / web_search 結果中的 URL。

每個摘要條目都可以點擊：

• 文件：打開側邊欄，並用對應工具預覽/編輯該文件。
• 鏈接：打開側邊欄「瀏覽器」加載該網址。
• 圖片：打開側邊欄「圖片閱讀器」。

側邊欄¶

側邊欄是右側抽屜面板，包含五個標籤：

側邊欄打開時，插件通過 Harness 右側 details 列預留 360px，對話框自動左移讓位，側邊欄貼合預留區，不遮擋對話內容。

安裝與啓用¶

先確認前置條件：已安裝 DeepSeek Harness（dsh），並使用 web profile（dsh web）；本機已安裝 node-pty。如果 Harness 的部署目錄或 $DSH_HOME/profiles/node_modules 中已有 node-pty 即可；沒有則執行下面命令安裝：

pnpm add node-pty

GitHub 安裝（推薦）¶

執行下面命令，從 GitHub 安裝插件：

dsh plugin --profile web add github:az790871109/dsh-summary-sidebar

安裝後，在 $DSH_HOME/profiles/web/cordis.patch.yml 中追加 insert 條目，使 web profile 組合該插件：

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

本地安裝¶

如果本地已有插件目錄，可以用 file: 方式安裝：

dsh plugin --profile web add file:/path/to/dsh-summary-sidebar

也可以直接把插件目錄複製到 node_modules：

cp -R /path/to/dsh-summary-sidebar "$DSH_HOME/profiles/web/node_modules/dsh-summary-sidebar"

重啓 web profile 並硬刷新瀏覽器：

dsh web

卸載¶

執行下面命令卸載插件：

dsh plugin --profile web remove dsh-summary-sidebar

也可以手動刪除 $DSH_HOME/profiles/web/cordis.patch.yml 中的 insert 條目，以及 node_modules/dsh-summary-sidebar 目錄。

典型用法¶

啓用後，從會話頭部右上角開始操作：

1、點擊「摘要」，查看當前對話涉及並輸出的文檔、網頁、圖片。
2、點擊摘要中的文件、鏈接或圖片，側邊欄會自動切換到對應工具：文件用於預覽/編輯，鏈接用於瀏覽器加載，圖片用於圖片閱讀器查看。
3、點擊「側邊欄」，直接打開文件夾、終端、瀏覽器、文檔閱讀器、圖片閱讀器。

在側邊欄中：

• 文件夾裏可以瀏覽工作區文件，執行新建文件、新建文件夾、打開、重命名、刪除等操作。
• 終端中可以執行命令、發送 Ctrl+C、清空或重啓終端。
• 瀏覽器中可輸入地址，預覽工作區 HTML 或外部網址；外部網址受站點自身 X-Frame-Options / CSP 限制，插件會做 iframe 內嵌檢測，並提供新標籤頁打開。
• 文檔閱讀器中可以打開文本文件進行閱讀與編輯，並保存回工作區。
• 圖片閱讀器中可查看 png/jpg/gif/webp/svg 等工作區圖片。

適用場景與注意¶

適合在 dsh web profile 中使用，需要把對話產物和工作區工具集中起來的場景，例如：

• 長對話後快速回顧當前會話涉及並輸出的文件、網頁、圖片；
• 在瀏覽器中直接查看工作區 HTML、文本文件、圖片；
• 在側邊欄中維護工作區文件，並在獨立 PTY 終端中執行命令。

使用插件前注意以下事項：

1、插件以當前 dsh 進程權限運行；安裝前應檢查源碼、許可證和來源。
2、終端、文件、瀏覽器能力依賴宿主端 /sbs JSON API，包括文件列表/讀寫/新建/重命名/刪除、終端流、/sbs/frame-check 幀檢測；請確保插件安裝在 web profile。
3、插件宿主端不註冊模型側工具。
4、摘要來源來自當前會話的工具調用與結果文本；bash 等命令中的文件路徑僅做保守提取。
5、外部網址預覽受站點自身 X-Frame-Options / CSP 限制；插件已做 iframe 內嵌檢測與新標籤頁打開處理。
6、終端依賴 node-pty，請確保 web profile 運行環境中可用。

獲取¶

GitHub 倉庫：

https://github.com/az790871109/dsh-summary-sidebar

DSH 社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。具體目錄頁請以當前 DSH 社區入口或本地插件目錄查詢結果爲準。