系统品牌

用途与权限

设置全局品牌文字、Logo 和版权信息，作为后台及公开页面的系统级品牌。仅平台系统管理员可操作；普通用户会看到“无权限”。

入口

左侧菜单“系统设置 → 系统品牌”，路由为 /settings/branding。

页面总览

社区版使用共享系统品牌接口；品牌字段包括品牌文字、Logo 地址、版权显示开关、版权文案和版权链接。

主要操作

1. 使用平台系统管理员账号进入页面。
2. 填写品牌文字，并输入 Logo URL；也可上传图片并完成裁剪。
3. 选择是否显示产品版权，填写署名文案和可选链接。
4. 保存后刷新后台，并用公开品牌接口检查生效结果。

字段/限制

• brand_name 与 logo_url 共同构成主要品牌展示。
• Logo 应使用浏览器可直接访问的 HTTPS 图片地址；上传结果会自动回填 URL。
• 版权链接应为可信地址，不应使用脚本或不安全协议。
• 品牌存在系统、工作区、域名等层级时，最终展示遵循后端有效品牌计算；社区版主要使用系统共享配置。

常见错误

• 页面显示无权限：当前用户不是平台系统管理员。
• Logo 上传失败：检查图片格式、尺寸、服务写入权限和反向代理上传限制。
• 保存后仍是旧品牌：刷新页面并清理浏览器缓存，再检查公开品牌接口。
• 公开短链页品牌不同：域名的网站名称或更高优先级品牌覆盖可能已生效。

关联 API

• GET|PUT /api/v1/branding/system
• POST /api/v1/branding/logo
• GET /api/v1/public/site-branding