# 工作目录

> Cube Agent 2.2.0 正式版（构建 2002007）使用说明。
> 分类：Web 与局域网。内容基准：2026-11-07。
> 网页：https://cubeagent.app/docs/script_workspace/

## 功能说明

工作目录管理代码解释器运行产生的文件。AI 在本机代码工作台（Python 与 JavaScript）中生成的网页、图片、文档、数据与代码等产物都会保存在这里。AI 将文件写入 outputs/ 后，整条回复结束时会在对应消息显示「生成文件」卡片。每条消息聚合为一张卡片，默认折叠，展开后每页最多显示 3 个文件，可翻页预览、保存或分享。其他工作区目录里的文件可让 AI 使用文件操作的 deliver 交付：保留原文件，复制到 outputs/，并同步显示在卡片和工作目录。交付不覆盖已有的同名文件；后续修改请编辑 outputs/ 内的交付文件。文件操作 write 仅传文件名时默认写入生成文件；显式指定路径则保留原位置。工具会区分“已写入工作区”和“已交付”，不能用 AI 的文字承诺代替真实文件结果。在会话文件中使用“浏览工作目录”进入全部工作区文件，再用“返回会话文件”返回；可直接导出，或在文件菜单选择“添加到生成文件”。手动添加保留原文件，显示在生成文件列表中。

## 生成 Word、Excel 和 PPT

在当前会话启用 **Office 文档**，可直接要求 AI 生成 Word 报告、Excel 预算表或 PPT 汇报。无需另开技能和代码工作台。生成、保存到本机和系统分享均无需 Pro；新增到跨会话共享文件、发布到公网另按会员规则处理。完整步骤见「如何生成 Word、Excel 和 PPT 文件？」。

## 两级入口

- **会话级（免费）**:在聊天页菜单打开，查看生成文件和全部工作区文件；已有共享文件可免费查看、导出和删除。
- **全局入口**:在 **设置 → 内容与文件 → 文件空间** 打开。所有用户可清理已有共享文件；跨会话集中浏览产物、新增与整理共享文件需要 Pro。已有公网发布仍可在“我的分享”撤销，不要求续费。

## 浏览文件夹时批量删除

在工作目录的文件夹浏览中，可长按可删除项目，或从菜单进入选择模式，再勾选文件与文件夹。**全选** 只选当前可删除项目，只读输入文件不会被纳入。删除前核对文件数量与范围，目录会连同其内容处理；包含子项目在内单次最多 500 项，较大范围需分批。

确认后可以取消后续处理，已删除的内容不会自动恢复。若文件内容发生变化、权限变化或部分项目失败，会给出部分完成结果；请按实际结果检查剩余文件，不要把失败提示理解为整批都没有执行。

## 已发送的输入文件

会话输入文件复用已发送附件的原件，按会话展示；可只读浏览、按格式预览和导出。同名文件通过别名区分，不表示原件已被重命名。输入文件不能像生成产物一样直接编辑或删除；需要修改时先保存副本到工作目录。能浏览原件不代表模型能解析该格式。

## 导入的文件放在哪里

会话文件根目录有两个文件夹：**输入文件** 是已作为附件发送的原件，只读；**生成与导入的文件** 放 AI 生成的文件，以及你用 **导入文件**（含 ZIP）或输入框的 **添加到会话文件** 手动放进来的文件，可编辑、删除、导出。导入的文件会和 AI 生成的文件放在同一处，同名时自动加序号，不会覆盖；它们不属于「输入文件」，也不是 AI 生成的结果。

## 文件操作与预览

文件会按类型展示。会话工作目录可导入普通文件或 ZIP；ZIP 会解压到独立目录，适合把完整项目交给 AI 继续修改。点击文件可直接预览：HTML 直接在内置预览中打开（支持同目录的样式、脚本等相对资源，无需为此启动 Web 服务器），常见文档 / 图片使用系统预览，其它格式可选择系统打开方式。更多菜单支持保存、存入共享文件、分享、预览链接、重命名与删除；整个目录也可下载为 zip。存入共享文件时可选择目标目录或新建文件夹；共享文件更多菜单支持“移动到…”，长按多选后可批量移动。同名可选择保留两份或跳过，原文件不会被覆盖。移动后旧路径访问链接失效，文件内相对引用可能需要调整。长按文件行可进入多选模式，批量删除选中的文件或目录（会话产物与共享文件均支持），删除前会再次确认。

## 文件夹与 ZIP 导入

在 **共享文件** 的上传菜单中选择 **上传文件夹** 或 **从 ZIP 导入文件夹**。支持文件夹选择的设备可直接选目录；手机和不支持直选的设备会引导使用 ZIP。目录导入保留子目录、空目录、隐藏文件和二进制文件，同名根目录自动避让，不合并覆盖已有内容。

共享文件的 **上传文件** 会把 ZIP 当普通文件保存；只有选择 **从 ZIP 导入文件夹** 才展开为目录。会话文件的 ZIP 导入则会解压到独立目录，两者用途不同。

共享单文件与输入 ZIP 上限为 200 MiB；共享目录累计最多 500 MiB、10000 项、64 层。会话文件导入沿用 500 MiB 限制。目录导入先准备完整内容再放入目标位置，失败或取消会清理暂存，不留下半个目标目录。

## 批量进度与取消

会话文件与共享文件的普通上传不再由应用限定单次 20 个，实际可选数量取决于系统文件选择器，并继续受容量限制；聊天附件与知识库自己的数量限制不变。

选择多个文件后逐项导入，显示当前文件和进度；某一项失败会继续后续项。普通批次取消会在当前项处理完后停止后续导入，已完成文件保留。结果区分成功、失败和未开始，失败项可重新选择重试；离开页面也会停止后续项。

标题栏搜索用于查找当前目录，结合类型筛选决定全选范围；改变搜索或切换目录会清空旧选择。目录导航可以返回上级或指定祖先，刷新收在目录菜单中。

## 共享文件与本机链接

共享文件单文件存入上限为 200 MB，本机上传、会话产物存入、AI 代办存入与 Web 分块上传保持一致。存入成功不代表所有读取方式都支持同样大小：本机 Web 访问链接目前支持最大 50 MB 的文件，较大文件请在应用内打开；AI 读取、文档解析和预览仍受各自处理能力限制。

共享文件用于本机跨会话复用，存入不等于公网发布。新增、上传、新建文件夹、重命名与移动需 Pro；已有文件的查看、导出、删除免费。AI 代办存入、新建目录和移动需要 Pro 与用户授权，可选择本次允许或始终允许；AI 删除共享文件不需要 Pro，复用同一授权，始终允许后不再额外确认。授权可在设置中撤销。其他普通会话可按需读取共享文件，无需启动 Web 服务，无痕会话不读取。访问链接需要身份验证，且依赖本机 Web 服务和设备在线；可根据网络环境选择域名、IPv6、局域网或本机地址。需要匿名公网访问时，请单独使用“发布到公网”。

## 发布到公网（Pro）

会话工作目录底部提供 **发布到公网**。点击后进入选择模式，勾选要发布的文件（支持全选），再经底栏 **发布所选** 提交；只有勾选的内容会上传，网页引用的样式、脚本等依赖文件需一并勾选。站点优先以 `index.html` 作为入口；没有入口页时会生成目录索引。站点提交后会经过内容审核，通过后可长期用公网链接访问，不要求你的设备或本机 Web 服务保持在线。

所有发布记录统一在 **设置** 顶部会员账号卡进入 **会员中心 → 账号与服务 → 我的分享 → 站点发布** 管理，可查看审核状态、复制链接或撤回。

## 引用文件与查看改动

在输入框用 **@** 把这里的文件直接交给 AI，见「怎么让 AI 直接用某个文件或技能？」；AI 改了哪些文件、改了哪几行，见「怎么查看 AI 改了哪些文件？」。

## 最佳实践

- 只查看当前会话结果时使用会话级工作目录，无需 Pro。
- 临时在同一网络分享时可用预览 / 公共链接；需要对方随时从公网访问时使用站点发布。
- 不要发布含 API Key、个人资料或其它敏感信息的文件；不再需要时及时撤回。
- 脚本产物会占用本机存储，可定期在文件空间或存储管理中清理。