公告
公告用于向控制台用户推送系统维护、版本更新、政策变更等信息。它有两级范围,并以三种方式呈现。
两级范围
- 系统公告:由平台管理员在概览 → 系统公告页发布,对所有登录用户可见。适用于私有云 / 公有云个人模式 / 公有云组织模式三种部署形态。
- 组织公告:由组织管理员在组织 → 组织公告页发布,仅对该组织成员可见。
个人模式用户(未加入任何组织)只会看到系统公告。
三种展示方式
- 横幅(banner):显示在所有控制台页面顶部,可点击右上角关闭。
- 弹窗(modal):强提示公告,登录后以对话框弹出,确认后关闭。
- 公告列表页:所有登录用户可在「公告」页查看可见的历史公告(含已过期)。
公告的「已关闭」状态记录在浏览器本地(localStorage),按公告 id + 更新时间存储:修改元数据或任一语言翻译后更新时间会变化,公告会重新出现。仅切换控制台语言不会改变关闭 key,因此不会让未编辑的公告重复弹出。该状态不跨设备同步。
多语言内容与回退
管理员可在中文与 English 页签中分别填写标题和内容,并选择一种默认语言。默认语言必须完整填写;另一种语言可以留空,因此单语言公告也可以发布。编辑页会标出每种语言“已填写 / 未填写”以及默认语言。
读者接口会按当前控制台语言返回一份已解析内容,不会把全部翻译发送给普通读者:
- 存在当前语言翻译时直接展示;
- 缺少当前语言时展示公告的默认语言,并在横幅详情和公告列表中提示发生了语言回退;
- 管理员之后补充或修改任一翻译,会推进公告更新时间并让已关闭的公告重新出现。
Markdown 编辑器
公告内容以 Markdown 保存。编辑器提供两种可随时切换的模式:
- 可视化:直接排版标题、强调、列表、链接、表格等内容;
- 源码模式:直接编辑原始 Markdown,适合粘贴现有内容或精确调整语法。
切换语言页签、编辑已有公告或在两种模式间切换时,当前草稿都会保留。可视化模式可能规范化空白、列表符号等源码格式,因此应把渲染语义视为稳定契约,而不是要求 Markdown 字符逐字不变。
当前支持的语法包括:段落、二至四级标题、粗体、斜体、删除线、行内代码、引用、有序 / 无序 / 任务列表、HTTP(S) 与控制台相对链接、代码块、分隔线和 GFM 表格。直接粘贴 HTTP(S) 地址也会显示为链接。
为避免公告成为可执行或跟踪内容,原始 HTML、MDX / JSX 和图片不会渲染;图片只显示替代文字,也不会向图片地址发起加载请求。javascript:、data: 等危险链接协议会被移除。公告内容上限为 8,000 个字符。
字段说明
| 字段 | 说明 |
|---|---|
| 默认语言 | 中文或 English;必须存在完整的对应翻译。 |
| 中文 / English 标题与内容 | 每种已填写的翻译都必须同时包含标题和内容;非默认语言可全部留空。内容使用上述受限 Markdown,可在可视化与源码模式之间切换。 |
| 级别 | 信息 / 提醒 / 重要,决定横幅配色。 |
| 展示方式 | 横幅 或 弹窗。 |
| 已发布 | 草稿不会对读者可见。 |
| 生效 / 失效时间 | 可选的发布窗口;留空表示立即生效 / 长期有效。 |