Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
import { Button } from '@/components/ui/button';
/**
* Telegram 个人 bot「回应与引用」设置节(设计 v3 §五点四/五点五)。
*
* 三组分段选择: emoji 回应等级 / 群回复引用 / DM 回复引用。
* 改动即写 main 侧 store(transport 每次使用现读), 无需重启 bot。
*/
import { useEffect, useLayoutEffect, useRef, useState } from 'react';
import { useTranslation } from 'react-i18next';
import { contactsService } from '@/lib/contactsService';
import { SegmentedControl } from '@/components/ui/segmented-control';
import { cn } from '@/lib/utils';
import type {
TelegramHookBehavior,
TelegramHookBehaviorState,
TelegramHookGroupActivationMode,
TelegramHookKnownGroup,
} from '../../../shared/hookControlIpc';
type Behavior = TelegramHookBehavior;
type SettingsSource = 'personal' | 'official';
function i18nRoot(source: SettingsSource): string {
return source === 'official' ? 'settings.remoteControl.hook.telegram' : 'settings.telegramBot';
}
const EMOJI_OPTIONS: Behavior['emojiReactions'][] = ['off', 'minimal', 'expressive'];
const GROUP_QUOTE_OPTIONS: Behavior['replyQuoteGroup'][] = ['off', 'first', 'all'];
const DM_QUOTE_OPTIONS: Behavior['replyQuoteDm'][] = ['off', 'first'];
function mergeOfficialGroupActivation(
groups: readonly TelegramHookKnownGroup[],
groupActivation: TelegramHookBehaviorState['groupActivation'],
): TelegramHookKnownGroup[] {
const merged = new Map(
groups.map((group) => [
group.chatId,
{
...group,
activation:
groupActivation[group.chatId] === 'always' ? ('always' as const) : ('mention' as const),
},
]),
);
for (const [chatId, activation] of Object.entries(groupActivation)) {
if (merged.has(chatId)) continue;
merged.set(chatId, {
chatId,
chatName: chatId,
activation: activation === 'always' ? 'always' : 'mention',
});
}
return [...merged.values()];
}
function SegmentedRow<T extends string>(props: {
label: string;
hint: string;
options: readonly T[];
value: T;
optionLabel: (option: T) => string;
onChange: (option: T) => void;
}) {
return (
<div className="flex flex-col gap-1.5">
<div
className="text-12 font-medium text-[var(--settings-section-desc)]"
style={{ letterSpacing: '0.12px' }}
>
{props.label}
</div>
<SegmentedControl
aria-label={props.label}
value={props.value}
onValueChange={props.onChange}
fullWidth
height={36}
optionHeight={30}
options={props.options.map((option) => ({
value: option,
label: props.optionLabel(option),
}))}
/>
<div className="text-11 leading-[1.5] text-[var(--text-secondary)]">
{props.hint}
</div>
</div>
);
}
function SettingsRequestError(props: { message: string; retryLabel: string; onRetry: () => void }) {
return (
<div className="flex items-center justify-between gap-3 text-11 text-[var(--settings-section-desc)]">
<span>{props.message}</span>
<Button variant="secondary" size="sm" compact type="button" onClick={props.onRetry}>
{props.retryLabel}
</Button>
</div>
);
}
export function TelegramBehaviorSettings({
source = 'personal',
bindingId,
}: {
source?: SettingsSource;
bindingId?: string;
}) {
const { t } = useTranslation();
const [behavior, setBehavior] = useState<Behavior | null>(null);
const [error, setError] = useState<'load' | 'save' | null>(null);
const [reloadToken, setReloadToken] = useState(0);
const behaviorRef = useRef<Behavior | null>(null);
const confirmedRef = useRef<Behavior | null>(null);
const pendingWrites = useRef(0);
const saveFailed = useRef(false);
const saveQueue = useRef<Promise<void>>(Promise.resolve());
const latestRevision = useRef(0);
const mounted = useRef(true);
const root = i18nRoot(source);
const bindingKey = `${source}:${bindingId ?? ''}`;
const activeBindingKey = useRef(bindingKey);
useEffect(() => {
mounted.current = true;
return () => {
mounted.current = false;
};
}, []);
useLayoutEffect(() => {
activeBindingKey.current = bindingKey;
behaviorRef.current = null;
confirmedRef.current = null;
pendingWrites.current = 0;
saveFailed.current = false;
saveQueue.current = Promise.resolve();
latestRevision.current += 1;
setBehavior(null);
setError(null);
}, [bindingKey]);
useEffect(() => {
let cancelled = false;
let loadSettled = false;
let pushedDuringLoad: TelegramHookBehaviorState | null = null;
saveFailed.current = false;
setError(null);
const unsubscribe =
source === 'official'
? window.electronAPI.hookControl.onTelegramBehaviorChanged((value) => {
if (cancelled || value.bindingId !== bindingId) return;
if (!loadSettled) {
pushedDuringLoad = value;
return;
}
if (pendingWrites.current > 0) return;
behaviorRef.current = value;
confirmedRef.current = value;
setBehavior(value);
setError(null);
})
: undefined;
const load =
source === 'official'
? window.electronAPI.hookControl
.getTelegramBehavior(bindingId as string)
.then((value) => value.behavior)
: window.electronAPI.telegramBot.getBehavior();
void load
.then((value) => {
loadSettled = true;
if (cancelled) return;
const effective = pushedDuringLoad ?? value;
if (pendingWrites.current > 0) return;
behaviorRef.current = effective;
confirmedRef.current = effective;
setBehavior(effective);
})
.catch(() => {
loadSettled = true;
if (!cancelled) setError('load');
});
return () => {
cancelled = true;
unsubscribe?.();
};
}, [bindingId, reloadToken, source]);
if (!behavior) {
return error === 'load' ? (
<SettingsRequestError
message={t(`${root}.behavior.error.load`)}
retryLabel={t(`${root}.behavior.error.retry`)}
onRetry={() => setReloadToken((value) => value + 1)}
/>
) : null;
}
const patch = (partial: Partial<Behavior>) => {
const writeBindingKey = bindingKey;
const writeBindingId = bindingId;
const writeSource = source;
const optimistic = { ...(behaviorRef.current ?? behavior), ...partial };
behaviorRef.current = optimistic;
setBehavior(optimistic);
setError(null);
const revision = ++latestRevision.current;
pendingWrites.current += 1;
saveQueue.current = saveQueue.current.then(async () => {
try {
const saved =
writeSource === 'official'
? await window.electronAPI.hookControl
.setTelegramBehavior(writeBindingId as string, partial)
.then((value) => value.behavior)
: await window.electronAPI.telegramBot.setBehavior(partial);
if (activeBindingKey.current !== writeBindingKey) return;
confirmedRef.current = saved;
if (mounted.current && revision === latestRevision.current) {
behaviorRef.current = saved;
setBehavior(saved);
setError(null);
}
} catch {
if (activeBindingKey.current === writeBindingKey) saveFailed.current = true;
} finally {
if (activeBindingKey.current !== writeBindingKey) return;
pendingWrites.current -= 1;
if (pendingWrites.current === 0 && saveFailed.current) {
const reconcileRevision = latestRevision.current;
let authoritative = confirmedRef.current;
try {
authoritative =
writeSource === 'official'
? await window.electronAPI.hookControl
.getTelegramBehavior(writeBindingId as string)
.then((value) => value.behavior)
: await window.electronAPI.telegramBot.getBehavior();
confirmedRef.current = authoritative;
} catch {
// Keep the last confirmed snapshot; the inline retry remains available.
}
if (
mounted.current &&
activeBindingKey.current === writeBindingKey &&
pendingWrites.current === 0 &&
reconcileRevision === latestRevision.current &&
authoritative !== null
) {
saveFailed.current = false;
behaviorRef.current = authoritative;
setBehavior(authoritative);
setError('save');
}
}
}
});
};
return (
<div className="flex flex-col gap-4">
<div className="text-13 font-medium text-[var(--settings-section-title)]">
{t(`${root}.behavior.title`)}
</div>
{error !== null && (
<SettingsRequestError
message={t(`${root}.behavior.error.${error}`)}
retryLabel={t(`${root}.behavior.error.retry`)}
onRetry={() => setReloadToken((value) => value + 1)}
/>
)}
<SegmentedRow
label={t(`${root}.behavior.emojiLabel`)}
hint={t(`${root}.behavior.emojiHint.${behavior.emojiReactions}`)}
options={EMOJI_OPTIONS}
value={behavior.emojiReactions}
optionLabel={(o) => t(`${root}.behavior.emojiOption.${o}`)}
onChange={(emojiReactions) => patch({ emojiReactions })}
/>
<SegmentedRow
label={t(`${root}.behavior.groupQuoteLabel`)}
hint={t(`${root}.behavior.groupQuoteHint.${behavior.replyQuoteGroup}`)}
options={GROUP_QUOTE_OPTIONS}
value={behavior.replyQuoteGroup}
optionLabel={(o) => t(`${root}.behavior.quoteOption.${o}`)}
onChange={(replyQuoteGroup) => patch({ replyQuoteGroup })}
/>
<SegmentedRow
label={t(`${root}.behavior.dmQuoteLabel`)}
hint={t(`${root}.behavior.dmQuoteHint.${behavior.replyQuoteDm}`)}
options={DM_QUOTE_OPTIONS}
value={behavior.replyQuoteDm}
optionLabel={(o) => t(`${root}.behavior.quoteOption.${o}`)}
onChange={(replyQuoteDm) => patch({ replyQuoteDm })}
/>
</div>
);
}
/** 「人格」节: bot 名字 + soul 文本(soul.md 语义), 可一键同步名字到 Telegram 资料页。 */
export function TelegramPersonaSettings() {
const { t } = useTranslation();
const [persona, setPersona] = useState<{ botName: string; soul: string } | null>(null);
const [syncState, setSyncState] = useState<'idle' | 'syncing' | 'done' | 'failed'>('idle');
const saveTimer = useRef<ReturnType<typeof setTimeout> | null>(null);
// 去抖窗口内未落盘的最新编辑 — 卸载时 flush, 600ms 内关面板不丢内容。
const pendingSave = useRef<{ botName: string; soul: string } | null>(null);
useEffect(() => {
let cancelled = false;
void window.electronAPI.telegramBot.getPersona().then((value) => {
if (!cancelled) setPersona(value);
});
return () => {
cancelled = true;
if (saveTimer.current) clearTimeout(saveTimer.current);
if (pendingSave.current) {
const flush = pendingSave.current;
pendingSave.current = null;
void window.electronAPI.telegramBot.setPersona(flush);
}
};
}, []);
if (!persona) return null;
const save = (next: { botName: string; soul: string }) => {
setPersona(next);
pendingSave.current = { botName: next.botName, soul: next.soul };
if (saveTimer.current) clearTimeout(saveTimer.current);
// 600ms 去抖自动保存 — 无显式保存按钮(设置卡即改即存的通用手感)。
saveTimer.current = setTimeout(() => {
pendingSave.current = null;
void window.electronAPI.telegramBot.setPersona({ botName: next.botName, soul: next.soul });
}, 600);
};
const syncProfile = async () => {
if (saveTimer.current) clearTimeout(saveTimer.current);
// 本次调用带的就是最新值, 去抖窗口的待存内容随之落盘。
pendingSave.current = null;
setSyncState('syncing');
const result = await window.electronAPI.telegramBot.setPersona({
botName: persona.botName,
soul: persona.soul,
syncProfile: true,
});
setSyncState(result.profileSynced ? 'done' : 'failed');
setTimeout(() => setSyncState('idle'), 2500);
};
return (
<div className="flex flex-col gap-3">
<div className="text-13 font-medium text-[var(--settings-section-title)]">
{t('settings.telegramBot.persona.title')}
</div>
<label
className="text-12 font-medium text-[var(--settings-section-desc)]"
style={{ letterSpacing: '0.12px' }}
>
{t('settings.telegramBot.persona.nameLabel')}
</label>
<input
type="text"
value={persona.botName}
maxLength={64}
onChange={(e) => save({ ...persona, botName: e.target.value })}
placeholder={t('settings.telegramBot.persona.namePlaceholder')}
spellCheck={false}
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' }}
/>
<label
className="text-12 font-medium text-[var(--settings-section-desc)]"
style={{ letterSpacing: '0.12px' }}
>
{t('settings.telegramBot.persona.soulLabel')}
</label>
<textarea
value={persona.soul}
maxLength={4000}
rows={5}
onChange={(e) => save({ ...persona, soul: e.target.value })}
placeholder={t('settings.telegramBot.persona.soulPlaceholder')}
spellCheck={false}
className={cn(
'w-full resize-y rounded-2xl px-[14px] py-[10px]',
'bg-[var(--settings-input-bg)] border border-[var(--settings-input-border)]',
'text-13 leading-[1.6] 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 items-center gap-2">
<Button
variant="secondary"
size="md"
compact
loading={syncState === 'syncing'}
type="button"
onClick={() => void syncProfile()}
disabled={syncState === 'syncing' || !persona.botName.trim()}
>
{t(`settings.telegramBot.persona.sync.${syncState}`)}
</Button>
<span className="text-11 text-[var(--text-secondary)]">
{t('settings.telegramBot.persona.syncHint')}
</span>
</div>
</div>
);
}
/**
* 智能通讯录接线状态引导(Chris 2026-07-30: 通讯录关着时自动记人静默失效,
* 没有任何引导 — 在群聊节明示状态, 关着给一键开启)。
*/
function ContactsAutoRegisterHint({ root }: { root: string }) {
const { t } = useTranslation();
const [enabled, setEnabled] = useState<boolean | null>(null);
const [busy, setBusy] = useState(false);
useEffect(() => {
let cancelled = false;
void contactsService
.settingsGet()
.then((s) => {
if (!cancelled) setEnabled(s.enabled);
})
.catch(() => {
/* 通讯录服务不可用时不渲染引导 */
});
return () => {
cancelled = true;
};
}, []);
if (enabled === null) return null;
if (enabled) {
return (
<div className="text-11 leading-[1.5] text-[var(--text-secondary)]">
{t(`${root}.groups.contactsOn`)}
</div>
);
}
return (
<div className="flex items-center gap-2">
<span className="text-11 leading-[1.5] text-[var(--settings-section-desc)]">
{t(`${root}.groups.contactsOff`)}
</span>
<Button
variant="primary"
size="sm"
compact
loading={busy}
type="button"
disabled={busy}
onClick={() => {
setBusy(true);
void contactsService
.settingsSet(true)
.then(() => setEnabled(true))
.catch(() => {
/* 失败保持关闭态, 用户可去通讯录设置页重试 */
})
.finally(() => setBusy(false));
}}
>
{t(`${root}.groups.contactsEnable`)}
</Button>
</div>
);
}
/** 「群聊」节: bot 进过的群逐行切换参与模式(仅@ / 全响应·自主判断)。 */
export function TelegramGroupActivationSettings({
source = 'personal',
bindingId,
}: {
source?: SettingsSource;
bindingId?: string;
}) {
const { t } = useTranslation();
const [groups, setGroups] = useState<TelegramHookKnownGroup[] | null>(null);
const [error, setError] = useState<'load' | 'save' | null>(null);
const [reloadToken, setReloadToken] = useState(0);
const groupsRef = useRef<TelegramHookKnownGroup[] | null>(null);
const confirmedRef = useRef<TelegramHookKnownGroup[] | null>(null);
const pendingWrites = useRef(0);
const saveFailed = useRef(false);
const saveQueue = useRef<Promise<void>>(Promise.resolve());
const latestRevision = useRef(0);
const mounted = useRef(true);
const root = i18nRoot(source);
const bindingKey = `${source}:${bindingId ?? ''}`;
const activeBindingKey = useRef(bindingKey);
useEffect(() => {
mounted.current = true;
return () => {
mounted.current = false;
};
}, []);
useLayoutEffect(() => {
activeBindingKey.current = bindingKey;
groupsRef.current = null;
confirmedRef.current = null;
pendingWrites.current = 0;
saveFailed.current = false;
saveQueue.current = Promise.resolve();
latestRevision.current += 1;
setGroups(null);
setError(null);
}, [bindingKey]);
useEffect(() => {
let cancelled = false;
let loadSettled = false;
let pushedDuringLoad: TelegramHookBehaviorState | null = null;
saveFailed.current = false;
setError(null);
const unsubscribe =
source === 'official'
? window.electronAPI.hookControl.onTelegramBehaviorChanged((behavior) => {
if (cancelled || behavior.bindingId !== bindingId) return;
if (!loadSettled) {
pushedDuringLoad = behavior;
return;
}
if (pendingWrites.current > 0) return;
const next =
groupsRef.current === null
? null
: mergeOfficialGroupActivation(groupsRef.current, behavior.groupActivation);
groupsRef.current = next;
confirmedRef.current = next;
setGroups(next);
setError(null);
})
: undefined;
const load =
source === 'official'
? window.electronAPI.hookControl.listTelegramGroups(bindingId as string)
: window.electronAPI.telegramBot.listGroups();
void load
.then((result) => {
loadSettled = true;
if (cancelled) return;
const next =
pushedDuringLoad === null
? result.groups
: mergeOfficialGroupActivation(result.groups, pushedDuringLoad.groupActivation);
groupsRef.current = next;
confirmedRef.current = next;
setGroups(next);
})
.catch(() => {
loadSettled = true;
if (!cancelled) setError('load');
});
return () => {
cancelled = true;
unsubscribe?.();
};
}, [bindingId, reloadToken, source]);
if (!groups) {
return error === 'load' ? (
<SettingsRequestError
message={t(`${root}.groups.error.load`)}
retryLabel={t(`${root}.groups.error.retry`)}
onRetry={() => setReloadToken((value) => value + 1)}
/>
) : null;
}
const setMode = (chatId: string, mode: TelegramHookGroupActivationMode) => {
const writeBindingKey = bindingKey;
const writeBindingId = bindingId;
const writeSource = source;
const optimistic = (groupsRef.current ?? groups).map((group) =>
group.chatId === chatId ? { ...group, activation: mode } : group,
);
groupsRef.current = optimistic;
setGroups(optimistic);
setError(null);
const revision = ++latestRevision.current;
pendingWrites.current += 1;
saveQueue.current = saveQueue.current.then(async () => {
try {
if (writeSource === 'official') {
const result = await window.electronAPI.hookControl.setTelegramGroupActivation(
writeBindingId as string,
chatId,
mode,
);
if (activeBindingKey.current !== writeBindingKey) return;
const authoritative = mergeOfficialGroupActivation(
groupsRef.current ?? optimistic,
result.behavior.groupActivation,
);
confirmedRef.current = authoritative;
if (mounted.current && revision === latestRevision.current) {
groupsRef.current = authoritative;
setGroups(authoritative);
}
} else {
await window.electronAPI.telegramBot.setGroupActivation({ chatId, mode });
if (activeBindingKey.current !== writeBindingKey) return;
confirmedRef.current = (confirmedRef.current ?? groups).map((group) =>
group.chatId === chatId ? { ...group, activation: mode } : group,
);
}
if (mounted.current && revision === latestRevision.current) setError(null);
} catch {
if (activeBindingKey.current === writeBindingKey) saveFailed.current = true;
} finally {
if (activeBindingKey.current !== writeBindingKey) return;
pendingWrites.current -= 1;
if (pendingWrites.current === 0 && saveFailed.current) {
const reconcileRevision = latestRevision.current;
let authoritative = confirmedRef.current;
try {
authoritative = (
writeSource === 'official'
? await window.electronAPI.hookControl.listTelegramGroups(writeBindingId as string)
: await window.electronAPI.telegramBot.listGroups()
).groups;
confirmedRef.current = authoritative;
} catch {
// Keep the last confirmed snapshot; the inline retry remains available.
}
if (
mounted.current &&
activeBindingKey.current === writeBindingKey &&
pendingWrites.current === 0 &&
reconcileRevision === latestRevision.current &&
authoritative !== null
) {
saveFailed.current = false;
groupsRef.current = authoritative;
setGroups(authoritative);
setError('save');
}
}
}
});
};
return (
<div className="flex flex-col gap-3">
<div className="text-13 font-medium text-[var(--settings-section-title)]">
{t(`${root}.groups.title`)}
</div>
<div className="text-11 leading-[1.5] text-[var(--text-secondary)]">
{t(`${root}.groups.hint`)}
</div>
{error !== null && (
<SettingsRequestError
message={t(`${root}.groups.error.${error}`)}
retryLabel={t(`${root}.groups.error.retry`)}
onRetry={() => setReloadToken((value) => value + 1)}
/>
)}
<ContactsAutoRegisterHint root={root} />
{groups.length === 0 ? (
<div className="text-12 text-[var(--settings-section-desc)]">
{t(`${root}.groups.empty`)}
</div>
) : (
groups.map((group) => (
<div key={group.chatId} className="cindy-segmented-row">
<div className="min-w-0 flex-1">
<div className="truncate text-12 font-medium text-[var(--settings-section-title)]">
{group.chatName || group.chatId}
</div>
<div className="text-11 text-[var(--text-secondary)]">
{group.chatId}
</div>
</div>
<SegmentedControl
aria-label={`${group.chatName || group.chatId} · ${t(`${root}.groups.title`)}`}
value={group.activation}
onValueChange={(mode) => setMode(group.chatId, mode)}
height={34}
optionHeight={28}
optionClassName="text-11"
options={(['mention', 'always'] as const).map((mode) => ({
value: mode,
label: t(`${root}.groups.mode.${mode}`),
}))}
/>
</div>
))
)}
</div>
);
}