Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
/**
* 客户端构建期端点自举配置。
*
* 运行期业务端点的唯一事实源是 region 对应的 config/endpoint*.json;构建期烘焙
* region 与 CN/Global 两份清单的 CDN 基址。基址直接取仓内正本的 cdnBaseUrl,
* 避免再维护一份 production-endpoints.json 镜像。
*/
import fs from 'node:fs';
import path from 'node:path';
import { fileURLToPath } from 'node:url';
const REPO_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', '..');
export const CLIENT_BUILD_REGIONS = Object.freeze(['cn', 'global', 'dev']);
/** 规范化并校验构建 region。 */
export function resolveClientBuildRegion(authRegion) {
const region = authRegion?.trim() || 'global';
if (!CLIENT_BUILD_REGIONS.includes(region)) {
throw new Error(`Invalid Cindy auth region: ${region}; expected cn, global or dev`);
}
return region;
}
/** 返回 region 对应的仓内端点清单正本路径。 */
export function clientEndpointManifestPath(authRegion, repoRoot = REPO_ROOT) {
const region = resolveClientBuildRegion(authRegion);
const fileByRegion = { cn: 'endpoint.json', global: 'endpoint.global.json', dev: 'endpoint.dev.json' };
return path.join(repoRoot, 'config', fileByRegion[region]);
}
/**
* 从仓内端点清单读取不可自引用覆盖的 CDN 自举基址。
* @param {{ authRegion?: string, repoRoot?: string }} [options]
*/
export function loadEndpointManifestBaseUrl(options = {}) {
const region = resolveClientBuildRegion(options.authRegion);
const manifestPath = clientEndpointManifestPath(region, options.repoRoot);
let parsed;
try {
parsed = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
} catch (error) {
if (error && typeof error === 'object' && error.code === 'ENOENT') {
throw new Error(`缺少 ${region} 客户端端点清单: ${manifestPath}`);
}
if (error instanceof SyntaxError) {
throw new Error(`客户端端点清单不是合法 JSON: ${manifestPath}`);
}
throw error;
}
if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
throw new Error(`客户端端点清单必须是 JSON object: ${manifestPath}`);
}
if (!Number.isInteger(parsed.schemaVersion) || parsed.schemaVersion < 1) {
throw new Error(`客户端端点清单 schemaVersion 非法: ${manifestPath}`);
}
const raw = parsed.cdnBaseUrl;
if (typeof raw !== 'string' || !raw.trim()) {
throw new Error(`客户端端点清单缺少非空字段 cdnBaseUrl: ${manifestPath}`);
}
const normalized = raw.trim().replace(/\/+$/, '');
let url;
try {
url = new URL(normalized);
} catch {
throw new Error(`客户端端点清单字段 cdnBaseUrl 不是合法绝对 URL: ${manifestPath}`);
}
if (url.protocol !== 'https:' || url.username || url.password) {
throw new Error(`客户端端点清单字段 cdnBaseUrl 必须是无凭据 HTTPS URL: ${manifestPath}`);
}
return normalized;
}
/**
* 返回当前构建区域之外的另一份受信任清单基址。CN/Global 互为对端;
* dev 以 CN 身份运行,仍只把 Global 作为对端。
*/
export function loadPeerEndpointManifestBaseUrl(options = {}) {
const region = resolveClientBuildRegion(options.authRegion);
return loadEndpointManifestBaseUrl({
authRegion: region === 'global' ? 'cn' : 'global',
repoRoot: options.repoRoot,
});
}
/** Desktop 正式构建所需的公开 Vite 变量。 */
export function desktopClientBuildEnv({ allowEnvOverride = true, authRegion, repoRoot } = {}) {
const region = resolveClientBuildRegion(
authRegion ||
process.env.CINDY_AUTH_REGION?.trim() ||
(allowEnvOverride ? process.env.VITE_CINDY_AUTH_REGION?.trim() : ''),
);
const override = allowEnvOverride
? process.env.VITE_ENDPOINT_MANIFEST_BASE_URL?.trim()
: '';
const peerOverride = allowEnvOverride
? process.env.VITE_ENDPOINT_MANIFEST_PEER_BASE_URL?.trim()
: '';
return {
VITE_CINDY_AUTH_REGION: region,
VITE_ENDPOINT_MANIFEST_BASE_URL:
override || loadEndpointManifestBaseUrl({ authRegion: region, repoRoot }),
VITE_ENDPOINT_MANIFEST_PEER_BASE_URL:
peerOverride || loadPeerEndpointManifestBaseUrl({ authRegion: region, repoRoot }),
};
}
/** Mobile/EAS 构建所需的公开变量。 */
export function mobileClientBuildEnv({ authRegion, repoRoot } = {}) {
const region = resolveClientBuildRegion(
authRegion || process.env.EXPO_PUBLIC_CINDY_AUTH_REGION?.trim(),
);
return {
EXPO_PUBLIC_CINDY_AUTH_REGION: region,
EXPO_PUBLIC_ENDPOINT_MANIFEST_BASE_URL: loadEndpointManifestBaseUrl({
authRegion: region,
repoRoot,
}),
};
}
/**
* Mobile JS bundle 额外需要对端区域清单基址;CindyDev 还需要 CN Release
* 清单基址供内部运行时切换。与 mobileClientBuildEnv 分开,避免把这些纯 JS
* 变量加入 app.config 的既有 Expo extra / runtime fingerprint。
*/
export function mobileClientBundleEnv(options = {}) {
const buildEnv = mobileClientBuildEnv(options);
const authRegion = buildEnv.EXPO_PUBLIC_CINDY_AUTH_REGION;
return {
...buildEnv,
EXPO_PUBLIC_ENDPOINT_MANIFEST_PEER_BASE_URL: loadPeerEndpointManifestBaseUrl({
authRegion,
repoRoot: options.repoRoot,
}),
...(authRegion === 'dev'
? {
EXPO_PUBLIC_CINDY_DEV_RELEASE_ENDPOINT_MANIFEST_BASE_URL:
loadEndpointManifestBaseUrl({
authRegion: 'cn',
repoRoot: options.repoRoot,
}),
}
: {}),
};
}
/**
* 合并最终传给 Mobile bundling 子进程的环境。正式构建必须主动删除 runner
* 可能残留的 CindyDev Release 清单变量,不能只依赖 app.config.js 在子进程内清理。
*/
export function mobileClientBundleProcessEnv({
authRegion,
baseEnv = process.env,
repoRoot,
} = {}) {
const bundleEnv = mobileClientBundleEnv({ authRegion, repoRoot });
// These callers build installable iOS/Android Release bundles. Region "dev"
// selects endpoints, not Babel's build mode. Do not inherit an agent/server's
// development environment into the production Worklets transform.
const env = { ...baseEnv, ...bundleEnv, NODE_ENV: 'production', BABEL_ENV: 'production' };
if (bundleEnv.EXPO_PUBLIC_CINDY_AUTH_REGION !== 'dev') {
delete env.EXPO_PUBLIC_CINDY_DEV_RELEASE_ENDPOINT_MANIFEST_BASE_URL;
}
return env;
}