UniBind - 跨平台用户身份绑定

UniBind 是一个基于 ErisPulse 框架的跨平台用户身份绑定模块，通过验证码将不同平台的同一用户关联到统一身份，并可选通过适配器中间件对下游模块透明地替换事件中的用户身份。

功能特性

  • 统一身份管理：跨平台用户身份绑定，一个身份关联多个平台账号
  • 验证码机制：6位数字验证码，5分钟有效，安全可靠
  • 强制替换：适配器中间件级事件改写，对下游模块完全透明
  • 自定义显示身份：每个绑定可独立指定替换后的平台和用户ID
  • 扩展字段：通过 extra JSON 存储自定义用户属性
  • 对外 API：提供完整的编程接口供其他模块调用

安装

epsdk install UniBind

配置

在 config.toml 中可自定义以下配置（均有默认值，无需手动添加）：

[UniBind]
verify_code_expire = 300     # 验证码有效期（秒）
verify_code_length = 6       # 验证码长度
max_accounts_per_user = 10   # 每个统一用户最大绑定账号数

使用方法

创建身份

在任意平台发送：

/bind

自动创建统一身份并生成验证码，返回验证码用于在其他平台绑定。

跨平台绑定

在另一个平台发送：

/bind 384729

输入验证码后选择显示身份，完成绑定。

查看绑定信息

/bind.info

列出所有绑定账号

/bind.accounts

设置扩展字段

/bind.set name 新名称
/bind.set email user@example.com

强制替换

开启后，中间件会将事件中的用户身份替换为指定的显示身份，对下游模块透明：

/bind.force

选择显示身份后开启。再次发送可关闭。

解绑

/bind.unbind

解绑当前平台账号。如果是最后一个绑定，统一身份将被删除。

命令列表

命令 说明
/bind 创建身份或生成验证码（已绑定时显示信息）
/bind <验证码> 通过验证码绑定到已有身份
/bind.info 查看当前绑定信息
/bind.accounts 列出统一身份下所有平台账号
/bind.set <key> <value> 设置扩展字段
/bind.force 开启/关闭强制替换
/bind.unbind 解绑当前平台账号

强制替换（中间件）

当用户通过 /bind.force 开启强制替换后，适配器中间件会自动改写事件数据：

原始事件 (telegram, tg456) → 强制替换为 (yunhu, U1001)

改写后事件:
  platform: "yunhu"
  user_id: "U1001"
  unibind_original: { platform: "telegram", user_id: "tg456" }

下游模块无需感知 UniBind 的存在，直接使用改写后的身份即可。

对外 API

其他模块可通过 sdk.UniBind 访问以下接口：

# 通过平台账号解析统一身份
aid = sdk.UniBind.resolve("yunhu", "U1001")      # → "uuid-xxx" 或 None

# 获取统一用户信息
user = sdk.UniBind.get_user("uuid-xxx")            # → {"aid", "name", "avatar", "extra", ...}

# 获取所有绑定账号
accounts = sdk.UniBind.get_accounts("uuid-xxx")    # → [{"platform", "user_id", "name", ...}, ...]

# 获取扩展字段
extra = sdk.UniBind.get_extra("uuid-xxx")          # → {"email": "...", ...}

# 批量查询
mapping = sdk.UniBind.resolve_batch([
    ("yunhu", "U1001"),
    ("telegram", "tg456"),
])
# → {"yunhu:U1001": "uuid-xxx", "telegram:tg456": "uuid-xxx"}

# 检查是否开启强制替换
is_force = sdk.UniBind.is_force_enabled("yunhu", "U1001")

# 获取替换后的显示身份
display = sdk.UniBind.get_display_identity("yunhu", "U1001")
# → {"platform": "yunhu", "user_id": "U1001"} 或 None

项目结构

ErisPulse-UniBind/
├── pyproject.toml
├── README.md
├── LICENSE
└── ErisPulse_UniBind/
    ├── __init__.py
    └── Core.py

许可证

MIT License

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for WSu2059 from gravatar.com WSu2059

Credits

Author: wsu2059q

License

MIT

Requires

Python >=3.10

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

erispulse_unibind-1.0.0.tar.gz (8.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

erispulse_unibind-1.0.0-py3-none-any.whl (9.8 kB view details)

Uploaded Python 3

File details

Details for the file erispulse_unibind-1.0.0.tar.gz.

File metadata

  • Download URL: erispulse_unibind-1.0.0.tar.gz
  • Upload date:
  • Size: 8.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for erispulse_unibind-1.0.0.tar.gz
Algorithm Hash digest
SHA256 6f940699fdbabe551844fb367790337b5f61fe8e37af6270b0043acec941874e
MD5 fed1d5501cf24e6877ccd1c20fd1d93a
BLAKE2b-256 a655e31f1bf62076f717d8aecc0086c61cc4da02ce01b35a2f889d46d6b035e1

See more details on using hashes here.

Provenance

The following attestation bundles were made for erispulse_unibind-1.0.0.tar.gz:

Publisher: python-publish.yml on wsu2059q/ErisPulse-UniBind

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file erispulse_unibind-1.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for erispulse_unibind-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 d440344e30db26a4f38bfee77428b51563c7cf488ac727d234e93b9b5355e3c6
MD5 9e0af8270fe5242c66fb9e971bc7d045
BLAKE2b-256 2bf8e3137d30359e096ad0939657b78d48602ea1c7ef9396da47301ced12ca61

See more details on using hashes here.

Provenance

The following attestation bundles were made for erispulse_unibind-1.0.0-py3-none-any.whl:

Publisher: python-publish.yml on wsu2059q/ErisPulse-UniBind

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page