Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
import AsyncStorage from '@react-native-async-storage/async-storage';
import type { HomeListSortBy, HomeStatusFilter } from './homeListPriority';
import type { HomeProjectOrder } from './homeProjectOrder';
import {
DEFAULT_HOME_TASK_INFO_FIELDS,
normalizeLastActivityFilter,
normalizeProjectFilter,
normalizeTaskInfoFields,
normalizeVendorFilter,
normalizeViewMode,
type HomeLastActivityFilter,
type HomeListViewMode,
type HomeProjectFilter,
type HomeTeammateFilter,
type HomeTaskInfoField,
type HomeVendorFilter,
} from './homeDisplaySettings';
const STORAGE_KEY = 'xdt-maker.mobile.home.view-preferences.v1';
/** 首页视图偏好:设备范围 + 显示菜单(与桌面侧栏同结构)。缺省值保持老用户现在的样子。 */
export interface HomeViewPreferences {
groupByProject: boolean;
/** 缺省关:老首页是项目 folder + 对话按时间混排,不是桌面现在的「对话归组」。 */
groupDialogue: boolean;
sortBy: HomeListSortBy;
statusFilter: HomeStatusFilter;
/** 缺省按最近活动;手动时项目行按 manualProjectOrder,对话仍跟任务排序。 */
projectOrder: HomeProjectOrder;
manualProjectOrder: string[];
/** 项目 key 带设备与路径,只对保存它的账号身份有效(见 projectFilterOwner)。 */
projectFilter: HomeProjectFilter;
teammateFilter: HomeTeammateFilter;
teammateFilterOwner: string;
/** 保存项目筛选时的账号身份(homeNavigationOwner);读取时与当前身份不符则视为不筛选。 */
projectFilterOwner: string;
vendorFilter: HomeVendorFilter;
lastActivityFilter: HomeLastActivityFilter;
/** 缺省列表(带预览行):手机首页一直是这个样子。 */
viewMode: HomeListViewMode;
/** 任务行右侧信息;顺序 = 勾选先后。 */
taskInfoFields: HomeTaskInfoField[];
/** 上次选中的电脑;name 用于设备列表尚未同步回来时的表头兜底显示。 */
selectedDevice: { deviceId: string; name: string } | null;
}
export interface HomeViewPreferencePatch {
groupByProject?: boolean;
groupDialogue?: boolean;
sortBy?: HomeListSortBy;
statusFilter?: HomeStatusFilter;
projectOrder?: HomeProjectOrder;
manualProjectOrder?: string[];
/** 写项目筛选必须同时给 owner,否则无法判断它属于哪个账号。 */
projectFilter?: { owner: string; value: HomeProjectFilter };
teammateFilter?: { owner: string; value: HomeTeammateFilter };
vendorFilter?: HomeVendorFilter;
lastActivityFilter?: HomeLastActivityFilter;
viewMode?: HomeListViewMode;
taskInfoFields?: HomeTaskInfoField[];
selectedDevice?: { deviceId: string; name: string } | null;
}
/**
* 读首页视图偏好。偏好整体按设备存一份,但项目筛选按账号隔离:切换账号后另一个账号
* 的项目 key 匹配不上任何项目,沿用会把新账号的首页筛空,因此身份不符时回到不筛选。
*/
export async function readHomeViewPreferences(owner: string): Promise<HomeViewPreferences> {
const raw = await AsyncStorage.getItem(STORAGE_KEY);
if (!raw) return emptyPreferences();
let preferences: HomeViewPreferences;
try {
preferences = normalizeStoredPreferences(JSON.parse(raw));
} catch {
return emptyPreferences();
}
return { ...preferences,
...(!owner || preferences.projectFilterOwner !== owner ? { projectFilter: 'all' as const, projectFilterOwner: '' } : {}),
...(!owner || preferences.teammateFilterOwner !== owner ? { teammateFilter: 'all' as const, teammateFilterOwner: '' } : {}),
};
}
// save 是 read-modify-write:并发调用会拿到同一份旧快照互相覆盖(后落盘者丢掉先落盘的 patch),
// 用单一 pending 链把「读 → 合并 → 写」串行化,保证每次写都基于上一次写完后的状态。
let writeChain: Promise<void> = Promise.resolve();
export function saveHomeViewPreferences(patch: HomeViewPreferencePatch): Promise<void> {
const next = writeChain.then(() => writeHomeViewPreferences(patch));
// 链自身吞掉失败,避免一次异常让后续所有写入跟着 reject。
writeChain = next.catch(() => undefined);
return next;
}
/**
* 只持久化用户 override(docs/dev-rules/configuration-and-overrides.md §2):把 patch 合并进已存的
* 稀疏记录,未写过的字段不落盘,读取时按当下默认值补齐,默认值演进时未自定义的用户自动跟随。
* 筛选的 'all' 即「不筛选」= 默认,写入时删除字段(「重置筛选」由此恢复跟随默认);
* 其余字段一经用户显式选择就保留为 override,即使恰好等于当前默认值。
* 旧版本写下的完整记录无法区分是否自定义,按规则不猜测,原样当作 override。
*/
async function writeHomeViewPreferences(patch: HomeViewPreferencePatch): Promise<void> {
// A failed read (disk/lock) must reject so we do not replace a still-valid
// blob with defaults. Corrupt JSON is different: keeping it makes every
// computer switch alert "couldn't save" forever.
const raw = await AsyncStorage.getItem(STORAGE_KEY);
const record: Record<string, unknown> = { ...(raw === null ? {} : parseStoredRecord(raw)) };
const assign = (field: string, value: unknown) => {
if (value !== undefined) record[field] = value;
};
assign('groupByProject', patch.groupByProject);
assign('groupDialogue', patch.groupDialogue);
assign('sortBy', patch.sortBy);
assign('statusFilter', patch.statusFilter);
assign('projectOrder', patch.projectOrder);
assign('manualProjectOrder', patch.manualProjectOrder ? [...patch.manualProjectOrder] : undefined);
assign('viewMode', patch.viewMode);
assign('taskInfoFields', patch.taskInfoFields ? [...patch.taskInfoFields] : undefined);
for (const field of ['projectFilter', 'teammateFilter'] as const) {
const filter = patch[field];
if (!filter) continue;
if (filter.value === 'all') {
delete record[field];
delete record[`${field}Owner`];
} else {
record[field] = filter.value === 'none' ? 'none' : [...filter.value];
record[`${field}Owner`] = filter.owner;
}
}
for (const field of ['vendorFilter', 'lastActivityFilter'] as const) {
const value = patch[field];
if (value === undefined) continue;
if (value === 'all') delete record[field];
else record[field] = value;
}
// null 是有效值(切回「所有对话」),用 undefined 判断字段是否出现在 patch 里。
if (patch.selectedDevice !== undefined) {
const device = normalizeDevice(patch.selectedDevice);
if (device) {
record.deviceId = device.deviceId;
record.deviceName = device.name;
} else {
delete record.deviceId;
delete record.deviceName;
}
}
await AsyncStorage.setItem(STORAGE_KEY, JSON.stringify(record));
}
/** 已存的稀疏记录;损坏或不是对象时从空记录重来(见上方关于损坏 JSON 的说明)。 */
function parseStoredRecord(raw: string): Record<string, unknown> {
try {
return readRecord(JSON.parse(raw)) ?? {};
} catch {
return {};
}
}
export async function clearHomeViewPreferences(): Promise<void> {
await AsyncStorage.removeItem(STORAGE_KEY).catch(() => undefined);
}
function emptyPreferences(): HomeViewPreferences {
return {
groupByProject: true,
groupDialogue: false,
selectedDevice: null,
sortBy: 'recency',
statusFilter: 'active',
projectOrder: 'activity',
manualProjectOrder: [],
projectFilter: 'all',
teammateFilter: 'all',
teammateFilterOwner: '',
projectFilterOwner: '',
vendorFilter: 'all',
lastActivityFilter: 'all',
viewMode: 'list',
taskInfoFields: [...DEFAULT_HOME_TASK_INFO_FIELDS],
};
}
function normalizeStoredPreferences(value: unknown): HomeViewPreferences {
const record = readRecord(value);
if (!record) return emptyPreferences();
const deviceId = readString(record.deviceId);
const deviceName = readString(record.deviceName);
return {
groupByProject: typeof record.groupByProject === 'boolean'
? record.groupByProject
: true,
groupDialogue: record.groupDialogue === true,
selectedDevice: deviceId
? { deviceId, name: deviceName || deviceId }
: null,
sortBy: record.sortBy === 'priority' || record.sortBy === 'created' ? record.sortBy : 'recency',
statusFilter: record.statusFilter === 'archived' || record.statusFilter === 'all'
? record.statusFilter
: 'active',
projectOrder: record.projectOrder === 'custom' ? 'custom' : 'activity',
manualProjectOrder: readStringList(record.manualProjectOrder),
projectFilter: normalizeProjectFilter(record.projectFilter),
teammateFilter: record.teammateFilter === 'none' ? 'none' : normalizeProjectFilter(record.teammateFilter),
teammateFilterOwner: readString(record.teammateFilterOwner) ?? '',
projectFilterOwner: readString(record.projectFilterOwner) ?? '',
vendorFilter: normalizeVendorFilter(record.vendorFilter),
lastActivityFilter: normalizeLastActivityFilter(record.lastActivityFilter),
viewMode: normalizeViewMode(record.viewMode),
taskInfoFields: normalizeTaskInfoFields(record.taskInfoFields),
};
}
function normalizeDevice(device: { deviceId: string; name: string } | null): HomeViewPreferences['selectedDevice'] {
if (!device) return null;
const deviceId = typeof device.deviceId === 'string' ? device.deviceId.trim() : '';
if (!deviceId) return null;
const name = typeof device.name === 'string' ? device.name.trim() : '';
return {
deviceId,
name: name || deviceId,
};
}
function readRecord(value: unknown): Record<string, unknown> | null {
return value && typeof value === 'object' && !Array.isArray(value)
? value as Record<string, unknown>
: null;
}
function readString(value: unknown): string | null {
return typeof value === 'string' && value.trim().length > 0 ? value.trim() : null;
}
function readStringList(value: unknown): string[] {
if (!Array.isArray(value)) return [];
const next: string[] = [];
const seen = new Set<string>();
for (const item of value) {
if (typeof item !== 'string') continue;
const key = item.trim();
if (!key || seen.has(key)) continue;
seen.add(key);
next.push(key);
}
return next;
}
/** Explicit navigation overrides are separate from legacy device/display preferences.
* Identity is account + host + resource, never a cached canonical Session or a name.
*/
export interface LastTeammateIdentity {
deviceId: string;
collectionId: string;
resourceKind: 'bot';
resourceId: string;
}
export interface HomeNavigationPreferences {
/** Preselects the computer when creating another teammate; launch never reopens it. */
lastTeammate?: LastTeammateIdentity;
/** The task home's teammate section: expanded rows or collapsed header. */
teammatesCollapsed?: boolean;
/** Explicit account override; absent defaults to showing the collapsed avatar strip. */
showCollapsedTeammateAvatars?: boolean;
}
const NAVIGATION_PREFIX = 'cindy.mobile.home.navigation.v1.';
export function normalizeHomeNavigationPreferences(value: unknown): HomeNavigationPreferences {
const record = readRecord(value);
if (!record) return {};
const last = readRecord(record.lastTeammate);
const identityFields = ['deviceId', 'collectionId', 'resourceId'] as const;
const validLast = last?.resourceKind === 'bot' && identityFields.every((field) =>
typeof last[field] === 'string' && last[field].trim().length > 0 && last[field].length <= 256);
// The retired tasks/teammates `mode` is dropped here, so the next write clears it.
return {
...(typeof record.showCollapsedTeammateAvatars === 'boolean' ? { showCollapsedTeammateAvatars: record.showCollapsedTeammateAvatars } : {}),
...(typeof record.teammatesCollapsed === 'boolean' ? { teammatesCollapsed: record.teammatesCollapsed } : {}),
...(validLast ? { lastTeammate: {
deviceId: last!.deviceId as string,
collectionId: last!.collectionId as string,
resourceKind: 'bot' as const,
resourceId: last!.resourceId as string,
} } : {}),
};
}
export async function readHomeNavigationPreferences(owner: string): Promise<HomeNavigationPreferences> {
if (!owner) return {};
// A failed read must not be treated as an empty blob and overwrite prior choices.
const raw = await AsyncStorage.getItem(NAVIGATION_PREFIX + encodeURIComponent(owner));
if (!raw || raw.length > 4096) return {};
try { return normalizeHomeNavigationPreferences(JSON.parse(raw)); } catch { return {}; }
}
export function saveHomeNavigationPreferences(
owner: string,
patch: { lastTeammate?: LastTeammateIdentity | null; teammatesCollapsed?: boolean; showCollapsedTeammateAvatars?: boolean },
): Promise<void> {
if (!owner) return Promise.resolve();
// Share the existing serialized writer; each operation captures its own owner.
const next = writeChain.then(async () => {
const current = await readHomeNavigationPreferences(owner);
const merged = normalizeHomeNavigationPreferences({ ...current, ...patch });
await AsyncStorage.setItem(NAVIGATION_PREFIX + encodeURIComponent(owner), JSON.stringify(merged));
});
writeChain = next.catch(() => undefined);
return next;
}
/** Task-home group disclosure. Keys carry device and path, so the record belongs to one account. */
export interface HomeCollapsePreferences {
pinnedCollapsed?: boolean;
sharedCollapsed?: boolean;
collapsedProjectKeys?: string[];
expandedAutomationGroups?: string[];
}
const COLLAPSE_PREFIX = 'cindy.mobile.home.collapse.v1.';
/** Removed projects never toggle again; keep the most recent choices instead of a GC pass. */
const COLLAPSE_KEY_LIMIT = 200;
function normalizeHomeCollapsePreferences(value: unknown): HomeCollapsePreferences {
const record = readRecord(value);
if (!record) return {};
const next: HomeCollapsePreferences = {};
for (const field of ['pinnedCollapsed', 'sharedCollapsed'] as const) {
if (typeof record[field] === 'boolean') next[field] = record[field];
}
for (const field of ['collapsedProjectKeys', 'expandedAutomationGroups'] as const) {
if (Array.isArray(record[field])) next[field] = readStringList(record[field]).slice(-COLLAPSE_KEY_LIMIT);
}
return next;
}
export async function readHomeCollapsePreferences(owner: string): Promise<HomeCollapsePreferences> {
if (!owner) return {};
const raw = await AsyncStorage.getItem(COLLAPSE_PREFIX + encodeURIComponent(owner));
if (!raw) return {};
try { return normalizeHomeCollapsePreferences(JSON.parse(raw)); } catch { return {}; }
}
export function saveHomeCollapsePreferences(owner: string, patch: HomeCollapsePreferences): Promise<void> {
if (!owner) return Promise.resolve();
const next = writeChain.then(async () => {
const current = await readHomeCollapsePreferences(owner);
const merged = normalizeHomeCollapsePreferences({ ...current, ...patch });
await AsyncStorage.setItem(COLLAPSE_PREFIX + encodeURIComponent(owner), JSON.stringify(merged));
});
writeChain = next.catch(() => undefined);
return next;
}
export const __testing = {
storageKey: STORAGE_KEY,
navigationPrefix: NAVIGATION_PREFIX,
collapsePrefix: COLLAPSE_PREFIX,
};