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.6 KB
Raw Blame
/**
 * MemorySection — Settings → Personalization 下的 Memory 控制面板。
 * ---------------------------------------------------------------------------
 *
 * 数据流:
 *   - 加载: window.electronAPI.maker.memoryGet(agentKind) on mount + agent
 *           不支持时 (BaseAgent throw NotSupported) row 整行 disable
 *   - 切换: memorySet → 返回 effective + settings override state,
 *           'next-session' 时 toast 提示 "新会话生效"
 *   - 重置: 必走 useConfirmDialog 二次确认, 确认后 memoryReset → toast 反馈条目数
 *
 * 跟 UserPromptSection 同视觉栈 (settings-* css var token), Memory 主标题用同
 * 的 16/medium, 卡片 bg/border 用 settings-theme-card-* token。
 */
import { useCallback, useEffect, useRef, useState, type ReactNode } from 'react';
import { useTranslation } from 'react-i18next';
import { RotateCcw, Sparkles } from 'lucide-react';

import { cn } from '@/lib/utils';
import { toast } from '@/lib/toast';
import { Switch } from '@/components/ui/switch';
import { useConfirmDialog } from '@/components/ui/confirm-dialog-provider';
import { ClaudeMark } from '@/components/icons/ClaudeMark';
import { CodexMark } from '@/components/icons/CodexMark';
import { PiMark } from '@/components/icons/PiMark';
import { createLogger } from '@/lib/logger';
import { useMemorySettings } from '@/hooks/useMemorySettings';
import { DefaultOverrideControls } from './DefaultOverrideControls';

const log = createLogger('MemorySection');

type AgentKind = 'claude-code' | 'codex' | 'pi';

interface AgentDescriptor {
  kind: AgentKind;
  /** 本地化展示用的稳定 key 段,与 i18n 表 settings.memory.agents.<key>.* 对齐。
      品牌名 (Claude / Codex) 不翻译,由 i18n 表里的 label 字段提供。 */
  Mark: () => ReactNode;
  /** Pi 的压缩记忆写入 Cindy Memory;其开关仅在 Cindy Memory 启用时有意义。 */
  requiresMaker?: boolean;
}

const AGENTS: readonly AgentDescriptor[] = [
  {
    kind: 'claude-code',
    Mark: () => <ClaudeMark size={18} className="text-[var(--settings-section-title)]" />,
  },
  {
    kind: 'codex',
    Mark: () => <CodexMark size={18} className="text-[var(--settings-section-title)]" />,
  },
  {
    kind: 'pi',
    Mark: () => <PiMark size={18} className="text-[var(--settings-section-title)]" />,
    requiresMaker: true,
  },
] as const;

interface MemorySlotState {
  /** undefined = 加载中; null = 不支持 (NotSupported / IPC 异常) */
  enabled: boolean | null | undefined;
  /** 防 toggle race —— 网络飞行时禁掉点击 */
  pending: boolean;
}

const INITIAL: MemorySlotState = { enabled: undefined, pending: false };

export function MemorySection() {
  const { confirm } = useConfirmDialog();
  const { t } = useTranslation();
  // Maker Memory 启用时,下方 Claude Code / Codex 运行时的原生 toggle 强制 disable + 视觉变灰。
  // (manager.enable() 在 maker-core 层会自动调 setMemory(false), 这里 UI 防止用户
  // 在状态不同步的窗口里点击 toggle 引发误解)。
  const { makerEnabled, setMakerEnabled } = useMemorySettings();
  const [settingsCustomized, setSettingsCustomized] = useState(false);
  const [slots, setSlots] = useState<Record<AgentKind, MemorySlotState>>({
    'claude-code': INITIAL,
    codex: INITIAL,
    pi: INITIAL,
  });
  // pending 飞行中跳过 reload — 否则 toggle/reset 飞行期间 focus 触发 reload 会
  // 把用户刚改的乐观值或回滚状态覆盖掉。任一 slot pending 都跳过整轮 reload。
  const slotsRef = useRef(slots);
  slotsRef.current = slots;

  // 加载/刷新: 各 agent 独立, 一个失败不影响另一个 (Promise.allSettled)。
  // 触发时机:
  //   1. mount       — useEffect 首跑
  //   2. window focus — 兜底外部改动 (e.g. 用户手动删 ~/.claude/projects/*/memory/,
  //                     或另一个 desktop 实例改了 memory)。Settings tab 切换本身
  //                     已经走 conditional render → unmount/remount, 不需要这里管。
  //   3. Maker toggle — manager.enable() 联动调 setMemory(false) 后必须 reload,
  //                     否则下方 slots 显示 stale 旧值跟真实 agent state 不符
  const reloadSlots = useCallback(async () => {
    if (Object.values(slotsRef.current).some((s) => s.pending)) return;
    const results = await Promise.allSettled(
      AGENTS.map((a) => window.electronAPI.maker.memoryGet(a.kind)),
    );
    setSlots((prev) => {
      if (Object.values(prev).some((s) => s.pending)) return prev;
      const next = { ...prev };
      AGENTS.forEach((a, i) => {
        const r = results[i];
        if (r.status === 'fulfilled') {
          next[a.kind] = { enabled: r.value.enabled, pending: false };
        } else {
          log.warn(`memoryGet(${a.kind}) failed`, r.reason);
          next[a.kind] = { enabled: null, pending: false };
        }
      });
      return next;
    });
  }, []);

  useEffect(() => {
    void reloadSlots();
    void window.electronAPI.maker.memoryGetSettingsState()
      .then((settings) => setSettingsCustomized(settings.isCustomized))
      .catch(() => undefined);
    const onFocus = () => void reloadSlots();
    window.addEventListener('focus', onFocus);
    return () => {
      window.removeEventListener('focus', onFocus);
    };
  }, [reloadSlots]);

  const handleResetSettings = useCallback(async () => {
    setMakerTogglePending(true);
    try {
      const settings = await window.electronAPI.maker.memoryResetSettings();
      setMakerEnabled(settings.maker);
      setSettingsCustomized(settings.isCustomized);
      await reloadSlots();
      // codexRestartDeferred: Codex 正忙时设置已生效, 只是存活会话要等任务结束后
      // 才换到新状态 — 信息性后缀, 不用 warning (同 per-agent 'next-session' 语义)。
      const suffix = settings.codexRestartDeferred
        ? t('settings.memory.maker.toast.deferredSuffix')
        : '';
      toast.success(`${t('settings.defaults.restored')}${suffix}`);
    } catch (err) {
      log.warn('memoryResetSettings failed', err);
      toast.error(err instanceof Error ? err.message : t('settings.defaults.restoreFailed'));
    } finally {
      setMakerTogglePending(false);
    }
  }, [reloadSlots, setMakerEnabled, t]);

  const handleToggle = useCallback(
    async (kind: AgentKind, next: boolean, label: string) => {
      setSlots((prev) => ({ ...prev, [kind]: { enabled: prev[kind].enabled, pending: true } }));
      try {
        const result = await window.electronAPI.maker.memorySet(kind, next);
        setSlots((prev) => ({ ...prev, [kind]: { enabled: next, pending: false } }));
        setSettingsCustomized(result.isCustomized);
        // 操作本身成功 → success(绿). next-session 只是信息性后缀, 不用 warning ——
        // 警告色会让用户误以为出错。文案 suffix 已经把 "新会话生效" 说清楚了。
        const suffix =
          result.effective === 'next-session' ? t('settings.memory.agent.toast.takesEffectSuffix') : '';
        const baseKey = next
          ? 'settings.memory.agent.toast.enabled'
          : 'settings.memory.agent.toast.disabled';
        toast.success(`${t(baseKey, { label })}${suffix}`);
      } catch (err) {
        log.warn(`memorySet(${kind}) failed`, err);
        toast.error(
          err instanceof Error ? err.message : t('settings.memory.agent.toast.toggleFailed'),
        );
        setSlots((prev) => ({ ...prev, [kind]: { ...prev[kind], pending: false } }));
      }
    },
    [t],
  );

  // Maker toggle: 先 await IPC (manager.enable/disable + 联动 setMemory(false)),
  // 成功后更新 store + reload native slots (避免显示 stale 旧值)。
  const [makerTogglePending, setMakerTogglePending] = useState(false);
  const handleMakerToggle = useCallback(
    async (next: boolean) => {
      // 乐观更新: 立即翻 toggle 视觉, 让用户感觉跟手 (IPC 内部调用几乎不会失败)
      const prev = makerEnabled;
      setMakerEnabled(next);
      setMakerTogglePending(true);
      try {
        const result = await window.electronAPI.maker.makerMemorySetEnabled(next);
        setSettingsCustomized(result.isCustomized);
        // enable 时联动调过 setMemory(false) → 下方 slots 真实 state 已变, 必须 reload
        // disable 不动 native, 但仍 reload 一次保证 UI 跟实际对齐 (零成本兜底)
        await reloadSlots();
        // codexRestartDeferred: Codex 正忙, 存活会话等任务结束后自动换新状态。
        // 操作本身成功 → success(绿) + 信息性后缀, 同 per-agent 'next-session' 处理。
        const suffix = result.codexRestartDeferred
          ? t('settings.memory.maker.toast.deferredSuffix')
          : '';
        toast.success(
          `${t(next ? 'settings.memory.maker.toast.enabled' : 'settings.memory.maker.toast.disabled')}${suffix}`,
        );
      } catch (err) {
        log.warn('makerMemorySetEnabled failed', err);
        toast.error(
          err instanceof Error ? err.message : t('settings.memory.maker.toast.toggleFailed'),
        );
        setMakerEnabled(prev); // 回滚乐观值
      } finally {
        setMakerTogglePending(false);
      }
    },
    [makerEnabled, setMakerEnabled, reloadSlots, t],
  );

  // Maker Memory 整库重置 — 删 <userData>/maker-memory/ 全部 workdir 目录,
  // 不论当前 makerEnabled 值 (即使关着也能清, 跟 native reset 同语义)。
  const [makerResetPending, setMakerResetPending] = useState(false);
  const handleMakerReset = useCallback(async () => {
    const ok = await confirm({
      title: t('settings.memory.maker.resetConfirm.title'),
      description: t('settings.memory.maker.resetConfirm.description'),
      confirmText: t('settings.memory.maker.resetConfirm.confirm'),
      cancelText: t('settings.memory.maker.resetConfirm.cancel'),
    });
    if (!ok) return;
    setMakerResetPending(true);
    try {
      const result = await window.electronAPI.maker.makerMemoryReset();
      toast.success(
        t('settings.memory.maker.toast.resetSuccess', { count: result.removedCount }),
      );
    } catch (err) {
      log.warn('makerMemoryReset failed', err);
      toast.error(
        err instanceof Error ? err.message : t('settings.memory.maker.toast.resetFailed'),
      );
    } finally {
      setMakerResetPending(false);
    }
  }, [confirm, t]);

  const handleReset = useCallback(
    async (kind: AgentKind, label: string) => {
      // Reset 全局 (跨 cwd) 删, 必须二次确认。文案显示真实 agent 品牌名 + 强调 "all"。
      const ok = await confirm({
        title: t('settings.memory.agent.resetConfirm.title', { label }),
        description: t('settings.memory.agent.resetConfirm.description', { label }),
        confirmText: t('settings.memory.agent.resetConfirm.confirm'),
        cancelText: t('settings.memory.agent.resetConfirm.cancel'),
      });
      if (!ok) return;
      setSlots((prev) => ({ ...prev, [kind]: { ...prev[kind], pending: true } }));
      try {
        const result = await window.electronAPI.maker.memoryReset(kind);
        setSlots((prev) => ({ ...prev, [kind]: { ...prev[kind], pending: false } }));
        // removedEntries 子类按需提供 (Codex 留 undefined), 缺省时给通用 fallback。
        if (typeof result.removedEntries === 'number') {
          toast.success(
            t('settings.memory.agent.toast.resetSuccess', {
              label,
              count: result.removedEntries,
            }),
          );
        } else {
          toast.success(t('settings.memory.agent.toast.resetSuccessGeneric', { label }));
        }
      } catch (err) {
        log.warn(`memoryReset(${kind}) failed`, err);
        toast.error(
          err instanceof Error ? err.message : t('settings.memory.agent.toast.resetFailed'),
        );
        setSlots((prev) => ({ ...prev, [kind]: { ...prev[kind], pending: false } }));
      }
    },
    [confirm, t],
  );

  return (
    <div className="flex flex-col gap-[14px]">
      <div className="flex flex-col gap-1">
        <div className="flex items-center justify-between gap-3">
          <h2 className="text-16 font-medium leading-[1.2] text-[var(--settings-section-title)]">
            {t('settings.memory.title')}
          </h2>
          <DefaultOverrideControls
            isCustomized={settingsCustomized}
            disabled={makerTogglePending}
            onReset={() => void handleResetSettings()}
          />
        </div>
        <p className="text-13 leading-[1.5] text-[var(--settings-section-desc)]">
          {t('settings.memory.description')}
        </p>
      </div>

      <div
        className={cn(
          'flex flex-col overflow-hidden rounded-xl',
          'bg-[var(--settings-theme-card-bg)]',
          'border border-[var(--settings-theme-card-border)]',
        )}
      >
        {/* Maker Memory cell — 顶部独立, 启用时下方 Claude / Codex 强制 disable + 视觉变灰 */}
        <div className="flex items-center justify-between gap-3 px-4 py-[14px]">
          <div className="flex items-center gap-3">
            <div
              className={cn(
                'flex h-9 w-9 shrink-0 items-center justify-center rounded-lg',
                'bg-[var(--settings-input-bg)]',
              )}
            >
              <Sparkles size={18} className="text-[var(--settings-section-title)]" />
            </div>
            <div className="flex flex-col gap-[8px]">
              <p className="text-14 font-medium leading-none text-[var(--settings-section-title)]">
                {t('settings.memory.maker.label')}
              </p>
              <p className="text-12 leading-none text-[var(--settings-section-desc)]">
                {t('settings.memory.maker.description')}
              </p>
            </div>
          </div>
          <div className="flex items-center gap-2">
            <Switch
              checked={makerEnabled}
              disabled={makerResetPending || makerTogglePending}
              onCheckedChange={(v) => void handleMakerToggle(v)}
              aria-label={t('settings.memory.maker.toggleAria')}
            />
            <button
              type="button"
              onClick={() => void handleMakerReset()}
              disabled={makerResetPending || makerTogglePending}
              aria-label={t('settings.memory.maker.resetAria')}
              className={cn(
                'flex h-[30px] w-[30px] items-center justify-center rounded-lg',
                'text-[var(--settings-section-desc)]',
                'hover:bg-[var(--settings-input-bg)] hover:text-[var(--settings-section-title)]',
                'transition-colors',
                'disabled:cursor-not-allowed disabled:opacity-40 disabled:hover:bg-transparent',
              )}
            >
              <RotateCcw size={16} />
            </button>
          </div>
        </div>

        {AGENTS.map((agent) => {
          const slot = slots[agent.kind];
          const supported = slot.enabled !== null;
          const loading = slot.enabled === undefined;
          const checked = slot.enabled === true;
          const disabled = (agent.requiresMaker ? !makerEnabled : makerEnabled)
            || !supported || slot.pending || loading;
          // Agent label/description 来自 i18n 表 (品牌名 Claude / Codex 也走 i18n
          // —— 各语种都保留品牌原文,只方便统一管理)。
          const label = t(`settings.memory.agents.${agent.kind}.label`);
          const description = t(`settings.memory.agents.${agent.kind}.description`);
          return (
            <div
              key={agent.kind}
              className={cn(
                'flex items-center justify-between gap-3 px-4 py-[14px]',
                'border-t border-[var(--settings-theme-card-border)]',
                (agent.requiresMaker ? !makerEnabled : makerEnabled) && 'opacity-50',
              )}
            >
              <div className="flex items-center gap-3">
                <div
                  className={cn(
                    'flex h-9 w-9 shrink-0 items-center justify-center rounded-lg',
                    'bg-[var(--settings-input-bg)]',
                  )}
                >
                  <agent.Mark />
                </div>
                <div className="flex flex-col gap-[8px]">
                  <p className="text-14 font-medium leading-none text-[var(--settings-section-title)]">
                    {label}
                  </p>
                  <p className="text-12 leading-none text-[var(--settings-section-desc)]">
                    {description}
                  </p>
                </div>
              </div>

              <div className="flex items-center gap-2">
                <Switch
                  checked={checked}
                  disabled={disabled}
                  onCheckedChange={(v) => void handleToggle(agent.kind, v, label)}
                  aria-label={t('settings.memory.agent.toggleAria', { label })}
                />
                <button
                  type="button"
                  onClick={() => void handleReset(agent.kind, label)}
                  disabled={disabled}
                  aria-label={t('settings.memory.agent.resetAria', { label })}
                  className={cn(
                    'flex h-[30px] w-[30px] items-center justify-center rounded-lg',
                    'text-[var(--settings-section-desc)]',
                    'hover:bg-[var(--settings-input-bg)] hover:text-[var(--settings-section-title)]',
                    'transition-colors',
                    'disabled:cursor-not-allowed disabled:opacity-40 disabled:hover:bg-transparent',
                  )}
                >
                  <RotateCcw size={16} />
                </button>
              </div>
            </div>
          );
        })}
      </div>
    </div>
  );
}