def ensure_one(found):
    """
    确保列表中仅有一个项，并返回这个项，否则抛出 `ValueError` 异常

    通常可用在查找聊天对象时，确保查找结果的唯一性，并直接获取唯一项

    :param found: 列表
    :return: 唯一项
    """
    if not isinstance(found, list):
        raise TypeError('expected list, {} found'.format(type(found)))
    elif not found:
        raise ValueError('not found')
    elif len(found) > 1:
        raise ValueError('more than one found')
    else:
        return found[0]
确保列表中仅有一个项，并返回这个项，否则抛出 `ValueError` 异常

通常可用在查找聊天对象时，确保查找结果的唯一性，并直接获取唯一项

:param found: 列表
:return: 唯一项
wxpy/utils/tools.py