Emoji 表情定制指南

本文档面向合作机构，说明如何定制专属的 Emoji 表情匹配方案。
请根据您的业务场景选择合适的分类，按模板准备数据后交付给我们。

一、定制分类总览

我们支持两种定制类型，请根据您的需求选择其中一种：

	A 类：关键词匹配	B 类：情感分类
一句话描述	您定义"哪些词/短语触发哪个表情"	您定义"哪些情感对应哪些关键词"
适用场景	有明确的场景化表情需求，需要精准控制触发词	只需按情感大类触发表情，不需逐词定义
数据量	通常数百~数千条关键词映射	通常 10-25 个情感分类
匹配方式	文本中包含关键词即触发，长关键词优先匹配	根据文本整体情感倾向判断
匹配范围	用户输入 + AI 回答均可匹配	仅对 AI 回答匹配
灵活度	高 — 每个关键词精确对应一个表情动作	中 — 按情感大类归类

二、A 类：关键词匹配模式

2.1 数据格式

请提供一个 JSON 文件，格式如下：

[
    {
        "keyword": "触发关键词或短语",
        "key_0": "表情动作标识符"
    },
    {
        "keyword": "另一个关键词",
        "key_0": "另一个表情标识符"
    }
]

2.2 字段说明

字段	类型	说明
`keyword`	字符串	触发词或触发短语。当对话文本中包含这个词/短语时，触发对应表情。支持中文、英文或中英混合。不区分大小写。
`key_0`	字符串	表情/动作的唯一标识符。命名规则：仅使用小写字母 (a-z)、数字 (0-9)、下划线 (_)，不超过 30 个字符。

2.3 填写规则

同一个表情动作（key_0）可以对应多条 keyword，建议每个动作至少覆盖 5-10 个关键词

关键词越长越精准（如"在春天的田野里散步"比"散步"更不容易误触发）

关键词可以是中文、英文或中英文混合

不需要处理大小写，系统会自动忽略大小写差异

2.4 填写示例

以一个宠物陪伴机器人为例：

[
    {"keyword": "摸摸头", "key_0": "happy_wag"},
    {"keyword": "pat on the head", "key_0": "happy_wag"},
    {"keyword": "好乖", "key_0": "happy_wag"},
    {"keyword": "good boy", "key_0": "happy_wag"},
    {"keyword": "乖宝宝", "key_0": "happy_wag"},

    {"keyword": "出去玩", "key_0": "excited_jump"},
    {"keyword": "go for a walk", "key_0": "excited_jump"},
    {"keyword": "出去散步", "key_0": "excited_jump"},
    {"keyword": "去公园", "key_0": "excited_jump"},

    {"keyword": "洗澡", "key_0": "scared_shake"},
    {"keyword": "take a bath", "key_0": "scared_shake"},

    {"keyword": "吃饭了", "key_0": "eat_food"},
    {"keyword": "dinner time", "key_0": "eat_food"},
    {"keyword": "开饭", "key_0": "eat_food"},
    {"keyword": "吃东西", "key_0": "eat_food"},

    {"keyword": "晚安", "key_0": "sleepy_curl"},
    {"keyword": "good night", "key_0": "sleepy_curl"},
    {"keyword": "睡觉", "key_0": "sleepy_curl"}
]

2.5 Excel / CSV 模板

如果您更习惯用表格整理，可以按下面的格式填写，我们会帮您转换为 JSON：

keyword	key_0	备注（仅供内部参考，无需提交）
摸摸头	happy_wag	开心摇尾巴
pat on the head	happy_wag	开心摇尾巴
出去玩	excited_jump	兴奋跳跃
洗澡	scared_shake	害怕发抖
...	...	...

三、B 类：情感分类模式

3.1 数据格式

请提供一个 JSON 文件，格式如下：

{
    "情感标签": ["关键词1", "关键词2", "keyword_en_1", "keyword_en_2"],
    "另一个标签": ["关键词3", "关键词4"]
}

3.2 字段说明

字段	类型	说明
情感标签（JSON 的 key）	字符串	表情/动作的唯一标识符。命名规则：仅使用小写字母 (a-z)、数字 (0-9)、下划线 (_)，不超过 30 个字符。
关键词列表（JSON 的 value）	字符串数组	与该情感相关的触发词列表。支持中英文混合。

3.3 填写规则

建议定义 10-25 个情感分类

每个分类建议覆盖 8-20 个关键词

关键词支持中英文混合

系统会对文本做整体情感打分，命中关键词越多的分类优先返回

3.4 填写示例

{
    "happy": [
        "开心", "高兴", "快乐", "太好了", "好棒",
        "happy", "joy", "great", "awesome", "wonderful"
    ],
    "sad": [
        "伤心", "难过", "失望", "沮丧", "不开心",
        "sad", "upset", "unhappy", "depressed"
    ],
    "angry": [
        "生气", "愤怒", "讨厌", "烦死了", "气死了",
        "angry", "mad", "furious", "annoyed"
    ],
    "surprised": [
        "惊讶", "哇塞", "天啊", "没想到", "居然",
        "wow", "omg", "amazing", "unbelievable"
    ],
    "loving": [
        "爱你", "喜欢", "亲爱的", "宝贝", "想你",
        "love", "like", "darling", "miss you"
    ],
    "thinking": [
        "思考", "考虑", "想一下", "为什么", "怎么回事",
        "think", "consider", "why", "how"
    ]
}

3.5 现有情感分类参考

以下是系统内置的 20 种情感分类，您可以在此基础上增删改：

标签	含义	示例关键词
`happy`	开心	开心、高兴、快乐、太好了
`laughing`	大笑	哈哈哈、笑死了、lol
`funny`	搞笑	搞笑、滑稽、幽默、段子
`sad`	伤心	伤心、难过、失望、唉
`angry`	生气	生气、愤怒、讨厌、烦死了
`crying`	哭泣	大哭、泪目、呜呜
`loving`	喜爱	爱你、喜欢、宝贝、想你
`embarrassed`	尴尬	尴尬、害羞、社死
`surprised`	惊讶	天啊、哇塞、没想到
`shocked`	震惊	震惊、吓到、不敢相信
`thinking`	思考	思考、考虑、为什么
`winking`	调皮	调皮、你懂的、坏笑
`cool`	酷	厉害、真棒、优秀
`relaxed`	放松	舒服、惬意、轻松
`delicious`	美味	好吃、美味、流口水
`kissy`	亲亲	么么哒、mua、飞吻
`confident`	自信	当然、肯定、毫无疑问
`sleepy`	困倦	晚安、好累、想睡
`silly`	傻	傻、呆萌、憨憨
`confused`	困惑	不明白、疑惑、啥意思

四、交付物清单

请最终提供以下内容：

分类类型：选择 A 类（关键词匹配）或 B 类（情感分类）

模式名称：英文小写标识符（如 petbot），用于系统内注册您的专属模式

数据文件：按上述对应模板填写的 JSON 文件

表情/动作标识符清单：列出所有使用到的 key_0，并附上每个标识符对应的表情/动作的文字描述或截图，方便我们联调校验

匹配范围选择：是否需要对用户输入也做匹配？（默认仅对 AI 回答做匹配）

五、常见问题

Q1：关键词会误触发怎么办？

关键词越长越精准。例如"开心"可能在很多句子中出现，但"今天真的好开心啊"作为关键词就不太会误触发。建议对高频通用词使用更长的短语。

Q2：一条对话会触发多个表情吗？

每段文本只会匹配一个表情（第一个命中的）。A 类模式下长关键词优先匹配。

Q3：可以同时使用中英文关键词吗？

可以。系统会统一转为小写后匹配，中英文关键词都支持。

Q4：数据量有上限吗？

技术上没有硬性上限，但建议 A 类模式控制在 10,000 条以内以保证匹配性能。B 类模式建议 25 个分类以内。

Q5：后续可以更新数据吗？

可以。提供更新后的 JSON 文件，我们替换后重启服务即生效。

Emoji 表情定制指南

Emoji 表情定制指南#

一、定制分类总览#

二、A 类：关键词匹配模式#

2.1 数据格式#

2.2 字段说明#

2.3 填写规则#

2.4 填写示例#

2.5 Excel / CSV 模板#

三、B 类：情感分类模式#

3.1 数据格式#

3.2 字段说明#

3.3 填写规则#

3.4 填写示例#

3.5 现有情感分类参考#

四、交付物清单#

五、常见问题#

Q1：关键词会误触发怎么办？#

Q2：一条对话会触发多个表情吗？#

Q3：可以同时使用中英文关键词吗？#

Q4：数据量有上限吗？#

Q5：后续可以更新数据吗？#

Emoji 表情定制指南

一、定制分类总览

二、A 类：关键词匹配模式

2.1 数据格式

2.2 字段说明

2.3 填写规则

2.4 填写示例

2.5 Excel / CSV 模板

三、B 类：情感分类模式

3.1 数据格式

3.2 字段说明

3.3 填写规则

3.4 填写示例

3.5 现有情感分类参考

四、交付物清单

五、常见问题

Q1：关键词会误触发怎么办？

Q2：一条对话会触发多个表情吗？

Q3：可以同时使用中英文关键词吗？

Q4：数据量有上限吗？

Q5：后续可以更新数据吗？