前言¶
在 DeepSeek Harness 裏，智能體會把筆記、計劃、調研和報告寫成工作區裏的 .md 文件。文件還在磁盤上，但產生它們的對話會不斷被頂走，想回頭集中看幾份文檔時，往往要在目錄樹裏來回找，或者把整份工作區當成一長串列表來掃。
下面介紹的 dsh-docdesk（界面名 資料區 / Materials）是一個 只增不減 的 Markdown 資料庫插件：由你主動挑選要保留的文檔，在固定網格桌面上擺放圖標，框選批量整理，並以全屏標籤頁閱讀；插件不會移動、重命名或刪除磁盤上的原文件。維護者爲 GitHub 用戶 wei238982377，在 DSH 社區目錄中歸類爲 客戶端 插件。
這是什麼¶
一句話定位：面向 DeepSeek Harness 的桌面式 Markdown 資料面板——從工作區裏顯式加入文檔，在插件內用網格桌面、虛擬文件夾和全屏閱讀器管理展示，渲染 GFM 表格、chart 與 mermaid 代碼塊，並支持沉浸式全屏。
英文簡介爲：A desktop-style materials panel for Markdown documents created in DeepSeek Harness. 當前 package.json 版本爲 0.2.8，許可證 MIT，要求 DSH 引擎 >=0.2.1-rc.3。
核心功能¶
顯式加入，不自動導入¶
- Add files 打開工作區選擇器，支持搜索與多選；已在庫中的文檔會標記且不能重複加入。
- 對話裏交付的 Markdown 文件卡片可出現 Add to library；右鍵卡片菜單也有同一操作。若宿主不渲染交付卡片，仍可用選擇器加入。
- 從庫中 Remove 只移除庫內條目，不觸碰磁盤文件。
固定網格桌面¶
圖標對齊到桌面框內的槽位，兩個圖標不會佔同一格。拖到已被佔用的槽位會與對方 交換位置；新圖標優先填入第一個空槽。首屏可見區域內可自由擺放；首屏滿後新增一行並出現滾動。
框選與批量操作¶
在桌面空白處 按住右鍵拖動 可框選多個圖標。拖動任一選中圖標可整組按網格塊移動。用 Delete / Backspace、工具欄選區 pill 或右鍵菜單可從庫中移除選中項（文件仍在磁盤）。多選時可右鍵 Put N items into 選文件夾，或拖到文件夾圖標上，一次性歸入文件夾。
虛擬文件夾與重命名¶
New folder 在當前頁創建文件夾，可嵌套；拖到文件夾圖標上即可歸檔，徽章顯示內含數量。F2 或右鍵 Rename 只改庫內顯示名，不改磁盤路徑。刪除文件夾會把文檔移回父級，不刪文件。
全屏閱讀與標籤頁¶
雙擊文檔全屏打開。頂欄爲瀏覽器式標籤：Home 與各打開文檔各佔一 tab，可切換與關閉。
沉浸式閱讀¶
資料區主頁工具欄 沉浸 / Immersive，或文檔路徑欄的展開圖標，快捷鍵 F 進入沉浸式：面板固定爲 100vw×100vh，通過宿主 layout.toggleSidebar() 收起側欄，並在可用時請求原生全屏。Esc 或浮動 Exit immersive 退出並恢復佈局。在閱讀器切回 Home tab 時仍保持沉浸狀態。
側欄把手¶
面板左緣中部有一條細把手，調用宿主側欄切換，可收起至圖標軌並再次展開。
Markdown 增強渲染¶
chart圍欄塊：本地渲染爲 SVG 柱狀、折線、面積、餅圖、環形圖；數據可爲 JSON 或label,value行，不執行任意代碼、不發起網絡請求。mermaid圍欄塊：使用插件內 bundled Mermaid 12.2.0（懶加載，非 CDN，strict 安全級別），支持 Gantt、xychart-beta、流程圖、時序圖等。- GFM 管道表格 渲染爲真實表格。
搜索、雙語與主題¶
可按標籤或路徑過濾當前頁。界面中英文隨 Harness locale；顏色使用宿主主題 token。
安裝與啓用¶
從插件市場（條目合併後）¶
README 說明：待倉庫進入 awesome-dsh-plugin 後，在 DSH 中打開 Plugins → Discover，搜索 資料區 或 Materials 安裝。市場從該 GitHub 倉庫安裝；npm 發佈爲可選項。
從 GitHub¶
指定 profile 時使用：
dsh plugin --profile <your-profile> add https://github.com/wei238982377/dsh-docdesk
在 DSH Desktop 中也可 Plugins → Add 粘貼上述倉庫 URL。包爲源碼包：根目錄 package.json 聲明 dsh.bundle 與 cordis.patch.yml。
安裝完成後 刷新瀏覽器標籤頁一次，客戶端插件纔會加載。
典型用法¶
- 在左側邊欄打開 資料區。
- 點右上角 Add files，按需搜索、勾選文檔，再點 Add selected。
- 拖動圖標對齊網格；佔槽交換、首屏滿後自動增行滾動。
- 空白處右鍵拖動框選；整組移動或從庫移除；多選批量放入文件夾。
- New folder 建文件夾，雙擊進入；右鍵圖標可 Open、Rename、Copy path、Move to folder、Remove from library。
- 雙擊文檔全屏閱讀；用標籤切換與關閉；F 進入沉浸，Esc 退出。
圖表示例（JSON 形式，摘自 README）：
```chart
{
"type": "bar",
"title": "Weekly documents",
"unit": "docs",
"data": [
{ "label": "Mon", "value": 3 },
{ "label": "Tue", "value": 5 },
{ "label": "Wed", "value": 4 }
]
}
```
簡寫行形式：
```chart:line
W1,2
W2,4
W3,3
```
適用場景與注意¶
適合：需要把 Agent 產出的多份 Markdown 留在「一張桌面」上快速打開、對照閱讀；文檔內含表格、Mermaid 或 chart 塊，希望在插件內直接渲染；希望庫內整理（文件夾、重命名、移除條目）而不改動工作區文件佈局。
注意：
- 插件以當前 DSH 進程權限運行；安裝前請自行查看 GitHub 源碼 與 MIT 許可證。
- 資料庫狀態與磁盤文件分離：移除庫條目、刪文件夾、重命名顯示名均 不 修改、移動或刪除工作區裏的
.md文件。 - DSH 生態理念是「一切皆插件」；社區目錄站點與 DeepSeek / 幻方無官方從屬關係，本文所述市場流程以 README 爲準。
結尾¶
dsh-docdesk（資料區） 把「你選中的 Markdown」收進固定網格桌面與全屏標籤閱讀器，並本地渲染 chart 與 Mermaid，適合在 Harness 里長期對照 Agent 寫出的文檔。更多信息見社區目錄頁與倉庫：
- 目錄頁：https://www.skillhub.cn/plugins/wei238982377/dsh-docdesk
- GitHub：https://github.com/wei238982377/dsh-docdesk
