Studio 是 DataBuddy 的统一开发工作台。本节介绍 Studio 总览页面的整体界面布局，以及文件组织、检索、收藏与回收站等基础操作。
概述
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 创建、源代码管理操作
