文件

先确认文件来源

Web 工作台显示的是服务端项目资料；桌面版可能同时显示本地目录、Git 工作区或 GitLab 资源。文件列表相同并不表示文件已经同步到另一端。

定位并预览文件

1. 打开项目工作区，先确认项目名称和当前文件来源。
2. 在文件树展开目录，使用搜索或排序缩小范围。
3. 单击文件查看预览。文本、Markdown、JSON、CSV、Office 文档和图片等类型会使用对应预览器；不支持在线预览的文件使用下载入口。
4. 预览前检查路径、大小和最后更新时间，避免编辑同名但来源不同的文件。

编辑并保存 Markdown 或文本

1. 在预览工具栏选择“编辑”，确认文件路径和编码。
2. 修改前先阅读上下文，保留标题层级、表格列和已有链接。
3. 保存前检查差异，确认没有误删内容或把密钥写入文档。
4. 出现版本冲突时，先打开最新版本，对比双方改动并合并，再重新保存；不要直接覆盖他人的新版本。

上传、下载和覆盖

上传前确认目标目录、文件名和大小限制。已有同名文件时，先选择“比较”或“另存为”；只有确认旧文件可被替换时才选择覆盖。下载后核对本地文件名和大小，敏感文件不要放入公共分享链接。

Git 或远端文件的安全边界

若 GitLab 连接失败，区分“账号未授权”“项目不存在”“文件路径错误”和“网络不可达”。记录项目、分支、路径和错误码后再反馈管理员。

完成检查清单

• 路径、分支和项目来源正确。
• 预览内容与本地或远端最新版本一致。
• 保存后重新打开确认内容已落盘。
• 下载、上传或覆盖操作有结果提示和可复核记录。

连接前准备

确认管理员已经启用 GitLab 集成，并知道要访问的实例地址、项目和默认分支。个人授权只代表当前账号的访问范围，不会自动提升项目权限。

完成授权和验证

1. 在项目或设置入口点击“连接 GitLab”。
2. 在浏览器授权页核对实例来源和申请的权限，再确认授权。
3. 返回工作台后查看连接状态，使用“验证”读取项目列表或默认分支。
4. 验证失败时记录实例、账号、时间和错误码，不要在会话中粘贴 Token。

绑定项目和分支

选择仓库前核对组织、项目路径和默认分支。需要处理发布分支时手动选择目标分支，并在会话中说明允许读取或修改的目录。不要把生产仓库和测试仓库仅凭名称相似当成同一项目。

读取、编辑和提交

先读取树和文件内容，再修改最小范围。提交前检查差异、未跟踪文件和提交目标；需要推送时确认远端、分支、提交信息和审批要求。网络超时后先刷新远端状态，确认提交是否已经存在，再决定是否重试。

完成检查清单

• 实例、组织、仓库和分支已核对。
• 授权范围满足任务且没有多余权限。
• 提交前已查看差异和未跟踪文件。
• 推送或超时后已确认远端实际结果。