Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
// 动态 Expo config —— region 是 app 身份、auth-server 与 OAuth 回调 scheme 的统一构建开关。
//
// - 标准开发脚本默认显式注入 global;这里无 env 时仍保留 cn 原生基线,避免仅为
// 默认值翻转触发一次全量冷更。下次计划内冷更再单独迁移该兼容基线。
// - cn:com.xd.cindycn + cindycn://auth;global:com.xd.cindy + cindy://auth。
// - beta 只改显示名,不改变所选 region 的身份。
// - production / TestFlight 必须由发布环境注入对应 App Store 数字 ID,缺失即中止。
// - 本地 Xcode / Simulator 与自建分发变体共用 scripts/self-host-regions.json 的 app 身份、
// TapDB / Google 公开配置;EAS 云构建看不到 gitignored 文件,继续使用 EAS environment。
// - 自建分发变体(`EXPO_PUBLIC_XDT_OTA_SELFHOST=1`):
// · iOS 与 Android app identity 各自一个字段,可独立调整,互不影响。
// · 旧 bridge 模式用占位 updates.url,由 mobileUpdateBaseUrl 运行时覆写;
// CINDY_MOBILE_OTA_NATIVE=1 则把构建注入的固定地址与共享 headers 写入原生,
// 启用原生事务恢复,有意改变自建 runtime。两种模式不能互投原生不兼容的 OTA。
// · 保留 region scheme,但使用自建 bundle identity。此变体有意改变指纹,
// 但只在该 env 开启时生效,EAS 路径仍逐字节不变。
// - 不注入任何按 commit 变化的内容(如 git hash),避免 fingerprint 每次提交漂移。
const fs = require('node:fs');
const path = require('node:path');
const appJson = require('./app.json');
const {
loadMobileClientBuildEnv,
} = require('../../scripts/shared/client-endpoint-build-env.cjs');
// 本地 Xcode / Simulator 与 self-host release 共用同一份地区构建配置。EAS 云端看不到
// gitignored 的真文件,因此不启用 CINDY_USE_LOCAL_REGION_CONFIG 时继续走 eas.json / EAS env。
function loadRegionBuildConfig(region, { selfHosted = false } = {}) {
const dir = path.join(__dirname, 'scripts');
const configured = process.env.CINDY_SELF_HOST_REGIONS_FILE?.trim();
const real = configured
? path.resolve(dir, configured)
: path.join(dir, 'self-host-regions.json');
const example = path.join(dir, 'self-host-regions.json.example');
let file = real;
if (!fs.existsSync(real)) {
// 自建发布线缺文件必须硬报错;本地构建缺文件不阻断——回落到空白模板并打警告,
// 身份字段由调用方回落内置 dev 身份,统计/Google 登录自动关闭。
if (selfHosted) {
throw new Error(
`缺少地区构建配置: ${real}。请复制 ${example} 为 self-host-regions.json 并填值`,
);
}
console.warn(
`[cindy] 缺少 ${real},本地构建回落空白模板 ${path.basename(example)}` +
'(app 身份用内置默认,统计/Google 登录关闭)。需自定义请复制该模板为 self-host-regions.json 填值。',
);
file = example;
}
const block = JSON.parse(fs.readFileSync(file, 'utf8'))[region];
if (!block || typeof block !== 'object') {
throw new Error(`${path.basename(file)} 缺少 region "${region}" 配置块`);
}
// 身份字段:自建发布线必须非空;本地构建允许留空,由调用方回落内置 dev 身份并打警告。
if (selfHosted && !(block.iosBundleId?.trim() && block.androidPackage?.trim())) {
throw new Error(
`${path.basename(file)} 缺少 region "${region}" 的 iosBundleId/androidPackage`,
);
}
// TapDB 只在自建发布线强制非空:漏填会静默发出无统计的正式包。本地 Xcode /
// Simulator 构建允许留空——运行时统计模块对缺失配置自动 no-op(mobileTapdb.ts),
// 外部开发者无需 TapDB 账号即可本地构建。
if (selfHosted && !(block.tapdb?.clientId?.trim() && block.tapdb?.clientToken?.trim())) {
throw new Error(
`${path.basename(file)} 缺少 region "${region}" 的 tapdb.clientId/clientToken`,
);
}
if (region === 'cn' && Object.hasOwn(block, 'google')) {
throw new Error(`${path.basename(file)} 的 cn 不得配置 google;Google 登录仅允许 global 线`);
}
const google = block.google;
const googleFields = ['webClientId', 'iosClientId', 'iosUrlScheme'];
const hasGoogleConfig = googleFields.every((key) => google?.[key]?.trim());
if (region === 'global' && selfHosted && !hasGoogleConfig) {
throw new Error(
`${path.basename(file)} 缺少 global.google.webClientId/iosClientId/iosUrlScheme`,
);
}
// 本地构建 google 可整体留空(跳过 Google 登录);只要填了任意字段就必须三个齐全,
// 防止部分填写被静默丢弃。
if (!hasGoogleConfig && googleFields.some((key) => google?.[key]?.trim())) {
throw new Error(
`${path.basename(file)} 的 global.google 三个字段须同时填写或同时留空`,
);
}
let normalizedGoogle;
if (hasGoogleConfig) {
const webClientId = google.webClientId.trim();
const iosClientId = google.iosClientId.trim();
const iosUrlScheme = google.iosUrlScheme.trim();
const clientIdSuffix = '.apps.googleusercontent.com';
if (!webClientId.endsWith(clientIdSuffix) || !iosClientId.endsWith(clientIdSuffix)) {
throw new Error(`${path.basename(file)} 的 global.google client id 格式无效`);
}
const expectedScheme = `com.googleusercontent.apps.${iosClientId.slice(0, -clientIdSuffix.length)}`;
if (iosUrlScheme !== expectedScheme) {
throw new Error(
`${path.basename(file)} 的 global.google.iosUrlScheme 必须由 iosClientId 反写为 ${expectedScheme}`,
);
}
normalizedGoogle = { webClientId, iosClientId, iosUrlScheme };
}
const normalizedBlock = { ...block };
delete normalizedBlock.google;
if (normalizedGoogle) normalizedBlock.google = normalizedGoogle;
return normalizedBlock;
}
// expo-updates 原生配置要求一个合法 URL 才能启用模块。自建线关闭原生启动联网检查,
// JS 启动闸门拉到 endpoint.json 后会在手动 check/fetch 前把它覆写成
// `${mobileUpdateBaseUrl}/manifest`;因此本值永不承载真实服务地址,也不得随环境变化。
const SELFHOST_UPDATES_PLACEHOLDER_URL = 'https://selfhost.invalid/manifest';
function resolveMobileBuildEnv() {
return loadMobileClientBuildEnv();
}
function resolveManifestBaseUrl(region) {
const previousRegion = process.env.EXPO_PUBLIC_CINDY_AUTH_REGION;
try {
process.env.EXPO_PUBLIC_CINDY_AUTH_REGION = region;
const peerBuildEnv = loadMobileClientBuildEnv();
return peerBuildEnv.EXPO_PUBLIC_ENDPOINT_MANIFEST_BASE_URL;
} finally {
if (previousRegion === undefined) {
delete process.env.EXPO_PUBLIC_CINDY_AUTH_REGION;
} else {
process.env.EXPO_PUBLIC_CINDY_AUTH_REGION = previousRegion;
}
}
}
function resolvePeerManifestBaseUrl(region) {
return resolveManifestBaseUrl(region === 'global' ? 'cn' : 'global');
}
const REGION_CONFIG = {
cn: {
scheme: 'cindycn',
iosBundleIdentifier: 'com.xd.cindycn',
androidPackage: 'com.xd.cindycn',
},
global: {
scheme: 'cindy',
iosBundleIdentifier: 'com.xd.cindy',
androidPackage: 'com.xd.cindy',
},
// dev 第三目标(与 desktop CindyDev 同一套身份命名,可同机三装)。
dev: {
scheme: 'cindydev',
iosBundleIdentifier: 'com.xd.cindydev',
androidPackage: 'com.xd.cindydev',
},
};
function resolveRegion() {
const region = process.env.EXPO_PUBLIC_CINDY_AUTH_REGION?.trim() || 'cn';
if (region !== 'cn' && region !== 'global' && region !== 'dev') {
throw new Error(
`EXPO_PUBLIC_CINDY_AUTH_REGION must be cn, global or dev, got: ${region}`,
);
}
return region;
}
function resolveAppStoreId(region) {
const regionKey = {
cn: 'CINDY_CN_APP_STORE_ID',
global: 'CINDY_GLOBAL_APP_STORE_ID',
dev: 'CINDY_DEV_APP_STORE_ID', // dev 不上架,仅显式要求时才校验(与下方 requiresId 同语义)
}[region];
const value = (process.env[regionKey] || '').trim();
const requiresId =
process.env.XDT_REQUIRE_APP_STORE_ID === '1' ||
[
'production',
'testflight',
'production-global',
'testflight-global',
].includes(process.env.EAS_BUILD_PROFILE || '');
if (requiresId && !/^\d+$/.test(value)) {
throw new Error(
`Missing numeric ${regionKey} for ${region} App Store build`,
);
}
return value;
}
function withNativeAuthPlugins(plugins, env, region) {
const next = [...plugins];
if (env.googleIosUrlScheme) {
next.push([
'@react-native-google-signin/google-signin',
{ iosUrlScheme: env.googleIosUrlScheme },
]);
}
// 微信公开配置可能残留在同一打包机的 shell 中,不能进入 Global 原生配置。
// 两项全空表示未启用;只填一项必须在 prebuild 阶段报错,避免发出无回跳能力的包。
const wechatEnabled = region === 'cn' || region === 'dev';
const appId = wechatEnabled ? env.wechatAppId?.trim() || '' : '';
const universalLink = wechatEnabled ? env.wechatUniversalLink?.trim() || '' : '';
if (!!appId !== !!universalLink) {
throw new Error(
'EXPO_PUBLIC_CINDY_WECHAT_APP_ID and EXPO_PUBLIC_CINDY_WECHAT_UNIVERSAL_LINK must both be set or both be empty',
);
}
if (appId && universalLink) {
let parsed;
try {
parsed = new URL(universalLink);
} catch {
throw new Error('EXPO_PUBLIC_CINDY_WECHAT_UNIVERSAL_LINK must be an https URL');
}
if (
parsed.protocol !== 'https:' ||
!parsed.hostname ||
parsed.username ||
parsed.password ||
parsed.search ||
parsed.hash
) {
throw new Error(
'EXPO_PUBLIC_CINDY_WECHAT_UNIVERSAL_LINK must be an https URL without credentials, query, or fragment',
);
}
next.push([
'xdt-wechat-login/plugin',
{ appId, universalLink },
]);
}
return next;
}
module.exports = (context = {}) => {
const baseConfig = context.config ?? appJson.expo;
const region = resolveRegion();
const mobileBuildEnv = resolveMobileBuildEnv();
const mobileBundleEnv = {
...mobileBuildEnv,
EXPO_PUBLIC_ENDPOINT_MANIFEST_PEER_BASE_URL:
resolvePeerManifestBaseUrl(region),
// CindyDev 的业务服务器切换只需把 CN Release 的可信清单基址内联进 JS。
// 不写入 extra / resolved ExpoConfig,避免让纯 JS 开发功能改变 runtime fingerprint。
...(region === 'dev'
? {
EXPO_PUBLIC_CINDY_DEV_RELEASE_ENDPOINT_MANIFEST_BASE_URL:
resolveManifestBaseUrl('cn'),
}
: {}),
};
for (const [key, value] of Object.entries(mobileBundleEnv)) {
if (!process.env[key]?.trim()) process.env[key] = value;
}
// 该值只允许由 CindyDev 构建从仓内 CN 清单派生。Dev 构建覆盖 runner
// 残留值,CN / Global 构建主动清除,确保正式包不会误烘焙 Dev-only 配置。
if (region === 'dev') {
process.env.EXPO_PUBLIC_CINDY_DEV_RELEASE_ENDPOINT_MANIFEST_BASE_URL =
mobileBundleEnv.EXPO_PUBLIC_CINDY_DEV_RELEASE_ENDPOINT_MANIFEST_BASE_URL;
} else {
delete process.env
.EXPO_PUBLIC_CINDY_DEV_RELEASE_ENDPOINT_MANIFEST_BASE_URL;
}
// xdtProductionEnv 是既有 Expo config / runtime fingerprint 的一部分。对端清单
// 基址只需通过上面的 EXPO_PUBLIC_* 环境变量进入 Metro bundle;不要把它追加到
// extra,否则本次纯 JS 登录路由会无意要求一次冷构建,并切断旧 runtime 的 OTA 链。
const selfHosted = process.env.EXPO_PUBLIC_XDT_OTA_SELFHOST === '1';
const usesLocalRegionConfig =
process.env.CINDY_USE_LOCAL_REGION_CONFIG === '1';
const usesRegionConfig = selfHosted || usesLocalRegionConfig;
const regionBuildConfig = usesRegionConfig
? loadRegionBuildConfig(region, { selfHosted })
: null;
const builtInRegional = REGION_CONFIG[region];
let regional = builtInRegional;
if (regionBuildConfig) {
// 身份字段留空(仅本地构建可能走到——自建线已在装载时硬校验)回落内置 dev 身份。
const iosBundleIdentifier =
regionBuildConfig.iosBundleId?.trim() || builtInRegional.iosBundleIdentifier;
const androidPackage =
regionBuildConfig.androidPackage?.trim() || builtInRegional.androidPackage;
if (
iosBundleIdentifier !== regionBuildConfig.iosBundleId?.trim() ||
androidPackage !== regionBuildConfig.androidPackage?.trim()
) {
console.warn(
`[cindy] self-host-regions 的 ${region} 身份字段留空,本地构建回落内置身份 ` +
`${iosBundleIdentifier} / ${androidPackage}(真机安装可能与商店版同 id 冲突,` +
'可在 self-host-regions.json 填自己的 bundle id)。',
);
}
regional = { ...builtInRegional, iosBundleIdentifier, androidPackage };
}
const regionGoogle = regionBuildConfig?.google;
const regionTapdb = regionBuildConfig?.tapdb;
resolveAppStoreId(region);
// EAS 账号绑定不入仓:owner / eas.projectId / updates.url 由构建期环境变量注入
// (EAS_OWNER / EAS_PROJECT_ID)。官方发布环境注回原值 → resolved ExpoConfig 逐字节不变
// → runtime fingerprint 不变、不触发冷更;缺省(dev / 外部 fork)不带账号绑定,由使用者
// 用自己的 Expo 项目(eas init)填 env。详见 docs/dev-rules/mobile-development.md。
const easOwner = process.env.EAS_OWNER?.trim();
const easProjectId = process.env.EAS_PROJECT_ID?.trim();
let next = {
...baseConfig,
...(easOwner ? { owner: easOwner } : {}),
scheme: regional.scheme,
ios: {
...baseConfig.ios,
bundleIdentifier: regional.iosBundleIdentifier,
usesAppleSignIn: true,
},
android: {
...baseConfig.android,
package: regional.androidPackage,
// Public Firebase application configuration, supplied by the selected build profile.
// No file is bundled from another app identity or copied from a user's installation.
...(process.env.CINDY_ANDROID_GOOGLE_SERVICES_FILE?.trim()
? { googleServicesFile: process.env.CINDY_ANDROID_GOOGLE_SERVICES_FILE.trim() } : {}),
},
// 非自建线的 EAS Update 入口:由下发的 projectId 推导;自建分支下方会把它覆写成
// selfhost 占位(真实地址运行时由 mobileUpdateBaseUrl 注入)。projectId 缺省则不配 OTA。
...(easProjectId
? { updates: { url: `https://u.expo.dev/${easProjectId}`, enabled: true } }
: {}),
plugins: withNativeAuthPlugins(baseConfig.plugins || [], {
googleIosUrlScheme: usesRegionConfig
? regionGoogle?.iosUrlScheme
: process.env.EXPO_PUBLIC_CINDY_GOOGLE_IOS_URL_SCHEME?.trim(),
wechatAppId: process.env.EXPO_PUBLIC_CINDY_WECHAT_APP_ID?.trim(),
wechatUniversalLink:
process.env.EXPO_PUBLIC_CINDY_WECHAT_UNIVERSAL_LINK?.trim(),
}, region),
extra: {
...baseConfig.extra,
...(easProjectId ? { eas: { projectId: easProjectId } } : {}),
cindy: {
authRegion: region,
...(usesRegionConfig
? {
regionConfigSource: 'self-host-regions',
// TapDB 留空(仅本地构建可能)时不烘焙该键:运行时 mobileTapdb 视为
// 未配置并关闭统计。已填值时输出与旧版逐字节一致,不动 runtime fingerprint。
...(regionTapdb?.clientId?.trim() && regionTapdb?.clientToken?.trim()
? {
tapdb: {
clientId: regionTapdb.clientId.trim(),
clientToken: regionTapdb.clientToken.trim(),
region,
},
}
: {}),
...(regionGoogle
? {
google: {
webClientId: regionGoogle.webClientId,
iosClientId: regionGoogle.iosClientId,
iosUrlScheme: regionGoogle.iosUrlScheme,
},
}
: {}),
}
: {}),
},
xdtProductionEnv: mobileBuildEnv,
},
};
if (process.env.EXPO_PUBLIC_APP_VARIANT === 'beta') {
const betaDev = process.env.EXPO_PUBLIC_BETA_DEV?.trim();
const suffix = betaDev ? ` Beta (${betaDev})` : ' Beta';
next = { ...next, name: `${next.name}${suffix}` };
}
// 自建门控用 EXPO_PUBLIC_XDT_OTA_SELFHOST:同一个 EXPO_PUBLIC 标志既在此决定
// bundleId / 原生 OTA 策略,又被 inline 进 JS 供运行时 IS_OTA_SELFHOST 判定,
// 构建与运行时严格对齐。原生恢复模式另用非 EXPO_PUBLIC 构建开关显式启用。
if (selfHosted) {
const nativeOta = process.env.CINDY_MOBILE_OTA_NATIVE?.trim();
if (nativeOta && nativeOta !== '0' && nativeOta !== '1') {
throw new Error('CINDY_MOBILE_OTA_NATIVE must be 0 or 1');
}
// Android 自建线:versionCode 只在此自建分支注入(经 release-android-*.mjs 传入的
// XDT_ANDROID_VERSION_CODE),APK 覆盖安装 + NPKG md5 去重要求它单调递增。app.json 里
// **不声明** android.versionCode → 非自建 resolved config 逐字节不变(红线 1,EAS 指纹不受影响)。
// 值来源是 committed android-version.json,由发布脚本读取并置入 env,app.config.js 不直接读文件
// (避免把版本文件卷进 @expo/fingerprint 的配置源)。缺省(非 Android 出包路径)则不注入。
const rawVersionCode = process.env.XDT_ANDROID_VERSION_CODE?.trim();
const versionCode = rawVersionCode ? Number(rawVersionCode) : undefined;
next = {
...next,
android: {
...next.android,
// Self-hosted APK and AAB share native config; Play installs skip APK updates at runtime.
permissions: [...new Set([
...(next.android.permissions || []),
'android.permission.REQUEST_INSTALL_PACKAGES',
])],
...(Number.isInteger(versionCode) && versionCode > 0 ? { versionCode } : {}),
},
updates: {
...next.updates,
// 原生层只负责启用 expo-updates + 本地已下载 bundle 选择;不在 JS 启动前联网。
// endpoint 闸门完成后 useStartupOtaGate 会运行时覆写真实 /manifest URL 并手动检查。
url: SELFHOST_UPDATES_PLACEHOLDER_URL,
checkAutomatically: 'NEVER',
// Expo 的运行时 URL override API 要求此开关。只在自建变体开启,EAS/TestFlight
// 继续保留默认 anti-bricking 策略。此原生配置变化需要最后一次冷更。
disableAntiBrickingMeasures: true,
},
};
// Explicit build-time rollout switch. Keeping the legacy configuration
// available permits the already shipped bridge runtime to remain frozen.
// Never detect this native capability from mutable OTA manifest extras.
if (nativeOta === '1') {
const { resolveUpdatesUrl, requestHeaders, nativeSourceHash } = require('./plugins/selfhost-ota/contract');
next = {
...next,
plugins: [...next.plugins, ['./plugins/with-selfhost-ota', { sourceHash: nativeSourceHash() }]],
updates: {
...next.updates,
url: resolveUpdatesUrl(process.env.CINDY_MOBILE_UPDATES_URL),
requestHeaders: requestHeaders('release'),
checkAutomatically: 'NEVER',
disableAntiBrickingMeasures: false,
},
};
}
}
return next;
};