Skip to content

公告

公告用于向控制台用户推送系统维护、版本更新、政策变更等信息。它有两级范围,并以三种方式呈现。

两级范围

  • 系统公告:由平台管理员在概览 → 系统公告页发布,对所有登录用户可见。适用于私有云 / 公有云个人模式 / 公有云组织模式三种部署形态。
  • 组织公告:由组织管理员在组织 → 组织公告页发布,仅对该组织成员可见。

个人模式用户(未加入任何组织)只会看到系统公告。

三种展示方式

  • 横幅(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,可在可视化与源码模式之间切换。
级别信息 / 提醒 / 重要,决定横幅配色。
展示方式横幅弹窗
已发布草稿不会对读者可见。
生效 / 失效时间可选的发布窗口;留空表示立即生效 / 长期有效。

相关