概览
@crosery/dsh-viewer
README / ZH
插件文档
目录摘要
dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义;完整 README 请查看源仓库。
在 GitHub 阅读完整 READMELIMITATIONS
已知限制
- **只接受本地文件路径**,不接受 URL。规范值的形状留了扩展位,但 v1 没做。 - **视频/音频的时长和分辨率不在卡片头部**——那需要 ffprobe。`<video>` 元素自己会显示。 - **插件自己读取只有附件的图片时(0.1.5 及以前),对象 URL 要到插件卸载才回收**。上界是这期间显示过的不同附件数量,与出厂对话图库按会话持有的上界同量级。0.1.7 起这些图片由对话自带的加载器持有。 - 远程 workspace(后端不提供 `processPath`)上,非图片媒体没有可用通道,卡片如实显示「此文件系统后端不提供可预览的本地路径」。 - 未做视频转码:浏览器放不了的编码(例如 `.mov` 里的 ProRes)会落到 `<video>` 的降级文案上。 - 桌面版里「在新标签打开」换成**「在侧边栏预览」**(harness 自带的预览,PDF 用 PDF.js):桌面窗口会静默拒绝指向应用 URL 的新标签。卡片里的内容——图片、播放器、PDF 与文档内嵌框——与 web 上完全一样。 - **轮次尾部需要 0.1.6 起的列表形态。** 在 0.1.2–0.1.5 上,折叠(`compact`)后的已完成轮次会把卡片留在折叠区里;想让它们保持展开,把对话视图切到 `normal`。在 0.1.6 的 `normal` 视图下,卡片会同时出现在轮次里和尾部。 - 用户展开一个已折叠的轮次时,其中展示过的文件会出现两次——工具行里一次、尾部一次——与 harness 自己的交付文件卡片相同。 - 尾部靠对话自己的过程锚点(它的 `turn-process` 轮次数据)识别插话过的轮次。如果将来的对话不再发布这份数据,插话过的轮次会把卡片显示两次——展开的工具行里一次、尾部一次——而不是丢掉它们。
