前言¶
在 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
