Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
import { useCallback, useEffect, useState } from 'react';
export const PROMPT_RECOMMENDATION_KEY = 'prompt-recommendation-enabled';
/** Module-level memory is the synchronous source of truth for event handlers. */
let memoryValue: boolean | null = null;
const listeners = new Set<() => void>();
const lifecycleListeners = new Set<(enabled: boolean) => void>();
function notifyPreferenceChanged(enabled: boolean): void {
listeners.forEach((fn) => fn());
lifecycleListeners.forEach((fn) => fn(enabled));
}
function readFromStorage(): boolean {
try {
return localStorage.getItem(PROMPT_RECOMMENDATION_KEY) !== 'false';
} catch {
return true;
}
}
export function getPromptRecommendationPreference(): boolean {
if (memoryValue !== null) return memoryValue;
memoryValue = readFromStorage();
return memoryValue;
}
/** 跨窗口 storage push 同步模块级真值;Store 与 hook 共用,避免首次 render 读旧缓存。 */
export function syncPromptRecommendationPreferenceFromStorageValue(
storageValue: string | null,
): boolean {
memoryValue = storageValue !== 'false';
notifyPreferenceChanged(memoryValue);
return memoryValue;
}
export function usePromptRecommendationPreference(): {
enabled: boolean;
setEnabled: (next: boolean) => void;
} {
const [enabled, setState] = useState<boolean>(getPromptRecommendationPreference);
const setEnabled = useCallback((next: boolean) => {
memoryValue = next;
setState(next);
try {
// 持久化用户显式选择,与「从未自定义」明确区分。
// 若未来版本默认值变化,显式设为 true 的用户不受影响。
localStorage.setItem(PROMPT_RECOMMENDATION_KEY, next ? 'true' : 'false');
} catch {
// localStorage 不可用 → 静默; 模块级内存值仍在本渲染进程内生效。
}
notifyPreferenceChanged(next);
}, []);
useEffect(() => {
const sync = () => setState(getPromptRecommendationPreference());
// 当所有 hook 实例都卸载后再次挂载时,跨窗口的 storage 事件可能已被错失,
// 此时 memoryValue 仍是旧值。在添加第一个 listener 前从 storage 刷新缓存,
// 确保多窗口切换场景下不会读到过期的偏好状态。
if (listeners.size === 0) {
memoryValue = readFromStorage();
setState(memoryValue);
}
listeners.add(sync);
const onStorage = (event: StorageEvent) => {
if (event.key !== PROMPT_RECOMMENDATION_KEY) return;
syncPromptRecommendationPreferenceFromStorageValue(event.newValue);
};
window.addEventListener('storage', onStorage);
return () => {
listeners.delete(sync);
window.removeEventListener('storage', onStorage);
};
}, []);
return { enabled, setEnabled };
}
/** 运行期消费者订阅偏好变化(推荐状态 Store 用于全局清理)。 */
export function subscribePromptRecommendationPreference(
listener: (enabled: boolean) => void,
): () => void {
lifecycleListeners.add(listener);
return () => lifecycleListeners.delete(listener);
}
/** Test-only reset for the module-level source of truth. */
export function _resetPromptRecommendationPreferenceForTests(): void {
memoryValue = null;
listeners.clear();
lifecycleListeners.clear();
}