user

type AddUserReq struct {
	Name     string
	UID      string // 如果无值，则随机生成
	Username string
	ShortNo  string // 如果无值，则自动生成
	Zone     string
	Phone    string
	Email    string
	Password string
	Robot    int // 机器人 0.否 1.是
}

type AppBotResolverFunc func(uid string) string

type BlacklistModel struct {
	UID      string // 用户唯一id
	Name     string // 用户名称
	Username string // 用户名
	db.BaseModel
}

type BotFriendApplyHook func(applyUID, applyName, robotID, remark, token, spaceID string)

type Category string

type DB struct {
	// contains filtered or unexported fields
}

type Detail struct {
	Model
	Mute         int // 免打扰
	Top          int // 置顶
	ChatPwdOn    int //是否开启聊天密码
	Screenshot   int //截屏通知
	RevokeRemind int //撤回提醒
	Receipt      int //消息回执
	db.BaseModel
}

type DetailModel struct {
	Remark     string //好友备注
	ToUID      string // 好友uid
	ToName     string // 好友名字
	ToCategory string // 用户分类
	Mute       int    // 免打扰
	Top        int    // 置顶
	Version    int64  // 版本
	Vercode    string // 验证码 加好友需要
	IsDeleted  int    // 是否删除
	IsAlone    int    // 是否为单项好友
	ShortNo    string //短编号
	ChatPwdOn  int    // 是否开启聊天密码
	Blacklist  int    //是否在黑名单
	Receipt    int    //消息是否回执
	Robot      int    // 机器人0.否1.是
	db.BaseModel
}

type DeviceInfo struct {
	DeviceID    string
	DeviceName  string
	DeviceModel string
}

type ExternalLoginReq struct {
	ExistingUID string

	// UID 仅新建用户场景下使用,ExistingUID 非空时忽略。
	UID string // 调用方生成的 UID（避免重复 GenerUUID 后还要再回传）

	// Name 在两条路径都用:新建时写入 user.name;ExistingUID 非空时与库中
	// user.name 比较,不同则同步覆盖(issue #1307)。两条路径都会做 @ → _ 消毒。
	Name  string
	Email string
	Phone string
	Zone  string

	DeviceFlag config.DeviceFlag
	Device     *DeviceInfo

	// PublicIP 用于欢迎消息日志,可空
	PublicIP string

	// TrustedSSOCreate 调用方声明本次新建用户的身份已由可信 IdP 完成认证,
	// 且已经过 oidc 模块的 IssuerAllowlist 准入校验(详见
	// modules/oidc/bind_service.go BindService.Create 与
	// modules/oidc/api.go callback `res.IsNew` 分支)。
	//
	// 置 true 时本方法**绕过** common.SystemSettings.RegisterOff() 全局开关:
	// register.off=1 主要用于阻断公开 email/手机号注册入口与 GitHub/Gitee OAuth
	// 自助建号通道,这两条通道的身份来源都是不受 dmwork 控制的外部输入。
	// OIDC 通道在本 PR 后由 DM_OIDC_PROVIDER_ALLOW_NEW_USER 与
	// OCTO_OIDC_BIND_ALLOW_CREATE 独立控制(IssuerAllowlist 兜底),
	// 语义上属于"可信 IdP 授权创建",不应受 register.off 影响。
	//
	// 仅 OIDC 模块在 callback `res.IsNew=true` / `/bind/create` 路径上置 true;
	// 其他外部 IdP(GitHub / Gitee 等)留 false,保留原有 register.off 守护。
	TrustedSSOCreate bool
}

type ExternalLoginResp struct {
	UID           string
	IsNewUser     bool
	LoginRespJSON string
}

type Friend struct {
	log.Log
	// contains filtered or unexported fields
}

type FriendApplyModel struct {
	UID    string
	ToUID  string
	Remark string
	Token  string
	Status int // 状态 0.未处理 1.通过 2.拒绝
	db.BaseModel
}

type FriendDetailModel struct {
	FriendModel
	Name   string // 用户名称
	ToName string //对方用户名称
}

type FriendModel struct {
	UID           string
	ToUID         string
	Flag          int
	Version       int64
	IsDeleted     int
	IsAlone       int // 是否为单项好友
	Vercode       string
	SourceVercode string //来源验证码
	Initiator     int    //1:发起方
	db.BaseModel
}

type FriendReq struct {
	UID     string
	ToUID   string
	Flag    int
	Version int64
}

type FriendResp struct {
	Name    string
	UID     string
	IsAlone int // 是否为单项好友
	Remark  string
}

type GroupMemberCheckFunc func(groupNo string, uid string) (bool, error)

type GroupMemberExternalProvider func(groupNo, uid string) (
	isExternal int,
	sourceSpaceID, sourceSpaceName string,
	homeSpaceID, homeSpaceName string,
	err error,
)

type GroupMemberResp struct {
	UID                string `json:"uid"`                  // 成员uid
	GroupNo            string `json:"group_no"`             // 群唯一编号
	Name               string `json:"name"`                 // 群成员名称
	Remark             string `json:"remark"`               // 成员备注
	Role               int    `json:"role"`                 // 成员角色
	IsDeleted          int    `json:"is_deleted"`           // 是否删除
	Status             int    `json:"status"`               //成员状态0:正常，2:黑名单
	Vercode            string `json:"vercode"`              // 验证码
	InviteUID          string `json:"invite_uid"`           // 邀请人
	Robot              int    `json:"robot"`                // 机器人
	ForbiddenExpirTime int64  `json:"forbidden_expir_time"` // 禁言时长
	// YUJ-206：透传群成员的外部来源/归属 Space 字段，命名与 /groups/{no}/members
	// 的 memberDetailResp 保持一致，供 Web/Android/iOS UserInfo 判定"同 Space 非
	// 好友 → 直接发消息" vs "跨 Space 外部成员 → 仅可在群内交流"。
	// 后端保留 IsExternal / SourceSpaceID / SourceSpaceName 的绝对语义不变；
	// HomeSpaceID / HomeSpaceName 是对齐企微相对视角的视图字段：
	//   外部成员 (is_external == 1) → home_space_id = source_space_id
	//   内部成员                     → home_space_id = group.space_id
	IsExternal      int    `json:"is_external"`       // 是否外部成员 0/1
	SourceSpaceID   string `json:"source_space_id"`   // 来源 Space ID（外部成员使用）
	SourceSpaceName string `json:"source_space_name"` // 来源 Space 名称
	HomeSpaceID     string `json:"home_space_id"`     // 成员归属 Space ID（相对视角）
	HomeSpaceName   string `json:"home_space_name"`   // 成员归属 Space 名称
	CreatedAt       string `json:"created_at"`
	UpdatedAt       string `json:"updated_at"`
}

type IOnlineService interface {
	// 获取用户最新在线状态
	GetUserLastOnlineStatus(uids []string) ([]*config.OnlinestatusResp, error)

	// 判断用户设备是否在线
	DeviceOnline(uid string, device config.DeviceFlag) (bool, error)

	// 总在线人数
	GetOnlineCount() (int64, error)
}

type IService interface {
	//获取用户
	GetUser(uid string) (*Resp, error)
	// 获取用户详情（包括与loginUID的关系等等）
	GetUserDetail(uid string, loginUID string) (*UserDetailResp, error)
	// 批量获取用户详情。ctx 用于按请求协商语言渲染 BotFather 命令菜单（#335），
	// 无请求上下文的调用方传 context.Background() 即回退部署默认语言。
	GetUserDetails(ctx context.Context, uids []string, loginUID string) ([]*UserDetailResp, error)
	// 通过用户名获取用户
	GetUserWithUsername(username string) (*Resp, error)
	// 通过用户名获取用户uid集合
	GetUserUIDWithUsernames(usernames []string) ([]string, error)
	// 批量获取用户信息
	GetUsers(uids []string) ([]*Resp, error)
	// 通过APPID获取用户
	GetUsersWithAppID(appID string) ([]*Resp, error)
	// 获取用户集合
	GetUsersWithCategory(category Category) ([]*Resp, error)
	// 获取指定类别的用户列表
	GetUsersWithCategories(categories []string) ([]*Resp, error)
	//查询某个人好友
	GetFriendsWithToUIDs(uid string, toUIDs []string) ([]*FriendResp, error)
	//查询某个用户的所有好友
	GetFriends(uid string) ([]*FriendResp, error)
	//添加一个好友
	AddFriend(uid string, friend *FriendReq) error
	//添加一个用户
	AddUser(user *AddUserReq) error
	// 通过qrvercode获取用户信息
	GetUserWithQRVercode(qrVercode string) (*Resp, error)
	// 获取总用户数量
	GetAllUserCount() (int64, error)
	// 查询某天注册用户数
	GetRegisterWithDate(date string) (int64, error)
	// 获取某个时间区间的注册数量
	GetRegisterCountWithDateSpace(startDate, endDate string) (map[string]int64, error)
	// IsFriend 查询两个用户是否为好友关系
	IsFriend(uid string, toUID string) (bool, error)
	// 获取在线用户
	GetUserOnlineStatus([]string) ([]*OnLineUserResp, error)
	// 更新用户信息
	UpdateUser(req UserUpdateReq) error
	// 获取所有用户
	GetAllUsers() ([]*Resp, error)
	// 更新登录密码
	UpdateLoginPassword(req UpdateLoginPasswordReq) error

	// GetUserSettings 获取用户的配置
	GetUserSettings(uids []string, loginUID string) ([]*SettingResp, error)

	// GetOnetimePrekeyCount 获取用户一次性signal key的数量(决定是否可以开启加密通讯)
	GetOnetimePrekeyCount(uid string) (int, error)

	// 获取设备在线状态
	GetDeviceOnline(uid string, deviceFlag config.DeviceFlag) (*config.OnlinestatusResp, error)
	// 查询在线用户总数量
	GetOnlineCount() (int64, error)
	// 存在黑明单
	ExistBlacklist(uid string, toUID string) (bool, error)
	// QueryPeerRobotInfo 返回目标用户是否为 bot 及其创建者 UID。
	// 实现委托给 PinnedDB（user/db_pinned.go），与置顶频道访问校验共用同一 SQL 真源。
	// 用于 messages_search 等模块的 p2p 访问门禁区分本人 bot / 他人 bot / 真人。
	QueryPeerRobotInfo(peerUID string) (isRobot bool, creatorUID string, err error)
	// AreSpaceMembers 校验两个 uid 是否同属一个在籍 Space。
	// 实现委托给 PinnedDB（user/db_pinned.go），底层调用 pkg/space.CheckBothMembers。
	// 用于 Space 模式下放行同 Space 成员间的 p2p 交互（无需互加好友）。
	AreSpaceMembers(spaceID, uid1, uid2 string) (bool, error)
	// 更新用户消息过期时长
	UpdateUserMsgExpireSecond(uid string, msgExpireSecond int64) error
	// 搜索好友
	SearchFriendsWithKeyword(uid string, keyword string) ([]*FriendResp, error)

	// LoginByExternalIdentity 给外部 IdP（OIDC / OAuth）登录流程签发 DMWork 会话。
	//
	// 内部委托给 *User 实现,需要在模块初始化时通过 (*Service).SetExternalLoginHandler 注入。
	// 未注入或调用方为 *Service 以外的 IService 实现时,返回 ErrExternalLoginNotConfigured。
	LoginByExternalIdentity(ctx context.Context, req ExternalLoginReq) (*ExternalLoginResp, error)

	// UpsertVerificationFromOIDC 基于 Aegis OIDC identity_verification scope
	// 返回的 claims 写入 user_verification 表(YUJ-382 / Aegis OIDC Phase 1 直切)。
	//
	// 自 2026-05-10 起替代原先的 verify-service HMAC 回调链路;权威写入口从
	// /v1/internal/verification/complete 转移到 oidc callback(登录时即写)。
	//
	// 语义:幂等 upsert,冲突按 user_id 主键全字段覆盖。调用方(oidc callback)
	// 负责判断 IsVerified / LegalName 非空 — 本方法再做一次防御式校验,空则 no-op。
	// verifiedProvider 必须在 allowlist 白名单内(cas/wecom/feishu),否则返错不写。
	UpsertVerificationFromOIDC(ctx context.Context, uid string, claims OIDCVerificationClaims) error

	// VerifyPasswordByUID 给 OIDC 自助绑定流程做账号密码二次验证(需求 FR-3.1)。
	//
	// 与 username 登录路径同款的 bcrypt/MD5 兼容 + loginGuard 反爆破,但走独立
	// 计数维度 ("oidc-bind:"+uid),避免与登录失败计数互相串扰。已注销/封号账号
	// 视为不可用。
	//
	// 三种返回组合(任一其它组合都是 bug,调用方可断言):
	//   - (true,  "",        nil)   密码正确且账号可用 → 推进绑定流程
	//   - (false, BindReason*, nil) 业务拒绝 → 计入审计,前端按 reason 显示文案
	//                                **(false, "", nil) 视为非法返回**,调用方应当
	//                                以基础设施异常处理(等同 err != nil)
	//   - (false, "",        err)   基础设施异常 / 调用方 contract 违反(如空 uid)
	//                                → 前端走兜底页 + 运维告警,不计审计失败计数
	//
	// reason 取值见 BindReason* 常量。
	//
	// 内部委托给 *User 实现,需通过 (*Service).SetOIDCBindHandler 注入;
	// 未注入时返回 ErrOIDCBindNotConfigured。
	VerifyPasswordByUID(ctx context.Context, uid, password string) (matched bool, reason string, err error)

	// SendOIDCBindSMS 向给定手机号发送 OIDC 绑定 OTP(需求 FR-3.3)。
	//
	// **调用方(oidc 模块)负责保证 zone/phone 来自 OIDC claims 的
	// phone_number/phone_number_verified,不接受用户输入** —— 否则攻击者
	// 可用自己手机绑别人 sub。本方法仅做信道分发,不做来源校验。
	//
	// keyspace 隔离边界(踩坑勘误):
	//   - 验证码本身 (CacheKeySMSCode) 按 codeType 分桶 —— OIDC bind 流程的
	//     OTP 不会被其他流程的验证码覆盖,也不会覆盖别人;
	//   - **但底层 SMSService 的"sms_rate_limit:zone@phone"(1min 发送频率)、
	//     "sms_verify_lock:zone@phone"(10min 失败锁定)、"sms_verify_fail:..."
	//     三个 key 都不带 codeType,跨流程共享**。后果:
	//       a. 用户刚走过 register/forget-pwd SMS 流程,1min 内进 OIDC bind
	//          会被 "发送过于频繁" 挡住;
	//       b. OIDC bind 路径连续输错 3 次,该手机号其他 SMS 流程一并被
	//          锁 10min。
	//   - bind_token 维度的"OTP 发送 ≤ 3 次"(SR-2.1)由 oidc 模块的
	//     BindStore.IncrAndCheck 单独兜底,与本层无关。
	SendOIDCBindSMS(ctx context.Context, zone, phone string) error

	// VerifyOIDCBindSMS 与 SendOIDCBindSMS 对称,复用底层 SMSService.Verify 的
	// 锁定/重试限制。**注意 lock/failCount key 同样不带 codeType,跨流程共享**,
	// 详见 SendOIDCBindSMS 注释。
	VerifyOIDCBindSMS(ctx context.Context, zone, phone, code string) error

	// IsBindable 给 oidc bind Confirm 路径在 identity.Insert 之前再校验一次
	// uid 仍可绑定。
	//
	// 必要性:locator/VerifyPasswordByUID 都只在 verify 阶段过滤
	// (is_destroy + status<>0)。verify→confirm 之间有 5min 用户交互窗口,
	// 期间运维可能 disable / 用户可能自助 destroy。若 confirm 不复核就 Insert,
	// 会给一个已不可绑定的账号写入 user_oidc_identity 行;残留脏数据让该
	// 用户后续 OIDC 登录走 (issuer, sub) autolink 命中 → IssueSession 拒绝 →
	// 死循环登录失败,需要人工 DB 清理。
	//
	// 实务上 TOCTOU 窗口仍 ~毫秒级(本方法返 true 后到 identity.Insert 之间),
	// DB 层 uk_uid_issuer + 登录路径的 status 检查兜底,但本方法把窗口从
	// "用户交互级"压缩到"DB 单次 round-trip 级",符合纵深防御。
	//
	// 返回:
	//   - (true, nil):账号可绑定
	//   - (false, nil):账号不可绑定(已 destroy / 已停用 / 不存在),调用方按业务拒绝处理
	//   - (false, err):基础设施错误,调用方按 internal_error 兜底
	IsBindable(ctx context.Context, uid string) (bool, error)
}

type LanguageService struct {
	// contains filtered or unexported fields
}

type LoginGuard struct {
	// contains filtered or unexported fields
}

type LoginLog struct {
	log.Log
	// contains filtered or unexported fields
}

type LoginLogDB struct {
	// contains filtered or unexported fields
}

type LoginLogModel struct {
	LoginIP string //登录IP
	UID     string
	db.BaseModel
}

type Manager struct {
	log.Log
	// contains filtered or unexported fields
}

type Model struct {
	AppID             string //app id
	UID               string // 用户唯一id
	Name              string // 用户名称
	Username          string // 用户名
	Email             string // email地址
	Password          string // 用户密码
	Category          string //用户分类
	Sex               int    //性别
	ShortNo           string //唯一短编号
	ShortStatus       int    //唯一短编号是否修改0.否1.是
	Zone              string //区号
	Phone             string //手机号
	ChatPwd           string //聊天密码
	LockScreenPwd     string // 锁屏密码
	LockAfterMinute   int    // 在几分钟后锁屏 0表示立即
	DeviceLock        int    //是否开启设备锁
	SearchByPhone     int    //是否可以通过手机号搜索0.否1.是
	SearchByShort     int    //是否可以通过短编号搜索0.否1.是
	NewMsgNotice      int    //新消息通知0.否1.是
	MsgShowDetail     int    //显示消息通知详情0.否1.是
	VoiceOn           int    //声音0.否1.是
	ShockOn           int    //震动0.否1.是
	OfflineProtection int    // 离线保护
	Version           int64
	Status            int          // 状态 0.禁用 1.启用
	Vercode           string       //验证码
	QRVercode         string       // 二维码验证码
	IsUploadAvatar    int          // 是否上传过头像0:未上传1:已上传
	AvatarVersion     int64        // 头像对象版本，0 表示旧版稳定路径
	Role              string       // 角色 admin/superAdmin
	Robot             int          // 机器人0.否1.是
	MuteOfApp         int          // app是否禁音（当pc登录的时候app可以设置禁音，当pc登录后有效）
	IsDestroy         int          // 注销状态 0.正常 1.注销申请中（冷静期） 2.已注销
	DestroyApplyAt    dbr.NullTime // 注销申请时间
	DestroyExpireAt   dbr.NullTime // 注销到期执行时间
	WXOpenid          string       // 微信openid
	WXUnionid         string       // 微信unionid
	GiteeUID          string       // gitee uid
	GithubUID         string       // github uid
	Web3PublicKey     string       // web3公钥
	MsgExpireSecond   int64        // 消息过期时长
	Language          string       // 用户语言偏好（BCP 47，空表示沿用 OCTO_DEFAULT_LANGUAGE）
	db.BaseModel
}

type OIDCVerificationClaims struct {
	// Subject OIDC sub,作为 user_verification.source_sub 写入。
	Subject string
	// VerifiedProvider Aegis 返回的 provider 全名,如 "cas.example.com"。
	// 存库前 strip 到一级(cas),不在 allowlist 内会被拒写。
	VerifiedProvider string
	// VerifiedAt Unix 秒,0 视为"未提供实名完成时间",Upsert 拒绝写入。
	VerifiedAt int64
	// LegalName 实名姓名。空字符串视为未实名,Upsert 拒绝写入。
	LegalName string
	// LegalEmail 实名邮箱,允许空。
	LegalEmail string
}

type OnLineUserResp struct {
	UID         string
	LastOffline int
	Online      int
	DeviceFlag  uint8
}

type OnlineService struct {
	log.Log
	// contains filtered or unexported fields
}

type Pinned struct {
	log.Log
	// contains filtered or unexported fields
}

type PinnedChannelModel struct {
	ID          int64     `db:"id"`
	UID         string    `db:"uid"`
	SpaceID     string    `db:"space_id"`
	ChannelID   string    `db:"channel_id"`
	ChannelType uint8     `db:"channel_type"`
	SortOrder   int       `db:"sort_order"`
	CreatedAt   time.Time `db:"created_at"`
}

type PinnedDB struct {
	log.Log
	// contains filtered or unexported fields
}

type PinnedSortError struct {
	// contains filtered or unexported fields
}

type PinnedSortItem struct {
	ChannelID   string `json:"channel_id"`
	ChannelType uint8  `json:"channel_type"`
}

type Resp struct {
	UID             string
	Name            string
	Zone            string
	Phone           string
	Email           string
	Status          int // 用户状态 1 正常 2:黑名单 0 禁用
	IsUploadAvatar  int
	NewMsgNotice    int
	MsgShowDetail   int //显示消息通知详情0.否1.是
	MsgExpireSecond int64
	CreatedAt       int64 // 注册时间 10位时间戳
	IsDestroy       int   // 是否注销
	Robot           int   // 机器人0.否1.是
}

type RoleService struct {
	// contains filtered or unexported fields
}

type Service struct {
	log.Log
	// contains filtered or unexported fields
}

type Setting struct {
	log.Log
	// contains filtered or unexported fields
}

type SettingDB struct {
	// contains filtered or unexported fields
}

type SettingModel struct {
	UID          string // 用户UID
	ToUID        string // 对方uid
	Mute         int    // 免打扰
	Top          int    // 置顶
	ChatPwdOn    int    // 是否开启聊天密码
	Screenshot   int    //截屏通知
	RevokeRemind int    //撤回提醒
	Blacklist    int    //黑名单
	Receipt      int    //消息是否回执
	Flame        int    // 是否开启阅后即焚
	FlameSecond  int    // 阅后即焚秒数
	Version      int64  // 版本
	Remark       string // 备注
	db.BaseModel
}

type SettingResp struct {
	ToUID        string // 用户UID
	UID          string // 用户UID
	Mute         int    // 免打扰
	Top          int    // 置顶
	ChatPwdOn    int    // 是否开启聊天密码
	Screenshot   int    //截屏通知
	RevokeRemind int    //撤回提醒
	Blacklist    int    //黑名单
	Receipt      int    //消息是否回执
	Version      int64  // 版本
}

type SpaceSettingDB struct {
	// contains filtered or unexported fields
}

type SpaceSettingModel struct {
	UID                      string `db:"uid"`
	SpaceID                  string `db:"space_id"`
	VoiceInputEnabled        int    `db:"voice_input_enabled"`
	VoiceFeedbackOn          int    `db:"voice_feedback_on"`
	VoiceFeedbackNoticeAcked int    `db:"voice_feedback_notice_acked"`
}

type Status int

type UpdateLoginPasswordReq struct {
	UID         string // 用户uid
	Password    string // 用户旧密码
	NewPassword string // 用户新密码
}

type User struct {
	log.Log
	// contains filtered or unexported fields
}

type UserDetailResp struct {
	UID                 string            `json:"uid"`
	Name                string            `json:"name"`
	Username            string            `json:"username"`
	Email               string            `json:"email,omitempty"`              // email（仅自己能看）
	Zone                string            `json:"zone,omitempty"`               // 手机区号（仅自己能看）
	Phone               string            `json:"phone,omitempty"`              // 手机号（仅自己能看）
	Mute                int               `json:"mute"`                         // 免打扰
	Top                 int               `json:"top"`                          // 置顶
	Sex                 int               `json:"sex"`                          //性别1:男
	Category            string            `json:"category"`                     //用户分类 '客服'
	ShortNo             string            `json:"short_no"`                     // 用户唯一短编号
	ChatPwdOn           int               `json:"chat_pwd_on"`                  //是否开启聊天密码
	Screenshot          int               `json:"screenshot"`                   //截屏通知
	RevokeRemind        int               `json:"revoke_remind"`                //撤回提醒
	Receipt             int               `json:"receipt"`                      //消息是否回执
	Online              int               `json:"online"`                       //是否在线
	LastOffline         int               `json:"last_offline"`                 //最后一次离线时间
	DeviceFlag          config.DeviceFlag `json:"device_flag"`                  // 在线设备标记
	Follow              int               `json:"follow"`                       //是否是好友
	BeDeleted           int               `json:"be_deleted"`                   // 被删除
	BeBlacklist         int               `json:"be_blacklist"`                 // 被拉黑
	Code                string            `json:"code"`                         //加好友所需vercode TODO: code不再使用 请使用Vercode
	Vercode             string            `json:"vercode"`                      //
	SourceDesc          string            `json:"source_desc"`                  // 好友来源
	Remark              string            `json:"remark"`                       //好友备注
	IsUploadAvatar      int               `json:"is_upload_avatar"`             // 是否上传头像
	Status              int               `json:"status"`                       //用户状态 1 正常 2:黑名单
	Robot               int               `json:"robot"`                        // 机器人0.否1.是
	BotCommands         string            `json:"bot_commands,omitempty"`       // 机器人命令列表JSON
	BotDescription      string            `json:"bot_description,omitempty"`    // Bot 简介
	BotCreatorUID       string            `json:"bot_creator_uid,omitempty"`    // Bot 创建者 UID
	BotCreatorName      string            `json:"bot_creator_name,omitempty"`   // Bot 创建者昵称
	BotAutoApprove      int               `json:"bot_auto_approve,omitempty"`   // 是否自动通过好友 0:否 1:是
	BotAgentPlatform    string            `json:"bot_agent_platform,omitempty"` // Agent 平台名称
	BotAgentVersion     string            `json:"bot_agent_version,omitempty"`  // Agent 平台版本号
	BotPluginVersion    string            `json:"bot_plugin_version,omitempty"` // DMWork 插件版本号
	IsDestroy           int               `json:"is_destroy"`                   // 注销状态 0.正常 1.注销申请中（冷静期，仍可正常通信） 2.已注销
	Flame               int               `json:"flame"`                        // 是否开启阅后即焚
	FlameSecond         int               `json:"flame_second"`                 // 阅后即焚秒数
	JoinGroupInviteUID  string            `json:"join_group_invite_uid"`        // 加入群聊邀请人UID
	JoinGroupInviteName string            `json:"join_group_invite_name"`       // 加入群聊邀请人名称
	JoinGroupTime       string            `json:"join_group_time"`              // 加入群聊时间
	GroupMember         *GroupMemberResp  `json:"group_member,omitempty"`       // 群成员信息
	// OCTO 实名认证（YUJ-354 / GH#1300）
	// RealnameVerified：该用户是否已完成 OCTO 实名认证（user_verification 有记录）。
	// RealName：已认证时返回实名姓名；未认证留空。
	// 目前对外可见（含非自己），因为实名结果会进入前端 displayName() 展示；
	// 若后续产品要求"仅自己可见"，改为仅当 loginUID == m.UID 时填充即可。
	RealnameVerified bool   `json:"realname_verified"`
	RealName         string `json:"real_name,omitempty"`
	// RealnameVerifiedAt：实名认证完成时间 (Unix 秒)。未认证时为 0 被 omitempty 剥离。
	// 三端客户端（Web/Android/iOS）在 Custom Tabs 实名回跳后读此字段做
	// 「已认证 · YYYY-MM」展示；同时与 login / GET /v1/user/current 下发的
	// 字段名保持一致（YUJ-413）。
	RealnameVerifiedAt int64 `json:"realname_verified_at,omitempty"`
}

type UserUpdateReq struct {
	UID  string
	Name *string
}

type VerificationInfo struct {
	UID                string
	RealName           string
	RealnameVerifiedAt int64 // Unix 秒;未实名 / 时间零值时为 0
}