Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState, type ReactNode } from 'react';
import { Appearance, StyleSheet, useColorScheme } from 'react-native';
import { palettes, type ThemeColors, type ThemeMode } from './tokens';
import {
readThemePreference,
resolveThemeMode,
saveThemePreference,
type ThemePreference,
} from './themePreferenceStore';
interface ThemeValue {
mode: ThemeMode;
colors: ThemeColors;
/** 用户的显示模式偏好(含 'system');子树覆盖(ThemeOverrideProvider)不改变它。 */
preference: ThemePreference;
/** 已保存的偏好是否已读回;启动遮罩等它就绪后再释放,避免先按系统外观闪一下。 */
preferenceReady: boolean;
/**
* 设置显示模式偏好:立即切换并同步原生外观,返回的 Promise 在持久化失败时 reject,
* 调用方据此提示「未保存」(本次会话仍按新选择显示)。
*/
setPreference: (next: ThemePreference) => Promise<void>;
}
const ThemeContext = createContext<ThemeValue>({
mode: 'light',
colors: palettes.light,
preference: 'system',
preferenceReady: true,
setPreference: async () => undefined,
});
/**
* 让系统绘制的部分(原生菜单 / 面板 / 键盘 / 状态栏 / 玻璃材质)与 Cindy 色板同一模式:
* 'system' 还原为 unspecified,浅色 / 深色强制对应外观。只改 JS 调用,不动原生配置。
* 强制期间 useColorScheme 读到的是被强制的外观;还原后下一次渲染即读回系统值。
*/
function applyNativeScheme(preference: ThemePreference): void {
Appearance.setColorScheme(preference === 'system' ? 'unspecified' : preference);
}
/**
* 按显示模式偏好(默认跟随系统)向下提供当前主题色板。挂在 SafeAreaProvider 内、其它业务
* Provider 之上。偏好读出是异步的:读回前按系统外观渲染,StartupSplashOverlay 以
* `preferenceReady` 为释放条件之一,保证遮罩淡出时已是用户选择的模式。
*/
export function ThemeProvider({ children }: { children: ReactNode }) {
const systemScheme = useColorScheme();
const [preference, setPreferenceState] = useState<ThemePreference>('system');
const [preferenceReady, setPreferenceReady] = useState(false);
// 用户已手动选择过时置位:挂载期的异步读回不得覆盖更晚的手动选择。
const userChoseRef = useRef(false);
useEffect(() => {
let cancelled = false;
void readThemePreference().then((stored) => {
if (cancelled) return;
if (!userChoseRef.current && stored !== 'system') {
applyNativeScheme(stored);
setPreferenceState(stored);
}
setPreferenceReady(true);
});
return () => {
cancelled = true;
};
}, []);
const setPreference = useCallback((next: ThemePreference) => {
userChoseRef.current = true;
applyNativeScheme(next);
setPreferenceState(next);
return saveThemePreference(next);
}, []);
const mode = resolveThemeMode(preference, systemScheme);
const value = useMemo<ThemeValue>(
() => ({ mode, colors: palettes[mode], preference, preferenceReady, setPreference }),
[mode, preference, preferenceReady, setPreference],
);
return <ThemeContext.Provider value={value}>{children}</ThemeContext.Provider>;
}
/** 读取当前主题(mode + 色板)。用于 JSX 内联色:lucide `color=`、ActivityIndicator、placeholderTextColor 等。 */
export function useTheme(): ThemeValue {
return useContext(ThemeContext);
}
/**
* 子树级主题覆盖。为「登录首启亮色门」(DESIGN.md §16.5 主题跟随:首次打开
* Cindy → 亮色登录;第二次起跟随)提供作用域强制 mode 的通道——只覆盖包裹的
* 子树(登录界面),不影响全局 ThemeProvider 与其它界面。mode 传 null 时透传
* 外层主题(等价不覆盖)。
*/
export function ThemeOverrideProvider({
mode,
children,
}: {
mode: ThemeMode | null;
children: ReactNode;
}) {
const parent = useContext(ThemeContext);
const value = useMemo<ThemeValue>(
() => (mode == null ? parent : { ...parent, mode, colors: palettes[mode] }),
[mode, parent],
);
return <ThemeContext.Provider value={value}>{children}</ThemeContext.Provider>;
}
type StyleFactory<T> = (colors: ThemeColors) => T;
/**
* 按 scheme 记忆化的 StyleSheet 工厂缓存。
*
* 模块级 `WeakMap<makeStyles, { light?, dark? }>` 保证每个 `makeStyles` 工厂**每种模式只编译一次** sheet
* (整个 app 生命周期),组件 re-render 只做缓存查找——热路径(MessageRenderer 每条消息渲染、长列表)
* 零 StyleSheet 分配。WeakMap 让热重载 / 卸载模块的工厂可被 GC。
*/
const sheetCache = new WeakMap<StyleFactory<unknown>, Partial<Record<ThemeMode, unknown>>>();
/**
* 把"随主题变化的 StyleSheet"接入组件。
*
* @param make 一个 `(colors) => StyleSheet.create({...})` 工厂。
* ⚠️ **必须是模块级常量**(身份稳定),不要在组件体内内联定义——否则 WeakMap 缓存每次都 miss,
* 退化成每帧新建 sheet,拖垮热路径。
*/
export function useThemedStyles<T extends StyleSheet.NamedStyles<T>>(make: StyleFactory<T>): T {
const { mode, colors } = useTheme();
return useMemo(() => {
const factory = make as StyleFactory<unknown>;
let byMode = sheetCache.get(factory);
if (!byMode) {
byMode = {};
sheetCache.set(factory, byMode);
}
if (!byMode[mode]) {
byMode[mode] = StyleSheet.create(make(colors));
}
return byMode[mode] as T;
}, [make, mode, colors]);
}