> ## Documentation Index
> Fetch the complete documentation index at: https://docs.happycapy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Files

> 集中查找上传文件、输出文件和 Project 文件

## Files 是什么

Files 是 Happycapy 沙盒里的文件浏览器。你可以用它查找上传素材、Project 文件，以及 Happycapy 工作时创建的输出文件。

当任务会生成素材、报告、代码、数据导出、图片或视频时，Files 特别有用。

## 打开 Files

<div style={{ borderRadius: '14px', border: '1px solid rgba(45, 36, 27, 0.12)', boxShadow: '0 18px 46px rgba(56, 38, 20, 0.09)', overflow: 'hidden', background: '#FFFFFF', marginBottom: '24px' }}>
  <div style={{ padding: '12px 16px', borderBottom: '1px solid rgba(45, 36, 27, 0.08)', background: '#FFFFFF' }}>
    <span style={{ display: 'block', color: '#2E2929', fontFamily: 'Instrument Serif, Georgia, "Times New Roman", serif', fontSize: '28px', fontWeight: 400, lineHeight: '1' }}>Files</span>
    <span style={{ display: 'block', marginTop: '6px', color: '#8A8178', fontFamily: 'Instrument Serif, Georgia, "Times New Roman", serif', fontSize: '18px', fontWeight: 400, lineHeight: '1.2' }}>浏览上传文件、输出文件和 Project 文件。</span>
  </div>

  <img src="https://mintcdn.com/happycapy/9SccTkPwiYpehlgU/images/features/files-browser.png?fit=max&auto=format&n=9SccTkPwiYpehlgU&q=85&s=ec788d745afc8278c71d79afc3029bc2" alt="Files 文件浏览器" style={{ maxWidth: '100%', display: 'block', margin: '0 auto' }} width="1586" height="1016" data-path="images/features/files-browser.png" />
</div>

打开 **Settings**，然后点击 **Files**。

你可以浏览：

* **Home** — 沙盒中的文件
* **Projects** — 按 Project 分组的文件
* **Skills** — 已安装的 Skill 文件

## 查找和管理文件

使用搜索按文件名查找文件。需要浏览图片、文件夹或文件详情时，可以在网格视图和列表视图之间切换。

你可以在文件浏览器里打开文件、预览支持的格式、重命名、移动、删除或下载文件。

## 上传文件

点击输入框里的 **+** 附加文件，或直接把文件拖进对话。Happycapy 可以把这些文件作为任务上下文。

Happycapy 可以处理多种常见文件类型，包括文档、表格、演示文稿、图片、视频、压缩包、代码文件、Markdown、CSV、JSON 等。不确定时，可以直接上传文件，让 Happycapy 读取或检查。

## 处理输出文件

Happycapy 创建的文件会保存在沙盒中，并且可以在 Files 里找到。

例如，你可以说：

```text theme={null}
把这个 Project 里的图片打包成 zip 文件，让我可以下载。
```

## Files 和 Projects

Project 文件会留在对应的 Project 里。同一个 Project 内的 sessions 可以读写同一批文件，所以你可以跨 sessions 继续工作，不需要重复上传同一批文件。

查看 [Projects](/zh/features/projects)，了解 Projects 如何组织 sessions 和文件。

## 通过 Project 或 session 链接定位文件

当对话链接符合以下任一格式时，`/s/` 后面的值就是 Project ID。后续在 Files 中查找 JSONL 日志或 workspace 文件时，使用这个 Project ID。

<div style={{ border: '1px solid rgba(250, 161, 92, 0.44)', borderRadius: '14px', padding: '18px 22px', overflowX: 'auto', fontFamily: 'ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", monospace', fontSize: '0.95em', lineHeight: '1.8', whiteSpace: 'nowrap' }}>
  <div>对话链接</div>
  <div>https\://<a href="https://happycapy.ai" style={{ fontWeight: 400 }}>happycapy.ai</a>/s/<strong>d94c8b54-161d-4278-a3f5-16e5046d66cd</strong></div>

  <br />

  <div>带子 session 的对话链接</div>
  <div>https\://<a href="https://happycapy.ai" style={{ fontWeight: 400 }}>happycapy.ai</a>/s/<strong>d94c8b54-161d-4278-a3f5-16e5046d66cd</strong>?sub=48c366cc-a0e0-4bf4-ac56-4fa52c7cd7a7</div>

  <br />

  <div>Project ID</div>
  <div><strong>d94c8b54-161d-4278-a3f5-16e5046d66cd</strong></div>
</div>

### 查找 JSONL 日志

打开 **Files**，进入 `Home > .claude > projects`，搜索链接里的 **Project ID**。

匹配到的文件夹里会包含这个 Project 下各个对话的 `.jsonl` 日志。每个 `.jsonl` 对应一个对话，包括主 session 或子 session。

### 查找工作区文件

打开 **Files**，可以用两种方式查找：

* 打开 **Projects**，搜索同一个 **Project ID**。
* 或进入 `Home > a0 > workspace`，搜索同一个 **Project ID**。

匹配到的 Project 或 workspace 文件夹里，是 Happycapy 在这个 Project 下创建或修改过的文件。

### 如果 session 出现问题

你可以自己打开这些文件查看，也可以打开一个新 session，对 Happycapy 说：

```text theme={null}
在 /home/node/.claude/projects/ 下找到 d94c8b54-161d-4278-a3f5-16e5046d66cd（Project ID）对应文件夹里的 JSONL 日志，先备份它，再诊断发生了什么，修复问题，并帮我继续这个对话。
```