Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
/**
* CindyDev 专属的业务服务器环境选择。
*
* `dev` 是系统默认值;仅把用户显式选择的 `release` 作为 override 落盘。
* CN / Global 正式包不读取、不写入该配置,始终返回 `dev` 占位值,调用方还需用
* `DEV_SERVER_ENVIRONMENT_SWITCH_ENABLED` 控制入口与行为。
*/
import AsyncStorage from '@react-native-async-storage/async-storage';
export type DevServerEnvironment = 'dev' | 'release';
export interface DevServerEndpointStartupStep {
manifestBaseUrl: string;
preserveBuildReleaseMetadata: boolean;
}
export interface DevServerEnvironmentReloadSwitch {
current: DevServerEnvironment;
next: DevServerEnvironment;
reload: () => Promise<void> | void;
setEnvironment: (environment: DevServerEnvironment) => Promise<void>;
}
export type DevServerEndpointStartupRunOutcome =
| { ok: true }
| { ok: false; reason: string; canResetToDev: boolean };
export const DEV_SERVER_ENVIRONMENT_SWITCH_ENABLED =
process.env.EXPO_PUBLIC_CINDY_AUTH_REGION === 'dev';
const STORAGE_KEY = 'cindy.mobile.devServerEnvironment.release.v1';
const DEFAULT_ENVIRONMENT: DevServerEnvironment = 'dev';
let activeEnvironment: DevServerEnvironment = DEFAULT_ENVIRONMENT;
let hydrated = false;
let hydratePromise: Promise<DevServerEnvironment> | null = null;
let mutationTail: Promise<void> = Promise.resolve();
const listeners = new Set<() => void>();
function notifyListeners(): void {
for (const listener of [...listeners]) {
try {
listener();
} catch {
// A broken view subscriber must not break the persisted environment state.
}
}
}
function restoreActiveEnvironment(environment: DevServerEnvironment): void {
activeEnvironment = environment;
hydrated = true;
notifyListeners();
}
export function hydrateDevServerEnvironment(): Promise<DevServerEnvironment> {
if (!DEV_SERVER_ENVIRONMENT_SWITCH_ENABLED) {
hydrated = true;
activeEnvironment = DEFAULT_ENVIRONMENT;
return Promise.resolve(activeEnvironment);
}
if (hydrated) return Promise.resolve(activeEnvironment);
if (hydratePromise) return hydratePromise;
hydratePromise = AsyncStorage.getItem(STORAGE_KEY)
.then((raw) => {
activeEnvironment = raw === 'release' ? 'release' : DEFAULT_ENVIRONMENT;
hydrated = true;
notifyListeners();
return activeEnvironment;
})
.catch(() => {
// Fail safe to the CindyDev build's own environment. A storage failure must
// never silently route an internal build to Release.
activeEnvironment = DEFAULT_ENVIRONMENT;
hydrated = true;
notifyListeners();
return activeEnvironment;
})
.finally(() => {
hydratePromise = null;
});
return hydratePromise;
}
/** 启动 gate hydrate 后可同步读取;未 hydrate 时同样 fail safe 到 Dev。 */
export function getDevServerEnvironment(): DevServerEnvironment {
return activeEnvironment;
}
export function subscribeDevServerEnvironment(listener: () => void): () => void {
listeners.add(listener);
return () => listeners.delete(listener);
}
/**
* 正式 CindyDev 包先加载自己的清单来固定 OTA / 审核元数据;选择 Release 时再
* 用第二份清单只覆写业务端点。Metro 本地开发默认直接消费包内 Dev 清单,因此
* 仅在选择 Release 时需要联网。
*/
export function buildDevServerEndpointStartupSteps(input: {
buildManifestBaseUrl: string;
defaultEndpointGateEnabled: boolean;
environment: DevServerEnvironment;
releaseManifestBaseUrl: string;
switchEnabled: boolean;
}): DevServerEndpointStartupStep[] {
const steps: DevServerEndpointStartupStep[] = [];
if (input.defaultEndpointGateEnabled) {
steps.push({
manifestBaseUrl: input.buildManifestBaseUrl,
preserveBuildReleaseMetadata: false,
});
}
if (input.switchEnabled && input.environment === 'release') {
steps.push({
manifestBaseUrl: input.releaseManifestBaseUrl,
preserveBuildReleaseMetadata: true,
});
}
return steps;
}
/** 执行启动步骤,并标记失败是否发生在可撤销的 Release 业务端点覆盖阶段。 */
export async function runDevServerEndpointStartupSteps(
steps: readonly DevServerEndpointStartupStep[],
runStep: (
step: DevServerEndpointStartupStep,
) => Promise<{ ok: true } | { ok: false; reason: string }>,
): Promise<DevServerEndpointStartupRunOutcome> {
for (const step of steps) {
const outcome = await runStep(step);
if (!outcome.ok) {
return {
...outcome,
canResetToDev: step.preserveBuildReleaseMetadata,
};
}
}
return { ok: true };
}
/** 重载失败时恢复旧选择,避免当前进程端点与持久化环境不一致。 */
export async function switchDevServerEnvironmentAndReload(
input: DevServerEnvironmentReloadSwitch,
): Promise<void> {
await input.setEnvironment(input.next);
try {
await input.reload();
} catch (error) {
try {
await input.setEnvironment(input.current);
} catch {
// 持久化层不可用时仍须让当前 JS 进程与实际未重载的旧端点保持一致。
// 最终继续抛出原始 reload 错误,避免回滚错误掩盖首要故障。
restoreActiveEnvironment(input.current);
}
throw error;
}
}
export async function setDevServerEnvironment(
next: DevServerEnvironment,
): Promise<void> {
if (!DEV_SERVER_ENVIRONMENT_SWITCH_ENABLED) {
throw new Error('dev-server-environment-switch-unavailable');
}
await hydrateDevServerEnvironment();
const run = mutationTail.then(async () => {
if (next === 'release') await AsyncStorage.setItem(STORAGE_KEY, 'release');
else await AsyncStorage.removeItem(STORAGE_KEY);
activeEnvironment = next;
notifyListeners();
});
mutationTail = run.catch(() => undefined);
return run;
}
export const __testing = {
storageKey: STORAGE_KEY,
async resetMemory(): Promise<void> {
await mutationTail.catch(() => undefined);
activeEnvironment = DEFAULT_ENVIRONMENT;
hydrated = false;
hydratePromise = null;
mutationTail = Promise.resolve();
listeners.clear();
},
};