DSH 生成的文件在哪里:预览、打开与交付文件指南

说明 DSH 文件上传、侧栏预览与交付方式,按 Safari Iterator、文件资源服务不可用、路径和权限分流排查,区分 Host 打开与浏览器下载。

社区整理已复核原始来源
DSH
0.1.5-rc.1
系统
Windows / macOS / Linux
风险
high
本页目录(9)

DSH 生成的文件通常留在执行任务的 Session 文件系统中。0.1.5-alpha.2 可在右侧 Sidebar 预览支持的文件,并由模型通过 present 显式声明交付;点击卡片并不自动把文件下载到访问浏览器的设备。

预览打不开时,先记录浏览器与 DSH 版本,再确认文件路径、当前查看的 Session 和 Host 在哪台机器上。本教程依据固定提交 b2e3b2a0125854567a4a5fcba75782e42fe84901 的第一方文档整理,未运行新版文件操作。版本选择见更新指南,当前默认安装基线为 0.2.0-rc.2(2026-09-30 起);0.1.7 的文件预览变化见上游发行说明,本页主体仍按原版本范围。9 月 11 日新增的浏览器排查区分社区报告和固定源码,未运行浏览器对照测试。

0.1.6-alpha.2:Office 预览与文件差异

2026-09-18 固定源码复核;本节只适用于 alpha.2,下面的 rc.1 流程与支持表保持原版本范围。本站未运行 Office 转换或制作产品实测截图。

新版专属 Office 预览支持 .doc、.docx、.xls、.xlsx、.ppt、.pptx。Host 的 office-to-pdf 提供方通过随包选择的 LibreOffice kit 原生或 WASM 引擎转换,再在浏览器预览 PDF;它不查找系统 LibreOffice,也不在运行时下载转换引擎。不要将此推定为所有 Office 格式、在线文档编辑或无损排版保证。

现象检查与边界
提示预览服务未配置核对当前版本及 Web 组合中的 Office 提供方;安装系统 Office 不等于补齐该服务
转换失败、文件过大或超时先用无敏感小文件对照;默认源文件上限 50 MiB、输出 PDF 100 MiB,转换开始后期限 60 秒,不含排队等待
字体或排版不一致核对 Host 可用字体;OOXML 可报告缺失字体,二进制 doc/xls/ppt 没有同等缺字诊断
能预览但没有保存修改PDF 是预览结果,源文件编辑、保存/下载与交付仍需分别完成

文件改动卡片点击某一行会打开该轮次的逐文件差异审阅,支持单栏/并排和换行。它比较轮次前后记录的内容,不是每次编辑的完整时间线;二进制文件、超限文件不能当作普通文本逐行查看,计算超时可退化为整文件替换,界面最多显示 5000 行并提示。

差异记录属于当前 Host 进程生命周期,Session 释放或 Host 重启后先前轮次可能没有卡片与对比。查看差异不等于撤销、提交 Git 或备份;继续独立保存文件与版本记录。URL 浏览器模式与 HTML 文件预览是不同能力,本次未完成前者边界核对,不能套用下面 HTML 预览的限制或安全结论。

依据:预览侧栏(外部链接,在新标签页打开)、Office 转换(外部链接,在新标签页打开)、改动记录(外部链接,在新标签页打开)、差异界面(外部链接,在新标签页打开)。

0.1.5-rc.1:上传、读取、处理再交付

本节记录 0.1.5-rc.1 的上传流程;后文 0.1.5-alpha.2 段落是预览和交付的固定来源说明,不再代表当前默认通道。新版汇总说明包含通用文件上传,但不能因此称它刚在 alpha.2 之后新增。

  1. 在目标 Session 中,通过附件选择或页面拖放加入虚构的 example.txt。图片与文件按选择顺序出现在同一附件栏;核对目标 Session,别把另一个会话的上传状态当作本次文件。
  2. 观察进度;首次字节报告前可能显示不定进度,失败可重试。需要取消时使用界面上传控件,不以切换会话代替取消;切回时核对该会话的状态。取消不应被解释为已清理所有 Host 存储。
  3. 上传成功后再提交任务,要求模型读取已保存文件并概括三行内容。凭证属于具体 Session,上传成功不等于 prompt 已投递,更不等于模型已经读到正文。
  4. 若要产生新文件,要求在允许写入的工作区保存结果,再用 present 声明交付;按下文预览核对内容。
请读取本条消息附带的 example.txt,先说明是否成功读取。
成功后把三行摘要保存为 out/example-summary.md 并交付。
如果缺少读取或交付工具,请明确报告,不猜测附件正文。

上述是包含写操作的虚构任务示例,本站未运行。通用文件可以上传不代表任意模型都能解析 PDF、表格或压缩包;先确认格式、读取工具及权限。大小限制以当前界面和 Host 拒绝信息为准,本页不编造统一上传上限。

问题下一步
上传失败或被拒绝保留脱敏错误,核对界面限制、网络和当前 Session,再重试
取消或切换会话后状态不明返回原 Session 核对,不重复发送造成误判
上传成功但模型没读到检查消息是否已发送、附件路径与可见工具;不粘贴私密文件到公开报告
模型不能解析格式使用自己已确认可用的解析工具或转换为可读文本,不能只更换文件后缀
文件产生但无法交付核对 Session 文件系统是否可访问,按下文源文件和 Host 分流

上传不会自动让文件公开。present 仍不保存快照;Host 原生打开不等于浏览器下载。来源:固定上传服务(外部链接,在新标签页打开)、附件 UI(外部链接,在新标签页打开)、交付工具(外部链接,在新标签页打开)。

文件路径、改动行和交付卡片有什么区别

页面中看到的内容含义不代表什么
回复中的文件路径模型对文件位置的说明;精确匹配的引用可能成为链接写出路径不等于文件实际存在或已交付
本轮文件改动支持的文件工具成功创建或修改的文件不保证覆盖所有 shell 产物,也不等于最终交付
present 交付卡片模型已声明一个 Session 文件系统可访问的普通文件不保存文件内容,不是不可变快照

standard、ptc 与 cordis preset 提供 present。文件必须先存在;相对路径按 Session 工作目录解析。目录、缺失文件、最终路径为符号链接或访问被拒绝时会失败。Shell 私有沙箱中的临时文件需先放到 Session 文件系统可访问的位置,不能假设 Host 可以访问同名路径。

最小示例:生成并交付一份报告

下面是给模型的虚构任务示例,包含创建文件的写操作;只在允许写入的可丢弃工作区尝试,不用于验证旧会话恢复:

请在当前工作区创建 out/example-report.md,写三条虚构项目进度。
确认文件存在后,使用当前环境可用的 present 工具交付该文件,
并说明相对路径。如果没有该工具,请明确说明,不要声称已交付。

预期观察:文件生成成功、present 调用结束并显示已交付、收尾回复出现卡片。点击卡片后应能在侧栏读到三条内容。这里只给出操作与观察方法,不是本站已经执行成功的记录。

如果没有卡片,检查 preset、工具是否可见和调用结果;不能仅靠模型说“已完成”判断。父 Session 若要交付子 Agent 的文件,需要自行声明,而且必须可访问该文件。

预览、默认应用、定位和下载

动作实际位置与结果
点击卡片或打开按钮左侧在 DSH 右侧 Sidebar 预览源文件
打开菜单中的默认应用在运行 DSH 的 Host 上启动关联应用,需要 Host 桌面和合适应用
Finder / 文件资源管理器 / 打开所在文件夹在 Host 的文件管理器中定位,具体名称随系统变化
浏览器下载固定卡片和行内引用不会触发浏览器下载,不应把上面操作称为“已下载到当前设备”

远程手机或电脑访问服务器时,Host 原生动作不会启动访问设备上的应用。没有桌面的服务器会禁用原生打开菜单;桌面信息读取失败时可重试,文件系统不能映射到 Host 路径时可能提示使用侧栏预览。需要将文件带到另一设备时,另用自己部署中已确认的文件传输方式,本页不虚构统一下载按钮。

支持哪些预览

类型读取方式与边界
Markdown、代码、纯文本顺序分页;滚动到底或加载更多继续读取,代码可显示行号
PDF完整读取后分页面展示,受 Host 文件大小上限约束
HTML完整读取,脚本在独立沙箱 iframe 中运行;本地依赖支持有限
PNG、JPEG、GIF、WebP、BMP、ICO、SVG静态图片上下文,当前查看器不提供缩放与拖拽平移
未知扩展名纯文本兜底,仍可能因编码或二进制内容失败;不代表 Office 文档有专属预览

预览器不提供编辑。文件修改后如出现变更提示,重新载入以查看新内容;不把旧画面当作当前源文件。PDF、HTML、图片要取得完整字节,超限会拒绝,不是截断后显示。

HTML 可以运行任意网页吗

不能。固定实现使用 sandbox="allow-scripts",不包含 allow-same-origin;预览脚本不能取得父应用源或运行时文件读取接口。仅打包直接引用的经典 .js 和 .css,上限为单个 4 MiB、合计 32 MiB、64 个资源。

本地模块 import、CSS url() / @import、动态 fetch 不通过 Host 文件读取桥接;HTTPS 等资源仍由浏览器按自身网络规则处理。因此不是完全离线,也不保证任意应用可以预览。失败时检查依赖及格式,不要求关闭沙箱或放宽 Host 权限。

交付后源文件还能改吗

可以,但会改变之后打开的内容。present 只记录路径和可选说明,不复制文件;移动或删除后可能打不开。需要保留交付版本时,在自己允许的位置另存版本副本并一起备份,不依赖卡片充当归档。

Session ZIP 导出包含交付声明,不包含交付文件内容。复制 Session 到其他设备或恢复旧会话,不保证源文件仍然可访问;相对路径还取决于当前查看的 Session 工作目录。

浏览器报错:先做同一文件对照

错误原文已报告环境与证据下一步
Can't find variable: Iterator#6083(外部链接,在新标签页打开) 最初为 Safari 17.6 / alpha.2;另有 rc.1 重装后仍失败和换浏览器后恢复的回复保存错误,在同一 Host 下用当前维护的浏览器对照;不能仅凭模块名归因于第三方插件
文件资源服务不可用 / The file resource service is unavailable.#6217(外部链接,在新标签页打开) 报告 rc.1、Windows 10、Chrome 125 下失败,且未发出文件请求区分资源解析与文件读取;记录浏览器版本及是否发出请求,不直接重装 Host

这些是报告者的环境与结果,不是本站兼容矩阵。本站核对的 rc.2 资源源码(外部链接,在新标签页打开)中,protocolOf() 仍依赖 new URL(address) 的 hostname 识别资源协议;这一事实不能独立证明所有旧浏览器都失败,也不能把帖子提到的版本阈值当作官方最低要求。rc.2 发行说明(外部链接,在新标签页打开)中的文件卡片优化不是浏览器兼容修复声明。

  1. 记录浏览器、系统、DSH 版本及错误原文,判断整个侧栏是否失败,还是只有某一份文件失败。
  2. 保持同一 Host、同一 Session 和同一份非敏感文件,在当前维护的浏览器中对照。记录结果,不把一次恢复推广为所有浏览器均兼容。
  3. 若仍失败,核对源文件是否存在、当前 Session 的路径与访问权限。只有单份失败时再检查格式、编码和大小。
  4. 在浏览器网络面板观察是否发出文件请求,并记录状态码;没有请求可能是前端阶段失败,不能据此断定 Host 已损坏。有请求但失败则结合对应时间的 Host 脱敏日志判断。
  5. 原因仍不清楚时,使用可复制故障记录保留对照结果。不要公开 Cookie、请求授权头、完整私有路径或原始日志。

排查浏览器故障不需要先清空数据目录、批量卸载插件或手改安装包。若错误是历史迁移或新会话预设挂载,转到会话异常分流。

按症状排查

现象检查顺序何时停止
Iterator 未定义 / 文件资源服务不可用按上节记录浏览器与同一文件对照结果未确认原因时不删数据或把 rc.2 当作通用修复
交付失败或文件不存在核对 Session、路径、是否普通文件和工具结果不知道文件归属时不批量移动或删除
权限不足核对配置的文件系统与可访问位置不为预览直接扩大整个机器权限
卡片存在但打不开源文件是否被移动、删除或更换;当前 Session 能否访问声明不是备份,不能保证可恢复
原生打开不可用Host 是否有桌面、关联应用与路径映射远程浏览器不等于 Host 桌面
预览失败或超限格式、编码、大小与 HTML 依赖不用关闭安全限制作为默认修复
内容仍是旧版检查文件变更提示并重新载入先确认源文件已保存,不重复生成覆盖唯一文件
升级后整个侧栏失败按程序、模块与插件分层检查见升级验收;历史正文错误转会话排障

依据:预览规范(外部链接,在新标签页打开)、交付工具(外部链接,在新标签页打开)、Web 卡片与原生动作(外部链接,在新标签页打开)。本页没有安装执行第三方插件,也没有用真实文件验证上述动作。

来源与维护信息

本文根据以下原始资料整理。版本变化后,请以官方资料和页面标注的验证日期为准。

完成当前任务后

按结果继续,不要停在文章末尾