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。

19.9 KB
Raw Blame
/**
 * 单个 IM 渠道的新会话设置。
 *
 * 每个渠道保存自己的 Agent / 模型路由。现有 IM 会话不会因为这里保存而被
 * 静默改写;非 thread 渠道通过 `/new` 显式应用。
 */

import { useModelPickerAgents } from '@/hooks/useAvailableAgents';
import {
  connectedProvidersForAgent,
  getModel,
  isModelSelectableForNewRoute,
} from '@cindy/model-providers';
import { MessageSquare, AlertTriangle } from 'lucide-react';
import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
import { useTranslation } from 'react-i18next';

import { ModelSelector } from '@/components/new-chat/ModelSelector';
import { useProviderShareAgentDevices } from '@/features/provider-share/useProviderShareAgentDevices';
import { PermissionSelector } from '@/components/new-chat/PermissionSelector';
import { type ModelDescriptor, useAgentCapabilities } from '@/hooks/useAgentCapabilities';
import { useProviders } from '@/hooks/useProviders';
import { useDeviceProviders } from '@/hooks/useDeviceProviders';
import { deriveModelsFromProviders } from '@/lib/providerModels';
import { toast } from '@/lib/toast';
import type { Effort } from '@/lib/userPreferences.types';
import { cn } from '@/lib/utils';
import {
  IM_DEFAULT_EFFORT_OVERRIDES,
  IM_DEFAULT_SETTINGS,
  isUnconditionalTurnPolicyChannel,
  isImDefaultPermissionMode,
  type ImDefaultAgentKind,
  type ImDefaultEffort,
  type ImDefaultSettingsChannel,
  type ImDefaultSettingsPatch,
  type ImDefaultSettingsState,
  isImDefaultEffort,
} from '../../../shared/imDefaultSettings';
import { DefaultOverrideControls } from './DefaultOverrideControls';
import { Button } from '@/components/ui/button';
import { buildAgentSettingsPatch, mergeSettingsPatch } from './imDefaultSettingsLogic';

function vendorKeyFor(agentKind: ImDefaultAgentKind): 'cc' | 'codex' | 'pi' {
  return agentKind === 'claude-code' ? 'cc' : agentKind;
}

/** AgentSelect 的 vendor → IM 默认配置的 agentKind。 */
function agentKindOfVendor(vendor: string): ImDefaultAgentKind {
  return vendor === 'cc' ? 'claude-code' : vendor === 'pi' ? 'pi' : 'codex';
}

export interface ImDefaultSettingsSummary {
  agentKind: ImDefaultAgentKind;
  model: string;
}

export function ImDefaultSettingsSection({
  channel,
  descriptionChannel = channel,
  embedded = false,
  onSummaryChange,
}: {
  /** Omit to edit the global defaults used by official hook channels. */
  channel?: ImDefaultSettingsChannel;
  /**
   * 只换说明文案的键(不影响读写 scope)。
   *
   * 官方 hook 卡曾有一个 'officialHook' 变体(写 global scope), 已随「新对话配置」
   * 区块一并移除 —— 它与目录行的 agent/model/effort 是同一份配置的两个入口, 画成
   * 平级两套只会让人以为可以分别设。global scope 仍是目录行的兜底层, 只是不再有
   * UI 入口(与 X 卡今天一致)。
   */
  descriptionChannel?: ImDefaultSettingsChannel;
  embedded?: boolean;
  onSummaryChange?: (summary: ImDefaultSettingsSummary | null) => void;
}) {
  const { t } = useTranslation();
  const [settings, setSettings] = useState<ImDefaultSettingsState | null>(null);
  const [pending, setPending] = useState(false);
  const settingsRequestVersion = useRef(0);
  const agentDeviceId = settings?.agents[settings.agentKind].agentDeviceId ?? null;
  const local = useProviders();
  const remote = useDeviceProviders(agentDeviceId ?? undefined);
  const providers = agentDeviceId ? remote.providers : local.providers;
  const cc = useAgentCapabilities('claude-code', agentDeviceId ?? undefined);
  const codex = useAgentCapabilities('codex', agentDeviceId ?? undefined);
  const pi = useAgentCapabilities('pi', agentDeviceId ?? undefined);
  const sharedDevices = useProviderShareAgentDevices([agentDeviceId]);

  const pickerAgents = useModelPickerAgents(settings?.agentKind ?? 'claude-code', agentDeviceId);

  useEffect(() => {
    let cancelled = false;
    const version = ++settingsRequestVersion.current;
    setSettings(null);
    setPending(false);
    void window.electronAPI.maker
      .imDefaultSettingsGet(channel)
      .then((state) => {
        if (!cancelled && version === settingsRequestVersion.current) setSettings(state);
      })
      .catch((err) => {
        if (!cancelled) {
          toast.error(err instanceof Error ? err.message : t('settings.imBot.defaults.loadFailed'));
        }
      });
    return () => {
      cancelled = true;
      if (version === settingsRequestVersion.current) settingsRequestVersion.current++;
    };
  }, [channel, t]);

  useEffect(() => {
    if (!settings) return;
    onSummaryChange?.({
      agentKind: settings.agentKind,
      model: settings.agents[settings.agentKind].model,
    });
  }, [onSummaryChange, settings]);

  const modelsByAgent = useMemo<Record<ImDefaultAgentKind, ModelDescriptor[]>>(() => {
    // 准入口径:IM 默认模型是「从零挑一个」的清单,停用的供应商/模型与能力模型
    // 不该可选 —— 否则 headless runner 派发时才降级换模型,用户无感(PR #744 review)。
    const fromProviders = {
      'claude-code': deriveModelsFromProviders(providers, 'claude-code', {
        admissionFiltered: true,
      }),
      codex: deriveModelsFromProviders(providers, 'codex', { admissionFiltered: true }),
      pi: deriveModelsFromProviders(providers, 'pi', { admissionFiltered: true }),
    };
    return {
      'claude-code': fromProviders['claude-code'].length
        ? fromProviders['claude-code']
        : (cc.capabilities?.availableModels ?? []),
      codex: fromProviders.codex.length
        ? fromProviders.codex
        : (codex.capabilities?.availableModels ?? []),
      pi: fromProviders.pi.length ? fromProviders.pi : (pi.capabilities?.availableModels ?? []),
    };
  }, [providers, cc.capabilities, codex.capabilities, pi.capabilities]);

  const resolveProviderId = useCallback(
    (agentKind: ImDefaultAgentKind, modelId: string, providerId: string | null): string | null => {
      if (!providerId) return null;
      const provider = connectedProvidersForAgent(providers, agentKind).find(
        (p) => p.id === providerId,
      );
      if (!provider) return null;
      // 只看 id 是否存在不够(issue #882 第 3 点,2026-07 review 第 18 轮):该来源这份
      // 具体条目若是非聊天类型,不能落成 IM 渠道的显式默认来源,否则渠道发消息会打进
      // image/audio/embedding 端点。
      const catalogModel = getModel(provider, modelId, agentKind);
      return catalogModel &&
        isModelSelectableForNewRoute(catalogModel, { userProvider: provider.source === 'user' })
        ? providerId
        : null;
    },
    [providers],
  );

  const resolveEffort = useCallback(
    (agentKind: ImDefaultAgentKind, modelId: string, requested: Effort): ImDefaultEffort => {
      const model = modelsByAgent[agentKind].find((m) => m.id === modelId);
      const requestedEffort = toImDefaultEffort(requested);
      if (!model || model.efforts.length === 0) {
        return requestedEffort ?? IM_DEFAULT_SETTINGS.agents[agentKind].effort;
      }
      if (requestedEffort && model.efforts.includes(requestedEffort)) return requestedEffort;
      const override = IM_DEFAULT_EFFORT_OVERRIDES[modelId];
      if (override && model.efforts.includes(override)) return override;
      const defaultEffort = toImDefaultEffort(model.defaultEffort);
      if (defaultEffort && model.efforts.includes(defaultEffort)) return defaultEffort;
      return toImDefaultEffort(model.efforts[0]) ?? IM_DEFAULT_SETTINGS.agents[agentKind].effort;
    },
    [modelsByAgent],
  );

  const persist = useCallback(
    async (patch: ImDefaultSettingsPatch) => {
      if (!settings || pending) return false;
      // A displayed automatic route may use a different engine than the stored empty default.
      if (patch.agents && !patch.agentKind) patch = { ...patch, agentKind: settings.agentKind };
      const previous = settings;
      const version = ++settingsRequestVersion.current;
      setPending(true);
      setSettings(mergeSettingsPatch(settings, patch));
      try {
        const next = await window.electronAPI.maker.imDefaultSettingsSet(patch, channel);
        if (version === settingsRequestVersion.current) setSettings(next);
        return true;
      } catch (err) {
        if (version !== settingsRequestVersion.current) return false;
        setSettings(previous);
        toast.error(err instanceof Error ? err.message : t('settings.imBot.defaults.saveFailed'));
        return false;
      } finally {
        if (version === settingsRequestVersion.current) setPending(false);
      }
    },
    [channel, pending, settings, t],
  );

  const reset = useCallback(async () => {
    if (pending) return;
    const version = ++settingsRequestVersion.current;
    setPending(true);
    try {
      const next = await window.electronAPI.maker.imDefaultSettingsReset(channel);
      if (version !== settingsRequestVersion.current) return;
      setSettings(next);
      toast.success(t('settings.defaults.restored'));
    } catch (err) {
      if (version !== settingsRequestVersion.current) return;
      toast.error(err instanceof Error ? err.message : t('settings.defaults.restoreFailed'));
    } finally {
      if (version === settingsRequestVersion.current) setPending(false);
    }
  }, [channel, pending, t]);

  const automaticMode =
    settings?.automaticModel ?? (settings ? !settings.agents[settings.agentKind].model : false);
  useEffect(() => {
    if (!automaticMode || pending || local.loading) return;
    const version = ++settingsRequestVersion.current;
    void window.electronAPI.maker
      .imDefaultSettingsGet(channel)
      .then((next) => {
        if (version === settingsRequestVersion.current) setSettings(next);
      })
      .catch(() => {
        // Retain the last display snapshot; normal settings writes report their own errors.
      });
    return () => {
      if (version === settingsRequestVersion.current) settingsRequestVersion.current++;
    };
  }, [automaticMode, channel, local.loading, local.providers, pending]);

  if (!settings) {
    return (
      <div
        className={cn(
          'text-13 text-[var(--text-tertiary)]',
          embedded
            ? 'py-2'
            : 'rounded-xl border border-[var(--settings-theme-card-border)] bg-[var(--settings-theme-card-bg)] px-4 py-5',
        )}
      >
        {t('settings.imBot.defaults.loading')}
      </div>
    );
  }

  const activeSettings = settings.agents[settings.agentKind];
  const automaticModel = settings.automaticModel ?? !activeSettings.model;
  // 按选中 Agent 的 capabilities 判断:未声明 / 声明了但 supported.supported !== true
  // 的 Agent(如 Pi)无法在「无条件挂逐条权限确认」的渠道(个人微信)使用。不写死 Pi——
  // 未来 Pi 补上该 capability、或新增其它不支持的 Agent 时,此处自动跟随 main 侧
  // 的 capability 真相,不会误警告 / 漏警告。(Telegram / 钉钉仅在群聊挂 policy,
  // 主人私聊 Pi 可用,设置 UI 不区分群聊/私聊,故不整体警告。)
  const selectedAgentCaps =
    settings.agentKind === 'claude-code' ? cc : settings.agentKind === 'codex' ? codex : pi;
  const selectedAgentCapabilitiesReady =
    !selectedAgentCaps.loading &&
    selectedAgentCaps.error === null &&
    selectedAgentCaps.capabilities !== null;
  const selectedTurnPolicy = selectedAgentCaps.capabilities?.turnPermissionPolicy;
  const selectedAgentUnsupported =
    selectedAgentCapabilitiesReady && selectedTurnPolicy?.supported.supported !== true;
  const selectedPermissionModeUnsupported =
    selectedAgentCapabilitiesReady &&
    selectedTurnPolicy?.supported.supported === true &&
    selectedTurnPolicy.unsupportedPermissionModes.includes(settings.permissionMode);
  // 渠道默认权限模式若是换 Agent 后仍不兼容的档位(Claude Code / Codex 的
  // unsupportedPermissionModes 并集:bypassPermissions / acceptEdits),仅换 Agent
  // 会在新会话(/new)上再次命中权限模式错误,警告需附加 /permission 提示。
  const modeUnsupportedAfterSwitch =
    settings.permissionMode === 'bypassPermissions' || settings.permissionMode === 'acceptEdits';
  const turnPolicyWarning =
    channel !== undefined && isUnconditionalTurnPolicyChannel(channel)
      ? selectedAgentUnsupported
        ? 'agent'
        : selectedPermissionModeUnsupported
          ? 'mode'
          : null
      : null;

  const changeModel = (
    model: string,
    providerId: string | null = activeSettings.providerId,
    reconciledEffort?: Effort,
  ) => {
    const nextProviderId = agentDeviceId
      ? providerId
      : resolveProviderId(settings.agentKind, model, providerId);
    const effort = isImDefaultEffort(reconciledEffort)
      ? reconciledEffort
      : resolveEffort(settings.agentKind, model, activeSettings.effort);
    return persist(
      buildAgentSettingsPatch(settings.agentKind, {
        ...activeSettings,
        model,
        providerId: nextProviderId,
        effort,
      }),
    );
  };

  const changeEffort = (effort: Effort) => {
    if (!isImDefaultEffort(effort) || effort === activeSettings.effort) return;
    return persist(
      buildAgentSettingsPatch(settings.agentKind, {
        ...activeSettings,
        effort,
      }),
    );
  };

  return (
    <section
      className={cn(
        'flex flex-col gap-[18px]',
        embedded
          ? 'py-1'
          : [
              'rounded-xl p-4',
              'border border-[var(--settings-theme-card-border)]',
              'bg-[var(--settings-theme-card-bg)]',
            ],
      )}
      aria-label={t('settings.imBot.defaults.title')}
    >
      <div className="flex items-start justify-between gap-3">
        <div className="flex min-w-0 items-start gap-3">
          <div className="flex h-9 w-9 shrink-0 items-center justify-center rounded-lg bg-[var(--settings-input-bg)]">
            <MessageSquare size={18} className="text-[var(--settings-section-title)]" />
          </div>
          <div className="min-w-0">
            <h3 className="text-14 font-medium leading-none text-[var(--settings-section-title)]">
              {t('settings.imBot.defaults.title')}
            </h3>
            <p className="mt-2 text-12 leading-[1.45] text-[var(--settings-section-desc)]">
              {t(`settings.imBot.defaults.channelDescriptions.${descriptionChannel}`)}
            </p>
          </div>
        </div>
        <DefaultOverrideControls
          isCustomized={settings.isCustomized}
          disabled={pending}
          onReset={() => void reset()}
        />
      </div>

      <div>
        <div className="flex flex-col gap-2">
          <span className="text-12 font-medium text-[var(--text-secondary)]">
            {t('settings.imBot.defaults.modelLabel')}
          </span>
          <div className="flex flex-wrap items-center justify-between gap-2 text-12 text-[var(--text-secondary)]">
            <span>
              {t(
                automaticModel
                  ? 'settings.imBot.defaults.automatic'
                  : 'settings.imBot.defaults.fixed',
              )}
            </span>
            {!automaticModel && (
              <Button
                size="sm"
                tone="quiet"
                disabled={pending}
                onClick={() =>
                  void persist({
                    agentKind: IM_DEFAULT_SETTINGS.agentKind,
                    agents: IM_DEFAULT_SETTINGS.agents,
                  })
                }
              >
                {t('settings.imBot.defaults.useAutomatic')}
              </Button>
            )}
          </div>
          {automaticModel && !activeSettings.model && (
            <p className="text-12 text-[var(--text-secondary)]">
              {t('settings.imBot.defaults.automaticUnavailable')}
            </p>
          )}
          <ModelSelector
            remoteAgent={{ devices: sharedDevices.devices, selectedDeviceId: agentDeviceId }}
            fastModeConfigurable={false}
            unifiedAgents={pickerAgents}
            onUnifiedSelect={({ engine, modelId, providerId, effort, agentDevice }) => {
              const agentKind = agentKindOfVendor(engine);
              return persist({
                agentKind,
                ...buildAgentSettingsPatch(agentKind, {
                  ...settings.agents[agentKind],
                  model: modelId,
                  providerId,
                  agentDeviceId: agentDevice?.deviceId ?? null,
                  effort: isImDefaultEffort(effort)
                    ? effort
                    : resolveEffort(agentKind, modelId, ''),
                }),
              });
            }}
            modelId={activeSettings.model}
            effort={activeSettings.effort}
            onModelChange={(modelId) => changeModel(modelId)}
            onEffortChange={changeEffort}
            vendorKey={vendorKeyFor(settings.agentKind)}
            currentProviderId={activeSettings.providerId}
            onProviderChange={(providerId, modelId, reconciledEffort) => {
              changeModel(modelId ?? activeSettings.model, providerId, reconciledEffort);
            }}
            switching={pending}
            triggerVariant="field"
            popoverSide="bottom"
          />
        </div>
      </div>

      {/* 飞书专属: 群里新建任务统一用的权限档(默认自动审批) —— 群里 @bot 开话题、
          群里 /new、群里 /ctr 都以它为准, 上面那个权限档只管私聊。群上下文含成员
          可控内容; 用户显式选择「完全访问」时群护栏取缔(不挂强确认策略, 直接
          执行), 防注入过滤仍独立生效。共享 PermissionSelector — 权限语义与
          新建对话工具栏同一份。 */}
      {channel === 'feishu' && (
        <div className="flex flex-col gap-2">
          <span className="text-12 font-medium text-[var(--text-secondary)]">
            {t('settings.imBot.defaults.groupPermissionLabel')}
          </span>
          <PermissionSelector
            permissionMode={settings.groupPermissionMode}
            vendorKey={vendorKeyFor(settings.agentKind)}
            triggerVariant="field"
            disabled={pending}
            ariaContext={t('settings.imBot.defaults.groupPermissionLabel')}
            onPermissionModeChange={(mode) => {
              if (isImDefaultPermissionMode(mode)) {
                void persist({ groupPermissionMode: mode });
              }
            }}
          />
          <p className="text-11 leading-[1.45] text-[var(--text-secondary)]">
            {t('settings.imBot.defaults.groupPermissionDescription')}
          </p>
        </div>
      )}

      {turnPolicyWarning && (
        <div
          role="status"
          aria-live="polite"
          aria-atomic="true"
          className="flex items-start gap-2 rounded-lg bg-[var(--warning-bg-soft)] px-3 py-2"
        >
          <AlertTriangle
            size={14}
            className="mt-0.5 shrink-0 text-[var(--warning-fg)]"
            aria-hidden
          />
          <div className="min-w-0">
            {turnPolicyWarning === 'agent' ? (
              <>
                <p className="text-11 leading-[1.45] text-[var(--text-secondary)]">
                  {t('settings.imBot.defaults.agentUnsupportedOnChannelHint', {
                    agent: t(`settings.imBot.defaults.agents.${settings.agentKind}`),
                  })}
                </p>
                {modeUnsupportedAfterSwitch && (
                  <p className="mt-1 text-11 leading-[1.45] text-[var(--text-secondary)]">
                    {t('settings.imBot.defaults.agentUnsupportedOnChannelModeHint')}
                  </p>
                )}
              </>
            ) : (
              <p className="text-11 leading-[1.45] text-[var(--text-secondary)]">
                {t('settings.imBot.defaults.permissionModeUnsupportedOnChannelHint')}
              </p>
            )}
          </div>
        </div>
      )}
    </section>
  );
}

function toImDefaultEffort(effort: Effort | null | undefined): ImDefaultEffort | null {
  return isImDefaultEffort(effort) ? effort : null;
}