---
title: "DSH 生成的文件在哪里：预览、打开与交付文件指南"
seo_title: "DSH 生成的文件在哪里：预览、打开与交付文件指南"
description: "说明 DSH alpha.2 的文件路径、侧栏预览、present 交付卡片与 Host 打开方式，解释下载区别、源文件保留及格式和权限排障。"
canonical: https://52dsh.com/tutorials/dsh-file-preview-delivery/
authors: ["52DSH 编辑部"]
audience: []
outcomes: []
prerequisites: ["已记录实际运行版本和 Profile","在独立数据副本中评估预发布能力"]
difficulty: intermediate
estimated_action_time: null
next_steps: null
published_at: 2026-09-10
updated_at: 2026-09-10
verified_on: 2026-09-10
maintenance_status: community
verification_level: source_reviewed
risk_level: high
dsh_version: 0.1.5-alpha.2
plugin_id: null
tutorial_kind: null
related_plugin_url: null
---

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

说明 DSH alpha.2 的文件路径、侧栏预览、present 交付卡片与 Host 打开方式，解释下载区别、源文件保留及格式和权限排障。

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

先确认文件路径、当前查看的 Session 和 Host 在哪台机器上。本教程依据固定提交 `b2e3b2a0125854567a4a5fcba75782e42fe84901` 的第一方文档整理，未运行新版文件操作。新版选择见[alpha.2 专题](/tutorials/deepseek-harness-0-1-5-alpha-2/)，默认安装基线仍为 rc.1。

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

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

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

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

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

```text
请在当前工作区创建 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 工作目录。

## 按症状排查

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

依据：[预览规范](https://github.com/deepseek-ai/deepseek-harness/blob/b2e3b2a0125854567a4a5fcba75782e42fe84901/packages/client/ui-sidebar-documentpreview/README.zh.md)、[交付工具](https://github.com/deepseek-ai/deepseek-harness/blob/b2e3b2a0125854567a4a5fcba75782e42fe84901/packages/fs/tool-present/README.zh.md)、[Web 卡片与原生动作](https://github.com/deepseek-ai/deepseek-harness/blob/b2e3b2a0125854567a4a5fcba75782e42fe84901/packages/client/ui-deliverables/README.zh.md)。本页没有安装执行第三方插件，也没有用真实文件验证上述动作。

## 原始来源

- https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.5-alpha.2
- https://github.com/deepseek-ai/deepseek-harness/blob/b2e3b2a0125854567a4a5fcba75782e42fe84901/packages/client/ui-sidebar-documentpreview/README.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/b2e3b2a0125854567a4a5fcba75782e42fe84901/packages/fs/tool-present/README.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/b2e3b2a0125854567a4a5fcba75782e42fe84901/packages/client/ui-deliverables/README.zh.md