一、概述
Studio 在同一个界面中支持 Notebook、SQL、Python、Markdown、CSV 等多种文件类型的开发，覆盖 Notebook、SQL、Python 等所有开发场景，统一提供目录、新建、检索、收藏夹与回收站等交互。Studio 目录按用户视角组织，文件之间通过 ACL 权限控制访问范围。
二、前提条件
·已加入目标工作空间，且具备 Studio 模块的访问权限。
·工作空间已绑定计算资源（运行 Notebook / Python / SQL 文件时使用）。
·如果需要使用 Git 文件夹，工作空间已配置 Git 连接，且当前用户已完成个人 Git 配置。
三、Studio 目录结构
Studio 目录按以下四个区域组织：
| 区域 | 说明 | 权限 |
| Workspace | 默认展示，存放所有成员在工作空间内创建的开发文件。 | 默认仅创建人和工作空间管理员可访问，可通过 ACL 授权给其他用户。 |
| GitFolder | 工作空间配置 Git 连接后展示，目录内容与远程 Git 仓库同步。 | 默认仅创建人可访问，不支持单独授权。 |
| 收藏夹 | 当前用户收藏的文件夹与文件，跨区域聚合展示。 | 收藏夹归当前用户所有。 |
| 回收站 | 当前用户从其他区域删除的对象，支持恢复或彻底删除。 | 回收站归当前用户所有。 |
注意：说明：
注意：Notebook、SQL、Python、其他文件均可放在同一个本地文件夹下。文件类型由扩展名识别（如 .ipynb、.sql、.py、.sh、.csv、.json、.yaml、.md、.txt）。
四、步骤 1：浏览 Studio 总览页面
1. 点击 Studio 功能模块，默认打开「Workspace」目录。
2. 用户可以在左侧目录「Workspace」「GitFolder」「收藏夹」「回收站」之间切换，按层级下钻查看子文件夹。
3. 单击文件夹名称，在右边可以看到文件夹下的子文件夹和子文件。
五、步骤 2：新建文件夹与文件
1. 在页面右上角单击 + 创建 。
2. 在弹出的菜单中选择新建对象：
·文件夹 ：用于组织文件。
·Notebook ：以 .ipynb 结尾的开发文件。
·SQL ：以 .sql 结尾的脚这篇件。
·Python ：选择文件，扩展名以 .py 结尾。
·文件 ：手动输入扩展名，支持 .sh、.csv、.json、.yaml、.md、.txt 等。
·仪表盘 ：跳转到「仪表盘」模块，并自动创建新仪表盘。
·模型实验 ：跳转到「模型实验」模块，并打开新建机器学习实验页面。
1. 输入名称并选择父文件夹，单击 确定 。
六、步骤 3：上传文件
1. 在目标文件夹-更多操作中，选择 上传文件 。
2. 选择本地文件，单击 打开 。
3. 上传后的文件出现在目标文件夹下。.zip、.pdf 等不支持在线打开的文件类型，单击后则会提示「无法预览」。
七、步骤 4：检索文件
1. 在页面右上角单击 检索 。
2. 在顶部检索框中输入文件名关键字。检索范围默认为当前目录。
3. 检索结果将显示在检索框下方，可以进行进一步选择。
八、步骤 5：文件操作
| 对象 | 支持操作 |
| 文件夹 | 新建文件夹 / Notebook / SQL / 文件、复制路径、重命名、移动、上传、权限配置、删除、收藏 / 取消收藏 |
| 文件 | 复制路径、重命名、移动、复制、下载、权限配置、收藏 / 取消收藏、删除 |
·复制路径 ：返回完整路径，如 /workspace_1/your_username/folder_1/file_1.ipynb，可粘贴进 Notebook 中通过 %run 或 import 引用。
·删除 ：进入回收站；可在「回收站」恢复或彻底删除。
九、步骤 6：管理收藏夹与回收站
·收藏夹 ：列表展示对象名称、类型、收藏时间、原始路径，支持按类型筛选，支持取消收藏与批量取消。
·回收站 ：列表展示对象名称、类型、删除时间、原始路径，支持按类型筛选与按删除时间排序，支持恢复、批量恢复、彻底删除、批量删除。
·备注：恢复时如源路径不存在，需重新选择父文件夹；如目标路径已有同名文件，需重命名。
十、步骤 7：进入 Studio IDE
进入 Studio IDE 后，界面分为三栏：
·最左侧：功能侧栏，依次为 Studio 目录 、数据目录 、Git 源代码管理 。
·中间：当前侧栏对应的目录或检索结果。
·右侧：编辑器主区域，按 Tab 形式打开多个文件。
注意：Studio 目录仅支持新建文件夹、Notebook、SQL、Python 和其他文件类型，不支持新建仪表盘和模型实验。其余操作与总览页面基本相同。
十一、新建对象命名规则
| 参数 | 说明 | 是否必填 | 默认值 |
| 名称 | 文件夹或文件名，支持中英文、数字、下划线、短横线、连字符、点、空格和冒号。 | 是 | 无 |
| 扩展名 | 仅在选择 新建文件 时需要，决定文件类型。 | 是 | 无 |
| 父文件夹 | 文件所在路径。Git 文件夹仅在工作空间配置 Git 连接后可选。 | 是 | 当前所在目录 |
十二、资源配额
| 项目 | 限制 |
| 单文件大小（页面创建/上传） | 500 MB |
| 单文件大小（OpenAPI 创建/上传） | 10 MB |
| 开发目录深度 | 不超过 10 层 |
| 文件名称长度 | 不超过 255 字符 |
| 单层目录下文件数量 | 不超过 2000 个 |
十三、使用限制
·不同模块（Studio、Workflow）目录互相隔离；Studio 中的 Notebook 文件不能直接作为调度任务运行，需要在 Workflow 中创建任务并引用。
·Git 文件夹下的文件不支持单独授权；如需精细化控制，请放在本地文件夹下。
·.zip、.pdf 等二进制文件可上传与下载，但不支持在线打开。
十四、常见问题
Q1：删除的文件能找回吗？
可以。删除的文件夹与文件都会进入个人回收站，可在回收站中选择 恢复 。彻底删除后不可恢复，请谨慎操作。
Q2：他人创建的文件我能看到吗？
·在 Workspace 中，如果你是 Workspace Admins，则可以看到他人文件；如果你不是 Workspace Admins，但对方通过 ACL 授予了「查看、运行、编辑、管理」权限，也可在你的目录中看到对应文件。
·在 GitFolder 中默认看不到他人文件，如登录远程 Git 仓库，则所有工作空间成员均能看到所有文件。
Q3：单层目录下文件数量超过 2000 怎么办？
请按业务逻辑拆分子文件夹。建议按「场景、主题、日期」三层组织，避免在一个目录下堆放过多文件。
十五、相关文档
·文件权限
·Git 初始化配置 / GitFolder 创建、源代码管理操作
·数据目录导航
·设置 Git 连接