Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
import { useGlobalSearchParams, usePathname, useRouter } from 'expo-router';
import { useCallback, useEffect, useRef } from 'react';
import { AppState } from 'react-native';
import { useAuth } from '@/auth/AuthContext';
import { useSelfHostedRelay } from '@/device-link/selfHostedRelay';
import Notifications from './nativeNotifications';
import { ChatBackgroundBridge } from './ChatBackgroundBridge';
import { notificationRecoveryRoute, parseNotificationResponseDeepLink } from './pushRegistrationModel';
import {
configureForegroundNotificationBehavior,
isPushSupported,
readPushEnabled,
retryPendingUnregister,
syncPushRegistration,
} from './pushNotifications';
/** 已消费点击的去重键(模块级:组件重挂/Provider 重建也不重复路由)。 */
const consumedNotificationResponseKeys = new Set<string>();
type NotificationResponse = Parameters<
Parameters<typeof Notifications.addNotificationResponseReceivedListener>[0]
>[0];
/**
* 移动推送的运行时桥(挂在 AuthProvider 内、导航树旁,不渲染任何 UI):
*
* 1. 登录后按本机开关同步 token 注册(启动补偿:上次注册失败/换账号后自愈);
* 2. APNs token 轮换时重新上报;
* 3. 通知点击(前台/后台/冷启动)→ 解析 APNs / Expo 深链 → 路由到对应会话;
* 4. 只在前台正阅读对应群聊/话题时压掉横幅。
*/
export function PushNotificationsBridge() {
const auth = useAuth();
const router = useRouter();
const pathname = usePathname();
const { threadRootId } = useGlobalSearchParams<{ threadRootId?: string }>();
const visibleChat = useRef({ pathname, threadRootId });
visibleChat.current = { pathname, threadRootId };
const routerRef = useRef(router);
routerRef.current = router;
/** 冷启动点通知时 auth 可能未就绪,先存下待路由的深链。 */
const pendingDeepLinkRef = useRef<string | null>(null);
const authStateRef = useRef({
initialized: auth.initialized,
isAuthenticated: auth.isAuthenticated,
});
authStateRef.current = {
initialized: auth.initialized,
isAuthenticated: auth.isAuthenticated,
};
const apiFetchRef = useRef(auth.apiFetch);
apiFetchRef.current = auth.apiFetch;
// 自建中转下不登记 device-link 推送;切回官方中转后按本机开关重新同步一次。
const selfHostedRelay = useSelfHostedRelay() !== null;
useEffect(() => {
if (!isPushSupported()) return;
configureForegroundNotificationBehavior(route => {
const [path, query] = route.split('?');
const thread = new URLSearchParams(query).get('threadRootId') ?? undefined;
return visibleChat.current.pathname === path && visibleChat.current.threadRootId === thread;
});
}, []);
// 登录态就绪后同步注册状态(开关关闭 / 从未注册时是 no-op)
useEffect(() => {
if (!isPushSupported()) return;
if (!auth.initialized || !auth.isAuthenticated) return;
let cancelled = false;
void (async () => {
// 只用当前会话补偿当前区域的注销,再按本机开关同步注册状态。
await retryPendingUnregister(apiFetchRef.current).catch(() => undefined);
if (cancelled) return;
const enabled = await readPushEnabled();
if (cancelled || !enabled) return;
await syncPushRegistration({ enabled, apiFetch: apiFetchRef.current }).catch(() => undefined);
})();
return () => {
cancelled = true;
};
}, [auth.accountGeneration, auth.initialized, auth.isAuthenticated, auth.user, selfHostedRelay]);
// APNs token 轮换 → 重新上报(仅开关开启且已登录时)
useEffect(() => {
if (!isPushSupported()) return;
if (!auth.initialized || !auth.isAuthenticated) return;
const sub = Notifications.addPushTokenListener(() => {
void (async () => {
const enabled = await readPushEnabled();
if (!enabled) return;
await syncPushRegistration({ enabled, apiFetch: apiFetchRef.current }).catch(
() => undefined,
);
})();
});
return () => sub.remove();
}, [auth.initialized, auth.isAuthenticated]);
const flushPendingDeepLink = useCallback((): void => {
const target = pendingDeepLinkRef.current;
if (!target) return;
const { initialized, isAuthenticated } = authStateRef.current;
if (!initialized || !isAuthenticated) return; // 待 auth 就绪后由下方 effect 重放
pendingDeepLinkRef.current = null;
routerRef.current.push(target as never);
}, []);
// 通知点击路由:后台点击经 response listener,冷启动 / 回前台经 last response 补偿
useEffect(() => {
if (!isPushSupported()) return;
const consumeResponse = (response: NotificationResponse): void => {
const deepLink = parseNotificationResponseDeepLink(response);
if (!deepLink) return;
const identifier = response.notification.request.identifier;
const dedupeKey = identifier ? `id:${identifier}` : `deepLink:${deepLink}`;
if (consumedNotificationResponseKeys.has(dedupeKey)) return;
consumedNotificationResponseKeys.add(dedupeKey);
void Notifications.clearLastNotificationResponseAsync?.()?.catch(() => undefined);
pendingDeepLinkRef.current = notificationRecoveryRoute(deepLink, dedupeKey);
flushPendingDeepLink();
};
const readLastResponse = (): void => {
void Notifications.getLastNotificationResponseAsync()
.then((response) => {
if (response) consumeResponse(response);
})
.catch(() => undefined);
};
const sub = Notifications.addNotificationResponseReceivedListener((response) => {
consumeResponse(response);
});
readLastResponse();
const appStateSub = AppState.addEventListener('change', (state) => {
if (state === 'active') readLastResponse();
});
return () => {
sub.remove();
appStateSub.remove();
};
}, [flushPendingDeepLink]);
// auth 就绪后重放冷启动 / 点击期间暂存的深链。监听本身保持挂载,避免 auth
// 状态变化重建 effect 时与 last-response 读取发生竞态。
useEffect(() => {
flushPendingDeepLink();
}, [auth.initialized, auth.isAuthenticated, flushPendingDeepLink]);
return <ChatBackgroundBridge />;
}