前言¶
在 DeepSeek Harness（DSH）里跑智能体，产出的笔记、计划、调研和报告多半是工作区里的 .md 文件。文件还在磁盘上，对话却早已滚走；若只靠文件树逐个打开，既难挑重点，也容易和当次任务脱节。把整 workspace 做成一列清单又太吵。
dsh-docdesk（界面名 资料区）是客户端插件：库一开始为空，由你主动挑选要留下的文档，在固定、不重叠的网格桌面上摆图标，框选成组移动，并用带标签页的全屏阅读器打开正文。插件不自动导入、不动磁盘上的原文件——库内改名、移除条目或删虚拟文件夹，都不会移动、重命名或删除工作区里的真实文件。
这是什么¶
- 插件名称：
dsh-docdesk（npm 包名），侧栏入口为 资料区 / Materials。 - 维护者：Velestia-star。
- 分类：客户端（
dsh.client.platform: web）。 - 当前版本（
package.json）：0.3.28；许可证 MIT。 - 目录页：SkillHub 插件条目；源码与说明：GitHub。
核心功能¶
只增不减的资料库¶
- Add files 打开工作区选择器，可搜索、多选；已在库中的文档会标记且不能重复加入。
- 交付的 Markdown 文件卡片上可出现 Add to library；右键菜单里也有同一操作。若宿主不渲染卡片，仍可用选择器添加。
固定网格桌面与虚拟文件夹¶
图标落在桌面框内的槽位，两枚图标不共用一格。首屏未满时可在可见槽位任意摆放；满后再加会新开一行并滚动。拖到另一图标上可前插/后插，拖到两图标之间插入空隙；文件夹对文件夹拖放可交换位置。支持右键框选（按住右键在空白处拖出选框）、整组拖动、Delete 从库中移除（磁盘不动）、批量 Put N items into 文件夹。可建嵌套虚拟文件夹；库内 F2 或右键仅改显示名，不改磁盘路径。
阅读、沉浸与书签¶
双击文档进入全屏阅读，顶栏为浏览器式标签（Home + 各文档页）。工具栏 沉浸 / Immersive 或文档内展开图标、快捷键 F 进入沉浸层；Esc 或 Exit immersive 退出。正文支持 GFM 表格；围栏 chart 块在本地渲染为 SVG 柱/线/面/饼/环图；围栏 mermaid 由插件自带 Mermaid 12.2.0（securityLevel: 'strict'，从宿主加载、非 CDN）绘制流程图、甘特、序列图等。阅读条显示上次阅读进度，书签键 B，滚动条左侧轨标出书签与上次位置。
宿主与数据边界¶
- 宿主（
index.js）：扫描工作区等待选的.md/.markdown/.mdx，提供只读 API（列表、读文件、解析交付卡片路径）。 - 客户端（
client.js）：侧栏、面板、选择器、阅读器。 - 库布局、文件夹、标签页等存在浏览器
dsh-docdesk.library.v2，按浏览器配置隔离，不跨设备同步。Markdown 文件仍是真相来源；库外移动或删除文件后，打开会报错并可从库中移除条目。
安装与启用¶
要求 DSH 0.2.2-rc.1 或更新（package.json 中 dsh.engines.dsh: ">=0.2.2-rc.1"）。
插件市场¶
条目并入 awesome-dsh-plugin 后，在 DSH 中打开 Plugins → Discover，搜索 资料区 或 Materials 安装。
从 GitHub 安装¶
将 <your-profile> 换成你的 profile 名：
dsh plugin --profile <your-profile> add https://github.com/Velestia-star/dsh-docdesk
DSH Desktop 也可在 Plugins → Add 粘贴上述仓库 URL。安装完成后刷新浏览器标签页，客户端才会加载。
若安装时出现镜像源 UND_ERR_DESTROYED 等警告，README 说明多与 profile 里其他插件的 pnpm 解析有关；本包无 npm 依赖。可指定镜像后重试，例如：
dsh plugin --profile <your-profile> add https://github.com/Velestia-star/dsh-docdesk --registry=https://registry.npmmirror.com
若上次安装中断，可先移除再添加：
dsh plugin --profile <your-profile> remove dsh-docdesk
dsh plugin --profile <your-profile> add https://github.com/Velestia-star/dsh-docdesk --registry=https://registry.npmmirror.com
典型用法¶
- 在左侧栏打开 资料区。
- 点 Add files，搜索并勾选文档，点 Add selected。
- 拖动图标对齐槽位；右键空白框选多枚后成组移动，或拖向面包屑进入路径投放模式。
- New folder 建文件夹，把文档拖到文件夹图标上；双击文件夹进入，双击文档全屏阅读。
- 在阅读界面用标签切换文档；需要图表时在 Markdown 里写
chart或mermaid围栏块，由阅读器内联渲染。
chart 块示例（JSON 形式）：
```chart
{
"type": "bar",
"title": "Weekly documents",
"unit": "docs",
"data": [
{ "label": "Mon", "value": 3 },
{ "label": "Tue", "value": 5 }
]
}
```
首次使用会种子一份简短的 DocDesk guide；删掉后不会自动再加回。
适用场景与注意¶
适合：长期在 DSH 里沉淀多份 Markdown，希望用桌面式布局集中翻看、对比和深读（含表格、Mermaid、简单图表），又不想动工作区目录结构的用户。
注意：
- 插件以当前 DSH 进程权限运行；安装前请查阅源码与 MIT 许可证，确认读文件范围与 API 行为符合你的安全预期。列表与读取接口受 loopback / 配对设备约束，读取限定在扫描根目录与 Markdown 扩展名内，单文件预览上限 2 MB。
- 扫描会跳过
node_modules、.git等目录；单工作区有文档数、目录深度等上限（见 README「How it works」）。 - 资料区是 DSH 生态中的社区插件；SkillHub 等目录为独立社区站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-docdesk 把「智能体写出来的 Markdown」收成你可编排的桌面资料库：主动入库、网格摆放、全屏标签阅读与本地渲染图表，且默认不改写磁盘文件。若要查看条目说明或提 issue，可访问 SkillHub 目录页 与 GitHub 仓库。
