Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

17.5 KB
Raw Blame
import { Button } from '@/components/ui/button';
import { ImConnectionError, ImSavedConnectionRecovery } from './ImConnectionRecovery';
import { useCallback, useMemo, useState } from 'react';
import { useTranslation } from 'react-i18next';
import {
  AlertTriangle,
  Check,
  ChevronDown,
  ChevronRight,
  Eye,
  EyeOff,
  Loader2,
  Power,
  PowerOff,
  Trash2,
} from 'lucide-react';

import { cn } from '@/lib/utils';
import { useConfirmDialog } from '@/components/ui/confirm-dialog-provider';
import { describeTelegramStatusFailure, useTelegramBot } from '@/hooks/useTelegramBot';
import { ImChannelSettingsCard, useImChannelSettingsSummary } from './ImChannelSettingsCard';
import { ImDefaultSettingsSection } from './ImDefaultSettingsSection';
import { TelegramRemoteDevices } from './TelegramRemoteDevices';
import {
  TelegramBehaviorSettings,
  TelegramGroupActivationSettings,
  TelegramPersonaSettings,
} from './TelegramBehaviorSettings';

const TELEGRAM_BOTFATHER_URL = 'https://t.me/BotFather';

const statusKey: Record<TelegramBotTransportStatus['kind'], string> = {
  idle: 'settings.telegramBot.status.needsConfig',
  connecting: 'settings.telegramBot.status.connecting',
  connected: 'settings.telegramBot.status.connected',
  conflict: 'settings.telegramBot.status.conflict',
  offline: 'settings.telegramBot.status.offline',
  error: 'settings.telegramBot.status.error',
};

/** 已有绑定的三档 —— 都带 appId(bot 数字 id), 卡片可直接展示。 */
type TelegramBoundStatus = Extract<TelegramBotTransportStatus, { appId: string }>;

/**
 * 有凭证的三档(已连接 / 被另一台占用 / 主动下线)都走已连接卡: 它们都不该
 * 显示 token 表单 —— 尤其 conflict, 落表单会让"被另一台设备占用"看起来像
 * "还没配置"。error(token 无效)与 connecting 仍走表单。
 */
function hasBinding(s: TelegramBotTransportStatus): s is TelegramBoundStatus {
  return s.kind === 'connected' || s.kind === 'offline' || s.kind === 'conflict';
}

function statusColor(s: TelegramBotTransportStatus): string {
  switch (s.kind) {
    case 'idle':
      return 'var(--settings-badge-needs-config)';
    case 'connecting':
    case 'conflict':
      return 'var(--settings-badge-saved)';
    // 主动下线是用户自己选的正常状态, 不是故障 —— 中性灰, 不用告警色。
    case 'offline':
      return 'var(--settings-badge-needs-config)';
    case 'connected':
      return 'var(--settings-badge-connected)';
    case 'error':
      return 'var(--settings-badge-error)';
  }
}

function statusTextColor(s: TelegramBotTransportStatus): string {
  return s.kind === 'connected' ? 'var(--settings-badge-connected-text)' : statusColor(s);
}

/** 个人 Telegram bot 设置卡 — 结构对齐 DiscordBotSection(token 手填模式)。 */
export function TelegramBotSection({
  expanded,
  onToggle,
}: {
  expanded: boolean;
  onToggle: () => void;
}) {
  const {
    token,
    setToken,
    ownerUserId,
    setOwnerUserId,
    status,
    botUsername,
    validationError,
    isSaving,
    isDisconnecting,
    isTogglingOnline,
    canConnect,
    connect,
    disconnect,
    setOnline,
  } = useTelegramBot();

  const [showToken, setShowToken] = useState(false);
  const [guideOpen, setGuideOpen] = useState(false);
  const [routeSummary, setRouteSummary] = useImChannelSettingsSummary('telegram');
  const { confirm } = useConfirmDialog();
  const { t } = useTranslation();

  const guideSteps = useMemo(
    () => [
      {
        title: t('settings.telegramBot.guide.step1.title'),
        body: t('settings.telegramBot.guide.step1.body'),
      },
      {
        title: t('settings.telegramBot.guide.step2.title'),
        body: t('settings.telegramBot.guide.step2.body'),
      },
      {
        title: t('settings.telegramBot.guide.step3.title'),
        body: t('settings.telegramBot.guide.step3.body'),
      },
      {
        title: t('settings.telegramBot.guide.step4.title'),
        body: t('settings.telegramBot.guide.step4.body'),
      },
    ],
    [t],
  );

  const handleDisconnectClick = useCallback(async () => {
    const confirmed = await confirm({
      title: t('settings.telegramBot.disconnectConfirm.title'),
      description: t('settings.telegramBot.disconnectConfirm.description'),
      confirmText: t('settings.telegramBot.disconnectConfirm.confirm'),
      cancelText: t('settings.telegramBot.disconnectConfirm.cancel'),
    });
    if (!confirmed) return;
    await disconnect();
  }, [confirm, disconnect, t]);

  const openBotFather = useCallback(() => {
    window.electronAPI.openExternal?.(TELEGRAM_BOTFATHER_URL);
  }, []);

  // 非 idle = 主进程已有保存的凭证(连接中/冲突/失败也算),表单区给小垃圾桶解绑入口。
  const hasSavedCreds = status.kind !== 'idle';

  return (
    <ImChannelSettingsCard
      id="personal-im-telegram"
      title={t('settings.telegramBot.title')}
      description={t('settings.telegramBot.description')}
      routeSummary={
        routeSummary
          ? `${t(`settings.imBot.defaults.agents.${routeSummary.agentKind}`)} · ${routeSummary.model}`
          : null
      }
      expanded={expanded}
      onToggle={onToggle}
      status={
        <span
          className={cn(
            'inline-flex items-center gap-1.5 rounded-full',
            'px-2.5 py-1',
            'bg-[var(--settings-badge-bg)]',
            'border border-[var(--settings-badge-border)]',
            'text-11 font-medium tracking-[0.12px]',
          )}
          style={{ letterSpacing: '0.12px', color: statusTextColor(status) }}
          role="status"
          aria-live="polite"
          aria-label={t('settings.telegramBot.statusAria', { status: t(statusKey[status.kind]) })}
        >
          <span
            className="h-1.5 w-1.5 rounded-full"
            style={{ backgroundColor: statusColor(status) }}
            aria-hidden
          />
          {t(statusKey[status.kind])}
        </span>
      }
    >
      <ImDefaultSettingsSection channel="telegram" embedded onSummaryChange={setRouteSummary} />
      <div className="h-px w-full bg-[var(--border-default)]" />
      <TelegramPersonaSettings />
      <div className="h-px w-full bg-[var(--border-default)]" />
      <TelegramBehaviorSettings />
      <div className="h-px w-full bg-[var(--border-default)]" />
      <TelegramGroupActivationSettings />
      <div className="h-px w-full bg-[var(--border-default)]" />
      {hasBinding(status) ? (
        <ConnectedCard
          status={status}
          botLabel={botUsername ? `@${botUsername}` : status.appId}
          ownerUserId={ownerUserId}
          isDisconnecting={isDisconnecting}
          isTogglingOnline={isTogglingOnline}
          onDisconnect={() => void handleDisconnectClick()}
          onToggleOnline={() => void setOnline(status.kind === 'offline')}
          remoteDevices={<TelegramRemoteDevices selfAppId={status.appId} />}
        />
      ) : (
        <div className="flex flex-col gap-3">
          <label
            className="text-12 font-medium text-[var(--settings-section-desc)]"
            style={{ letterSpacing: '0.12px' }}
          >
            {t('settings.telegramBot.tokenLabel')}
          </label>
          <div className="relative">
            <input
              type={showToken ? 'text' : 'password'}
              value={token}
              onChange={(e) => setToken(e.target.value)}
              placeholder={t('settings.telegramBot.tokenPlaceholder')}
              spellCheck={false}
              autoComplete="off"
              className={cn(
                'h-[42px] w-full rounded-full pl-[14px] pr-10',
                'bg-[var(--settings-input-bg)] border border-[var(--settings-input-border)]',
                'text-13 text-[var(--settings-input-text)] placeholder:text-[var(--settings-input-placeholder)]',
                'outline-none transition-colors focus:border-[var(--settings-input-border-focus)]',
              )}
              style={{ userSelect: 'text', WebkitUserSelect: 'text' }}
            />
            <button
              type="button"
              onClick={() => setShowToken(!showToken)}
              className="absolute right-[14px] top-1/2 -translate-y-1/2 text-[var(--settings-eye-icon)] transition-colors hover:text-[var(--settings-eye-icon-hover)]"
              aria-label={
                showToken
                  ? t('settings.telegramBot.hideToken')
                  : t('settings.telegramBot.showToken')
              }
            >
              {showToken ? <Eye size={18} /> : <EyeOff size={18} />}
            </button>
          </div>

          <label
            className="text-12 font-medium text-[var(--settings-section-desc)]"
            style={{ letterSpacing: '0.12px' }}
          >
            {t('settings.telegramBot.ownerUserIdLabel')}
          </label>
          <input
            type="text"
            value={ownerUserId}
            onChange={(e) => setOwnerUserId(e.target.value)}
            placeholder={t('settings.telegramBot.ownerUserIdPlaceholder')}
            spellCheck={false}
            autoComplete="off"
            inputMode="numeric"
            className={cn(
              'h-[42px] w-full rounded-full pl-[14px] pr-[14px]',
              'bg-[var(--settings-input-bg)] border border-[var(--settings-input-border)]',
              'text-13 text-[var(--settings-input-text)] placeholder:text-[var(--settings-input-placeholder)]',
              'outline-none transition-colors focus:border-[var(--settings-input-border-focus)]',
            )}
            style={{ userSelect: 'text', WebkitUserSelect: 'text' }}
          />

          <div className="flex min-h-[18px] items-center justify-between gap-3">
            <div className="min-w-0 flex-1">
              {validationError ? (
                <p className="text-12 text-[var(--settings-error-text)]" role="alert">
                  {validationError}
                </p>
              ) : status.kind === 'error' ? (
                <ImConnectionError
                  message={describeTelegramStatusFailure(status, t)}
                  details={status.reason}
                />
              ) : (
                <p className="text-12 text-[var(--settings-source-meta)]">
                  {t('settings.telegramBot.formHint')}
                </p>
              )}
            </div>
            {hasSavedCreds && (
              <button
                type="button"
                onClick={() => void handleDisconnectClick()}
                disabled={isDisconnecting}
                aria-label={t('settings.telegramBot.disconnectAria')}
                className={cn(
                  'mr-[4px] flex shrink-0 items-center justify-center bg-transparent p-0',
                  'text-[var(--settings-trash-icon)] transition-colors hover:text-[var(--settings-trash-icon-hover)]',
                  isDisconnecting && 'cursor-not-allowed opacity-40',
                )}
              >
                <Trash2 size={18} />
              </button>
            )}
          </div>

          {hasSavedCreds && ownerUserId && (
            <ImSavedConnectionRecovery
              loading={isTogglingOnline}
              disabled={isSaving || isDisconnecting}
              onReconnect={() => setOnline(true)}
            />
          )}

          <Button
            variant="cta"
            size="lg"
            loading={isSaving}
            type="button"
            onClick={() => void connect()}
            disabled={!canConnect}
            className="w-full"
          >
            {t('settings.telegramBot.connect')}
          </Button>
        </div>
      )}

      <div className="border-t border-[var(--settings-theme-card-border)] pt-3">
        <button
          type="button"
          onClick={() => setGuideOpen(!guideOpen)}
          className="flex w-full items-center justify-between gap-3 bg-transparent p-0 text-left"
          aria-expanded={guideOpen}
        >
          <span className="text-13 font-medium text-[var(--settings-section-title)]">
            {t('settings.telegramBot.guide.title')}
          </span>
          <span className="text-[var(--settings-section-desc)]">
            {guideOpen ? <ChevronDown size={16} /> : <ChevronRight size={16} />}
          </span>
        </button>

        {guideOpen && (
          <div className="mt-3 flex flex-col gap-3">
            {guideSteps.map((step, index) => (
              <div key={step.title} className="flex gap-3">
                <span className="flex h-5 w-5 shrink-0 items-center justify-center rounded-full border border-[var(--settings-badge-border)] bg-[var(--settings-badge-bg)] text-11 font-medium text-[var(--settings-section-title)]">
                  {index + 1}
                </span>
                <div className="min-w-0">
                  <div className="text-12 font-medium text-[var(--settings-section-title)]">
                    {step.title}
                  </div>
                  <div className="mt-0.5 text-12 leading-[1.6] text-[var(--settings-section-desc)]">
                    {step.body}
                  </div>
                </div>
              </div>
            ))}
            <button
              type="button"
              onClick={openBotFather}
              className="w-fit cursor-pointer bg-transparent p-0 text-12 font-medium text-[var(--settings-source-link)] underline decoration-[var(--settings-source-link)] decoration-1 underline-offset-2"
            >
              {t('settings.telegramBot.guide.openBotFather')}
            </button>
          </div>
        )}
      </div>
    </ImChannelSettingsCard>
  );
}

/** 已绑定状态卡(已连接 / 已下线 / 被占用三档共用) —— 结构对齐 DiscordBotSection。 */
function ConnectedCard(props: {
  status: TelegramBoundStatus;
  botLabel: string;
  ownerUserId: string;
  isDisconnecting: boolean;
  isTogglingOnline: boolean;
  onDisconnect: () => void;
  onToggleOnline: () => void;
  /** 「我的其他设备」区块;无其他设备时组件自身渲染 null。 */
  remoteDevices: React.ReactNode;
}) {
  const { t } = useTranslation();
  const kind = props.status.kind;
  const isOffline = kind === 'offline';
  const busy = props.isDisconnecting || props.isTogglingOnline;
  const headingKey =
    kind === 'offline'
      ? 'settings.telegramBot.connected.headingOffline'
      : kind === 'conflict'
        ? 'settings.telegramBot.connected.headingConflict'
        : 'settings.telegramBot.connected.heading';
  const noteKey =
    kind === 'offline'
      ? 'settings.telegramBot.connected.noteOffline'
      : kind === 'conflict'
        ? 'settings.telegramBot.connected.noteConflict'
        : 'settings.telegramBot.connected.note';
  return (
    <div
      className={cn(
        'mt-1 flex flex-col gap-3 rounded-xl p-5',
        'border border-[var(--settings-theme-card-border)]',
        'bg-[var(--settings-theme-card-bg)]',
      )}
    >
      <div className="flex items-start gap-3">
        <div
          className={cn(
            'mt-0.5 flex h-8 w-8 shrink-0 items-center justify-center rounded-full',
            'border border-[var(--settings-badge-border)] bg-[var(--settings-badge-bg)]',
          )}
          style={{ color: statusColor(props.status) }}
        >
          {kind === 'offline' ? (
            <PowerOff size={16} />
          ) : kind === 'conflict' ? (
            <AlertTriangle size={16} />
          ) : (
            <Check size={16} />
          )}
        </div>
        <div className="min-w-0 flex-1">
          <div className="text-13 font-medium text-[var(--settings-section-title)]">
            {t(headingKey)}
          </div>
          <div className="mt-1 text-12 leading-[1.6] text-[var(--settings-section-desc)]">
            {t(noteKey)}
          </div>
        </div>
      </div>
      <div className="grid gap-2 text-12 text-[var(--settings-section-desc)]">
        <div className="flex justify-between gap-4">
          <span>{t('settings.telegramBot.connected.botLabel')}</span>
          <span className="font-medium text-[var(--settings-section-title)]">{props.botLabel}</span>
        </div>
        <div className="flex justify-between gap-4">
          <span>{t('settings.telegramBot.connected.ownerLabel')}</span>
          <span className="font-medium text-[var(--settings-section-title)]">
            {props.ownerUserId || '—'}
          </span>
        </div>
      </div>
      <div className="flex gap-2 pt-1">
        {/* 下线/上线: 可逆且零数据损失, 不加二次确认(解绑才需要确认)。 */}
        <Button
          variant="secondary"
          size="lg"
          loading={props.isTogglingOnline}
          type="button"
          onClick={props.onToggleOnline}
          disabled={busy}
          className="flex-1"
        >
          {props.isTogglingOnline ? (
            <span className="inline-flex animate-spin motion-reduce:animate-none" aria-hidden>
              <Loader2 size={13} />
            </span>
          ) : isOffline ? (
            <Power size={13} />
          ) : (
            <PowerOff size={13} />
          )}
          {props.isTogglingOnline
            ? t(
                isOffline
                  ? 'settings.telegramBot.goingOnlineAction'
                  : 'settings.telegramBot.goingOfflineAction',
              )
            : t(isOffline ? 'settings.telegramBot.goOnline' : 'settings.telegramBot.goOffline')}
        </Button>
        <Button
          variant="secondary"
          size="lg"
          loading={props.isDisconnecting}
          type="button"
          onClick={props.onDisconnect}
          disabled={busy}
          className="flex-1"
        >
          <Trash2 size={13} />
          {t('settings.telegramBot.disconnect')}
        </Button>
      </div>
      {props.remoteDevices}
    </div>
  );
}