Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
// 启动端点清单闸门 hook:冷启动时跑 runStartupEndpointResolve,成功前业务树
// 不挂载。网络故障可用本区缓存/随包完整清单继续;配置错误仍进入 error 态,
// 由 _layout 渲染错误屏,用户点重试再跑一次。清单缺失/空白字段允许放行。
// __DEV__ 默认放行(零网络,端点初值来自仓内 config/endpoint.json,见 env.ts);
// EXPO_PUBLIC_ENDPOINTS_CDN=1 时 dev 也走完整 CDN 闸门(测线上清单,与
// desktop 的 --endpoints-cdn 同语义)。
// 时序:本闸门必须先于 OTA 检查更新(_layout 只在 ready 后挂载 OTA 门)。
import { useCallback, useEffect, useRef, useState } from 'react';
import { isTestFlightBuild } from '@/platform/appDistribution';
import { runStartupEndpointResolve } from './clientEndpointStartup';
import {
BUILD_AUTH_REGION,
DEV_RELEASE_ENDPOINT_MANIFEST_BASE_URL,
ENDPOINT_MANIFEST_BASE_URL,
resolveEnvFlag,
} from './env';
import {
DEV_SERVER_ENVIRONMENT_SWITCH_ENABLED,
buildDevServerEndpointStartupSteps,
hydrateDevServerEnvironment,
runDevServerEndpointStartupSteps,
setDevServerEnvironment,
} from './devServerEnvironment';
export type StartupEndpointGateStatus = 'pending' | 'ready' | 'error';
export interface StartupEndpointGate {
status: StartupEndpointGateStatus;
/** status === 'error' 时的失败原因(fetch-failed / invalid-json / ...)。 */
reason: string | null;
/** Release 业务端点覆盖失败时,唯一动作可将 CindyDev 恢复到 Dev。 */
canResetToDev: boolean;
/** 清除 Release 选择后重新执行启动闸门。 */
resetToDev: () => void;
/** 错误屏「重试」:回到 pending 并重新拉取。 */
retry: () => void;
}
export function useStartupEndpointGate(): StartupEndpointGate {
const defaultEndpointGateEnabled =
!__DEV__ || resolveEnvFlag(process.env.EXPO_PUBLIC_ENDPOINTS_CDN);
const enabled =
defaultEndpointGateEnabled || DEV_SERVER_ENVIRONMENT_SWITCH_ENABLED;
const [status, setStatus] = useState<StartupEndpointGateStatus>(
enabled ? 'pending' : 'ready',
);
const [reason, setReason] = useState<string | null>(null);
const [canResetToDev, setCanResetToDev] = useState(false);
const [attempt, setAttempt] = useState(0);
const running = useRef(false);
useEffect(() => {
if (!enabled || status === 'ready' || running.current) return;
if (status === 'error') return; // 等用户点重试
running.current = true;
let cancelled = false;
void (async () => {
const environment = DEV_SERVER_ENVIRONMENT_SWITCH_ENABLED
? await hydrateDevServerEnvironment()
: 'dev';
const steps = buildDevServerEndpointStartupSteps({
buildManifestBaseUrl: ENDPOINT_MANIFEST_BASE_URL,
defaultEndpointGateEnabled,
environment,
releaseManifestBaseUrl: DEV_RELEASE_ENDPOINT_MANIFEST_BASE_URL,
switchEnabled: DEV_SERVER_ENVIRONMENT_SWITCH_ENABLED,
});
return runDevServerEndpointStartupSteps(steps, (step) =>
runStartupEndpointResolve({
expectedRegion: BUILD_AUTH_REGION,
manifestBaseUrl: step.manifestBaseUrl,
preserveBuildReleaseMetadata: step.preserveBuildReleaseMetadata,
resolveIsTestFlight: isTestFlightBuild,
}),
);
})().then((outcome) => {
running.current = false;
if (cancelled) return;
if (outcome.ok) {
setCanResetToDev(false);
setStatus('ready');
} else {
setReason(outcome.reason);
setCanResetToDev(outcome.canResetToDev);
setStatus('error');
}
});
return () => {
cancelled = true;
};
}, [defaultEndpointGateEnabled, enabled, status, attempt]);
const retry = useCallback(() => {
setReason(null);
setCanResetToDev(false);
setStatus('pending');
setAttempt((n) => n + 1);
}, []);
const resetToDev = useCallback(() => {
if (running.current) return;
running.current = true;
setReason(null);
setCanResetToDev(false);
setStatus('pending');
void setDevServerEnvironment('dev')
.then(() => {
running.current = false;
setAttempt((n) => n + 1);
})
.catch(() => {
running.current = false;
setReason('environment-reset-failed');
setCanResetToDev(true);
setStatus('error');
});
}, []);
return { status, reason, canResetToDev, resetToDev, retry };
}