Method addOrUpdateAdmin

manage_admin/manage_admin.ts:250–347

(targetArg?: string, titleArg?: string)

          await resolveUserFromReplyOrArg(targetLike);
        if (!userEntity) {
          await msg.edit({ text: "请回复一条消息或提供 用户ID/用户名" });
          return;
        }

        // Normalize title (support clear keywords)
        const rawTitle = (title || "").trim();
        const titleIsProvided = title !== undefined;
        const normalizedTitle = [""].includes(rawTitle.toLowerCase())
          ? ""
          : rawTitle;
        // Telegram 限制头衔最长 16 字符
        const limitedTitle =
          normalizedTitle.length > 16
            ? normalizedTitle.slice(0, 16)
            : normalizedTitle;

        // Per spec: 权限默认只有 ban。无论此前是否为管理员，均设置为仅 ban 权限。
        const participant = await getCurrentParticipant(userEntity);
        // 不传头衔 = 清空
        let rankToUse = limitedTitle; // empty string clears
        let adminRightsToUse: Api.ChatAdminRights = new Api.ChatAdminRights({
          banUsers: true,
        });

        try {
          const client = await getGlobalClient();

          const isChannelChat = chatEntity instanceof Api.Channel;
          if (isChannelChat) {
            await client?.invoke(
              new Api.channels.EditAdmin({
                channel,
                userId: userEntity,
                adminRights: adminRightsToUse!,
                rank: rankToUse,
              })
            );
            // 等待服务器状态同步
            await sleep(1200);
          } else {
            // Basic group fallback: cannot set title/rights granularity
            await client?.invoke(
              new Api.messages.EditChatAdmin({
                chatId: (msg as any).chatId,
                userId: userEntity,
                isAdmin: true as any,
              })
            );
          }

          // Verify rank actually updated
          let appliedRank = rankToUse;
          let selfIsCreator = false;
          try {
            selfIsCreator = await getSelfIsCreator();
            const refreshed = await getCurrentParticipant(userEntity);
            if (
              refreshed instanceof Api.ChannelParticipantAdmin ||