Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
import Constants from 'expo-constants';
import * as Updates from 'expo-updates';
import { useUpdates } from 'expo-updates';
import { useRouter } from 'expo-router';
import { useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore } from 'react';
import {
Alert,
AppState,
Linking,
Platform,
Pressable,
ScrollView,
StyleSheet,
View,
useWindowDimensions,
} from 'react-native';
import { Text } from '@/components/AppText';
import { SafeAreaView, useSafeAreaInsets } from 'react-native-safe-area-context';
import { useTranslation } from 'react-i18next';
import { useAuth } from '@/auth/AuthContext';
import { loginText } from '@/auth/loginMessages';
import {
clearAnalyticsEnabledOverride,
getAnalyticsConsentState,
hydrateAnalyticsConsent,
setAnalyticsEnabled,
subscribeAnalyticsConsent,
} from '@/analytics/analyticsConsentStore';
import { initMobileTapdb, setTapdbUser, stopMobileTapdbReporting } from '@/analytics/mobileTapdb';
import { hasPrivacyConsent } from '@/update/updateConsentGate';
import { SUPPORTED_LOCALES, type LocalePreference } from '@/i18n';
import { useLocale } from '@/i18n/useLocale';
import { goBackGuarded } from '@/utils/backGuard';
import {
MainWindowActionGroup,
StatusDot,
} from '@/components/MobilePrimitives';
import { mobileInteractionStyles } from '@/components/mobileInteractionStyles';
import { MobileUserAvatar } from '@/components/MobileUserAvatar';
import {
NativePullDownMenu,
SimpleStackHeader,
simpleScrollInsetProps,
simpleScrollScreenSafeAreaEdges,
usesNativePullDownMenu,
} from '@/platform/chrome';
import {
APP_BINARY_VERSION,
AUTH_API_BASE_URL,
AUTH_REGION,
DESKTOP_PACKAGE_VERSION,
IS_OTA_SELFHOST,
IS_TESTFLIGHT_BUILD,
REVIEW_MODE,
} from '@/config/env';
import { LEGAL_LINKS } from '@/config/legalLinks';
import { useDeviceLink } from '@/device-link/DeviceLinkContext';
import { buildMobileDeviceName } from '@/device-link/mobileDeviceIdentity';
import { formatRemoteError } from '@/device-link/remoteStatus';
import { clearSelfHostedRelay, useSelfHostedRelay } from '@/device-link/selfHostedRelay';
import { buildMobileSettingsOverview } from '@/settings/mobileSettings';
import {
isPushSupported,
readPushEnabled,
syncPushRegistration,
writePushEnabled,
readPushPreviewEnabled,
writePushPreviewEnabled,
} from '@/notifications/pushNotifications';
import { isChatBackgroundSupported, readChatBackgroundEnabled, writeChatBackgroundEnabled } from '@/notifications/chatBackground';
import {
hydrateMobileVoiceDictionary,
readCachedMobileVoiceDictionarySnapshot,
subscribeMobileVoiceDictionaryCache,
} from '@/session/mobileVoiceDictionaryCache';
import { buildMobileVoiceDictionaryEntryViews } from '@/session/mobileVoiceDictionaryView';
import { UserBubbleSettings } from '@/settings/UserBubbleSettings';
import { shouldCheckBundleUpdate } from '@/update/bundleUpdate';
import { isGooglePlayInstallation } from '@/update/androidInstallSource';
import {
manualUpdateCheckMessage,
runManualUpdateCheck,
type ManualUpdateCheckOutcome,
} from '@/update/manualUpdateCheck';
import { runSelfHostedOtaRequest } from '@/update/otaRequestCoordinator';
import { useBundleUpdatePrompt } from '@/update/useBundleUpdatePrompt';
import { useUpdateChannelGate } from '@/update/useUpdateChannelGate';
import { useBetaChannel } from '@/update/useBetaChannel';
import { MobileChoicePickerList } from '@/session/MobileChoicePickerList';
import { SheetModal } from '@/session/SheetModal';
import { SheetSurface } from '@/session/SheetSurface';
import { computeContextSheetSnapHeights, type ContextSheetSnap } from '@/session/contextSheetModel';
import type { MobileChoiceOption } from '@/session/agentCapabilities';
import {
ActionInfoRow,
ChoicePickerRow,
InfoRow,
SettingsGroup,
SettingsSwitchRow,
useSettingsRowStyles,
} from '@/session/SettingsGroupRows';
import {
getMobileSpeakerFilterSnapshot,
hydrateMobileSpeakerFilter,
subscribeMobileSpeakerFilter,
} from '@/session/mobileSpeakerFilter';
import { useSettingsDeviceDirectory } from '@/session/settingsDeviceDirectory';
import { confirmLogout } from '@/session/confirmLogout';
import { THEME_PREFERENCES, useTheme, useThemedStyles, type ThemeColors } from '@/theme';
import { fontWeight, lineHeight, radius, spacing, typeScale } from '@/theme/tokens';
import { remoteSessionStore } from '@/session/remoteSessionStore';
import { useGuardedPush } from '@/utils/useGuardedPush';
type UpdatePhase = 'idle' | 'checking' | 'downloading' | 'uptodate' | 'error';
// 显示语言选项:「跟随系统」在前,英语作为第一个显式语言,其余语言按支持列表顺序排列。
const LANGUAGE_OPTIONS: readonly LocalePreference[] = [
'system',
'en',
...SUPPORTED_LOCALES.filter((locale) => locale !== 'en'),
];
function hasRunningRemoteTasks(): boolean {
return remoteSessionStore.getSessions().some((session) => remoteSessionStore.isSessionRunning(session.id));
}
/**
* 设置页。二级页(语音词典、本机名称、开发者等)是独立 stack 路由(app/settings/*),
* 系统返回只退回这里。
*
* 卡片里只放「名称 + 取值 / 开关 / 箭头」;成句说明与操作结果写在分组下方的 footer。
*/
export default function SettingsScreen() {
const styles = useThemedStyles(makeStyles);
const rowStyles = useSettingsRowStyles();
const { preference: themePreference, setPreference: setThemePreference } = useTheme();
const router = useRouter();
const push = useGuardedPush();
const auth = useAuth();
const { t } = useTranslation();
const { locale, setLocale } = useLocale();
const windowDimensions = useWindowDimensions();
const safeAreaInsets = useSafeAreaInsets();
const { status, connectionIssue } = useDeviceLink();
// 中转服务:官方中转或自建中转(docs/self-hosted-relay-plan.md §5.3)。
const selfHostedRelay = useSelfHostedRelay();
const [relaySwitching, setRelaySwitching] = useState(false);
const [relayMessage, setRelayMessage] = useState<string | null>(null);
const [loggingOut, setLoggingOut] = useState(false);
const [accountDeletionAvailable, setAccountDeletionAvailable] =
useState(false);
const [languagePickerOpen, setLanguagePickerOpen] = useState(false);
const [languagePickerSnap, setLanguagePickerSnap] = useState<ContextSheetSnap>('half');
const [appearancePickerOpen, setAppearancePickerOpen] = useState(false);
const [appearancePickerSnap, setAppearancePickerSnap] = useState<ContextSheetSnap>('half');
const [updatePhase, setUpdatePhase] = useState<UpdatePhase>('idle');
const [updateOutcome, setUpdateOutcome] = useState<ManualUpdateCheckOutcome | null>(null);
const [pushEnabled, setPushEnabled] = useState(false);
const [pushPreview, setPushPreview] = useState(true);
const [chatBackground, setChatBackground] = useState(false);
const [pushBusy, setPushBusy] = useState(false);
const [pushMessage, setPushMessage] = useState<string | null>(null);
// 使用统计(TapDB)开关。真相在 analyticsConsentStore,这里只是视图态。
const [analyticsEnabled, setAnalyticsEnabledState] = useState(true);
const [analyticsCustomized, setAnalyticsCustomized] = useState(false);
const [analyticsBusy, setAnalyticsBusy] = useState(false);
// hydration 完成前开关必须禁用:此时显示的是 fail-closed 默认值,可能与盘上
// 相反;放行点击会让 toggleAnalytics 对着真值取反,做出与所见相反的动作。
const [analyticsReady, setAnalyticsReady] = useState(false);
const [analyticsMessage, setAnalyticsMessage] = useState<string | null>(null);
// beta 测试渠道(设备级)开关在二级页「开发者」;这里只读状态,显示版本旁的徽标。
const { enabled: betaEnabled, ready: betaReady } = useBetaChannel();
const showBetaBadge = betaReady && betaEnabled;
const updateCheckInFlightRef = useRef(false);
// 语音词典:手机只读展示被控桌面的词典快照(正本在桌面,手机不参与合并)。查看页是独立路由。
const { desktopDevices, selfDeviceName } = useSettingsDeviceDirectory();
/** 缓存在模块里,组件用这个计数强制重渲染。 */
const [dictionaryRevision, setDictionaryRevision] = useState(0);
const systemDeviceName = buildMobileDeviceName({
constantsDeviceName: Constants.deviceName,
platform: Platform.OS,
});
const deviceName = selfDeviceName ?? systemDeviceName;
const overview = useMemo(
() => buildMobileSettingsOverview({
authBaseUrl: AUTH_API_BASE_URL,
authRegion: AUTH_REGION,
deviceId: auth.deviceId,
deviceName,
platform: Platform.OS,
relayStatus: status,
userEmail: auth.user?.email,
userId: auth.user?.id,
userName: auth.user?.name,
}),
// t 依赖:buildMobileSettingsOverview 内部走 i18n.t,语言切换时(t 身份变化)重建展示模型。
[auth.deviceId, auth.user?.email, auth.user?.id, auth.user?.name, deviceName, status, t],
);
// 整包版本必须读原生烧进的值(CFBundleShortVersionString / versionName):
// OTA 热更会把 manifest 里内嵌的 expoClient.version 覆盖给 Constants.expoConfig.version,
// 而热更不改原生包,若读 expoConfig 会在热更后回退成打热更时主仓 app.json 的旧值。
// APP_BINARY_VERSION 优先取原生层、热更后不漂移(与 mobileTapdb / env 上报同口径)。
const appVersion = APP_BINARY_VERSION || '0.0.0';
const updatesEnabled = Updates.isEnabled;
// 当前运行的 OTA bundle 信息:检查更新时判断应急启动;版本细节展示在二级页「开发者」。
const { currentlyRunning } = useUpdates();
const updateChannel = useUpdateChannelGate(IS_OTA_SELFHOST);
// 允许整包分发时统一入口先查整包;TestFlight 等禁用整包的环境直接进入 JS OTA。
const { checkNow: checkBundleUpdate } = useBundleUpdatePrompt({
auto: false,
channel: updateChannel.channel,
});
const playManagedUpdates = Platform.OS === 'android' && isGooglePlayInstallation();
const bundleCheckEnabled = shouldCheckBundleUpdate({
isSelfHosted: IS_OTA_SELFHOST,
isReviewMode: REVIEW_MODE,
isTestFlightBuild: IS_TESTFLIGHT_BUILD,
isGooglePlayInstallation: playManagedUpdates,
});
const updateCheckEnabled = bundleCheckEnabled || updatesEnabled;
// 保存未翻译的结果,语言切换触发重渲染时用当前 t() 重新生成提示。
const updateMessage = useMemo(
() => updateOutcome && manualUpdateCheckMessage(updateOutcome, {
isTestFlightBuild: IS_TESTFLIGHT_BUILD,
isGooglePlayInstallation: playManagedUpdates,
t,
}),
[playManagedUpdates, t, updateOutcome],
);
const aboutSection = overview.sections.find((section) => section.id === 'about');
const languagePickerOptions = useMemo<readonly MobileChoiceOption[]>(
() => LANGUAGE_OPTIONS.map((option) => ({
id: option,
label: t(`settings.language.options.${option}`),
})),
[t],
);
const choicePickerHeights = useMemo(
() => computeContextSheetSnapHeights({
safeAreaTopInset: safeAreaInsets.top,
screenHeight: windowDimensions.height,
}),
[safeAreaInsets.top, windowDimensions.height],
);
const openLanguagePicker = useCallback(() => {
setLanguagePickerSnap('half');
setLanguagePickerOpen(true);
}, []);
const selectLanguage = useCallback((next: string) => {
const nextLocale = LANGUAGE_OPTIONS.find((option) => option === next);
if (!nextLocale) return;
setLocale(nextLocale);
setLanguagePickerOpen(false);
}, [setLocale]);
const appearancePickerOptions = useMemo<readonly MobileChoiceOption[]>(
() => THEME_PREFERENCES.map((option) => ({
id: option,
label: t(`settings.appearance.options.${option}`),
})),
[t],
);
const openAppearancePicker = useCallback(() => {
setAppearancePickerSnap('half');
setAppearancePickerOpen(true);
}, []);
const selectAppearance = useCallback((next: string) => {
const nextPreference = THEME_PREFERENCES.find((option) => option === next);
if (!nextPreference) return;
setAppearancePickerOpen(false);
// 本次会话已切换;只有本机存储写失败时提示下次启动会回到原设置。
setThemePreference(nextPreference).catch(() => {
Alert.alert(t('settings.appearance.modeLabel'), t('settings.appearance.saveFailed'));
});
}, [setThemePreference, t]);
useEffect(() => {
if (!auth.isAuthenticated) {
setAccountDeletionAvailable(false);
return;
}
let cancelled = false;
setAccountDeletionAvailable(false);
void auth
.getAccountDeletionAvailability()
.then((availability) => {
if (!cancelled) {
setAccountDeletionAvailable(availability.available);
}
})
.catch(() => {
if (!cancelled) setAccountDeletionAvailable(false);
});
return () => {
cancelled = true;
};
}, [auth.getAccountDeletionAvailability, auth.isAuthenticated]);
const openPrivacyPolicy = useCallback(() => {
void Linking.openURL(LEGAL_LINKS.privacyPolicy).catch(() => undefined);
}, []);
const openUserAgreement = useCallback(() => {
void Linking.openURL(LEGAL_LINKS.termsOfService).catch(() => undefined);
}, []);
const checkForUpdate = useCallback(async () => {
// 审核模式:入口按钮已隐藏,这里再挡一层(状态由代码保证,不依赖 UI 层记得隐藏)。
if (REVIEW_MODE || !updateCheckEnabled || updateCheckInFlightRef.current) return;
updateCheckInFlightRef.current = true;
setUpdateOutcome(null);
try {
const outcome = await runManualUpdateCheck({
checkBundleUpdate: bundleCheckEnabled ? checkBundleUpdate : undefined,
otaEnabled: updatesEnabled,
// 自建线由事务协调器覆盖共享 UUID,因此不再借用 analytics consent;EAS /
// TestFlight 仍保留原同意闸门,TapDB 的 consent 状态也完全不在这里修改。
...(IS_OTA_SELFHOST
? {
withOtaClient: (operation) => runSelfHostedOtaRequest(
updateChannel.channel,
operation,
),
}
: { isConsented: hasPrivacyConsent }),
checkOtaUpdate: () => Updates.checkForUpdateAsync(),
fetchOtaUpdate: () => Updates.fetchUpdateAsync(),
reload: () => Updates.reloadAsync(),
isEmergencyLaunch: () => currentlyRunning.isEmergencyLaunch,
onPhase: (phase) => setUpdatePhase(phase),
});
setUpdateOutcome(outcome);
if (outcome.kind === 'bundle-update-available') {
setUpdatePhase('idle');
} else if (outcome.kind === 'up-to-date') {
setUpdatePhase('uptodate');
} else if (outcome.kind === 'ota-unavailable') {
setUpdatePhase('uptodate');
} else if (outcome.kind === 'reloading') {
setUpdatePhase('downloading');
} else if (outcome.kind === 'restart-required') {
// 更新已经拿到了,只是本进程重启不了 —— 不是失败态,提示文案负责说明要手动重开。
setUpdatePhase('uptodate');
} else if (outcome.kind === 'busy') {
setUpdatePhase('idle');
} else {
setUpdatePhase('error');
}
} finally {
updateCheckInFlightRef.current = false;
}
}, [
bundleCheckEnabled,
checkBundleUpdate,
currentlyRunning.isEmergencyLaunch,
t,
updateChannel.channel,
updateCheckEnabled,
updatesEnabled,
]);
const openSelfDeviceNameEditor = useCallback(() => {
push('/settings/device-name');
}, [push]);
const logout = useCallback(async () => {
if (loggingOut) return;
setLoggingOut(true);
try {
await auth.logout();
router.replace('/login');
} catch (error) {
Alert.alert(t('devices.list.alert.actionFailed'), formatRemoteError(error));
} finally {
setLoggingOut(false);
}
}, [auth, loggingOut, router, t]);
// 退出登录先确认(与首页抽屉同一套 confirmLogout 文案):运行中任务要额外说明。
const requestLogout = useCallback(() => {
if (loggingOut) return;
confirmLogout(t, hasRunningRemoteTasks(), () => void logout());
}, [loggingOut, logout, t]);
const openAccountDeletion = useCallback(() => {
router.push('/account-deletion');
}, [router]);
// 切回官方中转:先确认(之后要再用这个中转得在电脑上重新加入);删掉本机设置与凭证,
// 连接随路由变化重建。不会自动切回,只在用户确认后执行。
const switchToOfficialRelay = useCallback(async () => {
if (relaySwitching) return;
setRelaySwitching(true);
setRelayMessage(null);
try {
await clearSelfHostedRelay();
} catch {
setRelayMessage(t('relay.settings.switchFailed'));
} finally {
setRelaySwitching(false);
}
}, [relaySwitching, t]);
const requestSwitchToOfficialRelay = useCallback(() => {
if (!selfHostedRelay || relaySwitching) return;
Alert.alert(
t('relay.settings.confirmTitle'),
t('relay.settings.confirmBody', { name: selfHostedRelay.name }),
[
{ text: t('devices.common.cancel'), style: 'cancel' },
{ text: t('relay.settings.confirmAction'), style: 'destructive', onPress: () => void switchToOfficialRelay() },
],
);
}, [relaySwitching, selfHostedRelay, switchToOfficialRelay, t]);
// 自建中转下:被主人移出 / 中转停用(4410)或中转凭证被拒(401),以及本机凭证缺失,
// 都要在这里给出原因,并配「切回官方中转」。
const relayIssueMessage = !selfHostedRelay
? null
: selfHostedRelay.credential === null
? t('relay.settings.credentialMissingHint')
: status !== 'online' && (connectionIssue?.kind === 'device-removed' || connectionIssue?.kind === 'auth-failed')
? t('relay.settings.removedHint')
: null;
// 任务完成通知开关:开 → 请求系统权限 + 注册 APNs token 到 device-link server;
// 关 → 注销 token。开关状态本机持久化,server 注册表是唯一发送依据。
useEffect(() => {
let cancelled = false;
void readPushEnabled().then((enabled) => {
if (!cancelled) setPushEnabled(enabled);
});
void readPushPreviewEnabled().then(value => { if (!cancelled) setPushPreview(value); });
const refreshBackground = () => { void readChatBackgroundEnabled().then(value => { if (!cancelled) setChatBackground(value); }); };
refreshBackground();
const foreground = AppState.addEventListener('change', state => { if (state === 'active') refreshBackground(); });
return () => {
cancelled = true;
foreground.remove();
};
}, []);
// 使用统计开关的当前值。store 是本机唯一真相,订阅它以免多个入口写入后本页陈旧。
useEffect(() => {
let cancelled = false;
const sync = () => {
if (cancelled) return;
const snapshot = getAnalyticsConsentState();
setAnalyticsEnabledState(snapshot.enabled);
setAnalyticsCustomized(snapshot.enabledCustomized);
};
void hydrateAnalyticsConsent()
.then(sync)
.catch(() => undefined)
// 读失败也放开:store 已 fail closed 到已 hydrate 的默认态,此后的交互
// 操作的是真值,不再有「对陈旧显示取反」的问题。
.finally(() => {
if (!cancelled) setAnalyticsReady(true);
});
const unsubscribe = subscribeAnalyticsConsent(sync);
return () => {
cancelled = true;
unsubscribe();
};
}, []);
const togglePushNotifications = useCallback(async () => {
if (pushBusy) return;
setPushBusy(true);
setPushMessage(null);
const next = !pushEnabled;
try {
if (!next) {
// 关闭是用户明确的 opt-out:先落盘生效(离线也不允许开关弹回),
// 注销请求失败则排队补偿,下次联网启动自动补上。
await writePushEnabled(false);
setPushEnabled(false);
try {
await syncPushRegistration({ enabled: false, apiFetch: auth.apiFetch });
} catch {
setPushMessage(t('settings.notifications.unregisterQueued'));
}
return;
}
const result = await syncPushRegistration({ enabled: true, apiFetch: auth.apiFetch });
if (result === 'permission-denied') {
setPushMessage(t('settings.notifications.permissionDenied'));
return; // 权限被拒:开关保持关闭,不落盘
}
await writePushEnabled(true);
setPushEnabled(true);
if (result === 'local-only') setPushMessage(t('settings.notifications.googleUnavailable'));
} catch (error) {
setPushMessage(formatRemoteError(error));
} finally {
setPushBusy(false);
}
}, [auth.apiFetch, pushBusy, pushEnabled, t]);
/* ── 使用统计(TapDB)开关 ──
语义是 opt-out:用户在登录页同意《隐私政策》后默认开启,这里随时可关。
关闭后立即解绑账号标识、不再主动上报;原生 SDK 不支持反初始化,本次进程内
已初始化的实例要到下次冷启动才彻底不再初始化(见 analytics/mobileTapdb)。
关闭路径**先停上报再落盘**:写盘失败时本次运行已经不再上报(偏安全的一侧),
而开关值不变,如实反映「重启后仍是开启」。 */
/* 重新开启统计时必须**重新绑定当前账号**。关闭路径已经调过 clearNativeTapdbUser(),
而 AuthContext 里负责绑定的 effect 依赖 [initialized, user?.id] —— 拨开关不会
让这两个值变化,所以它不会再跑。不补这一下的话,账号维度的用量会一直空到下次
重启或下一次登录态变化。 */
const resumeAnalyticsReporting = useCallback(async () => {
const status = await initMobileTapdb();
if (!status.ok) return;
const userId = auth.user?.id;
if (userId) await setTapdbUser(userId);
}, [auth.user?.id]);
const toggleAnalytics = useCallback(async () => {
if (analyticsBusy) return;
setAnalyticsBusy(true);
setAnalyticsMessage(null);
try {
// 必须先 hydrate 再取反:AsyncStorage 读慢时 getAnalyticsConsentState() 返回的
// 是 fail-closed 默认值,直接取反会算错方向,对着一个陈旧值执行 stop/start。
await hydrateAnalyticsConsent();
const next = !getAnalyticsConsentState().enabled;
if (!next) await stopMobileTapdbReporting();
await setAnalyticsEnabled(next);
if (next) await resumeAnalyticsReporting();
} catch {
// 只可能是本机存储异常(无服务端往返)。开关值由 store 回推,保持落盘前的
// 真值;这里显式告诉用户没存住,而不是让它看起来「点了没反应」。
setAnalyticsMessage(t('settings.legal.analyticsSaveFailed'));
} finally {
setAnalyticsBusy(false);
}
}, [analyticsBusy, resumeAnalyticsReporting, t]);
/* 恢复默认:只删掉开关 override 让它重新跟随版本默认值,同意事实不动
(configuration-and-overrides §4)。仅在用户显式拨过开关时出现。 */
const resetAnalytics = useCallback(async () => {
if (analyticsBusy) return;
setAnalyticsBusy(true);
setAnalyticsMessage(null);
try {
await clearAnalyticsEnabledOverride();
if (getAnalyticsConsentState().enabled) await resumeAnalyticsReporting();
else await stopMobileTapdbReporting();
} catch {
setAnalyticsMessage(t('settings.legal.analyticsSaveFailed'));
} finally {
setAnalyticsBusy(false);
}
}, [analyticsBusy, resumeAnalyticsReporting, t]);
// 词条数来自本机缓存:进入设置时先把盘上缓存读进内存,查看页刷新后经缓存订阅同步回来。
useEffect(() => {
if (desktopDevices.length === 0) return;
let cancelled = false;
void Promise.all(desktopDevices.map((host) => hydrateMobileVoiceDictionary(host.deviceId)))
.then(() => {
if (!cancelled) setDictionaryRevision((value) => value + 1);
})
.catch(() => undefined);
return () => {
cancelled = true;
};
}, [desktopDevices]);
useEffect(() => subscribeMobileVoiceDictionaryCache(() => {
setDictionaryRevision((value) => value + 1);
}), []);
const openVoiceDictionary = useCallback(() => {
push('/settings/voice-dictionary');
}, [push]);
const speakerFilter = useSyncExternalStore(subscribeMobileSpeakerFilter, getMobileSpeakerFilterSnapshot);
useEffect(() => {
void hydrateMobileSpeakerFilter();
}, []);
const openVoiceSpeakerFilter = useCallback(() => {
push('/settings/voice-speaker-filter');
}, [push]);
// dictionaryRevision 只作为依赖存在:缓存是模块级的,刷新完成后靠它触发重算。
const dictionaryEntries = useMemo(
() =>
buildMobileVoiceDictionaryEntryViews(
desktopDevices.map((host) => readCachedMobileVoiceDictionarySnapshot(host.deviceId)),
),
[desktopDevices, dictionaryRevision],
);
const updateBusy = updatePhase === 'checking' || updatePhase === 'downloading';
const updateActionLabel = t(
IS_TESTFLIGHT_BUILD || playManagedUpdates
? 'settings.version.testFlightCheckAction'
: 'settings.version.checkAction',
);
// 「版本」分组下方的说明:TestFlight / Google Play 由商店管理安装包;其余说明 App 内的更新方式。
// 检查不了时直接不显示「检查更新」行,原因就写在这里。OTA 版本号等技术细节在「开发者」里。
const updateMethodHint = IS_TESTFLIGHT_BUILD
? t('settings.version.testFlightUpdateManaged')
: playManagedUpdates
? t('settings.version.googlePlayUpdateManaged')
: REVIEW_MODE
? null
: updatesEnabled
? t('settings.version.updateMethodInApp')
: bundleCheckEnabled
? t('settings.version.updateMethodPackage')
: t('settings.version.updateMethodUnavailable');
const showUpdateCheck = !REVIEW_MODE && updateCheckEnabled;
const openDeveloperSettings = useCallback(() => {
push('/settings/developer');
}, [push]);
return (
<SafeAreaView edges={simpleScrollScreenSafeAreaEdges()} style={styles.safeArea} testID="settings.screen">
<SimpleStackHeader
scrollEdge
backTestID="settings.backButton"
onBack={() => goBackGuarded(router)}
title={t('settings.title')}
titleTestID="settings.title"
/>
<ScrollView {...simpleScrollInsetProps} contentContainerStyle={styles.content} testID="settings.scroll">
{/* 账号头部:身份 + 连接状态一次性呈现,下面分组不再重复 */}
<View style={styles.headerCard} testID="settings.accountHeader">
<MobileUserAvatar imageUrl={auth.user?.avatar} name={overview.header.name} size="large" />
<View style={styles.headerTexts}>
<Text style={styles.headerName} numberOfLines={1}>{overview.header.name}</Text>
{overview.header.email ? (
<Text style={styles.headerEmail} numberOfLines={1}>{overview.header.email}</Text>
) : null}
<View style={styles.headerStatusRow}>
<StatusDot tone={overview.header.relayTone} pulsing={status === 'connecting'} />
<Text style={styles.headerStatusText} numberOfLines={1}>
{`${overview.header.relayLabel} · ${overview.header.relayDetail}`}
</Text>
</View>
</View>
</View>
{/* 中转服务:当前走官方中转还是自建中转;自建时提供「切回官方中转」。
加入自建中转从电脑上的二维码进入(相机扫码打开加入页),这里不放扫码入口。 */}
<SettingsGroup
footer={selfHostedRelay
? t('relay.settings.selfHostedHint', { address: selfHostedRelay.baseUrl })
: t('relay.settings.officialHint')}
messages={[
relayIssueMessage ? { text: relayIssueMessage, testID: 'settings.relay.issue' } : null,
relayMessage ? { text: relayMessage, testID: 'settings.relay.message' } : null,
]}
testID="settings.relay"
title={t('relay.settings.sectionTitle')}
>
<InfoRow
key="relay-current"
label={t('relay.settings.currentLabel')}
testID="settings.relay.current"
value={selfHostedRelay ? selfHostedRelay.name : t('relay.settings.official')}
/>
{selfHostedRelay ? (
<ActionInfoRow
accessibilityLabel={t('relay.settings.switchToOfficial')}
chevron={false}
disabled={relaySwitching}
key="relay-switch-official"
label={t('relay.settings.switchToOfficial')}
onPress={requestSwitchToOfficialRelay}
testID="settings.relay.switchToOfficial"
/>
) : null}
</SettingsGroup>
{/* 版本:当前版本 + 统一检查入口(允许整包分发时先查整包,否则直接查热更);
更新方式与检查结果写在分组下方。检查不可用或审核模式时不显示检查行。 */}
<SettingsGroup
footer={updateMethodHint}
footerTestID="settings.updateMethod"
messages={[updateMessage ? { text: updateMessage, testID: 'settings.updateMessage' } : null]}
testID="settings.version"
title={t('settings.version.sectionTitle')}
>
<View key="current-version" style={rowStyles.row}>
<View style={rowStyles.rowLine}>
<Text style={rowStyles.rowLabel}>{t('settings.version.currentLabel')}</Text>
{showBetaBadge ? (
<View style={styles.betaChannelBadge} testID="settings.betaChannelBadge">
<Text style={styles.betaChannelBadgeText}>{t('settings.betaChannel.badge')}</Text>
</View>
) : null}
<Text style={rowStyles.rowValue} numberOfLines={1} testID="settings.appVersion">{appVersion}</Text>
</View>
</View>
{/* 二级版本号:自建线打包所配对的桌面产品线版本(0.0.x),不是在线电脑的实时版本;仅自建线且已注入时显示 */}
{IS_OTA_SELFHOST && DESKTOP_PACKAGE_VERSION ? (
<InfoRow
key="desktop-version"
label={t('settings.version.pairedDesktopLabel')}
testID="settings.desktopVersion"
value={DESKTOP_PACKAGE_VERSION}
/>
) : null}
{showUpdateCheck ? (
<ActionInfoRow
accessibilityLabel={updateBusy
? t(
IS_TESTFLIGHT_BUILD || playManagedUpdates
? 'settings.version.testFlightCheckingAccessibility'
: 'settings.version.checkingAccessibility',
)
: updateActionLabel}
chevron={false}
disabled={updateBusy}
key="check-update"
label={updateActionLabel}
onPress={() => void checkForUpdate()}
testID="settings.checkUpdateButton"
value={updateBusy ? t('settings.version.checking') : ''}
/>
) : null}
</SettingsGroup>
{/* Notification permission and preview preferences belong to this installation. */}
{isPushSupported() ? (
<SettingsGroup
footer={t('settings.notifications.taskDoneHint')
+ (isChatBackgroundSupported() ? ` ${t('settings.notifications.backgroundHint')}` : '')
+ (selfHostedRelay ? ` ${t('relay.settings.pushUnavailable')}` : '')}
messages={[pushMessage ? { text: pushMessage, testID: 'settings.pushMessage' } : null]}
title={t('settings.notifications.sectionTitle')}
>
<SettingsSwitchRow
accessibilityLabel={t('settings.notifications.taskDone')}
disabled={pushBusy}
key="push-toggle"
label={t('settings.notifications.taskDone')}
onValueChange={() => void togglePushNotifications()}
switchTestID="settings.pushToggle"
testID="settings.pushToggleRow"
value={pushEnabled}
/>
<SettingsSwitchRow
accessibilityLabel={t('settings.notifications.preview')}
label={t('settings.notifications.preview')}
value={pushPreview}
disabled={pushBusy || !pushEnabled}
onValueChange={() => {
const next = !pushPreview;
setPushBusy(true);
void writePushPreviewEnabled(next).then(() => {
setPushPreview(next);
return syncPushRegistration({ enabled: pushEnabled, apiFetch: auth.apiFetch });
}).catch(error => setPushMessage(formatRemoteError(error))).finally(() => setPushBusy(false));
}}
/>
{isChatBackgroundSupported() ? <SettingsSwitchRow
accessibilityLabel={t('settings.notifications.background')}
label={t('settings.notifications.background')}
value={chatBackground}
disabled={pushBusy || !pushEnabled}
onValueChange={() => {
const next = !chatBackground;
void writeChatBackgroundEnabled(next).then(() => setChatBackground(next))
.catch(error => setPushMessage(formatRemoteError(error)));
}}
/> : null}
</SettingsGroup>
) : null}
{/* 语音词典:只读查看电脑上的词典(正本在电脑,增删改回电脑做) */}
<SettingsGroup
footer={t('settings.voiceDictionary.hint')}
title={t('settings.voiceDictionary.sectionTitle')}
>
<ActionInfoRow
accessibilityLabel={t('settings.voiceDictionary.openAccessibility')}
key="voice-dictionary"
label={t('settings.voiceDictionary.label')}
onPress={openVoiceDictionary}
testID="settings.voiceDictionary.row"
value={t('settings.voiceDictionary.entryCount', { count: dictionaryEntries.length })}
/>
</SettingsGroup>
{/* 识别我的声音:声纹只在本机;老安装包缺原生推理模块时不显示入口 */}
{speakerFilter.supported ? (
<SettingsGroup
footer={t('settings.voiceSpeakerFilter.entryHint')}
title={t('settings.voiceSpeakerFilter.sectionTitle')}
>
<ActionInfoRow
accessibilityLabel={t('settings.voiceSpeakerFilter.openAccessibility')}
key="voice-speaker-filter"
label={t('settings.voiceSpeakerFilter.label')}
onPress={openVoiceSpeakerFilter}
testID="settings.voiceSpeakerFilter.row"
value={t(speakerFilter.enabled ? 'settings.voiceSpeakerFilter.on' : 'settings.voiceSpeakerFilter.off')}
/>
</SettingsGroup>
) : null}
<SettingsGroup title={t('sharedTask.title')}>
<ActionInfoRow
accessibilityLabel={t('sharedTask.manageSharing')}
label={t('sharedTask.manageSharing')}
value=""
onPress={() => router.push({ pathname: '/shared-session', params: { mode: 'manage' } })}
testID="settings.sharedTasks.row"
/>
</SettingsGroup>
{/* 显示模式:默认跟随系统,手动选择浅色 / 深色即持久化 override(恢复跟随系统 = 清除 override) */}
<SettingsGroup title={t('settings.appearance.title')}>
<NativePullDownMenu
actions={THEME_PREFERENCES.map((option) => ({
id: option,
state: option === themePreference ? 'on' : 'off',
title: t(`settings.appearance.options.${option}`),
}))}
onAction={selectAppearance}
>
<ChoicePickerRow
expanded={appearancePickerOpen}
label={t('settings.appearance.modeLabel')}
onPress={usesNativePullDownMenu() ? () => undefined : openAppearancePicker}
testID="settings.appearance.picker"
value={t(`settings.appearance.options.${themePreference}`)}
/>
</NativePullDownMenu>
<UserBubbleSettings />
</SettingsGroup>
{/* 显示语言:默认跟随系统,手动选择即持久化 override(恢复跟随系统 = 清除 override) */}
<SettingsGroup
footer={t('settings.language.hint')}
title={t('settings.language.title')}
>
<NativePullDownMenu
actions={LANGUAGE_OPTIONS.map((option) => ({
id: option,
state: option === locale ? 'on' : 'off',
title: t(`settings.language.options.${option}`),
}))}
onAction={selectLanguage}
>
<ChoicePickerRow
expanded={languagePickerOpen}
label={t('settings.language.title')}
onPress={usesNativePullDownMenu() ? () => undefined : openLanguagePicker}
testID="settings.language.picker"
value={t(`settings.language.options.${locale}`)}
/>
</NativePullDownMenu>
</SettingsGroup>
{/* 关于这台手机 */}
{aboutSection ? (
<SettingsGroup footer={aboutSection.footer} title={aboutSection.title}>
{aboutSection.rows.map((row) => (
row.id === 'about.deviceName' ? (
<ActionInfoRow
accessibilityLabel={t('settings.about.editAccessibility', { label: row.label })}
key={row.id}
label={row.label}
onPress={openSelfDeviceNameEditor}
testID="settings.selfDeviceNameRow"
value={row.value}
/>
) : (
<InfoRow key={row.id} label={row.label} testID={`settings.row.${row.id}`} value={row.value} />
)
))}
</SettingsGroup>
) : null}
{/* 法律信息:隐私政策/用户协议始终显示(链接区域分流走 legalLinks 单点);App 备案号仅国内版显示。
使用统计开关(合规要求关闭途径可被找到)单独成组,说明与保存失败紧接在开关下方的 footer;
「恢复默认」再单独成组,避免 footer 被夹在开关和它之间。 */}
<SettingsGroup title={t('settings.legal.sectionTitle')}>
<ActionInfoRow
accessibilityLabel={t('settings.legal.openPrivacyPolicy')}
accessibilityRole="link"
key="privacy-policy"
label={t('settings.legal.privacyPolicy')}
onPress={openPrivacyPolicy}
testID="settings.privacyPolicy"
value={t('settings.legal.view')}
/>
<ActionInfoRow
accessibilityLabel={t('settings.legal.openUserAgreement')}
accessibilityRole="link"
key="user-agreement"
label={t('settings.legal.userAgreement')}
onPress={openUserAgreement}
testID="settings.userAgreement"
value={t('settings.legal.view')}
/>
{AUTH_REGION === 'cn' ? (
<InfoRow
key="app-filing-number"
label={t('settings.legal.appFilingNumber')}
testID="settings.appFilingNumber"
value="沪ICP备11033765号-89A"
/>
) : null}
</SettingsGroup>
<SettingsGroup
footer={t('settings.legal.analyticsHint')}
messages={[analyticsMessage ? { text: analyticsMessage, testID: 'settings.analyticsMessage' } : null]}
>
<SettingsSwitchRow
accessibilityLabel={t('settings.legal.analytics')}
disabled={analyticsBusy || !analyticsReady}
key="analytics-toggle"
label={t('settings.legal.analytics')}
onValueChange={() => void toggleAnalytics()}
switchTestID="settings.analyticsToggle"
testID="settings.analyticsToggleRow"
value={analyticsEnabled}
/>
</SettingsGroup>
{analyticsCustomized ? (
<SettingsGroup>
<ActionInfoRow
accessibilityLabel={t('settings.legal.analyticsReset')}
chevron={false}
onPress={() => void resetAnalytics()}
label={t('settings.legal.analyticsReset')}
testID="settings.analyticsReset"
value={t('settings.legal.analyticsResetAction')}
/>
</SettingsGroup>
) : null}
{/* 开发者:Debug 日志、Beta 渠道、标识与更新信息在二级页,按用途分组。 */}
<SettingsGroup testID="settings.debugGroup">
<ActionInfoRow
accessibilityLabel={t('settings.developer.title')}
key="developer"
label={t('settings.developer.title')}
onPress={openDeveloperSettings}
testID="settings.developerRow"
/>
</SettingsGroup>
{/* 账号操作:退出保持明确(先确认),说明写在按钮下方;注销账号仅保留低调的次要文字入口。 */}
<View style={styles.dangerArea} testID="settings.accountActions">
<MainWindowActionGroup
dangerActions={[
{
accessibilityLabel: loggingOut ? t('settings.account.loggingOutAccessibility') : t('settings.account.logout'),
busy: loggingOut,
label: t('settings.account.logout'),
onPress: requestLogout,
testID: 'settings.logoutButton',
tone: 'danger',
},
]}
testID="settings.logoutActions"
/>
<Text style={styles.dangerHint}>
{t('settings.account.logoutHint')}
</Text>
{accountDeletionAvailable ? (
<Pressable
accessibilityLabel={loginText('accountDeletionSettingsAction')}
accessibilityRole="button"
onPress={openAccountDeletion}
style={({ pressed }) => [
styles.accountDeletionLink,
pressed && styles.pressed,
]}
testID="settings.deleteAccountButton"
>
<Text style={styles.accountDeletionLinkText}>
{loginText('accountDeletionSettingsAction')}
</Text>
</Pressable>
) : null}
</View>
</ScrollView>
<SheetModal
backdropTestID="settings.appearancePicker.backdrop"
nativePresentation
onBackdropPress={() => setAppearancePickerOpen(false)}
onRequestClose={() => setAppearancePickerOpen(false)}
visible={appearancePickerOpen}
>
<SheetSurface
bottomInset={safeAreaInsets.bottom}
heights={choicePickerHeights}
onClose={() => setAppearancePickerOpen(false)}
onSnapChange={setAppearancePickerSnap}
snap={appearancePickerSnap}
testID="settings.appearancePicker"
title={t('settings.appearance.modeLabel')}
>
<MobileChoicePickerList
activeId={themePreference}
onSelect={selectAppearance}
options={appearancePickerOptions}
testID="settings.appearancePicker.option"
/>
</SheetSurface>
</SheetModal>
<SheetModal
backdropTestID="settings.languagePicker.backdrop"
nativePresentation
onBackdropPress={() => setLanguagePickerOpen(false)}
onRequestClose={() => setLanguagePickerOpen(false)}
visible={languagePickerOpen}
>
<SheetSurface
bottomInset={safeAreaInsets.bottom}
heights={choicePickerHeights}
onClose={() => setLanguagePickerOpen(false)}
onSnapChange={setLanguagePickerSnap}
snap={languagePickerSnap}
testID="settings.languagePicker"
title={t('settings.language.title')}
>
<MobileChoicePickerList
activeId={locale}
onSelect={selectLanguage}
options={languagePickerOptions}
testID="settings.languagePicker.option"
/>
</SheetSurface>
</SheetModal>
</SafeAreaView>
);
}
const makeStyles = (colors: ThemeColors) => StyleSheet.create({
safeArea: { backgroundColor: colors.surface, flex: 1 },
content: {
gap: spacing.xl,
paddingBottom: spacing.xxl,
paddingHorizontal: spacing.lg,
paddingTop: spacing.lg,
},
// —— 账号头部 ——
headerCard: {
alignItems: 'center',
flexDirection: 'row',
gap: spacing.md,
paddingHorizontal: spacing.xs,
paddingVertical: spacing.sm,
},
headerTexts: { flex: 1, gap: spacing.xs, minWidth: 0 },
headerName: { color: colors.textPrimary, fontSize: typeScale.title, lineHeight: lineHeight.title, fontWeight: fontWeight.semibold },
headerEmail: { color: colors.textSecondary, fontSize: typeScale.footnote, lineHeight: lineHeight.caption },
headerStatusRow: { alignItems: 'center', flexDirection: 'row', gap: spacing.xs },
headerStatusText: { color: colors.textSecondary, flex: 1, fontSize: typeScale.footnote, lineHeight: lineHeight.caption, minWidth: 0 },
// —— 版本 ——
betaChannelBadge: {
backgroundColor: colors.betaChannelBadgeBackground,
borderRadius: radius.pill,
flexShrink: 0,
paddingHorizontal: spacing.sm,
},
betaChannelBadgeText: {
color: colors.betaChannelBadgeForeground,
fontSize: typeScale.micro,
lineHeight: lineHeight.micro,
fontWeight: fontWeight.semibold,
},
// —— 退出 ——
dangerArea: { gap: spacing.md, paddingTop: spacing.sm },
dangerHint: { color: colors.textSecondary, fontSize: typeScale.footnote, lineHeight: lineHeight.caption, paddingHorizontal: spacing.md },
accountDeletionLink: {
alignItems: 'center',
alignSelf: 'center',
justifyContent: 'center',
minHeight: 44,
paddingHorizontal: spacing.md,
},
accountDeletionLinkText: {
color: colors.textSecondary,
fontSize: typeScale.footnote,
lineHeight: lineHeight.caption,
},
pressed: mobileInteractionStyles.pressed,
});