前言¶

在 DSH 的 Web GUI 對話流中，模型調用 read_image 後，用戶通常希望直接看到圖片，而不是隻看到工具結果裏的引用或文本。dsh-read-image-view 就是補上這一展示層的客戶端插件：它讓 Web GUI 在對話裏直接顯示 read_image 讀到的圖片，並覆蓋透明圖、多圖和頁面內放大等查看場景。

它由 Yu-tao-Li 維護，許可證爲 MIT。

這是什麼¶

dsh-read-image-view 是一個面向 DSH Web GUI 的客戶端插件，定位是讓 read_image 的結果在對話中直接可見。

• 純客戶端插件（browser-only）。
• 零運行時依賴。
• 不改 DSH 本體。
• 僅影響 Web GUI，TUI 和其他表面不受影響。

核心功能¶

下面列出的能力都圍繞“把 read_image 讀到的圖顯示出來”：

• 在 DSH Web GUI 對話流中直接顯示 read_image 讀到的圖片。
• 提供專用 Read image 行。
• 結果默認展開，使用消息同款圖片卡樣式。
• 透明圖片顯示 PS 風格灰白棋盤格。
• 同一次請求讀到的多張圖合併成一行並排展示。
• 頁面內放大層，支持縮放按鈕、鼠標滾輪、1:1 原始尺寸。
• 圖片字節通過 session/attachment 端點獲取。
• 插件本身不做任何文件 I/O，不新增網絡端點。

安裝與啓用¶

安裝命令如下，--profile web 用於 Web GUI profile：

dsh plugin --profile web add github:Yu-tao-Li/dsh-read-image-view

profile 插件集在啓動時裝配，安裝後需要重啓：

dsh web

已覈實資料給出的運行環境要求是：

Node >=22

典型用法¶

安裝並重啓後：

1、模型每次調用 read_image，對話裏即可直接看到圖。
2、一次請求讀多張圖時，自動並排成一行。
3、透明圖片顯示 PS 風格灰白棋盤格。
4、頁面內放大層支持縮放按鈕、鼠標滾輪、1:1 原始尺寸。

適用場景與注意¶

適合主要在 DSH Web GUI 裏工作、需要把 read_image 結果直接看成圖片的場景。它不會改變 TUI 或其他表面的行爲。

作爲 DSH 插件，插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證：

https://github.com/Yu-tao-Li/dsh-read-image-view

使用 LICENSE 查看許可條款，並建議閱讀源碼後再安裝。

另外注意這些邊界：

• 僅 Web GUI 生效，TUI / 其他表面不受影響。
• 圖片字節只經 session/attachment 端點獲取。
• session/attachment 按會話授權，只放行該會話持久日誌中引用過的附件；跨會話引用被拒。
• 插件本身不做任何文件 I/O，不新增網絡端點。
• 依賴 shell 內置的 react / react-dom / dsh-client-ui-primitives 模塊、image.* 語言鍵與 useSession 快照鉤子。
• 若上游調整了槽位契約、模塊裝載表或會話快照結構，需要同步適配。

結尾¶

dsh-read-image-view 的價值很集中：讓 DSH Web GUI 裏的 read_image 結果不再只停留在工具文本中，而是直接作爲圖片被查看。倉庫地址：

https://github.com/Yu-tao-Li/dsh-read-image-view