跳转到主要内容

​
Files 是什么

Files 是沙盒的完整文件浏览器。点击左侧边栏的 Files 即可打开。 你的沙盒是一个持久化的 Linux 环境——Happycapy 创建的每个文件、运行的每个脚本、生成的每个输出都保存在这里。Files 让你直接访问这个文件系统。

​
左侧导航

左侧面板分三个区块： Home — 沙盒文件系统的根目录。配置文件、已安装的工具、对话输出、Happycapy 在你各次对话中创建的文件，都在这里。 Desktops — 按桌面整理的文件视图。如果你有多个桌面对应不同项目，这个视图能帮你快速看到哪些文件属于哪个桌面。 Skills — 沙盒中已安装的 Skills。可以在这里浏览 Skill 文件，查看某个 Skill 的内容或复制它的配置。

​
查找文件

右上角的 搜索框 支持按文件名搜索。文件列表会显示名称、修改日期和文件大小。 搜索框旁边的图标可以切换网格视图和列表视图。

​
找到输出文件

Happycapy 完成任务后产生的文件——图片、文档、数据导出、处理过的视频——都会保存在沙盒里。在 Files 里找到它们，右键下载到本地，或者直接让 Happycapy 打包： 
把 outputs 文件夹里的图片打包成 zip 文件，让我可以下载

​
上传文件

点击对话输入框旁的 + 按钮，从本地选择文件上传到对话。上传的文件会放在沙盒 Home 目录的 uploads/ 文件夹中。
支持的格式：图片（JPG、PNG）、文档（PDF、Word、Excel）、视频（MP4）、数据文件（CSV、JSON）、代码（所有语言）。单个文件最大 100MB。

​
进阶：配置你的项目工作区

每个 Desktop 在沙盒里有一个专属的项目目录，路径为 /home/node/a0/workspace/<desktop-id>/。同一 Desktop 下的所有 session 共享这个目录。目录里的所有文件都可以直接编辑——在 Files 里导航到这里，改任何东西都行。 这让你对 Claude 在这个 Desktop 里的行为有完整的控制权。一个结构清晰的项目工作区长这样： 
你的项目/
├── CLAUDE.md              ← 对这个 Desktop 里 Claude 的持久指令
├── README.md
│
├── .claude/
│   ├── settings.json      ← Claude Code 配置
│   ├── hooks/             ← 自动化触发器和检查
│   └── skills/            ← 这个项目专用的 Skills
│       └── my-skill/
│           └── SKILL.md
│
├── docs/
│   ├── architecture.md
│   └── decisions/
│
└── src/                   ← 实际的项目代码
    └── api/
        └── CLAUDE.md      ← 这个模块的子上下文
CLAUDE.md 是最有用的文件。把项目背景、编码规范和持久指令写进去。Claude 在这个 Desktop 的每次 session 开始时都会读取它，你就不用每次重新介绍项目了。 .claude/skills/ 存放这个项目专用的 Skills，只对这个 Desktop 的 session 生效，不会全局安装。 .claude/hooks/ 存放自动化脚本，在特定触发条件下运行——比如每次编辑代码后自动跑测试。 对话历史单独保存在 /home/node/.claude/projects/ 下，按 Desktop 分文件夹，格式为 .jsonl 文件。
如果某个 session 出现异常，可以查看它的日志。从 URL 里复制 session ID——也就是 /s/ 后面的 UUID——然后开一个新 session，说：
在 /home/node/.claude/projects/ 下找到 session <id> 的 JSONL 日志，备份它，分析哪里出了问题，修复后让那个对话继续进行。
Claude 会找到对应文件，备份原始日志，读取对话历史，修复问题——修复后，原来那个对话就可以重新正常使用了。