- DSH
- 0.1.5-alpha.2
- 系统
- Windows / macOS / Linux
- 风险
- high
本页目录（6）
DSH 生成的文件通常留在执行任务的 Session 文件系统中。0.1.5-alpha.2 可在右侧 Sidebar 预览支持的文件，并由模型通过 present 显式声明交付；点击卡片并不自动把文件下载到访问浏览器的设备。
先确认文件路径、当前查看的 Session 和 Host 在哪台机器上。本教程依据固定提交 b2e3b2a0125854567a4a5fcba75782e42fe84901 的第一方文档整理，未运行新版文件操作。新版选择见alpha.2 专题，默认安装基线仍为 rc.1。
文件路径、改动行和交付卡片有什么区别
| 页面中看到的内容 | 含义 | 不代表什么 |
|---|---|---|
| 回复中的文件路径 | 模型对文件位置的说明；精确匹配的引用可能成为链接 | 写出路径不等于文件实际存在或已交付 |
| 本轮文件改动 | 支持的文件工具成功创建或修改的文件 | 不保证覆盖所有 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、代码、纯文本 | 顺序分页；滚动到底或加载更多继续读取，代码可显示行号 |
| 完整读取后分页面展示，受 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 工作目录。
按症状排查
| 现象 | 检查顺序 | 何时停止 |
|---|---|---|
| 交付失败或文件不存在 | 核对 Session、路径、是否普通文件和工具结果 | 不知道文件归属时不批量移动或删除 |
| 权限不足 | 核对配置的文件系统与可访问位置 | 不为预览直接扩大整个机器权限 |
| 卡片存在但打不开 | 源文件是否被移动、删除或更换；当前 Session 能否访问 | 声明不是备份，不能保证可恢复 |
| 原生打开不可用 | Host 是否有桌面、关联应用与路径映射 | 远程浏览器不等于 Host 桌面 |
| 预览失败或超限 | 格式、编码、大小与 HTML 依赖 | 不用关闭安全限制作为默认修复 |
| 内容仍是旧版 | 检查文件变更提示并重新载入 | 先确认源文件已保存，不重复生成覆盖唯一文件 |
| 升级后整个侧栏失败 | 按程序、模块与插件分层检查 | 见升级验收；历史正文错误转会话排障 |
依据：预览规范（外部链接，在新标签页打开）、交付工具（外部链接，在新标签页打开）、Web 卡片与原生动作（外部链接，在新标签页打开）。本页没有安装执行第三方插件，也没有用真实文件验证上述动作。
来源与维护信息
本文根据以下原始资料整理。版本变化后，请以官方资料和页面标注的验证日期为准。