前言¶

在 DSH 中使用 Agent 時，一次任務可能同時產出報告、圖表、圖片、PDF 和數據文件。若這些結果只散落在工作區目錄或工具記錄裏，檢查、對比和分享都不夠直接。DSH Right Sidebar 爲 DSH Web 增加一個右側產物工作區，讓 Agent 在會話中生成的交付物留在對話旁邊。

這是什麼¶

DSH Right Sidebar 是 Limitinfinitude 維護的 DSH 插件，許可證爲 MIT。它爲 DeepSeek Harness 提供原生右側產物工作區，把報告、圖表、圖片、數據和文檔等結果集中到會話旁邊；源碼、配置等項目內部文件仍由 DSH 工作區負責。

下面介紹它的核心能力、安裝方式和典型用法。

核心能力¶

會話綁定的產物欄¶

• 常駐右側入口，可自動展開，也可手動收起和恢復。
• 產物與會話綁定；切換會話時同步切換標籤、排序和關閉狀態。
• Agent 更新同一路徑的產物後，當前預覽自動刷新。
• 頂部堆疊標籤支持關閉和拖拽重排，狹窄側欄仍保留可讀文件名。
• 底部“本會話產物”目錄可重新打開已關閉的結果，超過七項時獨立滾動。

支持讀取的文件¶

插件支持 Agent 明確輸出的 HTTP(S) 文件 URL，以及工作區內唯一匹配的不完整文件路徑。

自動產物包括：

• Markdown
• MDX
• PDF
• SVG
• PNG
• JPEG
• WebP
• GIF
• AVIF
• BMP

按需產物包括：

• TXT
• JSON
• JSONL
• CSV
• TSV

按需產物僅在 Agent 回覆中明確提到文件路徑或名稱時顯示。

不展示的文件包括：

• 源碼
• HTML/HTM
• 配置
• 日誌
• YAML
• TOML
• XML
• INI
• CONF 等項目內部文件

預覽與操作¶

• Markdown 可直接在渲染內容上編輯，並在停止輸入後靜默保存。
• 支持複製路徑、複製內容、下載、打開所在目錄、置頂與隱藏。
• JSON/JSONL 支持可摺疊結構樹、搜索、全部展開/收起、格式化原文及錯誤行提示。
• CSV/TSV 支持篩選、數值/文本排序、分頁和列寬調整，並正確處理引號與多行字段。
• TXT 支持行號、全文搜索、匹配計數、自動換行，大文件按 250 行分頁。
• 圖片/SVG 支持適應窗口、原始尺寸、縮放、拖拽平移、尺寸信息和透明背景棋盤格。
• PDF 使用瀏覽器內置 PDF 閱讀器，並提供刷新和外部打開。

安裝與啓用¶

DSH Right Sidebar 需要 DSH Web 提供會話級 details.overlay 插槽和具名詳情欄 API。先確認當前環境是 DSH Web，再在倉庫目錄中執行安裝命令。

下面命令會克隆倉庫、安裝依賴、構建插件，並把當前目錄添加到 DSH Web profile：

git clone https://github.com/Limitinfinitude/DSH-Right-Sidebar.git
cd DSH-Right-Sidebar
npm install
npm run build
dsh plugin --profile web add .

經過上面的步驟後，刷新 DSH Web 會話。

運行要求¶

插件會在 DSH 客戶端環境中運行，並訪問工作區文件、產物內容或網絡產物。使用上需要注意以下配置聲明：

• package.json 聲明 peerDependencies: @deepseek-ai/cordis ^4.0.1。
• package.json 聲明 dsh.client.platform 爲 web。
• package.json 聲明注入以下客戶端包：
• @deepseek-ai/dsh-client-runtime
• @deepseek-ai/dsh-client-locale
• @deepseek-ai/dsh-client-connection
• @deepseek-ai/dsh-client-ui-layout

典型用法¶

1. 讓 DSH 生成報告、圖表、圖片、PDF 或數據文件。
2. Markdown、PDF、SVG 和圖片等富預覽產物出現時，右側欄自動展開並打開最新產物。
3. TXT、JSON 和 CSV 等數據文件只在 Agent 明確提到時進入產物列表，且不會搶佔當前富預覽。
4. 使用標籤在不同產物之間切換；關閉後可從底部目錄重新打開。
5. 需要源碼或項目文件時，使用“打開所在目錄”回到 DSH 工作區。

性能與安全¶

側欄空閒時不輪詢文件或端口。產物內容只在用戶選中後讀取，複雜預覽按需初始化。JSON 搜索只遍歷數據一次，表格限制爲最多 10,000 行，TXT 分頁渲染。瀏覽器端包體積約爲 185 KB gzip。

工作區內文件會校驗路徑。工作區外產物通過 DSH 同源授權後限時訪問，外部授權根目錄最多保留 256 個，6 小時後過期。Markdown 和 SVG 在渲染前淨化，二進制文件保持只讀，HTML/HTM 源文件不會嵌入到 Dock。

網絡產物必須由同源 DSH 頁面先授權，再通過無 Cookie、無認證頭的受限代理讀取；僅允許受支持的文件擴展名，單個響應上限 16 MB，10 秒超時。不完整路徑僅在已註冊工作區中有唯一匹配時解析，遇到多個同名文件會拒絕猜測。

適合誰¶

適合在 DSH Web 中使用 Agent 生成文檔、圖表、圖片和數據文件，並希望把交付物集中在會話旁邊查看的開發者。由於插件以當前 dsh 進程權限運行，安裝前應檢查源碼與 MIT 許可證。

結尾¶

DSH Right Sidebar 的價值在於把會話產物從工作區和工具記錄中收攏到一個穩定的右側位置：富預覽自動出現，數據文件按需進入列表，關閉後可以重新打開，源碼仍回到 DSH 工作區處理。

• 倉庫：https://github.com/Limitinfinitude/DSH-Right-Sidebar
• 目錄頁：https://www.skillhub.cn/plugins/Limitinfinitude/DSH-Right-Sidebar