自定义标签

路径：UI管理 → 自定义标签（pages_admin/tag-styles/index）

按区域配置笔记卡角标（xiaoyi-tag）外观：样式库卡片点选编辑，支持全平台默认、区域覆盖、从平台同步与 AI 生成。标签是否出现由业务规则决定，本页只管「长什么样」。

按区域配置笔记卡角标（xiaoyi-tag）的外观。与 UI 编辑器里的笔记列表配合：列表决定卡片布局，本页决定角标颜色与样式。

UI管理 → 自定义标签·运营 / UI 编辑人员pages_admin/tag-styles/index

管理后台 H5 可访问
账号具备 tag.style 相关权限
需 AI 生成样式时请先配置 AI 中台

页面是做什么的

控制笔记列表、笔记详情、评论等场景里各类角标长什么样。不负责「笔记有没有这个标签」——那是圈子/笔记/用户业务规则决定的。

每条配置 = 标签键 tag_name + 外观 JSON（style_json）+ 所属区域
App 内 xiaoyi-tag 读取 GET /api/system/tag-styles，按 tag_name 匹配样式
标签文案（如「热帖」「男」「已认证」）由业务下发；此处只改背景、边框、图标、字号等
保存后立即写入数据库；客户端有缓存，改完建议强刷或换账号验证

与笔记列表、圈子业务的关系

自定义标签是「样式层」，笔记列表与圈子业务是「数据层」。两者分工明确，不要混在 UI 编辑器里配置角标外观。

配置了 tag 样式但 App 不显示：多半是业务未命中该标签（例如笔记并非热帖），不是样式页故障
笔记列表改了但角标颜色没变：应来本页改 tag_name 对应样式，而不是在笔记列表属性里找颜色项
瀑布流、圈子详情时间线等也复用同一套 tag-styles，改一处全站同 tag_name 生效

笔记列表（UI 编辑器）配置卡片布局、字号、是否显示认证行等；属性里「用户标签」分组仅提示样式来自本页，不能逐条改角标颜色

圈子业务圈主、置顶、圈子内笔记等会带上 circle_owner、pinned 等 tag_name；是否在列表展示由笔记列表开关与业务状态共同决定

笔记业务热帖/精帖/审核中/闲置/投票等由笔记类型、审核状态、运营规则命中后自动带 tag；你在本页配置这些 tag 的外观

用户业务性别、年龄、等级、认证状态（未认证/认证中/已认证）等来自用户资料；gender 支持男女分设两套样式，level 支持按等级序号分设

区域全平台打底 → 各区域可覆盖或「从平台同步」后微调；客户端按用户当前区域拉取对应样式

笔记列表组件文档

圈子与笔记业务文档

区域与继承

顶栏「区域筛选」决定当前编辑哪一层配置。

建议先在「全平台」配好通用样式，再对个别区域微调或「从平台同步」后改差异项。

全部 / 全平台（region_id=0）全站默认样式。各区域未单独配置时回退到这里

指定区域只覆盖该区域的同名 tag_name；与全平台合并后，区域行优先

已配置 N 项当前区域下已有 style_json 记录的数量（不是内置标签总数）

从平台同步仅区域视图可用：把全平台已配置项复制到当前区域，同名覆盖

恢复默认重置当前区域下全部内置标签为系统预设；自定义 tag_name 不受影响

页面结构

1
说明与工具栏顶部说明「按区域配置笔记卡角标外观…」；右侧：从平台同步、恢复默认、+ 自定义（与 pages_admin/tag-styles/index 一致）
2
区域筛选admin-region-filter 选择全部/具体区域；下方显示「已配置 N 项 · 区域 xxx · 点击卡片编辑样式」
3
笔记卡预览已配置 ≥1 项时出现：把所有已配置标签并排展示组合效果（性别、等级可多枚预览）
4
标签样式库卡片网格：内置常用标签 + 已保存的自定义 tag_name；灰色虚线 = 未配置，点击可新建

样式库卡片怎么用

删除只移除当前区域的该条样式记录，不会关闭业务上的标签展示逻辑；未配置时会回退全平台或系统默认外观。

未配置（灰色 +）点击 → 新建该 tag_name 的样式（需 create 权限）

已配置（带预览 +「已配置」角标）点击卡片主体 → 编辑；下方有「编辑」「删除」按钮

内置标签来自系统预设列表（hot、gender 等），卡片下方显示中文名、说明与 tag 键

自定义标签通过「+ 自定义」新建的非预设 tag_name，保存后追加在网格末尾

内置标签类型（与后台样式库一致）

样式库默认展示以下 tag_name；业务命中对应规则时 App 会带上该标签键。完整列表以管理端「标签样式库」为准。

自定义 tag_name 须与前后端约定一致，否则配置了也不会被业务引用。

hot / featured / co_create热帖 / 精帖 / 共创笔记角标

deleted / reviewing / rejected已删除 / 审核中 / 审核不通过（笔记状态）

pinned / topic / topic_owner / topic_pk置顶 / 话题 / 话题主 / 话题 PK

gender / age / level用户性别、年龄、等级（gender 男女分设；level 按等级序号分设）

official / admin / circle_owner / region_lead / rider / bot官方、管理员、圈主、区域负责人、骑手、机器人身份标识

idle / idle_sell / idle_want / vote闲置、出售、求购、投票笔记类型

comment_author / first_comment评论作者、首评标识（评论区场景）

auth_unverified / auth_pending / auth_verified / auth_failed作者认证四种状态

1
标签类型新建时填写 tag 键（如 hot、gender、pinned）；下方自动显示中文展示名。编辑时键不可改，需改名请删后新建
2
实时预览左侧（宽屏）或表单上方（窄屏）用 xiaoyi-tag 实时渲染，与 App 一致
3
AI 生成（可选）描述风格 → AI 生成 → 自动填入下方表单，可再微调
4
样式表单尺寸、背景、边框、左侧装饰、文字、内边距（见下节）
5
保存拼接为 style_json 提交；按当前区域 region_id + tag_name upsert

性别标签（gender）特殊配置

笔记卡预览与样式库卡片：检测到 gender 且含男/女子样式时，会并排展示两个标签
切换「单一样式 ↔ 男女分设」时，会把当前表单复制到另一模式作为初始值

单一样式男女共用一套外观，预览显示单个标签

男女分设分别配置男/女两套样式，笔记卡按作者性别渲染对应角标

限制男女分设模式下暂不支持 AI 批量生成，需分别编辑男/女表单

等级标签（level）特殊配置

与 gender 类似，可按用户等级序号（1、2、3…）分别配置样式；未单独配置的等级回退默认外观。

样式库预览会展示多个等级标签的组合效果
等级数据来自用户成长体系，本页只改各等级角标的外观

样式表单字段

编辑弹窗内 tag-style-form-block 各区块；数字可只填数值，保存时自动补 rpx。

图标与图片互斥；切换「无/图标/图片」会清空另一类型的字段。颜色请用表单内色板，不要手填无效值。

标签尺寸宽、高（如 120、48）

背景纯色：色板选 backgroundColor；渐变：起始色、结束色、角度（deg），生成 linear-gradient

边框边框粗细、边框颜色

左侧装饰三选一：无 / 字体图标（选图标 + 大小 + 颜色）/ 图片（文件库选图 + 宽高 + 圆角）

文字字号 textSize、字重 fontWeight、文字颜色 textColor

内边距上/右/下/左 padding，写入 style_json.padding 对象

AI 生成样式

需 AI 中台已开通且账号有 tag.style 写权限；gender 男女分设模式不显示 AI 面板。

1
填写标签类型须先有 tag_name，AI 才能结合标签语义生成
2
描述风格如：热帖警示感，红橙渐变，白字，小圆角，紧凑内边距
3
AI 生成调用 tag_style_generate 场景，返回 style_json 填入表单
4
预览微调后保存生成结果可在实时预览中继续改色/尺寸，满意再点保存

AI 中台配置文档

style_json 保存结构（供排查）

常规：{ width, height, backgroundColor 或 gradient+backgroundImage, borderWidth, borderColor, padding:{top,right,bottom,left}, textSize, fontWeight, textColor, iconSource, iconName/iconSize/iconColor 或 imageUrl/... }
gender 男女分设：{ male: { ... }, female: { ... } }
客户端 xiaoyi-tag 直接消费上述字段；与 UI 编辑器里标签组件不是同一套配置

权限说明

tag.style（write）从平台同步、恢复默认

tag.style create点击未配置卡片新建、+ 自定义

tag.style update编辑并保存已有样式

tag.style delete删除当前区域某条样式

管理端权限文档

验证清单

当前区域「已配置 N 项」数量正确
样式库卡片预览与编辑弹窗实时预览一致
保存后刷新列表，卡片仍为「已配置」
App 笔记列表：找一条带热帖/认证/性别等标签的笔记，角标颜色图标符合预期
App 圈子页笔记列表：圈主等身份角标样式正确
区域专属配置：切换客户端区域后生效对应区域样式

常见问题

我的模块文档

圈子与笔记文档

改了样式 App 没变化确认已保存且 tag_name 与业务一致；客户端强刷；检查是否在看另一个区域的笔记。

灰色卡片点不了无 tag.style create 权限；或当前为只读账号。

恢复默认会删自定义吗不会。只重置内置预设 tag_name 为系统默认，自定义 tag_name 保留。

和 UI 编辑器里拖的标签组件什么关系无关。本页管笔记/圈子业务角标（xiaoyi-tag）；编辑器里的「标签」是页面装饰组件。

笔记列表里找不到改角标颜色的地方正常。角标外观统一在本页配置；笔记列表只控制是否显示认证行等布局开关。

AI 生成失败检查 AI 中台、tag_style_generate 场景是否启用；描述是否填写；非 gender 男女分设模式。

自定义标签 ​