dsh-reader-workspace

使用方式

在任意 DSH 工作区直接说“把这段整理到课堂笔记知识库”，Agent 会先查授权知识库，再把文档直接写到你指定的位置。新建操作返回稳定文档 ID、版本号和打开链接。编辑现有文档时必须先读取并携带版本号；出现冲突时重新读取和合并。图片需要通过 reader_upload_image 存成文档资源，不能把临时截图路径留在正文里。

可选的 source 记录只用于说明内容当时从哪个工作区、文件或会话来。它是私人历史记录，不参与同步，也不会出现在公开页面。知识库本身仍由 Reader 管理；工作区只是内容来源和本次会话的上下文。

在 DSH 右侧栏的“开始”页点击“阅读器”，会在原生侧栏标签中加载 Reader 首页。Reader 顶部的外部打开图标可用独立浏览器打开同一页面。Reader 页面本身仍是同一套网页，插件不会复制界面或知识库，也不依赖 DSH 的可选通用浏览器插件。Agent 返回的文档链接也可以从会话中打开。针对侧栏尺寸的编辑、上传和导出仍需在真实 DSH 桌面宿主里验证。

本机管理界面的文档「···」菜单有文件定位入口；目录与知识库菜单可打开所在位置。macOS 使用访达，Windows 使用文件资源管理器；iOS 和远程访客不显示本机文件管理入口。工作区浏览记录也可定位原文件：新记录保存 DSH 返回的本机路径，旧记录在 DSH 内点击时即时查询。跨设备工作区路径无法在另一台设备的文件管理器中定位。

iOS 首次打开插件时需填入可从该设备访问的 HTTPS 阅读器地址。临时公开链接可用于访客阅读；远程管理编辑仍需单独的安全连接方案，不能把本机管理地址直接公开。

安装此插件后，DSH 文件列表中的 Markdown 默认在 Reader 右侧预览。相对链接继续打开工作区文件，相对图片从当前工作区读取；预览不会移动原文件。本机管理者打开预览时，正文与已读取的图片会按来源写入 Reader 的“工作区浏览记录”，重复打开会更新快照；远程 Reader 不会自动记录工作区文件。浏览记录可以回看、归档、恢复，也可以从快照收录为默认私有的正式文档。点击 DSH 预览中的“收录到知识库”会重新读取最新源文件与本地图片。此预览是只读的，收录后编辑知识库中的副本。

入口默认指向 http://127.0.0.1:8090/。界面连接地址在 DSH 标签内设置；Agent 工具连接地址由 READER_URL 控制，两者目前需要分别设置。