文件、Logo 与品牌资源

入口在哪

产品入口：工作台 → 空间/企业设置 → 外观或品牌设置；文件入口：应用或组件中的文件上传控件。下图用于识别品牌资源入口。

操作步骤

1. 上传 Logo 时选择空间 sales_ops，文件选择 sales_logo.png，格式优先使用 PNG，背景保持透明或与主题色一致。

2. 控制 Logo 文件大小：以后端 multipart.logo.maxFileSize 配置为准；当前代码没有发现固定像素尺寸限制，尺寸按当前 UI 设计规范复核。

3. 上传销售附件时记录返回文件 ID 或 URL，绑定到 客户管理 应用或 销售明细元素，不要直接粘贴本地路径。

4. 修改品牌色或外观后刷新工作台，确认登录页、工作台和应用入口是否同步显示。

如何验证配置成功

1. 正向校验 1：Logo 上传接口或页面返回新 Logo 路径，工作台刷新后显示新 Logo。

2. 正向校验 2：文件上传后可通过文件服务下载或预览，且访问 URL 不依赖本地磁盘绝对路径。

3. 负向校验：如果上传成功但访问 403/404，检查空间参数、文件 ID、文件服务日志和网关权限。

常见问题

问：Logo 尺寸要求是多少？ 答：代码证据只确认文件大小配置和上传接口，没有固定像素限制；上线前按当前 UI 设计规范截图复核。

问：文件上传成功但页面不显示怎么办？ 答：复制返回路径，检查是否带正确 space/app 上下文，再查文件服务下载日志。

问：能不能直接引用外部图片 URL？ 答：不建议。品牌资源应通过平台文件或 Logo 服务管理，避免外部链接失效。