Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

feat(desktop): 模型选择器新增「最近」视图

Zhang Yunjine8fd07ad8500
diff --git a/apps/desktop/src/renderer/__tests__/authContextRace.test.ts b/apps/desktop/src/renderer/__tests__/authContextRace.test.ts
index f12255ab5a..a73eef1ac1 100644
--- a/apps/desktop/src/renderer/__tests__/authContextRace.test.ts
+++ b/apps/desktop/src/renderer/__tests__/authContextRace.test.ts
@@ -41,6 +41,7 @@ describe('AuthContext auth-state races', () => {
'setProviderModelMemoryOwner(state.dataOwnerId);',
'setModelEnginePrefsOwner(state.dataOwnerId);',
'setModelFavoritesOwner(state.dataOwnerId);',
+ 'setRecentModelsOwner(state.dataOwnerId);',
]) {
expect(applyBlock).toContain(call);
}
diff --git a/apps/desktop/src/renderer/__tests__/authContextSessionBoundary.test.tsx b/apps/desktop/src/renderer/__tests__/authContextSessionBoundary.test.tsx
index 65f3e2022d..34656617ea 100644
--- a/apps/desktop/src/renderer/__tests__/authContextSessionBoundary.test.tsx
+++ b/apps/desktop/src/renderer/__tests__/authContextSessionBoundary.test.tsx
@@ -109,6 +109,11 @@ import {
addModelFavorite,
listModelFavorites,
} from '@/state/modelFavorites';
+import {
+ __resetForTest as resetRecentModels,
+ listRecentModels,
+ recordRecentModel,
+} from '@/state/recentModels';
import { __testing as ssoOrgHistoryTesting } from '@/state/ssoOrgHistory';
function user(id: string) {
@@ -865,13 +870,15 @@ describe('AuthContext session cache boundaries', () => {
* applyIncomingState,不能自己拼半套 setter —— 漏接任一 owner 分区都会让本地模式
* 读写上一个身份的数据:跨身份可见,还会把改动写进别人的账号。
*/
- it('repartitions unified-picker favorites and engine overrides across local mode', async () => {
+ it('repartitions unified-picker favorites, recents and engine overrides across local mode', async () => {
resetFavorites();
resetEnginePrefs();
+ resetRecentModels();
const view = renderHook(() => useAuth(), { wrapper });
await waitFor(() => expect(view.result.current.user?.id).toBe('account-a'));
const cloudUid = addModelFavorite({ providerId: 'xd', modelId: 'gpt-5.5', agent: 'codex' });
setModelEngineOverride('xd', 'gpt-5.5', 'cc');
+ recordRecentModel({ providerId: 'xd', modelId: 'gpt-5.5', agent: 'codex' }, 1000);
expect(cloudUid).not.toBe('');
await act(async () => {
@@ -880,12 +887,14 @@ describe('AuthContext session cache boundaries', () => {
// 本地模式是另一个分区:云端身份存的东西一条都不该露出来。
expect(listModelFavorites()).toHaveLength(0);
expect(getModelEngineOverride('xd', 'gpt-5.5')).toBeUndefined();
+ expect(listRecentModels()).toHaveLength(0);
const localUid = addModelFavorite({
providerId: 'anthropic',
modelId: 'claude-opus-5',
agent: 'cc',
});
setModelEngineOverride('anthropic', 'claude-opus-5', 'codex');
+ recordRecentModel({ providerId: 'anthropic', modelId: 'claude-opus-5', agent: 'cc' }, 2000);
expect(listModelFavorites().map((item) => item.uid)).toEqual([localUid]);
mocks.service.exitLocalMode.mockResolvedValue(authState('account-a'));
@@ -896,8 +905,10 @@ describe('AuthContext session cache boundaries', () => {
expect(listModelFavorites().map((item) => item.uid)).toEqual([cloudUid]);
expect(getModelEngineOverride('xd', 'gpt-5.5')).toBe('cc');
expect(getModelEngineOverride('anthropic', 'claude-opus-5')).toBeUndefined();
+ expect(listRecentModels().map((item) => item.modelId)).toEqual(['gpt-5.5']);
resetFavorites();
resetEnginePrefs();
+ resetRecentModels();
window.localStorage.clear();
});
diff --git a/apps/desktop/src/renderer/__tests__/recentModels.test.ts b/apps/desktop/src/renderer/__tests__/recentModels.test.ts
new file mode 100644
index 0000000000..b5b1630af5
--- /dev/null
+++ b/apps/desktop/src/renderer/__tests__/recentModels.test.ts
@@ -0,0 +1,236 @@
+/**
+ * recentModels.test.ts
+ * ---------------------------------------------------------------------------
+ * 回归 state/recentModels.ts 的核心约定(统一模型选择器「最近」视图):
+ * 1. 默认空列表,不写 localStorage
+ * 2. record 落盘 + usedAt 倒序 + 重复记录移到最前(时间取新)
+ * 3. 去重按**副本身份**(来源 + 模型 + 引擎 + 深度 + Fast):同一模型不同配置各占一行,
+ * 完全相同的副本只留一条、usedAt 取 max(时钟回拨不降级)
+ * 4. 容量裁剪:只留最近 RECENT_MODELS_KEEP 条
+ * 5. sanitize:非法条目丢弃、引擎非法整条丢、providerId 拒绝保留位 '*'、重复副本取最新、排序倒序
+ * 6. dataOwnerId 分区隔离
+ * 7. storage 事件跨窗口重读,迟到旧事件不回滚
+ * 8. 落盘失败静默吞,内存态仍生效
+ *
+ * 项目 vitest env=node,无 window。沿用 modelFavorites.test.ts 的最小 localStorage stub。
+ */
+
+import { describe, it, expect, afterEach, beforeEach, vi } from 'vitest';
+
+class MemLocalStorage {
+ private store = new Map<string, string>();
+ onWrite: ((key: string) => void) | null = null;
+ getItem(k: string): string | null {
+ return this.store.has(k) ? (this.store.get(k) as string) : null;
+ }
+ setItem(k: string, v: string): void {
+ this.store.set(k, v);
+ this.onWrite?.(k);
+ }
+ removeItem(k: string): void {
+ this.store.delete(k);
+ }
+ clear(): void {
+ this.store.clear();
+ }
+}
+
+let memStorage: MemLocalStorage;
+
+beforeEach(() => {
+ memStorage = new MemLocalStorage();
+ vi.stubGlobal('window', { localStorage: memStorage });
+ vi.stubGlobal('localStorage', memStorage);
+ vi.resetModules();
+});
+
+afterEach(() => {
+ vi.unstubAllGlobals();
+ vi.restoreAllMocks();
+});
+
+/** 「另一窗口写盘 → 广播 storage 事件」的最小总线。 */
+function installStorageBus(): void {
+ const handlers: Array<(event: StorageEvent) => void> = [];
+ vi.stubGlobal('window', {
+ localStorage: memStorage,
+ addEventListener: (type: string, listener: EventListenerOrEventListenerObject) => {
+ if (type === 'storage' && typeof listener === 'function') {
+ handlers.push(listener as (event: StorageEvent) => void);
+ }
+ },
+ removeEventListener: vi.fn(),
+ });
+ memStorage.onWrite = (key: string) => {
+ queueMicrotask(() => {
+ for (const handler of handlers) handler({ key } as StorageEvent);
+ });
+ };
+}
+
+async function loadModule() {
+ return await import('@/state/recentModels');
+}
+
+const OPUS = { providerId: 'anthropic', modelId: 'claude-opus-5', agent: 'cc' } as const;
+const SOL = { providerId: 'openai', modelId: 'gpt-5.6-sol', agent: 'codex' } as const;
+
+describe('recentModels store', () => {
+ it('默认空列表,不落盘', async () => {
+ const m = await loadModule();
+ expect(m.listRecentModels()).toEqual([]);
+ expect(memStorage.getItem(m.__STORAGE_KEY)).toBeNull();
+ });
+
+ it('记录后倒序陈列,重复记录移到最前并更新时间', async () => {
+ const m = await loadModule();
+ m.recordRecentModel(OPUS, 1000);
+ m.recordRecentModel(SOL, 2000);
+ expect(m.listRecentModels().map((item) => item.modelId)).toEqual([
+ 'gpt-5.6-sol',
+ 'claude-opus-5',
+ ]);
+
+ m.recordRecentModel(OPUS, 3000);
+ const items = m.listRecentModels();
+ expect(items.map((item) => item.modelId)).toEqual(['claude-opus-5', 'gpt-5.6-sol']);
+ expect(items[0]?.usedAt).toBe(3000);
+ // 去重:同一份副本不堆第二条。
+ expect(items).toHaveLength(2);
+ });
+
+ it('按副本身份去重:同一模型的不同配置各占一行', async () => {
+ const m = await loadModule();
+ m.recordRecentModel(OPUS, 1000);
+ m.recordRecentModel({ ...OPUS, effort: 'high' }, 2000);
+ m.recordRecentModel({ ...OPUS, fast: true }, 3000);
+ const items = m.listRecentModels();
+ expect(items).toHaveLength(3);
+ expect(items.map((item) => `${item.effort ?? '-'}${item.fast ? '+fast' : ''}`)).toEqual([
+ '-+fast',
+ 'high',
+ '-',
+ ]);
+ // 完全相同的副本(含 effort / fast 全同)仍然只留一条。
+ m.recordRecentModel({ ...OPUS, effort: 'high' }, 4000);
+ expect(m.listRecentModels()).toHaveLength(3);
+ expect(m.listRecentModels()[0]).toMatchObject({ effort: 'high', usedAt: 4000 });
+ });
+
+ it('落盘内容与列表一致,可跨重启恢复(同一 key 重读)', async () => {
+ const m = await loadModule();
+ m.recordRecentModel(OPUS, 1000);
+ const persisted = JSON.parse(memStorage.getItem(m.__STORAGE_KEY) as string) as {
+ items: Array<{ modelId: string; usedAt: number }>;
+ };
+ expect(persisted.items).toEqual([
+ { providerId: 'anthropic', modelId: 'claude-opus-5', agent: 'cc', usedAt: 1000 },
+ ]);
+ // 模拟重启:清缓存后重读同一份 localStorage。
+ m.__resetForTest();
+ memStorage.setItem(
+ m.__STORAGE_KEY,
+ JSON.stringify({
+ items: [{ providerId: 'anthropic', modelId: 'claude-opus-5', agent: 'cc', usedAt: 1000 }],
+ }),
+ );
+ expect(m.listRecentModels().map((item) => item.modelId)).toEqual(['claude-opus-5']);
+ });
+
+ it('非法入参静默 no-op,不写脏数据', async () => {
+ const m = await loadModule();
+ m.recordRecentModel({ providerId: '*', modelId: 'x', agent: 'cc' }, 1);
+ m.recordRecentModel({ providerId: 'anthropic', modelId: '', agent: 'cc' }, 1);
+ // agent 非法 → 整条丢弃(配置副本缺引擎无法表达任何配置)。
+ m.recordRecentModel({ providerId: 'anthropic', modelId: 'claude-opus-5', agent: 'nope' } as never, 1);
+ m.recordRecentModel({ ...OPUS }, Number.NaN);
+ expect(m.listRecentModels()).toEqual([]);
+ expect(memStorage.getItem(m.__STORAGE_KEY)).toBeNull();
+ });
+
+ it('时钟回拨:更旧的 usedAt 不把已有记录的时间往回拧', async () => {
+ const m = await loadModule();
+ m.recordRecentModel(OPUS, 5000);
+ m.recordRecentModel(OPUS, 1000);
+ expect(m.listRecentModels()[0]?.usedAt).toBe(5000);
+ });
+
+ it('容量裁剪:只保留最近 RECENT_MODELS_KEEP 条', async () => {
+ const m = await loadModule();
+ for (let i = 0; i < m.RECENT_MODELS_KEEP + 5; i += 1) {
+ m.recordRecentModel({ providerId: 'anthropic', modelId: `m-${i}`, agent: 'cc' }, 1000 + i);
+ }
+ const items = m.listRecentModels();
+ expect(items).toHaveLength(m.RECENT_MODELS_KEEP);
+ // 保留的是最新的一批:队首是最后记的,队尾是第 (总数 - KEEP + 1) 条。
+ expect(items[0]?.modelId).toBe(`m-${m.RECENT_MODELS_KEEP + 4}`);
+ expect(items[items.length - 1]?.modelId).toBe('m-5');
+ });
+
+ it('sanitize:损坏 / 越界条目丢弃,重复副本取最新,排序倒序', async () => {
+ const m = await loadModule();
+ memStorage.setItem(
+ m.__STORAGE_KEY,
+ JSON.stringify({
+ items: [
+ null,
+ 'nope',
+ { providerId: '*', modelId: 'reserved', agent: 'cc', usedAt: 9 },
+ { providerId: 'anthropic', modelId: '', agent: 'cc', usedAt: 9 },
+ { providerId: 'anthropic', modelId: 'claude-opus-5', agent: 'nope', usedAt: 9 },
+ { providerId: 'anthropic', modelId: 'claude-opus-5', agent: 'cc', usedAt: 'oops' },
+ { providerId: 'anthropic', modelId: 'claude-opus-5', agent: 'cc', usedAt: 100 },
+ { providerId: 'anthropic', modelId: 'claude-opus-5', agent: 'cc', usedAt: 300 },
+ { providerId: 'anthropic', modelId: 'claude-opus-5', agent: 'cc', effort: 'high', usedAt: 200 },
+ ],
+ }),
+ );
+ expect(m.listRecentModels()).toEqual([
+ { providerId: 'anthropic', modelId: 'claude-opus-5', agent: 'cc', usedAt: 300 },
+ { providerId: 'anthropic', modelId: 'claude-opus-5', agent: 'cc', effort: 'high', usedAt: 200 },
+ ]);
+ });
+
+ it('storage 事件重读真相,且不采信迟到的旧事件', async () => {
+ installStorageBus();
+ const m = await loadModule();
+ m.recordRecentModel(OPUS, 1000);
+ // 另一窗口写入更完整的状态(真实浏览器不回送写入方,这里手动广播)。
+ memStorage.setItem(
+ m.__STORAGE_KEY,
+ JSON.stringify({
+ items: [
+ { providerId: 'openai', modelId: 'gpt-5.6-sol', agent: 'codex', usedAt: 2000 },
+ { providerId: 'anthropic', modelId: 'claude-opus-5', agent: 'cc', usedAt: 1000 },
+ ],
+ }),
+ );
+ await Promise.resolve();
+ expect(m.listRecentModels().map((item) => item.modelId)).toEqual([
+ 'gpt-5.6-sol',
+ 'claude-opus-5',
+ ]);
+ });
+
+ it('落盘失败静默吞,内存态仍生效', async () => {
+ const m = await loadModule();
+ vi.spyOn(memStorage, 'setItem').mockImplementation(() => {
+ throw new Error('quota');
+ });
+ expect(() => m.recordRecentModel(OPUS, 1000)).not.toThrow();
+ expect(m.listRecentModels().map((item) => item.modelId)).toEqual(['claude-opus-5']);
+ });
+
+ it('dataOwnerId 分区隔离:切号后各读各的', async () => {
+ const m = await loadModule();
+ m.setRecentModelsOwner('user-a');
+ m.recordRecentModel(OPUS, 1000);
+ m.setRecentModelsOwner('user-b');
+ expect(m.listRecentModels()).toEqual([]);
+ m.recordRecentModel(SOL, 2000);
+ m.setRecentModelsOwner('user-a');
+ expect(m.listRecentModels().map((item) => item.modelId)).toEqual(['claude-opus-5']);
+ m.setRecentModelsOwner('user-b');
+ expect(m.listRecentModels().map((item) => item.modelId)).toEqual(['gpt-5.6-sol']);
+ });
+});
diff --git a/apps/desktop/src/renderer/__tests__/unifiedModelPanelRendering.test.tsx b/apps/desktop/src/renderer/__tests__/unifiedModelPanelRendering.test.tsx
index 90a27f9cbe..883ac07bc0 100644
--- a/apps/desktop/src/renderer/__tests__/unifiedModelPanelRendering.test.tsx
+++ b/apps/desktop/src/renderer/__tests__/unifiedModelPanelRendering.test.tsx
@@ -10,7 +10,8 @@
* 3. 点自定义 / 右键弹出配置浮层,浮层里的引擎胶囊只列候选引擎;
* 4. 点引擎胶囊 → 写 modelEnginePrefs override,行三元组当场跟着变;
* 5. 点 ☆ → 写 modelFavorites 配置副本,收藏区置顶出现;
- * 6. 点行 → 按该行生效配置回调 (provider, model, effort)。
+ * 6. 点行 → 按该行生效配置回调 (provider, model, effort);
+ * 7. recordRecentUsage 开启时选择成功才写 recentModels(「最近」区当场出现)。
*/
import { act, fireEvent, render, screen, waitFor, within } from '@testing-library/react';
@@ -33,6 +34,8 @@ vi.mock('react-i18next', async (importOriginal) => ({
'newChat.modelSelector.search.noResults': '无匹配模型',
'newChat.modelSelector.search.placeholderAll': '搜索模型…',
'newChat.modelSelector.unified.favoritesGroup': '收藏',
+ 'newChat.modelSelector.unified.recentGroup': '最近',
+ 'newChat.modelSelector.unified.recentEmpty': '还没有最近使用的模型',
'newChat.modelSelector.unified.recommended': '推荐',
'newChat.modelSelector.unified.addFavorite': '存为收藏',
'newChat.modelSelector.unified.customize': '自定义',
@@ -41,6 +44,7 @@ vi.mock('react-i18next', async (importOriginal) => ({
'newChat.modelSelector.unified.customized': '已自定义',
'newChat.modelSelector.unified.reset': '恢复推荐',
'newChat.modelSelector.unified.railAll': '全部',
+ 'newChat.modelSelector.unified.railRecent': '最近',
'newChat.modelSelector.unified.railSameEngine': `仅 ${options?.agent ?? ''}`,
'newChat.modelSelector.unified.crossEngineWarning': '切换引擎会重建上下文,可能丢失内容',
'newChat.modelSelector.category.anthropic': 'Anthropic',
@@ -218,6 +222,11 @@ import {
listModelFavorites,
updateModelFavorite,
} from '@/state/modelFavorites';
+import {
+ __resetForTest as resetRecentModels,
+ listRecentModels,
+ recordRecentModel,
+} from '@/state/recentModels';
import { setModelEngineOverride } from '@/state/modelEnginePrefs';
const onProviderChange = vi.fn();
@@ -263,6 +272,7 @@ beforeEach(() => {
onProviderChange.mockClear();
resetEnginePrefs();
resetFavorites();
+ resetRecentModels();
});
describe('统一面板 · 打折 GPT-5.6 与 GPT-6 包月互切', () => {
@@ -4129,60 +4139,273 @@ it('teammate fallback exposes supported Harness choices and preserves the primar
expect(change).toHaveBeenLastCalledWith([primary, expect.objectContaining({ harness: 'claude', providerId: 'openai', model: 'chatgpt/gpt-5.6' })]);
});
+describe('统一面板 · 最近使用记录与陈列', () => {
+ it('默认不记录(非对话入口不开 recordRecentUsage)', async () => {
+ renderPanel();
+ await act(async () => {
+ fireEvent.click(rowFor('GPT-5.5'));
+ });
+ expect(listRecentModels()).toEqual([]);
+ expect(document.querySelector('[data-group-label="最近"]')).toBeNull();
+ });
-describe('harness configuration keeps the model menu open', () => {
- it.each(['success', 'cancel', 'error'] as const)('%s keeps both menus available', async (outcome) => {
- let finish!: (value: boolean) => void;
- let fail!: (error: Error) => void;
- const change = vi.fn(() => new Promise<boolean>((resolve, reject) => {
- finish = resolve;
- fail = reject;
- }));
- function Picker() {
- const [pendingTarget, setPendingTarget] = React.useState<'claude-code' | undefined>();
- return <ModelSelector
- modelId="gpt-5.5" effort="high" vendorKey="codex"
- currentProviderId="xd" onModelChange={vi.fn()} onEffortChange={vi.fn()}
- sessionEngineFilter={{
- currentAgent: 'codex',
- runtimeAgent: 'codex',
- pendingTarget,
- onCrossEngineSelect: async ({ targetAgent }) => {
- const applied = await change();
- if (applied) setPendingTarget(targetAgent === 'claude-code' ? targetAgent : undefined);
- return applied;
- },
- }}
- />;
- }
- render(<Picker />);
- await act(async () => { fireEvent.click(screen.getByRole('button')); });
- await act(async () => { fireEvent.click(screen.getByRole('button', { name: '全部' })); });
- const flyout = await openRowFlyout('GPT-5.5');
+ it('开启后选择成功即记(归一化行身份),但常规视图不陈列最近区', async () => {
+ renderPanel({ recordRecentUsage: true });
await act(async () => {
- fireEvent.click(flyout.querySelector('[data-engine-capsule="cc"]') as HTMLElement);
+ fireEvent.click(rowFor('GPT-5.6'));
});
- expect(change).toHaveBeenCalledTimes(1);
- expect(screen.getByRole('listbox')).toBeTruthy();
+ expect(listRecentModels().map((item) => `${item.providerId}:${item.modelId}`)).toEqual([
+ 'openai:gpt-5.6',
+ ]);
+ // 最近只作为侧栏「最近」格的独立视图,不再混进全部 / 供应商列表(2026-09-16 实测裁决)。
+ expect(document.querySelector('[data-group-label="最近"]')).toBeNull();
+ });
+
+ it('选择失败(false)不记', async () => {
+ onProviderChange.mockImplementationOnce(() => false);
+ renderPanel({ recordRecentUsage: true });
await act(async () => {
- if (outcome === 'error') fail(new Error('switch failed'));
- else finish(outcome === 'success');
+ fireEvent.click(rowFor('GPT-5.5'));
});
- expect(screen.getByRole('listbox')).toBeTruthy();
- expect(screen.getByTestId('unified-model-config-flyout')).toBeTruthy();
- if (outcome === 'success') {
- expect(screen.getByTestId('unified-model-config-flyout')
- .querySelector('[data-engine-capsule="cc"]')?.getAttribute('aria-pressed')).toBe('true');
- // Switching back must clear the pending intent through the same transaction.
- await act(async () => {
- fireEvent.click(screen.getByTestId('unified-model-config-flyout')
- .querySelector('[data-engine-capsule="codex"]') as HTMLElement);
- });
- expect(change).toHaveBeenCalledTimes(2);
- await act(async () => { finish(true); });
- }
- expect(screen.getByRole('listbox')).toBeTruthy();
- expect(screen.getByTestId('unified-model-config-flyout')
- .querySelector('[data-engine-capsule="codex"]')?.getAttribute('aria-pressed')).toBe('true');
+ expect(listRecentModels()).toEqual([]);
+ });
+
+ it('收藏行(存的是旧 wire id)记的是归一化行身份', async () => {
+ addModelFavorite({ providerId: 'openai', modelId: 'chatgpt/gpt-5.6', agent: 'cc' });
+ renderPanel({ recordRecentUsage: true });
+ const favRow = document.querySelector('[data-unified-anchor^="fav::"]');
+ expect(favRow).not.toBeNull();
+ await act(async () => {
+ fireEvent.click(favRow as HTMLElement);
+ });
+ expect(listRecentModels().map((item) => item.modelId)).toEqual(['gpt-5.6']);
+ });
+
+ it('rail 的「最近」格在收藏之上,点击后只留最近区', async () => {
+ recordRecentModel({ providerId: 'openai', modelId: 'gpt-5.6', agent: 'codex' }, 1000);
+ renderPanel();
+ const railKeys = [...document.querySelectorAll('[data-rail-item]')].map((el) =>
+ el.getAttribute('data-rail-item'),
+ );
+ expect(railKeys.indexOf('recent')).toBeGreaterThanOrEqual(0);
+ expect(railKeys.indexOf('recent')).toBeLessThan(railKeys.indexOf('favorites'));
+
+ await act(async () => {
+ fireEvent.click(document.querySelector('[data-rail-item="recent"]') as HTMLElement);
+ });
+ const list = screen.getByRole('listbox');
+ expect(within(list).getByText('GPT-5.6')).toBeTruthy();
+ expect(within(list).queryByText('GPT-5.5')).toBeNull();
+ // 最近面板与收藏面板一致:L2 显示 provider 来源(来源详情行),不是模型描述。
+ const sourceRow = list.querySelector('[data-model-source-details]');
+ expect(sourceRow?.textContent).toContain('OpenAI');
+ expect(within(list).queryByText(/A very long English description/)).toBeNull();
+ });
+
+ it('最近视图为空时显示引导空态', async () => {
+ renderPanel();
+ await act(async () => {
+ fireEvent.click(document.querySelector('[data-rail-item="recent"]') as HTMLElement);
+ });
+ expect(screen.getByText('还没有最近使用的模型')).toBeTruthy();
+ });
+
+ it('点最近行按该副本的完整配置回调(引擎 / 深度一并带出)', async () => {
+ recordRecentModel(
+ { providerId: 'openai', modelId: 'gpt-5.6', agent: 'cc', effort: 'high' },
+ 1000,
+ );
+ renderPanel();
+ await act(async () => {
+ fireEvent.click(document.querySelector('[data-rail-item="recent"]') as HTMLElement);
+ });
+ await act(async () => {
+ fireEvent.click(rowFor('GPT-5.6'));
+ });
+ // 副本存的是 cc 引擎 → 按 cc 的 wire id 与 high 档发出。
+ expect(onProviderChange).toHaveBeenCalledWith(
+ 'openai',
+ 'chatgpt/gpt-5.6',
+ 'high',
+ expect.any(Boolean),
+ );
+ });
+
+ it('最近行的星标按配置副本匹配收藏:未收藏点星新增,已收藏点星取消', async () => {
+ recordRecentModel({ providerId: 'openai', modelId: 'gpt-5.6', agent: 'codex' }, 1000);
+ renderPanel();
+ await act(async () => {
+ fireEvent.click(document.querySelector('[data-rail-item="recent"]') as HTMLElement);
+ });
+ // 未收藏:悬停星是「存为收藏」,点一下把这份副本存进收藏。
+ await act(async () => {
+ fireEvent.click(within(screen.getByRole('listbox')).getByRole('button', { name: '存为收藏' }));
+ });
+ expect(listModelFavorites()).toHaveLength(1);
+ expect(listModelFavorites()[0]).toMatchObject({
+ providerId: 'openai',
+ modelId: 'gpt-5.6',
+ agent: 'codex',
+ });
+ // 星标点亮(按钮语义变为「取消收藏」)。
+ expect(
+ within(screen.getByRole('listbox')).getByRole('button', { name: '取消收藏' }),
+ ).toBeTruthy();
+
+ // 再点一次 → 移除匹配的那条收藏,星灭。
+ await act(async () => {
+ fireEvent.click(within(screen.getByRole('listbox')).getByRole('button', { name: '取消收藏' }));
+ });
+ expect(listModelFavorites()).toHaveLength(0);
+ expect(within(screen.getByRole('listbox')).getByRole('button', { name: '存为收藏' })).toBeTruthy();
+ });
+
+ it('已收藏的副本在最近视图里直接亮星,点星移除对应收藏', async () => {
+ addModelFavorite({ providerId: 'openai', modelId: 'gpt-5.6', agent: 'codex' });
+ recordRecentModel({ providerId: 'openai', modelId: 'gpt-5.6', agent: 'codex' }, 1000);
+ renderPanel();
+ await act(async () => {
+ fireEvent.click(document.querySelector('[data-rail-item="recent"]') as HTMLElement);
+ });
+ await act(async () => {
+ fireEvent.click(within(screen.getByRole('listbox')).getByRole('button', { name: '取消收藏' }));
+ });
+ expect(listModelFavorites()).toHaveLength(0);
+ });
+
+ it('星标先圈定来源 + 模型:另一型号的收藏即使三元组巧合一致也不误命中(2026-09-16 review P0)', async () => {
+ // gpt-5.5 的收藏解析后与 gpt-5.6 的这条副本同引擎 / 同档 / 同 Fast —— 只有模型不同。
+ addModelFavorite({ providerId: 'openai', modelId: 'gpt-5.5', agent: 'codex' });
+ recordRecentModel({ providerId: 'openai', modelId: 'gpt-5.6', agent: 'codex' }, 1000);
+ renderPanel();
+ await act(async () => {
+ fireEvent.click(document.querySelector('[data-rail-item="recent"]') as HTMLElement);
+ });
+ const list = screen.getByRole('listbox');
+ // 不能点亮:本行并没有被收藏。
+ expect(within(list).getByRole('button', { name: '存为收藏' })).toBeTruthy();
+ // 点星只能新增 gpt-5.6 这条,绝不能把 gpt-5.5 的收藏删掉。
+ await act(async () => {
+ fireEvent.click(within(list).getByRole('button', { name: '存为收藏' }));
+ });
+ expect(
+ listModelFavorites()
+ .map((item) => item.modelId)
+ .sort(),
+ ).toEqual(['gpt-5.5', 'gpt-5.6']);
+ });
+
+ it('点已标星的最近行 = 按收藏副本选中(锚点带上那条收藏的 uid)', async () => {
+ const uid = addModelFavorite({ providerId: 'openai', modelId: 'gpt-5.6', agent: 'codex' });
+ expect(uid).not.toBe('');
+ recordRecentModel({ providerId: 'openai', modelId: 'gpt-5.6', agent: 'codex' }, 1000);
+ const onSessionFavoriteAnchorChange = vi.fn();
+ renderPanel({ onSessionFavoriteAnchorChange });
+ await act(async () => {
+ fireEvent.click(document.querySelector('[data-rail-item="recent"]') as HTMLElement);
+ });
+ await act(async () => {
+ fireEvent.click(rowFor('GPT-5.6'));
+ });
+ // 选择真的应用(同引擎链路回调拿到行配置)……
+ expect(onProviderChange).toHaveBeenCalledWith('openai', 'gpt-5.6', 'medium', false);
+ // ……锚点才记上命中的那条收藏(与收藏行同构;不传就是「选中态回落到模型行」)。
+ expect(onSessionFavoriteAnchorChange).toHaveBeenCalledWith(
+ expect.objectContaining({ uid, engine: 'codex', providerId: 'openai' }),
+ );
+ });
+
+ it('最近行不提供配置入口:不宣告 ← / 不抢右键 / 按 ← 不开浮层(2026-09-16 review P1)', async () => {
+ recordRecentModel({ providerId: 'openai', modelId: 'gpt-5.6', agent: 'codex' }, 1000);
+ renderPanel();
+ await act(async () => {
+ fireEvent.click(document.querySelector('[data-rail-item="recent"]') as HTMLElement);
+ });
+ const row = rowFor('GPT-5.6');
+ expect(row.getAttribute('aria-keyshortcuts')).toBeNull();
+ expect(row.querySelector('[data-row-customize]')).toBeNull();
+ // 右键不 preventDefault(不吞原生菜单),也不开浮层。
+ const contextMenu = new MouseEvent('contextmenu', { bubbles: true, cancelable: true });
+ await act(async () => {
+ row.dispatchEvent(contextMenu);
+ });
+ expect(contextMenu.defaultPrevented).toBe(false);
+ expect(screen.queryByTestId('unified-model-config-flyout')).toBeNull();
+ await act(async () => {
+ fireEvent.keyDown(row, { key: 'ArrowLeft' });
+ });
+ expect(screen.queryByTestId('unified-model-config-flyout')).toBeNull();
+ });
+
+ it('在最近视图取消「当前选中的那份收藏」:与收藏视图同一口径——先把默认配置应用出去再删', async () => {
+ const uid = addModelFavorite({
+ providerId: 'xd',
+ modelId: 'gpt-5.5',
+ agent: 'cc',
+ effort: 'low',
+ });
+ recordRecentModel({ providerId: 'xd', modelId: 'gpt-5.5', agent: 'cc', effort: 'low' }, 1000);
+ const onUnifiedSelect = vi.fn();
+ renderPanel({
+ onUnifiedSelect,
+ selectedFavoriteUid: uid,
+ currentProviderId: 'xd',
+ modelId: 'gpt-5.5',
+ vendorKey: 'cc',
+ effort: 'low',
+ fastMode: false,
+ });
+ await act(async () => {
+ fireEvent.click(document.querySelector('[data-rail-item="recent"]') as HTMLElement);
+ });
+ await act(async () => {
+ fireEvent.click(within(screen.getByRole('listbox')).getByRole('button', { name: '取消收藏' }));
+ });
+ // 删的正是正在跑的那一份 → 先把默认配置应用出去(与收藏视图逐字同一条链路),
+ // 再删记录;否则配置与选中态会分家。
+ expect(onUnifiedSelect).toHaveBeenCalledWith({
+ providerId: 'xd',
+ modelId: 'gpt-5.5',
+ engine: 'codex',
+ effort: 'high',
+ fast: false,
+ favoriteUid: null,
+ resetToRecommended: true,
+ });
+ expect(listModelFavorites()).toHaveLength(0);
+ });
+
+ it('会话跨引擎:点已标星的最近行仍走切换事务,并把命中的收藏 uid 带过去', async () => {
+ const uid = addModelFavorite({
+ providerId: 'anthropic',
+ modelId: 'claude-opus-5',
+ agent: 'cc',
+ });
+ recordRecentModel({ providerId: 'anthropic', modelId: 'claude-opus-5', agent: 'cc' }, 1000);
+ const onCrossEngineSelect = vi.fn();
+ renderPanel({
+ sessionEngineFilter: {
+ currentAgent: 'codex' as const,
+ onCrossEngineSelect,
+ },
+ vendorKey: 'codex',
+ currentProviderId: 'openai',
+ modelId: 'codex/gpt-5.6',
+ });
+ await act(async () => {
+ fireEvent.click(document.querySelector('[data-rail-item="recent"]') as HTMLElement);
+ });
+ await act(async () => {
+ fireEvent.click(rowFor('Opus 5'));
+ });
+ // 跨引擎不走 onProviderChange(selectRow 内改道),锚点随事务一起交出去。
+ expect(onProviderChange).not.toHaveBeenCalled();
+ expect(onCrossEngineSelect).toHaveBeenCalledWith(
+ expect.objectContaining({
+ providerId: 'anthropic',
+ targetAgent: 'claude-code',
+ favoriteUid: uid,
+ }),
+ );
});
});
diff --git a/apps/desktop/src/renderer/__tests__/unifiedModelSelection.test.ts b/apps/desktop/src/renderer/__tests__/unifiedModelSelection.test.ts
index 6aa716a162..733840c205 100644
--- a/apps/desktop/src/renderer/__tests__/unifiedModelSelection.test.ts
+++ b/apps/desktop/src/renderer/__tests__/unifiedModelSelection.test.ts
@@ -1,6 +1,6 @@
/**
* 统一模型选择器(模型优先)M3 / M4 的**纯逻辑锁**:行生效配置合成、收藏副本语义、
- * 收藏置顶 + 分组陈列、rail 派生、浮层定位、档位绝对色。
+ * 收藏 / 最近置顶 + 分组陈列、rail 派生、浮层定位、档位绝对色。
*
* 为什么这些必须有测试:行右侧的三元组与浮层里的每个控件显示的是**同一份合成结果**,
* 一旦两边规则漂移,用户会看到「行上写着 high、浮层滑杆停在 medium」这种自相矛盾;
@@ -17,6 +17,7 @@ import type {
import {
UNIFIED_FLYOUT_GAP,
+ UNIFIED_RECENT_MODELS_LIMIT,
buildUnifiedListSections,
engineOfAgentKind,
entryMatchesModelId,
@@ -29,7 +30,9 @@ import {
resolveFavoriteRowConfig,
resolveUnifiedRowConfig,
} from '@/components/new-chat/unifiedModelSelection';
+import type { ModelConfigCopy } from '@/state/modelConfigCopy';
import type { ModelFavoriteItem } from '@/state/modelFavorites';
+import type { RecentModelItem } from '@/state/recentModels';
import {
EFFORT_TIER_COLORS,
effortTierColor,
@@ -79,6 +82,16 @@ function favoriteOf(over: Partial<ModelFavoriteItem> = {}): ModelFavoriteItem {
};
}
+function recentOf(over: Partial<RecentModelItem> = {}): RecentModelItem {
+ return {
+ providerId: 'anthropic',
+ modelId: 'claude-opus-5',
+ agent: 'cc',
+ usedAt: 1,
+ ...over,
+ };
+}
+
describe('resolveUnifiedRowConfig', () => {
it('无 override 时落推荐引擎与目录默认档', () => {
const config = resolveUnifiedRowConfig({ entry: entryOf() });
@@ -395,6 +408,174 @@ describe('buildUnifiedListSections', () => {
});
expect(sections[0].rows.map((row) => row.favorite?.uid)).toEqual(['fav-1', 'fav-2']);
});
+
+ describe('最近视图(仅侧栏「最近」格)', () => {
+ it('常规视图(全部 / 供应商 / 同引擎)不陈列最近区 —— 即使 store 里有记录', () => {
+ for (const rail of [
+ { kind: 'all' } as const,
+ { kind: 'provider', providerId: 'anthropic' } as const,
+ { kind: 'engine', agent: 'claude-code' } as const,
+ ]) {
+ const sections = buildUnifiedListSections({
+ entries: [opus, gpt],
+ favorites: [favoriteOf()],
+ recentModels: [recentOf()],
+ query: '',
+ rail,
+ });
+ expect(sections.some((section) => section.kind === 'recent')).toBe(false);
+ // 收藏区照旧置顶。
+ expect(sections[0].kind).toBe('favorites');
+ }
+ });
+
+ it('rail = 最近时只出最近区,行锚点是副本身份(带 recent 条目)', () => {
+ const sections = buildUnifiedListSections({
+ entries: [opus, gpt],
+ favorites: [favoriteOf()],
+ recentModels: [recentOf({ providerId: 'openai', modelId: 'gpt-5.5' })],
+ query: '',
+ rail: { kind: 'recent' },
+ recommendation: { agent: 'codex', providerId: 'openai', modelId: 'gpt-5.5' },
+ });
+ expect(sections.map((section) => section.kind)).toEqual(['recent']);
+ // 锚点是**副本身份**(同一模型不同配置各占一行);key 由 store 的去重身份算得。
+ expect(sections[0].rows[0].anchor).toEqual({
+ kind: 'recent',
+ key: expect.any(String),
+ providerId: 'openai',
+ modelId: 'gpt-5.5',
+ });
+ expect(sections[0].rows[0].favorite).toBeUndefined();
+ expect(sections[0].rows[0].recent).toMatchObject({
+ providerId: 'openai',
+ modelId: 'gpt-5.5',
+ agent: 'cc',
+ });
+ });
+
+ it(`最多陈列 ${UNIFIED_RECENT_MODELS_LIMIT} 条,按传入的最近顺序取`, () => {
+ const entries = [
+ opus,
+ gpt,
+ entryOf({ modelId: 'm-3' }),
+ entryOf({ modelId: 'm-4' }),
+ entryOf({ modelId: 'm-5' }),
+ entryOf({ modelId: 'm-6' }),
+ entryOf({ modelId: 'm-7' }),
+ ];
+ const sections = buildUnifiedListSections({
+ entries,
+ favorites: [],
+ recentModels: entries.map((entry, index) =>
+ recentOf({ providerId: entry.providerId, modelId: entry.modelId, usedAt: 100 - index }),
+ ),
+ query: '',
+ rail: { kind: 'recent' },
+ });
+ expect(sections[0].kind).toBe('recent');
+ expect(sections[0].rows.map((row) => row.entry.modelId)).toEqual([
+ 'claude-opus-5',
+ 'gpt-5.5',
+ 'm-3',
+ 'm-4',
+ 'm-5',
+ ]);
+ });
+
+ it('不可路由的条目跳过,并从更早的历史里补足', () => {
+ const sections = buildUnifiedListSections({
+ entries: [opus, gpt],
+ favorites: [],
+ // 最新三条里两条已下架 → 展示仍然是最近可用的 2 条,不多也不少。
+ recentModels: [
+ recentOf({ modelId: 'gone-1', usedAt: 300 }),
+ recentOf({ modelId: 'gone-2', usedAt: 200 }),
+ recentOf({ providerId: 'openai', modelId: 'gpt-5.5', usedAt: 100 }),
+ recentOf({ usedAt: 50 }),
+ ],
+ query: '',
+ rail: { kind: 'recent' },
+ });
+ expect(sections[0].kind).toBe('recent');
+ expect(sections[0].rows.map((row) => row.entry.modelId)).toEqual([
+ 'gpt-5.5',
+ 'claude-opus-5',
+ ]);
+ });
+
+ it('老数据存的 wire id 也能解析回行身份', () => {
+ const bridged = entryOf({
+ providerId: 'openai',
+ modelId: 'gpt-5.6',
+ displayName: 'GPT-5.6',
+ candidates: ['claude-code'],
+ capabilities: {
+ 'claude-code': capability('claude-code', { wireModelId: 'chatgpt/gpt-5.6' }),
+ },
+ });
+ const sections = buildUnifiedListSections({
+ entries: [bridged],
+ favorites: [],
+ recentModels: [recentOf({ providerId: 'openai', modelId: 'chatgpt/gpt-5.6' })],
+ query: '',
+ rail: { kind: 'recent' },
+ });
+ expect(sections[0].rows[0].entry.modelId).toBe('gpt-5.6');
+ expect(sections[0].rows[0].anchor).toEqual({
+ kind: 'recent',
+ key: expect.any(String),
+ providerId: 'openai',
+ modelId: 'gpt-5.6',
+ });
+ });
+
+ it('搜索词生效时回落「全部」视图(rail 被搜索接管,最近不再是当前视图)', () => {
+ const sections = buildUnifiedListSections({
+ entries: [opus, gpt],
+ favorites: [],
+ recentModels: [recentOf({ usedAt: 200 }), recentOf({ providerId: 'openai', modelId: 'gpt-5.5', usedAt: 100 })],
+ query: 'gpt',
+ rail: { kind: 'recent' },
+ });
+ expect(sections.some((section) => section.kind === 'recent')).toBe(false);
+ expect(sections.flatMap((section) => section.rows.map((row) => row.entry.modelId))).toEqual([
+ 'gpt-5.5',
+ ]);
+ });
+
+ it('rail = 收藏时不出最近区(收藏轨只陈列收藏)', () => {
+ const sections = buildUnifiedListSections({
+ entries: [opus],
+ favorites: [favoriteOf()],
+ recentModels: [recentOf()],
+ query: '',
+ rail: { kind: 'favorites' },
+ });
+ expect(sections.map((section) => section.kind)).toEqual(['favorites']);
+ });
+
+ it('空列表 / 全部不可路由时最近视图为空', () => {
+ expect(
+ buildUnifiedListSections({
+ entries: [opus],
+ favorites: [],
+ recentModels: [],
+ query: '',
+ rail: { kind: 'recent' },
+ }),
+ ).toEqual([]);
+ expect(
+ buildUnifiedListSections({
+ entries: [opus],
+ favorites: [],
+ recentModels: [recentOf({ modelId: 'gone' })],
+ query: '',
+ rail: { kind: 'recent' },
+ }),
+ ).toEqual([]);
+ });
+ });
});
describe('会话内形态(同引擎过滤 / pinnedEngine)', () => {
@@ -504,7 +685,7 @@ describe('会话内形态(同引擎过滤 / pinnedEngine)', () => {
const engineOfRow = (
overrides: Record<string, 'cc' | 'codex' | 'pi'> = {},
pinnedEngine: 'cc' | 'codex' | 'pi' = 'cc',
- ) => (entry: UnifiedModelEntry, favorite?: ModelFavoriteItem) =>
+ ) => (entry: UnifiedModelEntry, favorite?: ModelConfigCopy) =>
favorite
? resolveFavoriteRowConfig({ entry, item: favorite }).engine
: resolveUnifiedRowConfig({
@@ -719,25 +900,29 @@ describe('会话内形态(同引擎过滤 / pinnedEngine)', () => {
});
describe('buildUnifiedRail', () => {
- it('★ 常驻,供应商按行首次出现序排列', () => {
+ it('最近 / ★ 常驻,最近在上;供应商按行首次出现序排列', () => {
const entries = [
entryOf({ providerId: 'xd', modelId: 'a' }),
entryOf({ providerId: 'anthropic', modelId: 'b' }),
entryOf({ providerId: 'xd', modelId: 'c' }),
];
- // ★ 常驻(2026-08-13 裁决:空收藏也显示,点进去看引导空态,不再按有无收藏隐藏)。
+ // 两格常驻(2026-08-13 ★ 裁决 / 2026-09-16 最近裁决:空列表也显示,点进去看引导空态)。
expect(buildUnifiedRail(entries)).toEqual([
+ { kind: 'recent' },
{ kind: 'favorites' },
{ kind: 'all' },
{ kind: 'provider', providerId: 'xd' },
{ kind: 'provider', providerId: 'anthropic' },
]);
- expect(buildUnifiedRail(entries)[0]).toEqual({ kind: 'favorites' });
+ // 最近在收藏之上(2026-09-16 实测反馈)。
+ expect(buildUnifiedRail(entries)[0]).toEqual({ kind: 'recent' });
+ expect(buildUnifiedRail(entries)[1]).toEqual({ kind: 'favorites' });
});
it('会话内多一格「同引擎」,位置在 ★ 之下、全部之上', () => {
const entries = [entryOf({ providerId: 'xd', modelId: 'a' })];
expect(buildUnifiedRail(entries, 'codex')).toEqual([
+ { kind: 'recent' },
{ kind: 'favorites' },
{ kind: 'engine', agent: 'codex' },
{ kind: 'all' },
@@ -754,6 +939,7 @@ describe('buildUnifiedRail', () => {
entryOf({ providerId: 'openai', modelId: 'c' }),
];
expect(buildUnifiedRail(entries, undefined, ['openai', 'xd'])).toEqual([
+ { kind: 'recent' },
{ kind: 'favorites' },
{ kind: 'all' },
{ kind: 'provider', providerId: 'openai' },
diff --git a/apps/desktop/src/renderer/components/new-chat/ChatInput.tsx b/apps/desktop/src/renderer/components/new-chat/ChatInput.tsx
index 8a85714c38..d0f76cfe3a 100644
--- a/apps/desktop/src/renderer/components/new-chat/ChatInput.tsx
+++ b/apps/desktop/src/renderer/components/new-chat/ChatInput.tsx
@@ -9292,6 +9292,11 @@ export function ChatInput({
// Claude Code 回退冒充);草稿直接取当前引擎。
engineMarkVendor={unifiedPanelActive ? composerEngineMarkVendor : null}
unifiedPanel={unifiedPanelActive}
+ // 「最近使用」只记**对话**入口(新任务草稿 / 会话内,本组件就是这两个),且
+ // 远程不记:被控端目录的模型写进本机列表只会得到一行永远不可路由的记录。
+ // deviceLinkDeviceId 为 undefined = 归属尚未解析(冷启动) —— 宁可这一帧
+ // 不记,也不把远程选择写成本地记录。
+ recordRecentUsage={!remoteHostId && deviceLinkDeviceId === null}
// 联合列表只列**运行时已注册**的引擎(撤掉 AgentSelect 后接住它的
// hiddenVendors 门禁);未加载时不传 = 不隐藏任何引擎。会话内没有
// 跨引擎切换事务可走时锁定当前引擎(见 inSessionEngineLocked)。
diff --git a/apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx b/apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx
index 1e9a572a24..6f1abf296a 100644
--- a/apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx
+++ b/apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx
@@ -824,6 +824,8 @@ interface ModelSelectorProps {
unifiedAgents?: readonly AgentKind[];
/** 统一面板是否只采用目录官方推荐配置,不读取个人引擎偏好与收藏配置。 */
unifiedSelectionPolicy?: UnifiedModelPanelProps['selectionPolicy'];
+ /** 语义同 ModelSelectorContentProps.recordRecentUsage(选中成功后记入「最近使用」)。 */
+ recordRecentUsage?: boolean;
/**
* composer pill 尾部的**引擎小标**(model-selector-unified §1.1)。
*
@@ -989,6 +991,13 @@ interface ModelSelectorContentProps {
*/
unifiedAgents?: readonly AgentKind[];
unifiedSelectionPolicy?: UnifiedModelPanelProps['selectionPolicy'];
+ /**
+ * 选择真的应用成功后,把该模型记进「最近使用」(见 state/recentModels 的语义边界)。
+ * **默认关**:统一面板被对话之外的入口共用(定时任务 / IM 默认 / Bot / Hook /
+ * Worker / 子代理 / 设置页),那些选择是配置动作;只有对话侧真正的两个入口
+ * (ChatInput 的新任务草稿与会话内)开启,且 SSH / device-link 远程不开启。
+ */
+ recordRecentUsage?: boolean;
/**
* 统一面板里被选中的**收藏锚点** uid(规格 §1.5:选中的是那一条收藏副本,不是模型本体)。
* 由调用方持有(草稿层),因为它与 (来源, 模型) 一样属于「当前选了什么」这份状态。
@@ -1186,6 +1195,7 @@ function ModelSelectorContentView({
sessionEngineFilter,
unifiedAgents: requestedUnifiedAgents,
unifiedSelectionPolicy = 'personalized',
+ recordRecentUsage = false,
selectedFavoriteUid = null,
onSessionFavoriteAnchorChange,
onUnifiedSelect,
@@ -3351,6 +3361,7 @@ function ModelSelectorContentView({
onPaymentRequired={showPaymentRequired}
configurationEnabled={configurationEnabled}
selectionPolicy={unifiedSelectionPolicy}
+ recordRecentUsage={recordRecentUsage}
isRouteDisabled={(providerId, id, rowAgent) => providersOverride ? false : modelDisabledOf(providers.find((provider) => provider.id === providerId) ?? null, id, rowAgent)}
{...(panelSessionEngineFilter ? { sessionEngineFilter: panelSessionEngineFilter } : {})}
{...(followSession ? { followSession: {
@@ -3745,6 +3756,7 @@ export function ModelSelector({
unifiedAgents,
unifiedSelectionPolicy = 'personalized',
engineMarkVendor = null,
+ recordRecentUsage = false,
selectedFavoriteUid = null,
onSessionFavoriteAnchorChange,
onUnifiedSelect,
@@ -4560,6 +4572,7 @@ export function ModelSelector({
sessionEngineFilter={contentSessionEngineFilter}
unifiedAgents={unifiedAgents}
unifiedSelectionPolicy={unifiedSelectionPolicy}
+ recordRecentUsage={recordRecentUsage}
selectedFavoriteUid={selectedFavoriteUid}
onSessionFavoriteAnchorChange={onSessionFavoriteAnchorChange}
onUnifiedSelect={onUnifiedSelect}
diff --git a/apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx b/apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx
index dbb8db4c58..45c6979f0f 100644
--- a/apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx
+++ b/apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx
@@ -16,9 +16,11 @@ import { cn } from '@/lib/utils';
import { modelPriceDiscountLabelValues, type ModelPricePresentation } from '@/lib/modelPriceFormat';
import type { Effort } from '@/lib/userPreferences.types';
import { getModelEngineOverride, useModelEnginePrefsVersion } from '@/state/modelEnginePrefs';
+import { modelConfigCopyIdentity, type ModelConfigCopy } from '@/state/modelConfigCopy';
import { useModelFavorites, type ModelFavoriteItem } from '@/state/modelFavorites';
import { useProviderModelMemoryVersion } from '@/state/providerModelMemory';
import { useAgentDeviceModelMemoryVersion } from '@/state/agentDeviceModelMemory';
+import { useRecentModels, type RecentModelItem } from '@/state/recentModels';
import { flashScrollbar } from '@/lib/scrollbarAutoHide';
import { MORPH_CONTENT_RESIZE_EVENT } from '@/components/ui/morph-popover';
@@ -75,6 +77,7 @@ const RAIL_ALL: UnifiedRailFilter = { kind: 'all' };
/** 定宽 sizer 的行不接交互。 */
const noop = (): void => {};
const NO_FAVORITES: readonly ModelFavoriteItem[] = [];
+const NO_RECENT: readonly RecentModelItem[] = [];
export interface UnifiedSelectedRow {
/** 该行**生效**引擎(推荐 ⊕ override ⊕ 会话内 pinnedEngine ⊕ 收藏副本)。 */
@@ -150,6 +153,14 @@ export interface UnifiedModelPanelProps {
onPaymentRequired?: () => void;
/** false = 只选模型,不出配置浮层(设置类入口的 configurationEnabled)。 */
configurationEnabled?: boolean;
+ /**
+ * 选择真的应用成功后,把该模型记进「最近使用」(见 state/recentModels 的语义边界)。
+ * **默认关**:统一面板被对话之外的入口(定时任务 / IM 默认 / Bot / Hook / Worker /
+ * 子代理 / 设置页)共用,那些入口的选择是配置动作,不是「用这个模型跑过活」。只有
+ * 对话侧的两个入口(ChatInput 的新任务草稿与会话内)显式开启,且远程(SSH /
+ * device-link)不传 —— 被控端目录的模型写进本机列表只会得到一行永远不可路由的记录。
+ */
+ recordRecentUsage?: boolean;
isRouteDisabled?: (providerId: string, modelId: string, agent: AgentKind) => boolean;
/**
* official = 模型优先的受限入口。忽略全局引擎偏好、模型记忆和收藏配置,
@@ -334,6 +345,7 @@ export function UnifiedModelPanel({
paymentRequiredUnlockLabel,
onPaymentRequired,
configurationEnabled = true,
+ recordRecentUsage = false,
selectionPolicy = 'personalized',
deviceId,
isRouteDisabled,
@@ -354,6 +366,10 @@ export function UnifiedModelPanel({
// 分享来的供应商(`share:<id>`)不是同账号的电脑,没有可同步的收藏:不去读,也不报同步失败。
const remoteFavorites = useRemoteModelFavorites(isProviderShareAgentDeviceId(deviceId) ? undefined : deviceId);
const favorites = selectionPolicy === 'official' ? NO_FAVORITES : deviceId ? remoteFavorites.items : storedFavorites;
+ const storedRecentModels = useRecentModels();
+ // official 入口(设置页 / create-agent)刻意不展示「最近」:那里的选择动作不记录(见
+ // `recordRecentUsage`)也不该被个人流水影响 —— 与收藏区同一条策略门。
+ const recentModels = selectionPolicy === 'official' ? NO_RECENT : storedRecentModels;
// 引擎 override / 深度 / Fast 三份 store 的版本号:任一变化都要重算行三元组与浮层
// (其它窗口的 storage 事件、device-link 推送同样经这两个版本号进来)。远程 Agent 的档位记忆
// 是另一份 store,版本号并进 memoryVersion。
@@ -544,14 +560,15 @@ export function UnifiedModelPanel({
const configOf = useCallback(
(
entry: UnifiedModelEntry,
- favorite?: ModelFavoriteItem,
+ /** 配置副本条目(收藏 / 最近)—— 只读它自存的引擎 / 深度 / Fast。 */
+ copy?: ModelConfigCopy,
// 定宽 sizer 量的是「全部」视图,必须按那条轨解析,不能继承当前 effectiveRail
// (否则兼容行被钉成 π 后量到更窄的三元组,切「全部」再弹宽)。
railForConfig: UnifiedRailFilter = effectiveRail,
): UnifiedRowConfig => {
- // 收藏条目只读它自己存的副本(规格 §1.5),不掺模型默认与记忆。
- if (favorite) {
- return resolveFavoriteRowConfig({ entry, item: favorite, agentFastModeCapable });
+ // 收藏 / 最近条目只读它自己存的副本(规格 §1.5),不掺模型默认与记忆。
+ if (copy) {
+ return resolveFavoriteRowConfig({ entry, item: copy, agentFastModeCapable });
}
// 两个版本号只作重算触发器:store 是模块级单例,值本身不进依赖。
void enginePrefsVersion;
@@ -649,7 +666,7 @@ export function UnifiedModelPanel({
* configOf 把显示/点选钉在轨引擎,这里不钉 —— 否则排序键全变成当前轨,优先/兼容段塌掉。
*/
const effectiveEngineOf = useCallback(
- (entry: UnifiedModelEntry, favorite?: ModelFavoriteItem): UnifiedEngine => {
+ (entry: UnifiedModelEntry, favorite?: ModelConfigCopy): UnifiedEngine => {
if (favorite) {
// 收藏行引擎 = 副本自存引擎(掉出候选回落推荐)。不传 agentFastModeCapable:
// 它只影响 fast/fastCapable,不影响 engine。
@@ -686,6 +703,7 @@ export function UnifiedModelPanel({
buildUnifiedListSections({
entries,
favorites,
+ recentModels,
query,
matchesQuery: (entry, q) => matchesModelName({
id: entry.modelId, displayName: entry.displayName, description: entry.description,
@@ -697,7 +715,7 @@ export function UnifiedModelPanel({
? { recommendation: { agent: liveEngineAgent, ...selected } }
: {}),
}),
- [entries, favorites, query, effectiveRail, effectiveEngineOf, providerOrder, t, scope, liveEngineAgent, selected.modelId, selected.providerId],
+ [entries, favorites, recentModels, query, effectiveRail, effectiveEngineOf, providerOrder, t, scope, liveEngineAgent, selected.modelId, selected.providerId],
);
// 打开或切视图时,把模型本体的当前行对齐到可视高度 35% 处;收藏可以滚出顶部。
@@ -830,13 +848,40 @@ export function UnifiedModelPanel({
const isSelectedRow = useCallback(
(anchor: UnifiedAnchor, entry: UnifiedModelEntry): boolean => {
if (anchor.kind === 'fav') return false;
+ // 最近行 = 配置副本:选中态按**整份配置**核对(同模型不同档位各占一行,不能都打上
+ // 选中底色)。与收藏锚点同一条判据,只是没有 uid、以副本身份为锚点。
+ if (anchor.kind === 'recent') {
+ const item = recentModels.find(
+ (candidate) => modelConfigCopyIdentity(candidate) === anchor.key,
+ );
+ return (
+ !!item &&
+ favoriteMatchesSelection({
+ entry,
+ item,
+ selected,
+ agent: liveEngineAgent,
+ effort: selectedEffort,
+ fast: fastMode,
+ agentFastModeCapable,
+ })
+ );
+ }
// 会话 / 草稿存的是 wire id;按「行 id 或任一引擎 wire id 命中」解析(合并行契约)。
return (
entryMatchesModelId(entry, selected.modelId) &&
(selected.providerId === null || selected.providerId === anchor.providerId)
);
},
- [selected.modelId, selected.providerId],
+ [
+ agentFastModeCapable,
+ fastMode,
+ liveEngineAgent,
+ recentModels,
+ selected.modelId,
+ selected.providerId,
+ selectedEffort,
+ ],
);
/** ☆ 点亮 0.7s 后恢复(规格 §1.5:源头行不持有收藏态,只给一次动作反馈)。 */
@@ -866,6 +911,7 @@ export function UnifiedModelPanel({
} = useUnifiedRowActions({
favoriteStore: deviceId ? remoteFavorites.store : undefined,
interactionDisabled,
+ recordRecentUsage,
isLiveRow,
// 两笔实时写入(深度 + Fast)里第二笔失败时回滚第一笔用的原值,以及收藏 live 判定
// 要比的实时深度 / Fast —— 与 configOf 里「选中行读 live 值」取的是同一个格子。
@@ -894,9 +940,9 @@ export function UnifiedModelPanel({
// 「按这份收藏副本解析该行」——与收藏行渲染(configOf 的 favorite 分支)走**同一个**
// resolveFavoriteRowConfig:编辑选中收藏的引擎时,新引擎的 wire id / 档位回落 / Fast
// 能力必须与编辑完之后行上显示的那一份逐字一致(详见 useUnifiedRowActions)。
- // uid 在这里无意义(解析只看配置),给空串占位。
+ // uid 在这里无意义(解析只看配置),配置副本类型直接兼容收藏条目。
resolveFavoriteConfig: (entry, favorite) =>
- resolveFavoriteRowConfig({ entry, item: { uid: '', ...favorite }, agentFastModeCapable }),
+ resolveFavoriteRowConfig({ entry, item: favorite, agentFastModeCapable }),
// 「该行没有收藏语境时的默认配置」:引擎 = 推荐 ⊕ 用户 override ⊕ 会话 pinned(与
// configOf 的模型行分支同一套合成,少给一路就会算出一个用户从没见过的引擎),
// **刻意不传 memoryEffort / memoryFast** —— 回落的是「该模型的默认」,不是用户上次在
@@ -957,13 +1003,15 @@ export function UnifiedModelPanel({
};
/**
- * 小节标题:收藏 / 供应商分组(Chris 2026-08-13 裁决:按供应商,不按模型家族;
- * 组名与模型设置页同一套 providerLabel)。
+ * 小节标题:收藏 / 最近 / 推荐 / 供应商分组(Chris 2026-08-13 裁决:按供应商,
+ * 不按模型家族;组名与模型设置页同一套 providerLabel)。
*/
const sectionLabel = (section: (typeof sections)[number]): string =>
section.kind === 'favorites'
? t('newChat.modelSelector.unified.favoritesGroup')
- : section.kind === 'recommended'
+ : section.kind === 'recent'
+ ? t('newChat.modelSelector.unified.recentGroup')
+ : section.kind === 'recommended'
? t('newChat.modelSelector.unified.recommended')
: section.group
? providerHeading(section.group.providerId)
@@ -972,6 +1020,16 @@ export function UnifiedModelPanel({
const rows = sections.flatMap((section) => section.rows);
const hasRows = rows.length > 0;
+ /**
+ * 行 L2 显示 provider 来源而不是模型描述(2026-09-16 实测裁决)。
+ * 收藏 / 最近 / 全部三个视图一致:它们都是「跨来源的快捷清单」,行上必须说清
+ * 这一条是哪家供的(同名模型跨来源价格不同);单来源视图(供应商轨)不需要重复来源。
+ */
+ const showsSourceRow =
+ effectiveRail.kind === 'all' ||
+ effectiveRail.kind === 'recent' ||
+ effectiveRail.kind === 'favorites';
+
/**
* 行内价格的派生(设计稿 v4 定稿 F 样式):付费行显示 $ 档串,折扣行亮段按
* 折后价比例填充并尾随 ↓X%;限免显示淡染小徽标;无报价不渲染节点。
@@ -1042,13 +1100,14 @@ export function UnifiedModelPanel({
? buildUnifiedListSections({
entries,
favorites,
+ recentModels,
query: '',
rail: RAIL_ALL,
effectiveEngineOf,
providerOrder,
})
: [],
- [widthSizerActive, entries, favorites, effectiveEngineOf, providerOrder],
+ [widthSizerActive, entries, favorites, recentModels, effectiveEngineOf, providerOrder],
);
const panelContent = (
@@ -1171,10 +1230,12 @@ export function UnifiedModelPanel({
)
) : !hasRows ? (
<div className="px-3 py-6 text-center text-13 text-[var(--text-tertiary)]">
- {/* ★ 视图的空态是引导语,不是「没有匹配」(设计稿 favEmpty;★ 常驻后必经)。 */}
- {effectiveRail.kind === 'favorites' && !query.trim()
+ {/* 最近 / ★ 视图的空态是引导语,不是「没有匹配」(设计稿 favEmpty;两格常驻后必经)。 */}
+ {!query.trim() && effectiveRail.kind === 'favorites'
? t('newChat.modelSelector.unified.favoritesEmpty')
- : t('newChat.modelSelector.search.noResults')}
+ : !query.trim() && effectiveRail.kind === 'recent'
+ ? t('newChat.modelSelector.unified.recentEmpty')
+ : t('newChat.modelSelector.search.noResults')}
</div>
) : (
sections.map((section) => (
@@ -1195,27 +1256,59 @@ export function UnifiedModelPanel({
{section.rows.map((row) => {
const config = withOptimisticConfig(
row.anchor,
- configOf(row.entry, row.favorite),
+ configOf(row.entry, row.favorite ?? row.recent),
optimisticConfig,
);
const key = anchorKey(row.anchor);
const priceDisplay = priceDisplayOf(row.entry, config);
+ /**
+ * 最近行按**解析后的整份配置**匹配收藏(2026-09-16 裁决:最近也是配置副本):
+ * 同一来源 + 同一模型下,引擎 / 深度 / Fast 解析后一致就点亮星标;
+ * 点星把它存进收藏 / 从收藏里移除。
+ * 前两维(来源 + 模型)必须先圈定(2026-09-16 review P0):只看三元组的话,
+ * 另一个型号的收藏只要引擎 / 深度 / Fast 巧合一致就会被误命中,点星删掉的是
+ * 用户根本没点的那条收藏。三元组用**解析值**而不是存储字面量比:两边都可能是
+ * 「跟随推荐」的缺省字段 —— 按字面量会比出「一边有 effort、一边没有」的假不匹配。
+ */
+ const matchingFavorite = row.recent
+ ? favorites.find((favorite) => {
+ if (favorite.providerId !== row.entry.providerId) return false;
+ if (!entryMatchesModelId(row.entry, favorite.modelId)) return false;
+ const favoriteConfig = resolveFavoriteRowConfig({
+ entry: row.entry,
+ item: favorite,
+ agentFastModeCapable,
+ });
+ return (
+ favoriteConfig.engine === config.engine &&
+ favoriteConfig.effort === config.effort &&
+ favoriteConfig.fast === config.fast
+ );
+ })
+ : undefined;
+ const recentRow = !!row.recent;
+ // 最近行本身不持有收藏态:命中的收藏就是它的星标与**选中锚点**
+ // (点击=按这份副本配置应用,同收藏副本语义 —— 带上 uid,锚点/星标才一致)。
+ const starredFavorite = row.favorite ?? matchingFavorite;
return (
<UnifiedModelRow
key={key}
entry={row.entry}
anchor={row.anchor}
config={config}
- {...(effectiveRail.kind === 'all' || effectiveRail.kind === 'favorites'
+ {...(showsSourceRow
? { sourceLabel: providerLabel(row.entry.providerId) }
: {})}
selected={isSelectedRow(row.anchor, row.entry)}
active={sameAnchor(flyAnchor, row.anchor)}
- isFavoriteRow={!!row.favorite}
+ isFavoriteRow={!!starredFavorite}
justFavorited={justFavorited === key}
{...(priceDisplay ? { priceDisplay } : {})}
configurationEnabled={configurationEnabled}
+ // 最近行是只读的配置副本(流水账):不在这一页改配置,也没有配置浮层
+ // (引擎 / 深度 / Fast 由记录时的选择决定,改配置走模型行或收藏)。
+ customizeEnabled={!recentRow}
interactionDisabled={
interactionDisabled ||
actionPending ||
@@ -1231,15 +1324,31 @@ export function UnifiedModelPanel({
{...(onPaymentRequired ? { onPaymentRequired } : {})}
effortLabelOf={effortLabelOf}
providers={providers}
- onReveal={revealFlyout}
- onRevealForKeyboard={revealFlyoutForKeyboard}
- onSelect={() => selectRow(row.anchor, config, row.favorite)}
+ onReveal={recentRow ? noop : revealFlyout}
+ onRevealForKeyboard={recentRow ? noop : revealFlyoutForKeyboard}
+ onSelect={() =>
+ // 星标行的点击与收藏行同构:带上命中的那条收藏,选中态才不只停在「配置像」上。
+ selectRow(row.anchor, config, starredFavorite, row.entry)
+ }
onStar={
selectionPolicy === 'personalized'
- ? () =>
- row.favorite
- ? removeFavorite(row.anchor, row.entry)
- : addFavorite(row.anchor, config)
+ ? recentRow
+ ? () =>
+ matchingFavorite
+ ? removeFavorite(
+ {
+ kind: 'fav',
+ uid: matchingFavorite.uid,
+ providerId: matchingFavorite.providerId,
+ modelId: matchingFavorite.modelId,
+ },
+ row.entry,
+ )
+ : addFavorite(row.anchor, config)
+ : () =>
+ row.favorite
+ ? removeFavorite(row.anchor, row.entry)
+ : addFavorite(row.anchor, config)
: undefined
}
/>
@@ -1271,7 +1380,7 @@ export function UnifiedModelPanel({
<span className="truncate">{sectionLabel(section)}</span>
</div>
{section.rows.map((row) => {
- const config = configOf(row.entry, row.favorite, RAIL_ALL);
+ const config = configOf(row.entry, row.favorite ?? row.recent, RAIL_ALL);
const priceDisplay = priceDisplayOf(row.entry, config);
return (
<UnifiedModelRow
@@ -1322,7 +1431,7 @@ export function UnifiedModelPanel({
// 深度 / Fast 写入在途时显示目标值,松手即停在新档(见 withOptimisticConfig)。
const config = withOptimisticConfig(
target.anchor,
- configOf(target.entry, target.favorite),
+ configOf(target.entry, target.favorite ?? target.recent),
optimisticConfig,
);
const state: ModelConfigFlyoutState = target.favorite
diff --git a/apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx b/apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx
index 14e4f82e6b..57a26e571f 100644
--- a/apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx
+++ b/apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx
@@ -1,5 +1,5 @@
import type { ReactNode } from 'react';
-import { LayoutGrid, Star } from 'lucide-react';
+import { History, LayoutGrid, Star } from 'lucide-react';
import { useTranslation } from 'react-i18next';
import type { ProviderView } from '@cindy/model-providers';
@@ -24,7 +24,7 @@ import {
* UnifiedModelRail —— 统一面板左侧的视图筛选栏(model-selector-unified §1.2 / §1.6)。
*
* 格位由数据派生(见 `buildUnifiedRail`),这里只负责画:
- * ★收藏 → 同引擎(仅会话内,图标 = 当前会话引擎的品牌 mark)→ ──分隔── → 全部 → 各来源
+ * 最近 → ★收藏 → 同引擎(仅会话内,图标 = 当前会话引擎的品牌 mark)→ ──分隔── → 全部 → 各来源
* → (新任务草稿)──分隔── → 其他电脑上的供应商(带信号波纹的 Logo,每台电脑一段)。
* rail 常驻(2026-08-13 裁决),分隔线与设计稿 .rail-sep 同构:「个人钉的」与
* 「目录本身的视图」两段之间画一条 22px 细线。
@@ -97,17 +97,19 @@ export function UnifiedModelRail({
provider?.openAiAccount?.identity?.trim() ||
provider?.subscriptionAccount?.identity?.trim();
const label =
- item.kind === 'favorites'
- ? t('newChat.modelSelector.unified.railFavorites')
- : item.kind === 'engine'
- ? t('newChat.modelSelector.unified.railSameEngine', {
- agent: engineOption?.label ?? '',
- })
- : item.kind === 'all'
- ? t('newChat.modelSelector.unified.railAll')
- : item.kind === 'remote-provider'
- ? (remoteSources?.labelOf(item.deviceId, item.providerId) ?? item.providerId)
- : (remoteSources?.localProviderLabel ?? providerLabel)(item.providerId);
+ item.kind === 'recent'
+ ? t('newChat.modelSelector.unified.railRecent')
+ : item.kind === 'favorites'
+ ? t('newChat.modelSelector.unified.railFavorites')
+ : item.kind === 'engine'
+ ? t('newChat.modelSelector.unified.railSameEngine', {
+ agent: engineOption?.label ?? '',
+ })
+ : item.kind === 'all'
+ ? t('newChat.modelSelector.unified.railAll')
+ : item.kind === 'remote-provider'
+ ? (remoteSources?.labelOf(item.deviceId, item.providerId) ?? item.providerId)
+ : (remoteSources?.localProviderLabel ?? providerLabel)(item.providerId);
return (
<div key={key} className="contents">
{separatorBefore && (
@@ -126,7 +128,11 @@ export function UnifiedModelRail({
provider={providerUsage ? provider : undefined}
usageDeviceId={usageDeviceId}
>
- {item.kind === 'favorites' ? (
+ {item.kind === 'recent' ? (
+ // 最近格用 History(时钟 + 回拨箭头)表达「用过的时间序」,与 ★ 的「钉住」
+ // 语义区分;与其它非激活格同灰,hover 提亮,不抢视线。
+ <History size={16} />
+ ) : item.kind === 'favorites' ? (
// ☆ 未激活与其它格同灰(hover 提亮)—— 常亮金色会在没进收藏视图时也
// 抢视线(2026-08-14 实机自查);激活时整格反色 + 实心星跟随 currentColor。
<Star size={16} fill={isActive ? 'currentColor' : 'none'} />
diff --git a/apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx b/apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx
index 38e6de4b3b..f9c91de47f 100644
--- a/apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx
+++ b/apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx
@@ -48,6 +48,7 @@ export function UnifiedModelRow({
onRevealForKeyboard,
priceDisplay,
configurationEnabled = true,
+ customizeEnabled = true,
paymentRequired = false,
paymentRequiredLabel,
paymentRequiredUnlockLabel,
@@ -75,6 +76,13 @@ export function UnifiedModelRow({
/** 行内价格展示;不传 = 无报价。字段语义见 `UnifiedRowPriceDisplay`。 */
priceDisplay?: UnifiedRowPriceDisplay;
configurationEnabled?: boolean;
+ /**
+ * 行是否提供「自定义」入口(配置浮层)。false 时隐藏按钮、并在调用方关掉 reveal 回调;
+ * 与 `configurationEnabled` 的区别:那个还会把三元组里的档位 / Fast 显示一并收掉
+ * (设置类入口不展示这些维度),而最近视图是**只读的配置副本行** —— 档位照常显示,
+ * 只是不在这里编辑(最近是流水账,不提供手工改配置的入口)。
+ */
+ customizeEnabled?: boolean;
/** 付费锁定行保留在原位置,可聚焦但不能选中、收藏或打开配置。 */
paymentRequired?: boolean;
paymentRequiredLabel?: string;
@@ -88,7 +96,8 @@ export function UnifiedModelRow({
const priceSymbol = priceDisplay?.symbol ?? '$';
const engineOption = agentOptionOf(config.engine);
const openConfig = (element: HTMLElement, toggle = false) => {
- if (!paymentRequired) onReveal(anchor, element, toggle);
+ if (paymentRequired || !customizeEnabled) return;
+ onReveal(anchor, element, toggle);
};
const tripleTitle = `${engineOption.label}${
configurationEnabled && config.effort ? ` · ${effortLabelOf(config.agent, config.effort)}` : ''
@@ -108,7 +117,9 @@ export function UnifiedModelRow({
'aria-disabled': interactionDisabled ? true : undefined,
'aria-label': paymentRequiredActionLabel,
// ← 开配置浮层是这一行唯一的键盘入口,不声明就只有摸索得到(读屏用户尤甚)。
- 'aria-keyshortcuts': paymentRequired ? undefined : 'ArrowLeft',
+ // 最近行是只读配置副本(customizeEnabled=false):既没有浮层入口,就不能再宣告这个快捷键,
+ // 否则读屏用户按过去什么都不到。
+ 'aria-keyshortcuts': paymentRequired || !customizeEnabled ? undefined : 'ArrowLeft',
tabIndex: interactionDisabled ? -1 : 0,
'data-model-selected': selected ? ('true' as const) : undefined,
// Shared menu row: the panel's glide highlight; the chosen row keeps its static fill (below).
@@ -116,7 +127,9 @@ export function UnifiedModelRow({
'data-state': active ? 'open' : selected ? 'checked' : undefined,
'data-unified-anchor': anchorKey(anchor),
onContextMenu: (event: ReactMouseEvent<HTMLDivElement>) => {
- if (interactionDisabled || paymentRequired) return;
+ // 没有配置入口的行(付费行 / 最近行)**不抢**右键:不 preventDefault,把原生菜单留给用户,
+ // 否则右键变成「什么都不发生、原生菜单也被吃掉」(2026-09-16 review P1)。
+ if (!customizeEnabled || interactionDisabled || paymentRequired) return;
event.preventDefault();
openConfig(event.currentTarget);
},
@@ -135,6 +148,7 @@ export function UnifiedModelRow({
return;
}
if (event.key === 'ArrowLeft') {
+ if (!customizeEnabled) return;
event.preventDefault();
onRevealForKeyboard(anchor, event.currentTarget);
return;
@@ -269,7 +283,7 @@ export function UnifiedModelRow({
/>
)}
{starButton}
- {configurationEnabled && customizeButton}
+ {customizeEnabled && customizeButton}
{/* 常驻三元组:引擎图标 + 推理强度 + ⚡。所有行同构,自定义行整组提亮一档。
设计稿 .l1-right:margin-left auto 把右侧簇推到最右,左侧簇贴名字排。 */}
<span data-model-row-meta className="ml-auto flex shrink-0 items-center gap-2">
diff --git a/apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts b/apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts
index 2925e5600c..129e15f5ce 100644
--- a/apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts
+++ b/apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts
@@ -1,6 +1,6 @@
/**
* unifiedModelSelection —— 统一模型选择器(模型优先)面板的**纯逻辑层**:行生效配置合成、
- * 收藏/分组陈列、rail 派生、配置浮层定位。规格见
+ * 收藏 / 最近 / 分组陈列、rail 派生、配置浮层定位。规格见
* `docs/product-rules/model-selector-unified.md` §1.2 / §1.3 / §1.5 / §2。
*
* 为什么单独一层:M3 的行三元组(引擎图标 + 推理强度 + Fast)与 M4 浮层里的每一个控件,
@@ -23,7 +23,9 @@ import type { AgentKind } from '@/hooks/useAgentCapabilities';
import type { SelectableVendor } from '@/lib/agentVendors';
import type { Effort } from '@/lib/userPreferences.types';
import { applyProviderOrderIds } from '../../../shared/providerOrder';
+import { modelConfigCopyIdentity, type ModelConfigCopy } from '@/state/modelConfigCopy';
import type { ModelFavoriteItem } from '@/state/modelFavorites';
+import type { RecentModelItem } from '@/state/recentModels';
/** 引擎在**选择器 / 草稿链路**里的口径(vendor);catalog / capabilities 侧是 AgentKind。 */
export type UnifiedEngine = SelectableVendor;
@@ -41,16 +43,22 @@ export function engineOfAgentKind(agent: AgentKind): UnifiedEngine {
/**
* 行 / 浮层的锚点(规格 §1.5):模型行按 (来源, 模型) 定位,收藏条目按**独立 uid** 定位。
* 同模型的多条收藏互不牵连,靠的就是这个 uid —— 选中 / hover / 浮层绑定 / 删除全走锚点。
+ *
+ * 最近条目按**副本身份**(`key`,与 store 的去重身份同一份)定位:同一模型的不同配置
+ * (引擎 / 深度 / Fast)各占一行,选中态只能对着其中一行。
*/
export type UnifiedAnchor =
| { kind: 'model'; providerId: string; modelId: string }
- | { kind: 'fav'; uid: string; providerId: string; modelId: string };
+ | { kind: 'fav'; uid: string; providerId: string; modelId: string }
+ | { kind: 'recent'; key: string; providerId: string; modelId: string };
/** 锚点的字符串键(React key / DOM data 属性 / 相等比较)。 */
export function anchorKey(anchor: UnifiedAnchor): string {
return anchor.kind === 'fav'
? `fav::${anchor.uid}`
- : `model::${anchor.providerId}::${anchor.modelId}`;
+ : anchor.kind === 'recent'
+ ? `recent::${anchor.key}`
+ : `model::${anchor.providerId}::${anchor.modelId}`;
}
export function sameAnchor(a: UnifiedAnchor | null, b: UnifiedAnchor | null): boolean {
@@ -230,7 +238,8 @@ export function resolveUnifiedRowConfig(args: ResolveRowConfigArgs): UnifiedRowC
*/
export function resolveFavoriteRowConfig(args: {
entry: UnifiedModelEntry;
- item: ModelFavoriteItem;
+ /** 配置副本(收藏条目或最近记录)—— *只* 读它自存的引擎 / 深度 / Fast。 */
+ item: ModelConfigCopy;
agentFastModeCapable?: (agent: AgentKind) => boolean;
}): UnifiedRowConfig {
const { entry, item, agentFastModeCapable } = args;
@@ -265,7 +274,7 @@ export function resolveFavoriteRowConfig(args: {
*/
export function favoriteMatchesSelection(args: {
entry: UnifiedModelEntry;
- item: ModelFavoriteItem;
+ item: ModelConfigCopy;
selected: { providerId: string | null; modelId: string };
agent: AgentKind | null | undefined;
effort: Effort | undefined;
@@ -307,6 +316,7 @@ export function isRecommendedFavoriteConfig(
* `engine` 格只在**会话内**出现(规格 §1.6:图标 = 当前会话引擎,默认选中)。
*/
export type UnifiedRailItem =
+ | { kind: 'recent' }
| { kind: 'favorites' }
| { kind: 'engine'; agent: AgentKind }
| { kind: 'all' }
@@ -341,14 +351,17 @@ export function railItemKey(item: UnifiedRailItem): string {
}
/**
- * rail 项派生:★收藏(**常驻**) → 同引擎(仅会话内) → 全部 → 各来源供应商
+ * rail 项派生:最近 → ★收藏(**两者常驻**) → 同引擎(仅会话内) → 全部 → 各来源供应商
* (按行首次出现序,即联合列表的引擎优先序 × catalog 序)。
*
+ * 「最近」在 ★ 之上(2026-09-16 裁决):它是面板里最常用的回顾入口,常驻与 ★ 同理 ——
+ * 空列表时点进去看引导空态,不按有无记录隐藏。
+ *
* 「同引擎」格刻意排在 ★ 之下、全部之上(规格 §1.6):它是会话内的**默认视图**,
* 但收藏仍是用户自己钉的东西,优先级更高。
*
- * 刻意**不收** favorites:★ 常驻是裁决(见函数体注释),格位与收藏条目多少无关 ——
- * 收着一个不看的参数只会让调用方以为「传了它就会影响 rail」。
+ * 刻意**不收** favorites / recent 数据:两格常驻是裁决(见函数体注释),格位与条目多少
+ * 无关 —— 收着不看的参数只会让调用方以为「传了它就会影响 rail」。
*/
export function buildUnifiedRail(
entries: readonly UnifiedModelEntry[],
@@ -356,8 +369,9 @@ export function buildUnifiedRail(
providerOrder?: readonly string[],
): UnifiedRailItem[] {
const items: UnifiedRailItem[] = [];
- // ★ 常驻(设计稿 renderRail:collection 永远在第一格,空收藏点进去看空态引导)——
- // 只在有收藏时出现会让功能不可发现(Chris 2026-08-13 实测:「分类栏直接砍了?」)。
+ // 最近 / ★ 常驻(设计稿 renderRail:collection 永远在第一格,空收藏点进去看空态引导)——
+ // 只在有数据时出现会让功能不可发现(Chris 2026-08-13 实测:「分类栏直接砍了?」)。
+ items.push({ kind: 'recent' });
items.push({ kind: 'favorites' });
if (sessionAgent) items.push({ kind: 'engine', agent: sessionAgent });
items.push({ kind: 'all' });
@@ -379,13 +393,15 @@ export function buildUnifiedRail(
export interface UnifiedListRow {
anchor: UnifiedAnchor;
entry: UnifiedModelEntry;
- /** 收藏区行才有;模型行为 undefined。 */
+ /** 收藏区行才有;模型行 / 最近行没有。 */
favorite?: ModelFavoriteItem;
+ /** 最近视图行才有(配置副本 + usedAt);其余行没有。 */
+ recent?: RecentModelItem;
}
export interface UnifiedListSection {
key: string;
- kind: 'favorites' | 'recommended' | 'group';
+ kind: 'favorites' | 'recent' | 'recommended' | 'group';
/**
* 分组小节的口径 —— **按供应商,不按模型家族**(Chris 2026-08-13 实测裁决:供应商决定
* 价格,同名模型跨来源混排会让用户没法选)。每个供应商各自成组,标题用
@@ -414,9 +430,18 @@ function entryKeyOf(providerId: string, modelId: string): string {
return `${providerId} ${modelId}`;
}
+/**
+ * 面板「最近」区最多陈列几条(产品口径:最近使用的 5 个模型)。
+ *
+ * 刻意**不**从 recentModels store import:纯逻辑层只 import store 的**类型**
+ * (`import type` 会被编译期抹掉),拖进一个带 React 的模块会破坏「零 IO、可脱离 jsdom 单测」
+ * 的边界(见文件头三条边界)。
+ */
+export const UNIFIED_RECENT_MODELS_LIMIT = 5;
+
type EnginePreferenceResolver = (
entry: UnifiedModelEntry,
- favorite?: ModelFavoriteItem,
+ favorite?: ModelConfigCopy,
) => UnifiedEngine;
/**
@@ -479,7 +504,9 @@ function arrangeEngineRailClusters(
}
/**
- * 面板列表:**收藏区置顶** → **按供应商分组**。
+ * 面板列表(常规视图):**收藏区** → **推荐区(仅会话)** → **按供应商分组**。
+ * 最近**不**并入常规列表 —— 它是侧栏「最近」格单独的筛选视图(2026-09-16 实测裁决:
+ * 与收藏上下叠放会产生视觉歧义)。
*
* 没有「默认」小节(Chris 2026-08-16 裁决:去掉默认小节,简单一点)—— 服务端的默认
* 推荐改以**种子收藏**交付(见 modelFavorites.seedDefaultFavorite):gateway 用户的
@@ -502,6 +529,12 @@ function arrangeEngineRailClusters(
export function buildUnifiedListSections(args: {
entries: readonly UnifiedModelEntry[];
favorites: readonly ModelFavoriteItem[];
+ /**
+ * 最近使用的模型(store 的原样快照,已按 usedAt 倒序)。只服务 `rail.kind === 'recent'`
+ * 的独立视图;常规视图(全部 / 供应商 / 同引擎)不陈列最近区(2026-09-16 实测裁决),
+ * 因此与收藏、推荐之间的重叠在 UI 上不可见,无需去重。
+ */
+ recentModels?: readonly RecentModelItem[] | undefined;
query: string;
matchesQuery?: (entry: UnifiedModelEntry, query: string) => boolean;
rail: UnifiedRailFilter;
@@ -510,7 +543,7 @@ export function buildUnifiedListSections(args: {
* (默认 / 用户选过的本引擎在前,仅兼容的在后)以及收藏区过滤。缺省时按原生底座回落。
* override / pinned / forceEngine 的合成结果由调用方注入,这里不 import store。
*/
- effectiveEngineOf?: (entry: UnifiedModelEntry, favorite?: ModelFavoriteItem) => UnifiedEngine;
+ effectiveEngineOf?: (entry: UnifiedModelEntry, favorite?: ModelConfigCopy) => UnifiedEngine;
/** 供应商组间显示顺序(设置页拖动序);缺省 = 入参首见序。 */
providerOrder?: readonly string[];
recommendation?: { agent: AgentKind; providerId: string | null; modelId: string };
@@ -522,21 +555,28 @@ export function buildUnifiedListSections(args: {
const byKey = new Map<string, UnifiedModelEntry>();
for (const entry of entries) byKey.set(entryKeyOf(entry.providerId, entry.modelId), entry);
+ /**
+ * 把一份「存下来的模型身份」解析回本轮目录里的一行(收藏与最近共用)。
+ *
+ * 老数据可能存的是某个引擎的 wire id(合并行之前行身份就是 wire id):先按归一化 id
+ * 精确命中,失配再按「任一引擎的 wire id」扫一遍 —— 否则升级后老收藏会整条消失。
+ * 解析不到 = 该模型当前不可路由(来源断开 / 目录下架)→ 调用方跳过,**不删条目**:
+ * 连回来就该回来,静默删掉用户存过的东西是不可逆的。
+ */
+ const resolveStoredEntry = (providerId: string, modelId: string): UnifiedModelEntry | undefined =>
+ byKey.get(entryKeyOf(providerId, modelId)) ??
+ entries.find(
+ (candidate) =>
+ candidate.providerId === providerId && entryMatchesModelId(candidate, modelId),
+ );
+
const sections: UnifiedListSection[] = [];
// ── 收藏区 ── 恒置顶,在任何 rail 视图下都显示;按供应商筛选时只留该来源的收藏。
const favRows: UnifiedListRow[] = [];
for (const item of favorites) {
- // 老收藏可能存的是某个引擎的 wire id(合并行之前的行身份就是 wire id):先按归一化 id
- // 精确命中,失配再按「任一引擎的 wire id」扫一遍 —— 否则升级后老收藏会整条消失。
- const entry =
- byKey.get(entryKeyOf(item.providerId, item.modelId)) ??
- entries.find(
- (candidate) =>
- candidate.providerId === item.providerId && entryMatchesModelId(candidate, item.modelId),
- );
- // 收藏指向的模型已不可路由(来源断开 / 目录下架)→ 本轮不显示;**不删条目**:
- // 连回来就该回来,静默删掉用户存过的配置是不可逆的。
+ const entry = resolveStoredEntry(item.providerId, item.modelId);
+ // 收藏指向的模型已不可路由(来源断开 / 目录下架)→ 本轮不显示。
if (!entry) continue;
const railProviderId = railProviderFilterId(rail);
if (railProviderId !== null && entry.providerId !== railProviderId) continue;
@@ -565,12 +605,49 @@ export function buildUnifiedListSections(args: {
favorite: item,
});
}
+ // ★ 视图只陈列收藏:提前返回,不进最近 / 推荐 / 分组。
+ if (rail.kind === 'favorites') {
+ if (favRows.length > 0) {
+ sections.push({ key: 'favorites', kind: 'favorites', rows: favRows });
+ }
+ return sections;
+ }
+
+ // ── 最近视图 ── **只服务侧栏的「最近」格**(2026-09-16 实测裁决:各供应商 / 全部视图
+ // 不再陈列最近区 —— 它与收藏上下叠放会产生「这两区到底有什么不同」的视觉歧义)。
+ // 因此这里不把最近并入常规列表,而是单独成页:白名单是 store 里最近的 UNIFIED_RECENT_MODELS_LIMIT
+ // 条可路由模型,行身份就是模型本体(点击等价于点供应商组里那一行,生效配置由既有合成规则
+ // 重新解析,见 recentModels 文件头)。
+ if (rail.kind === 'recent') {
+ const recentRows: UnifiedListRow[] = [];
+ for (const item of args.recentModels ?? []) {
+ if (recentRows.length >= UNIFIED_RECENT_MODELS_LIMIT) break;
+ const entry = resolveStoredEntry(item.providerId, item.modelId);
+ if (!entry) continue;
+ if (!matches(entry, q)) continue;
+ recentRows.push({
+ anchor: {
+ kind: 'recent',
+ // 副本身份当锚点:同一模型的不同配置各占一行,选中态只能对着其中一行。
+ key: modelConfigCopyIdentity(item),
+ providerId: entry.providerId,
+ modelId: entry.modelId,
+ },
+ entry,
+ recent: item,
+ });
+ }
+ if (recentRows.length > 0) {
+ sections.push({ key: 'recent', kind: 'recent', rows: recentRows });
+ }
+ return sections;
+ }
+
+ // ── 收藏区 ── 常规视图(全部 / 供应商 / 同引擎)里恒置顶,按供应商筛选时只留该来源。
if (favRows.length > 0) {
sections.push({ key: 'favorites', kind: 'favorites', rows: favRows });
}
- if (rail.kind === 'favorites') return sections;
-
// ── 分组区 ──
// 同引擎视图的准入只有一条:候选里有当前引擎。生效引擎是排序优先级,不是隐藏条件
// (Chris 2026-08-23 纠正 08-19「不显示」裁决):默认 / 用户选过本引擎的在前,其余兼容
diff --git a/apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts b/apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts
index c8a542d2db..886787aae8 100644
--- a/apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts
+++ b/apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts
@@ -13,6 +13,8 @@ import type { FavoriteStore } from '@/state/useRemoteModelFavorites';
* 配置真的应用到正在跑的那一份**(live 状态不读记忆表,只清记忆等于只改了显示),
* 跨引擎时复用与 applyEngine 同一条切换链路;
* - 收藏:☆ 是单向「存一份当前生效配置的副本」,收藏行的 ☆ 才是删除;
+ * - 最近使用:选中**真的应用成功**才记(定时任务 / 设置等非对话入口不开,见
+ * `recordRecentUsage`);
* - 选中:跨引擎的那一下**不走**普通 onSelect,交给调用方的切换事务。
*
* 本 hook 持有写入锁;点亮反馈的计时器留在组件里,经 `onFavoriteFlash` 回调触发。
@@ -33,6 +35,7 @@ import {
type ModelFavoriteConfig,
type ModelFavoriteItem,
} from '@/state/modelFavorites';
+import { recordRecentModel } from '@/state/recentModels';
import type { ModelMemoryAccessors } from './ModelSelector';
import type { UnifiedSelectedRow } from './UnifiedModelPanel';
@@ -101,6 +104,11 @@ export interface UnifiedRowActionsOptions {
config: UnifiedSelectedRow,
) => ActionResult)
| undefined;
+ /**
+ * 选择真的应用成功后,把该模型记进「最近使用」(见 state/recentModels 的语义边界)。
+ * 默认关:统一面板被对话之外的入口共用,那些选择是配置动作;只有对话侧两个入口开启。
+ */
+ recordRecentUsage?: boolean;
sessionEngineFilter?:
| {
currentAgent: AgentKind;
@@ -237,6 +245,8 @@ export interface UnifiedRowActions {
anchor: UnifiedAnchor,
config: UnifiedRowConfig,
favorite?: ModelFavoriteItem,
+ /** 该锚点指向的模型行 —— 「最近使用」记的归一化行身份从这里取(见 selectRow 实现)。 */
+ entry?: UnifiedModelEntry,
) => ActionResult;
}
@@ -374,6 +384,7 @@ export function useUnifiedRowActions(options: UnifiedRowActionsOptions): Unified
onSelect,
onConfigure,
onSelectedFavoriteAnchorClear,
+ recordRecentUsage = false,
sessionEngineFilter,
sessionAgent,
resolveEngineConfig,
@@ -391,6 +402,43 @@ export function useUnifiedRowActions(options: UnifiedRowActionsOptions): Unified
remove: removeModelFavorite,
};
+ /**
+ * 「最近使用」的唯一记录点:选择**真的应用成功**之后才记 —— 取消确认 / 写入失败 / 抛错都
+ * 不记(与收藏锚点「成功才落」同一条规则)。void 视为成功(调用方既有约定);同步 / 异步
+ * 结果都接住,并把原结果原样传回去(调用方还要靠 false 决定留不留面板)。
+ *
+ * 记的是**归一化行身份 + 那一刻生效的整份配置**(引擎 / 深度 / Fast):最近 = 配置副本,
+ * 与收藏同一套语义(见 recentModels 文件头),星标也按这份副本与收藏做完全匹配。
+ * 缺省字段不落快照(effort 无所谓「跟随推荐」/ fast 关闭)。
+ */
+ const rememberRecentModel = (
+ result: ActionResult,
+ entry: UnifiedModelEntry | undefined,
+ config: UnifiedRowConfig,
+ ): ActionResult => {
+ if (!recordRecentUsage || !entry) return result;
+ // 归属代次在**发起选择时**捕获:选择可能是异步的(跨引擎事务、远程写),回调落地时用户
+ // 可能已经登出 / 切到本地模式。那种情况下绝不能把 A 的一条模型记录写进 B 的分区
+ // (2026-09-16 review P1:跨账号串写)。归属变了就整条丢弃 —— 少一条快捷方式远好于串号。
+ const ownerAtSelect = getRecentModelsOwner();
+ const commit = (applied: void | boolean): void | boolean => {
+ if (applied !== false && getRecentModelsOwner() === ownerAtSelect) {
+ recordRecentModel({
+ providerId: entry.providerId,
+ modelId: entry.modelId,
+ agent: config.engine,
+ ...(config.effort ? { effort: config.effort } : {}),
+ ...(config.fast ? { fast: true as const } : {}),
+ });
+ }
+ return applied;
+ };
+ if (result && typeof result === 'object' && 'then' in result) {
+ return Promise.resolve(result).then(commit);
+ }
+ return commit(result);
+ };
+
// ── 「把一份配置真的应用到正在跑的那一份上」的三条链路 ─────────────────────
// 恢复推荐(§1.4)与「删除当前选中的收藏」(§1.5)是同一件事的两个入口:都要把行回落到
// 默认 / 推荐配置。三条链路抽在这里,两个入口共用 —— 各写一遍必然漂移成「恢复推荐会
@@ -828,7 +876,8 @@ export function useUnifiedRowActions(options: UnifiedRowActionsOptions): Unified
// device-link 镜像、IM /model)。这里写归一化 id 会造出一份谁也读不到的影子记录,
// 同时污染那张表。anchor.modelId 只是行身份,不是可以发出去的东西。
if (!modelMemory && onConfigure) {
- return selectRow(anchor, { ...config, effort }, undefined, true);
+ // 第 4 参(preferredEntry)不传 —— 「配置应用」不是一次模型选择,最近使用不在此记录。
+ return selectRow(anchor, { ...config, effort }, undefined, undefined, true);
}
modelMemory?.setEffort(
config.agent,
@@ -876,7 +925,7 @@ export function useUnifiedRowActions(options: UnifiedRowActionsOptions): Unified
}
// 同上:Fast 槽也按 wire id 存取。
if (!modelMemory && onConfigure) {
- return selectRow(anchor, { ...config, fast: enabled }, undefined, true);
+ return selectRow(anchor, { ...config, fast: enabled }, undefined, undefined, true);
}
modelMemory?.setFast(
config.agent,
@@ -1105,6 +1154,7 @@ export function useUnifiedRowActions(options: UnifiedRowActionsOptions): Unified
anchor: UnifiedAnchor,
config: UnifiedRowConfig,
favorite?: ModelFavoriteItem,
+ entry?: UnifiedModelEntry,
configuring = false,
): ActionResult => {
if (interactionDisabled) return;
@@ -1116,31 +1166,38 @@ export function useUnifiedRowActions(options: UnifiedRowActionsOptions): Unified
// 交出去的一律是**该引擎的 wire id**(建会话 / 切模型 / 写 draft 都用它);
// 行的归一化身份另放在 config.rowModelId 里,调用方要记 override / 收藏时用那个。
const wireModelId = config.wireModelId ?? anchor.modelId;
- if (sessionEngineFilter && shouldCrossEngine(config.agent)) {
- // 收藏锚点一并交出去:会话侧要在事务**真成功后**才把它记成「当前选中的收藏」
- // (取消 / 失败时什么都没换,锚点当然不能动)。同引擎那一路由 onSelect 的 config 带走。
- return (configuring && sessionEngineFilter.onCrossEngineConfigure
- ? sessionEngineFilter.onCrossEngineConfigure
- : sessionEngineFilter.onCrossEngineSelect)({
- providerId: anchor.providerId,
- modelId: wireModelId,
- targetAgent: config.agent,
- effort,
- // 行上显示的 Fast 就是按目标引擎解析好的那个值(resolveUnifiedRowConfig /
- // resolveFavoriteRowConfig 均已过能力门控):显式交给事务,收藏副本「Fast 关」
- // 也要能压过目标记忆里残留的「开」(2026-08-17 review)。
- fast: config.fast,
- favoriteUid: favorite ? favorite.uid : null,
- });
- }
- // 生效引擎 / Fast / 收藏锚点随选中一起交出去:调用方(M5 新会话)要按它派生
- // newMakerDraft 的 vendor,再重推一遍必然与行上显示的三元组漂移。
- return (configuring && onConfigure ? onConfigure : onSelect)(anchor.providerId, wireModelId, effort, {
- engine: config.engine,
- fast: config.fast,
- favoriteUid: favorite ? favorite.uid : null,
- rowModelId: anchor.modelId,
- });
+ const result =
+ sessionEngineFilter && shouldCrossEngine(config.agent)
+ ? // 收藏锚点一并交出去:会话侧要在事务**真成功后**才把它记成「当前选中的收藏」
+ // (取消 / 失败时什么都没换,锚点当然不能动)。同引擎那一路由 onSelect 的 config 带走。
+ // configuring 时优先走配置入口(#4496 的 onCrossEngineConfigure),否则才是切换事务。
+ (configuring && sessionEngineFilter.onCrossEngineConfigure
+ ? sessionEngineFilter.onCrossEngineConfigure
+ : sessionEngineFilter.onCrossEngineSelect)({
+ providerId: anchor.providerId,
+ modelId: wireModelId,
+ targetAgent: config.agent,
+ effort,
+ // 行上显示的 Fast 就是按目标引擎解析好的那个值(resolveUnifiedRowConfig /
+ // resolveFavoriteRowConfig 均已过能力门控):显式交给事务,收藏副本「Fast 关」
+ // 也要能压过目标记忆里残留的「开」(2026-08-17 review)。
+ fast: config.fast,
+ favoriteUid: favorite ? favorite.uid : null,
+ })
+ : // 生效引擎 / Fast / 收藏锚点随选中一起交出去:调用方(M5 新会话)要按它派生
+ // newMakerDraft 的 vendor,再重推一遍必然与行上显示的三元组漂移。
+ (configuring && onConfigure ? onConfigure : onSelect)(
+ anchor.providerId,
+ wireModelId,
+ effort,
+ {
+ engine: config.engine,
+ fast: config.fast,
+ favoriteUid: favorite ? favorite.uid : null,
+ rowModelId: anchor.modelId,
+ },
+ );
+ return rememberRecentModel(result, entry, config);
};
return {
diff --git a/apps/desktop/src/renderer/contexts/AuthContext.tsx b/apps/desktop/src/renderer/contexts/AuthContext.tsx
index c626a5bea8..e24b6d6590 100644
--- a/apps/desktop/src/renderer/contexts/AuthContext.tsx
+++ b/apps/desktop/src/renderer/contexts/AuthContext.tsx
@@ -45,6 +45,7 @@ import { isSidebarWindow } from '@/lib/sidebarWindow';
import { isGhostPanelWindow } from '@/lib/ghostPanelWindow';
import { setModelEnginePrefsOwner } from '@/state/modelEnginePrefs';
import { setModelFavoritesOwner } from '@/state/modelFavorites';
+import { setRecentModelsOwner } from '@/state/recentModels';
import { setProviderModelMemoryOwner } from '@/state/providerModelMemory';
import { setAgentDeviceModelMemoryOwner } from '@/state/agentDeviceModelMemory';
import { setFavoriteAnchorMemoryOwner } from '@/state/favoriteAnchorMemory';
@@ -352,6 +353,8 @@ export function AuthProvider({
// 无后缀的默认槽)。漏接 = 多账号串号(providerModelMemory 的旧教训)。
setModelEnginePrefsOwner(state.dataOwnerId);
setModelFavoritesOwner(state.dataOwnerId);
+ // 「最近使用」与收藏同分区:多账号不串流水。
+ setRecentModelsOwner(state.dataOwnerId);
// 收藏**锚点**记忆(面板上哪一行打勾)与收藏本体同分区:漏接同样是多账号串号。
setFavoriteAnchorMemoryOwner(state.dataOwnerId);
setComposerDraftOwner(state.dataOwnerId);
diff --git a/apps/desktop/src/renderer/i18n/locales/en/common.json b/apps/desktop/src/renderer/i18n/locales/en/common.json
index ed7df3a280..58ad4731b1 100644
--- a/apps/desktop/src/renderer/i18n/locales/en/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/en/common.json
@@ -9428,10 +9428,13 @@
},
"unified": {
"railFavorites": "Favorites",
+ "railRecent": "Recent",
"railAll": "All",
"railRemoteProvider": "{{provider}} · {{device}}",
"remoteLoading": "Loading models from that computer…",
"favoritesGroup": "Favorites",
+ "recentGroup": "Recent",
+ "recentEmpty": "No recent models yet — pick a model and it will show up here",
"favoritesEmpty": "No favorites yet — hover a model and hit ☆ to pin it here",
"addFavorite": "Save to favorites",
"customize": "Customize",
diff --git a/apps/desktop/src/renderer/i18n/locales/ja/common.json b/apps/desktop/src/renderer/i18n/locales/ja/common.json
index d13a6bbde1..71e295adb5 100644
--- a/apps/desktop/src/renderer/i18n/locales/ja/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/ja/common.json
@@ -9408,10 +9408,13 @@
},
"unified": {
"railFavorites": "お気に入り",
+ "railRecent": "最近",
"railAll": "すべて",
"railRemoteProvider": "{{provider}} · {{device}}",
"remoteLoading": "そのパソコンのモデルを読み込み中…",
"favoritesGroup": "お気に入り",
+ "recentGroup": "最近",
+ "recentEmpty": "最近使ったモデルはまだありません——モデルを選ぶとここに表示されます",
"favoritesEmpty": "お気に入りはまだありません——モデルの行にカーソルを合わせて ☆ で保存できます",
"addFavorite": "お気に入りに保存",
"customize": "カスタマイズ",
diff --git a/apps/desktop/src/renderer/i18n/locales/ko/common.json b/apps/desktop/src/renderer/i18n/locales/ko/common.json
index 254dcd93d6..7cbccdeb2d 100644
--- a/apps/desktop/src/renderer/i18n/locales/ko/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/ko/common.json
@@ -9408,10 +9408,13 @@
},
"unified": {
"railFavorites": "즐겨찾기",
+ "railRecent": "최근",
"railAll": "전체",
"railRemoteProvider": "{{provider}} · {{device}}",
"remoteLoading": "그 컴퓨터의 모델을 불러오는 중…",
"favoritesGroup": "즐겨찾기",
+ "recentGroup": "최근",
+ "recentEmpty": "최근 사용한 모델이 없습니다 — 모델을 선택하면 여기에 표시됩니다",
"favoritesEmpty": "즐겨찾기가 없습니다 — 모델 행에 마우스를 올리고 ☆를 눌러 저장하세요",
"addFavorite": "즐겨찾기에 저장",
"customize": "사용자 지정",
diff --git a/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json b/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json
index a0fe6a0b58..cd6ff8d83b 100644
--- a/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json
@@ -9408,10 +9408,13 @@
},
"unified": {
"railFavorites": "收藏",
+ "railRecent": "最近",
"railAll": "全部",
"railRemoteProvider": "{{provider}} · {{device}}",
"remoteLoading": "正在读取那台电脑的模型…",
"favoritesGroup": "收藏",
+ "recentGroup": "最近",
+ "recentEmpty": "还没有最近使用——选一个模型后,它会出现在这里",
"favoritesEmpty": "还没有收藏——把鼠标停到模型行上,点 ☆ 存到这里",
"addFavorite": "存为收藏",
"customize": "自定义",
diff --git a/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json b/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json
index b155c55fae..2daa3d3f3b 100644
--- a/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json
@@ -9407,10 +9407,13 @@
},
"unified": {
"railFavorites": "收藏",
+ "railRecent": "最近",
"railAll": "全部",
"railRemoteProvider": "{{provider}} · {{device}}",
"remoteLoading": "正在讀取那臺電腦的模型…",
"favoritesGroup": "收藏",
+ "recentGroup": "最近",
+ "recentEmpty": "還沒有最近使用——選一個模型後,它會出現在這裡",
"favoritesEmpty": "還沒有收藏——把滑鼠停到模型列上,點 ☆ 存到這裡",
"addFavorite": "存為收藏",
"customize": "自訂",
diff --git a/apps/desktop/src/renderer/state/modelConfigCopy.ts b/apps/desktop/src/renderer/state/modelConfigCopy.ts
new file mode 100644
index 0000000000..b2966da472
--- /dev/null
+++ b/apps/desktop/src/renderer/state/modelConfigCopy.ts
@@ -0,0 +1,96 @@
+/**
+ * modelConfigCopy —— 「配置副本」的公共归一化与身份规则:收藏(modelFavorites)与
+ * 最近使用(recentModels)共用的那一份定义。
+ *
+ * 副本 = 模型身份 + 引擎 + 深度 + Fast 的完整组合。两个 store 都按同一套语义存取:
+ * - providerId 拒绝 providerModelMemory 的保留位 `'*'`(MODEL_PRESET_SLOT_ID);
+ * - agent 非法 → **整条丢弃**(副本缺引擎无法表达任何配置);合法值域是选择器 / 草稿
+ * 链路的 vendor 口径(`SelectableVendor`);
+ * - effort 存 canonical key(`'high'` / `'low'`…),显示文案不回灌;非法值只丢该字段,
+ * 缺省语义 = 跟随该 (模型, 引擎) 的推荐档;
+ * - fast 只在**开启**时存 `true`(关闭即缺省,不落「等于默认」的快照);
+ * - 身份(去重 / 星标匹配) = providerId + modelId + agent + effort + fast,缺省字段参与,
+ * 与「跟随推荐」区分。
+ *
+ * 为什么单点:收藏的「重复添加去重」与最近的「同一模型不同配置各占一行」「星标按完全一致的
+ * 副本匹配」必须用同一套判等 —— 各写一遍必然漂移成两套身份(收藏存的 effort 是 key、
+ * 最近存的却是显示文案之类)。
+ */
+
+import { EFFORT_VALUES } from '@cindy/model-providers';
+
+import { isSelectableVendor } from '@/lib/agentVendors';
+import type { Effort } from '@/lib/userPreferences.types';
+
+import type { ModelEngine } from './modelEnginePrefs';
+
+/**
+ * v2 记忆 schema 内的保留来源 id:同一 agent 下跨真实 provider 共享的模型级预设槽。
+ *
+ * 定义放在这里(配置副本的身份空间):两个副本 store 的归一化都要拒绝它,而它们是
+ * **纯模块**——保留位反向 import providerModelMemory 会把整个 store(含 React 与
+ * 存储订阅)拖进纯逻辑层的依赖图。providerModelMemory 原样 re-export 给既有消费方,
+ * 常量仍然只有一份定义。
+ */
+export const MODEL_PRESET_SLOT_ID = '*';
+
+/** 一份配置副本的完整描述(不含各 store 自己的锚点 / 时间戳)。 */
+export interface ModelConfigCopy {
+ providerId: string;
+ modelId: string;
+ agent: ModelEngine;
+ /** 思考深度**档位 key**('low' | 'high' | …);缺省 = 跟随该 (模型, 引擎) 的推荐档。 */
+ effort?: Effort;
+ /** Fast(插队加速)。**只在开启时存 true**,关闭即缺省 —— 不落「等于默认」的快照。 */
+ fast?: true;
+}
+
+/**
+ * `'*'` 是 providerModelMemory v2 的保留来源 id(跨来源模型预设槽),真实来源不可能等于它
+ * (规格 §4「偏好/记忆」的防撞要求)。
+ */
+export function isUsableModelProviderId(value: unknown): value is string {
+ return typeof value === 'string' && value.length > 0 && value !== MODEL_PRESET_SLOT_ID;
+}
+
+export function isCanonicalModelEffort(value: unknown): value is Effort {
+ return typeof value === 'string' && (EFFORT_VALUES as readonly string[]).includes(value);
+}
+
+/**
+ * 归一化配置字段(收藏 / 最近的 add / update / sanitize 共用);模型身份或引擎不合法 → null。
+ * `effort` 非法只丢该字段(不是丢整条):缺省有明确语义「跟随推荐档」。
+ */
+export function normalizeModelConfigCopy(raw: {
+ providerId?: unknown;
+ modelId?: unknown;
+ agent?: unknown;
+ effort?: unknown;
+ fast?: unknown;
+}): ModelConfigCopy | null {
+ const providerId = typeof raw.providerId === 'string' ? raw.providerId.trim() : '';
+ const modelId = typeof raw.modelId === 'string' ? raw.modelId.trim() : '';
+ if (!isUsableModelProviderId(providerId) || !modelId) return null;
+ // agent 非法 → **丢整条**:副本的必要组成部分,缺了它这条记录无法表达任何配置。
+ if (!isSelectableVendor(raw.agent)) return null;
+ const config: ModelConfigCopy = { providerId, modelId, agent: raw.agent };
+ if (isCanonicalModelEffort(raw.effort)) config.effort = raw.effort;
+ if (raw.fast === true) config.fast = true;
+ return config;
+}
+
+/**
+ * 去重 / 匹配身份:providerId + modelId + agent + effort + fast(缺省字段参与,与「跟随推荐」区分)。
+ * 分隔符用空格而不是 NUL:源码里嵌一个裸 `\0` 会让整个文件被 git / rg / grep 判成二进制
+ * (diff 显示 `Bin`、搜不到任何符号),代价远大于它能防的那点分隔符冲突 —— provider id 与
+ * model id 都是 slug 形态,不含空格(与 unifiedSelection.entryKey 同一取舍)。
+ */
+export function modelConfigCopyIdentity(config: ModelConfigCopy): string {
+ return [
+ config.providerId,
+ config.modelId,
+ config.agent,
+ config.effort ?? '',
+ config.fast === true ? '1' : '0',
+ ].join(' ');
+}
diff --git a/apps/desktop/src/renderer/state/modelFavorites.ts b/apps/desktop/src/renderer/state/modelFavorites.ts
index fbca19fdcc..940b977dfd 100644
--- a/apps/desktop/src/renderer/state/modelFavorites.ts
+++ b/apps/desktop/src/renderer/state/modelFavorites.ts
@@ -67,28 +67,23 @@ import { parseModelFavoriteMutation, sameModelFavorite, type ModelFavoriteMutati
import { useSyncExternalStore } from 'react';
-import { EFFORT_VALUES } from '@cindy/model-providers';
-
import { isSelectableVendor } from '@/lib/agentVendors';
import type { Effort } from '@/lib/userPreferences.types';
+import {
+ isCanonicalModelEffort,
+ modelConfigCopyIdentity,
+ normalizeModelConfigCopy,
+ type ModelConfigCopy,
+} from './modelConfigCopy';
import type { ModelEngine } from './modelEnginePrefs';
-import { MODEL_PRESET_SLOT_ID } from './providerModelMemory';
import { createStorageReconciler } from './storageOpReplay';
let requireDurableWrite = false;
const STORAGE_KEY = 'xdt:modelFavorites:v1';
-/** 一条收藏所描述的完整配置(不含锚点)。 */
-export interface ModelFavoriteConfig {
- providerId: string;
- modelId: string;
- agent: ModelEngine;
- /** 思考深度**档位 key**('low' | 'high' | …);缺省 = 跟随该 (模型, 引擎) 的推荐档。 */
- effort?: Effort;
- /** Fast(插队加速)。**只在开启时存 true**,关闭即缺省 —— 不落「等于默认」的快照。 */
- fast?: true;
-}
+/** 一条收藏所描述的完整配置(不含锚点)。归一化 / 身份规则与最近使用共用(见 modelConfigCopy)。 */
+export type ModelFavoriteConfig = ModelConfigCopy;
/** 落盘 / 消费的收藏条目:配置 + 独立锚点 uid。 */
export interface ModelFavoriteItem extends ModelFavoriteConfig {
@@ -138,59 +133,10 @@ function seqOfUid(uid: string): number | null {
return Number.isSafeInteger(n) ? n : null;
}
-function isCanonicalEffort(value: unknown): value is Effort {
- return typeof value === 'string' && (EFFORT_VALUES as readonly string[]).includes(value);
-}
-
-/**
- * `'*'` 是 providerModelMemory v2 的保留来源 id(跨来源模型预设槽)。收藏条目的 providerId
- * 必须是真实来源,撞上保留位直接丢条目(规格 §4「偏好/记忆」的防撞要求)。
- */
-function isUsableProviderId(value: unknown): value is string {
- return typeof value === 'string' && value.length > 0 && value !== MODEL_PRESET_SLOT_ID;
-}
-
-/** 归一化配置字段(供 add / update / sanitize 共用);模型身份或引擎不合法 → null。 */
-function normalizeConfig(raw: {
- providerId?: unknown;
- modelId?: unknown;
- agent?: unknown;
- effort?: unknown;
- fast?: unknown;
-}): ModelFavoriteConfig | null {
- const providerId = typeof raw.providerId === 'string' ? raw.providerId.trim() : '';
- const modelId = typeof raw.modelId === 'string' ? raw.modelId.trim() : '';
- if (!isUsableProviderId(providerId) || !modelId) return null;
- // agent 非法 → **丢整条**:收藏是「配置副本」,引擎是副本的必要组成部分,缺了它这条
- // 记录无法表达任何配置(与 effort 不同 —— effort 缺省有明确语义「跟随推荐档」)。
- if (!isSelectableVendor(raw.agent)) return null;
- const config: ModelFavoriteConfig = { providerId, modelId, agent: raw.agent };
- // effort 非法(显示文案 / 过期档名 / 非字符串)→ 只丢这个字段,条目保留,调用层回落推荐档。
- if (isCanonicalEffort(raw.effort)) config.effort = raw.effort;
- if (raw.fast === true) config.fast = true;
- return config;
-}
-
-/**
- * 去重身份:providerId + modelId + agent + effort + fast(缺省字段参与,与「跟随推荐」区分)。
- * 分隔符用空格而不是 NUL:源码里嵌一个裸 `\0` 会让整个文件被 git / rg / grep 判成二进制
- * (diff 显示 `Bin`、搜不到任何符号),代价远大于它能防的那点分隔符冲突 —— provider id 与
- * model id 都是 slug 形态,不含空格(与 unifiedSelection.entryKey 同一取舍)。
- */
-function identityOf(config: ModelFavoriteConfig): string {
- return [
- config.providerId,
- config.modelId,
- config.agent,
- config.effort ?? '',
- config.fast === true ? '1' : '0',
- ].join(' ');
-}
-
/**
* 严格校验 + 锚点补齐。老版本 / 手改 localStorage 损坏时静默回退空表,不抛。
* - 形状非法的条目(非对象 / 缺模型身份 / 引擎不认识 / providerId 撞 `'*'`)整条丢弃;
- * - effort 非法只丢字段(见 normalizeConfig);
+ * - effort 非法只丢字段(规则与「最近使用」共用,见 modelConfigCopy.normalizeModelConfigCopy);
* - uid 缺失 / 非字符串 / 与前面的条目重复 → 就地补一个新 uid(收藏靠 uid 做锚点,
* 重复 uid 会让 hover / 删除 / 选中打到错误的条目);
* - uidSeq 非正整数,或小于已见 uid 的序号 + 1 → 抬到安全值,保证后续新 uid 不撞已有锚点。
@@ -206,7 +152,7 @@ function sanitize(raw: unknown): FavoritesState {
const parsed: Array<{ config: ModelFavoriteConfig; uid: string | null }> = [];
for (const entry of rawItems) {
if (!entry || typeof entry !== 'object' || Array.isArray(entry)) continue;
- const config = normalizeConfig(entry as Record<string, unknown>);
+ const config = normalizeModelConfigCopy(entry as Record<string, unknown>);
if (!config) continue;
const rawUid = (entry as { uid?: unknown }).uid;
const uid = typeof rawUid === 'string' && rawUid.length > 0 && !seenUids.has(rawUid)
@@ -309,7 +255,7 @@ function sameState(a: FavoritesState, b: FavoritesState): boolean {
&& a.items.every((item, i) => {
const other = b.items[i];
return (
- other !== undefined && item.uid === other.uid && identityOf(item) === identityOf(other)
+ other !== undefined && item.uid === other.uid && modelConfigCopyIdentity(item) === modelConfigCopyIdentity(other)
);
})
);
@@ -333,10 +279,10 @@ function appendFavorite(
config: ModelFavoriteConfig,
preferredUid: string,
): FavoritesState {
- const identity = identityOf(config);
+ const identity = modelConfigCopyIdentity(config);
// 幂等的关键一半:同配置已在表里(可能是本次同步写留下的,也可能是另一窗口存过的)
// → 原样返回,重放不会堆出第二条。
- if (state.items.some((item) => identityOf(item) === identity)) return state;
+ if (state.items.some((item) => modelConfigCopyIdentity(item) === identity)) return state;
const taken = new Set(state.items.map((item) => item.uid));
let uid = preferredUid;
if (!uid || taken.has(uid)) {
@@ -388,7 +334,7 @@ function patchConfig(
}
if ('effort' in patch) {
// null = 显式清除(回落推荐档);非法值同样按清除处理(不写脏档名)。
- if (isCanonicalEffort(patch.effort)) next.effort = patch.effort;
+ if (isCanonicalModelEffort(patch.effort)) next.effort = patch.effort;
else delete next.effort;
}
if (patch.fast !== undefined) {
@@ -423,7 +369,7 @@ function applyOp(state: FavoritesState, op: FavoritesOp): FavoritesState {
const patched = patchConfig(configOf(current), op.patch);
if (!patched) return state;
const next: ModelFavoriteItem = { uid: current.uid, ...patched };
- if (identityOf(next) === identityOf(current)) return state;
+ if (modelConfigCopyIdentity(next) === modelConfigCopyIdentity(current)) return state;
const items = [...state.items];
items[index] = next;
return { ...state, items };
@@ -619,13 +565,13 @@ export function getModelFavorite(uid: string): ModelFavoriteItem | undefined {
* effort 非法只丢该字段(条目仍建,回落推荐档)。
*/
export function addModelFavorite(config: ModelFavoriteConfig): string {
- const normalized = normalizeConfig(config);
+ const normalized = normalizeModelConfigCopy(config);
if (!normalized) return '';
// 基底取**重读后的**持久化快照(见 freshState):另一窗口刚加的条目要一起带上,
- // 否则本次整表写回会把它抹掉。uidSeq 的单调性、identityOf 去重都在这份新鲜基底上判。
+ // 否则本次整表写回会把它抹掉。uidSeq 的单调性、modelConfigCopyIdentity 去重都在这份新鲜基底上判。
const state = freshState();
- const identity = identityOf(normalized);
- const existing = state.items.find((item) => identityOf(item) === identity);
+ const identity = modelConfigCopyIdentity(normalized);
+ const existing = state.items.find((item) => modelConfigCopyIdentity(item) === identity);
if (existing) return existing.uid;
const uid = uidOfSeq(state.uidSeq);
// uid 必须**当场**返回(调用方要拿它当选中锚点),所以先在这份基底上定下首选锚点;
@@ -643,7 +589,7 @@ export function addModelFavorite(config: ModelFavoriteConfig): string {
* - 只投放一次:`seeded` 标记持久化,取消后不复种(取消即显式否决推荐);
* - 只对**从未收藏过**的用户投放:已有收藏说明用户在整理自己的列表,不打扰,
* 但同样落下标记(这一版的推荐对 TA 已经「见过即弃权」);
- * - 配置字段与普通收藏同一套校验(normalizeConfig),effort / fast 缺省跟随推荐档。
+ * - 配置字段与普通收藏同一套校验(normalizeModelConfigCopy),effort / fast 缺省跟随推荐档。
*/
export function seedDefaultFavorite(config: ModelFavoriteConfig): void {
// 同 addModelFavorite:基底必须新鲜 —— 另一窗口若已投放过种子,这里读到的 seeded
@@ -651,7 +597,7 @@ export function seedDefaultFavorite(config: ModelFavoriteConfig): void {
const state = freshState();
if (state.seeded) return;
// 非法配置不落标记:下次给出合法推荐时仍要能投放。
- const normalized = normalizeConfig(config);
+ const normalized = normalizeModelConfigCopy(config);
if (!normalized) return;
commitOp({ kind: 'seed', config: normalized, preferredUid: uidOfSeq(state.uidSeq) }, state);
}
@@ -740,9 +686,9 @@ export function accessHostModelFavorites(ownerId: string | null, mutation?: Mode
requireDurableWrite = true;
try {
if (op.kind === 'add') {
- const config = normalizeConfig(op.item);
+ const config = normalizeModelConfigCopy(op.item);
if (!config) throw new Error('Invalid favorite');
- if (base.items.length >= 4096 && !base.items.some(item => identityOf(item) === identityOf(config))) throw new Error('Favorites limit reached');
+ if (base.items.length >= 4096 && !base.items.some(item => modelConfigCopyIdentity(item) === modelConfigCopyIdentity(config))) throw new Error('Favorites limit reached');
commitOp({kind:'add',config,preferredUid:uidOfSeq(base.uidSeq)},base);
} else if (op.kind === 'remove') commitOp({kind:'remove',uid:op.expected.uid},base);
else commitOp({kind:'update',uid:op.expected.uid,patch:{agent:op.item.agent, effort:(op.item.effort as Effort | undefined) ?? null, fast:!!op.item.fast}},base);
diff --git a/apps/desktop/src/renderer/state/providerModelMemory.ts b/apps/desktop/src/renderer/state/providerModelMemory.ts
index 860a1809cd..c2829a7560 100644
--- a/apps/desktop/src/renderer/state/providerModelMemory.ts
+++ b/apps/desktop/src/renderer/state/providerModelMemory.ts
@@ -46,7 +46,9 @@ const STORAGE_KEY = 'xdt:providerModelMemory:v2';
/** 历史单槽版本 key —— 冷启动迁移源(只读,不再写)。 */
const LEGACY_STORAGE_KEY_V1 = 'xdt:providerModelMemory:v1';
/** v2 schema 内的保留来源 id:同一 agent 下跨真实 provider 共享的模型级预设槽。 */
-export const MODEL_PRESET_SLOT_ID = '*';
+// 定义在 modelConfigCopy(配置副本的归一化要拒绝它),这里 re-export 给既有消费方。
+import { MODEL_PRESET_SLOT_ID } from './modelConfigCopy';
+export { MODEL_PRESET_SLOT_ID };
let activeDataOwnerId: string | null = null;
diff --git a/apps/desktop/src/renderer/state/recentModels.ts b/apps/desktop/src/renderer/state/recentModels.ts
new file mode 100644
index 0000000000..a5fda53782
--- /dev/null
+++ b/apps/desktop/src/renderer/state/recentModels.ts
@@ -0,0 +1,380 @@
+/**
+ * recentModels —— 统一模型选择器的「最近」视图存储(model-selector-unified §1.2):
+ * 用户在**对话**里用过的**配置副本**(模型 + 引擎 + 深度 + Fast),按最近一次使用时间倒序。
+ *
+ * 语义边界:
+ * - 收藏是**用户钉住**的配置副本(手动添加 / 删除,长期保留);
+ * - 最近是**自动记录**的配置副本(选择成功即记录,超出容量自动淘汰)。
+ * 两者是同一套「配置副本」语义(归一化 / 身份规则共用 modelConfigCopy),所以:
+ * - 同一模型用不同深度 / 引擎 / Fast 各占**一行**(和收藏一致,不是按模型去重);
+ * - 星标(面板绘制)按**完全一致的副本**匹配收藏 —— 该条副本已在收藏里就点亮,
+ * 没有则点星把这份副本存进收藏;匹配与去重都走同一份身份(modelConfigCopyIdentity)。
+ * 与收藏的区别只在生命周期与入口:最近不能手动编辑(它是流水账,不是用户整理的清单),
+ * 由记录点自动写入、超过容量自动淘汰。
+ *
+ * 记录点只有一个:对话入口里「选择真的应用成功」的那一下(useUnifiedRowActions.selectRow;
+ * 草稿 / 会话 / 跨引擎三条链路都在那里收口),记的是**那一刻生效的整份配置**。
+ * 定时任务、IM 默认、Bot、Hook、Worker、子代理与设置页共用的同一面板**不记**(那些是配置
+ * 动作,不是「用这个模型跑过活」);远程(SSH / device-link)会话与草稿也不记:模型来自被控端
+ * 目录,写进本机列表只会得到一行永远不可路由的记录(与「远程模型不写入本机记忆」同向)。
+ *
+ * 持久化:localStorage,owner 分区(与 modelFavorites / modelEnginePrefs 同形)。写频率极低
+ * (用户选一次模型写一次),**同步写** —— 热更 relaunch 走 app.exit() 强退,异步写会丢最近
+ * 一次改动。写失败静默吞,内存态照常生效。
+ *
+ * 并发写(多窗口):沿用 storageOpReplay 的「同步乐观写 + 会话 op-log + 事件驱动的持续调和」
+ * (机制正文在那个文件头,那里是唯一权威)。这里只记本 store 的落地方式:
+ * - 每个写入表达成一个可重放的 op(`record`:一次「这份配置在此时被用过」的断言);
+ * - `applyOp(state, op)` 按副本身份取 max(usedAt) 并入,无变化时返回原对象;
+ * - 整条 log 的重放要保持幂等:`compactRecentOps` 把同一副本身份的历史 op 折成一条,
+ * 否则重放会拿旧 usedAt 去顶掉后来的记录;
+ * - 没有删除类 op(用户不能「删掉最近用过」),所以不设 tombstone。
+ * 与收藏相比残余边界更温和:即使调和完全失效,最坏也只是少一条快捷方式,不丢用户手存的数据。
+ */
+
+import { useSyncExternalStore } from 'react';
+
+import {
+ modelConfigCopyIdentity,
+ normalizeModelConfigCopy,
+ type ModelConfigCopy,
+} from './modelConfigCopy';
+import { createStorageReconciler } from './storageOpReplay';
+
+const STORAGE_KEY = 'xdt:recentModels:v1';
+
+/**
+ * 本机保留的流水条数。刻意大于展示条数:最近几条恰好指向不可路由的模型(来源断开 / 目录
+ * 下架)时,面板能往后补足 5 条,而不是显示成「最近只用过 2 个」。
+ */
+export const RECENT_MODELS_KEEP = 20;
+
+/** 落盘 / 消费的一条记录:配置副本 + 最近一次使用时间。 */
+export interface RecentModelItem extends ModelConfigCopy {
+ /** 最近一次使用时间(epoch ms);排序与跨窗口合并都以它为准。 */
+ usedAt: number;
+}
+
+interface RecentModelsState {
+ /** 按 usedAt 倒序。 */
+ items: RecentModelItem[];
+}
+
+let activeDataOwnerId: string | null = null;
+
+function storageKey(): string {
+ return activeDataOwnerId ? `${STORAGE_KEY}:${encodeURIComponent(activeDataOwnerId)}` : STORAGE_KEY;
+}
+
+function emptyState(): RecentModelsState {
+ return { items: [] };
+}
+
+/**
+ * 严格校验一条记录:配置字段走与收藏同一套归一化(见 modelConfigCopy),时间不合法 → null。
+ * 模型身份或引擎不合法整条丢弃;effort 非法只丢该字段。
+ */
+function normalizeItem(raw: {
+ providerId?: unknown;
+ modelId?: unknown;
+ agent?: unknown;
+ effort?: unknown;
+ fast?: unknown;
+ usedAt?: unknown;
+}): RecentModelItem | null {
+ const config = normalizeModelConfigCopy(raw);
+ if (!config) return null;
+ if (typeof raw.usedAt !== 'number' || !Number.isFinite(raw.usedAt) || raw.usedAt <= 0) {
+ return null;
+ }
+ return { ...config, usedAt: raw.usedAt };
+}
+
+/**
+ * 严格校验 + 归一化。老版本 / 手改 localStorage 损坏时静默回退空表,不抛。
+ * - 形状非法的条目整条丢弃;
+ * - 同一**副本身份**出现多条时只保 usedAt 最新的那条;
+ * - 按 usedAt 倒序,并裁到 RECENT_MODELS_KEEP 条。
+ */
+function sanitize(raw: unknown): RecentModelsState {
+ if (!raw || typeof raw !== 'object' || Array.isArray(raw)) return emptyState();
+ const rawItems = Array.isArray((raw as { items?: unknown }).items)
+ ? ((raw as { items: unknown[] }).items)
+ : [];
+ const byKey = new Map<string, RecentModelItem>();
+ for (const entry of rawItems) {
+ if (!entry || typeof entry !== 'object' || Array.isArray(entry)) continue;
+ const item = normalizeItem(entry as Record<string, unknown>);
+ if (!item) continue;
+ const key = modelConfigCopyIdentity(item);
+ const existing = byKey.get(key);
+ if (!existing || item.usedAt > existing.usedAt) byKey.set(key, item);
+ }
+ return {
+ items: [...byKey.values()].sort((a, b) => b.usedAt - a.usedAt).slice(0, RECENT_MODELS_KEEP),
+ };
+}
+
+// 进程内缓存(惰性加载)。读多写少,避免每次读都 parse localStorage。
+let cache: RecentModelsState | null = null;
+
+/**
+ * 按**给定 key** 读原始 localStorage(不碰缓存)。key 可能不是当前 active 分区 ——
+ * 登出 / 切号之后旧分区的调和仍要按它自己的 key 读写(机制见 storageOpReplay 文件头)。
+ */
+function loadFromKey(key: string): RecentModelsState {
+ if (typeof window === 'undefined') return emptyState();
+ try {
+ const raw = window.localStorage.getItem(key);
+ return raw ? sanitize(JSON.parse(raw)) : emptyState();
+ } catch {
+ return emptyState();
+ }
+}
+
+function loadFromStorage(): RecentModelsState {
+ return loadFromKey(storageKey());
+}
+
+function load(): RecentModelsState {
+ if (!cache) cache = loadFromStorage();
+ return cache;
+}
+
+/**
+ * **写路径的基底** —— 每次写入前重读 localStorage,拿到的是此刻的共享真相,而不是本窗口的
+ * 内存快照(理由与 modelFavorites.freshState 逐字相同:storage 事件是异步的,整表写回用陈旧
+ * 基底会抹掉另一窗口刚记的那条)。读不出来时退回内存缓存,不退回空表 —— 私密窗口 / 写满时
+ * setItem 静默失败、getItem 恒 null,拿空表当基底会把本次会话已记的全部抹掉。
+ */
+function freshState(): RecentModelsState {
+ if (typeof window === 'undefined') return load();
+ let raw: string | null = null;
+ try {
+ raw = window.localStorage.getItem(storageKey());
+ } catch {
+ return load();
+ }
+ if (raw === null) return load();
+ try {
+ return sanitize(JSON.parse(raw));
+ } catch {
+ return load();
+ }
+}
+
+/** 两份状态在用户可见语义上是否一致(副本身份 + 时间 + 顺序)。 */
+function sameState(a: RecentModelsState, b: RecentModelsState): boolean {
+ return (
+ a.items.length === b.items.length &&
+ a.items.every((item, i) => {
+ const other = b.items[i];
+ return (
+ other !== undefined &&
+ modelConfigCopyIdentity(item) === modelConfigCopyIdentity(other) &&
+ item.usedAt === other.usedAt
+ );
+ })
+ );
+}
+
+// ── 可重放的写操作(见文件头「并发写」)────────────────────────────────────
+
+/** 一次「这份配置在此时被用过」的断言。只依赖自身 + 目标状态,重放才成立。 */
+type RecentModelsOp = RecentModelItem;
+
+/**
+ * 把一条记录并入状态:同副本身份取 max(usedAt),移到队首,按时间倒序并裁剪。
+ * **无实际变化时返回入参对象本身**(引用判等决定要不要落盘 / 这一轮是否真的断言了什么)。
+ */
+function applyOp(state: RecentModelsState, op: RecentModelsOp): RecentModelsState {
+ const item = normalizeItem(op);
+ if (!item) return state;
+ const key = modelConfigCopyIdentity(item);
+ const existing = state.items.find((entry) => modelConfigCopyIdentity(entry) === key);
+ const usedAt = existing ? Math.max(existing.usedAt, item.usedAt) : item.usedAt;
+ const rest = state.items.filter((entry) => modelConfigCopyIdentity(entry) !== key);
+ const next: RecentModelsState = {
+ items: [{ ...item, usedAt }, ...rest]
+ .sort((a, b) => b.usedAt - a.usedAt)
+ .slice(0, RECENT_MODELS_KEEP),
+ };
+ return sameState(state, next) ? state : next;
+}
+
+/**
+ * op-log 的归并:同一副本身份的历史 op 折成一条 —— 否则整条 log 重放时,先录的旧 usedAt
+ * 会被再次并入(虽然取 max 不会把时间改小,但会让「这次记录」在 log 里出现两遍,
+ * 无谓地占用 TTL / 断言次数)。
+ * 时间更旧的 op(时钟回拨 / 跨窗口乱序)直接放弃:重放不能把已有记录的时间往回拧。
+ */
+function compactRecentOps(
+ log: readonly RecentModelsOp[],
+ op: RecentModelsOp,
+): readonly RecentModelsOp[] {
+ const key = modelConfigCopyIdentity(op);
+ const existing = log.find((entry) => modelConfigCopyIdentity(entry) === key);
+ if (existing && existing.usedAt > op.usedAt) return log;
+ return [...log.filter((entry) => modelConfigCopyIdentity(entry) !== key), op];
+}
+
+const reconciler = createStorageReconciler<RecentModelsState, RecentModelsOp>({
+ // active 分区走 freshState(带「读不出来就退回内存缓存」的兜底);其它分区(登出 / 切号后的
+ // 旧 key)按 key 直读。
+ read: (key) => (key === storageKey() ? freshState() : loadFromKey(key)),
+ apply: applyOp,
+ persist: (key, state) => persistTo(key, state),
+ adopt: (key, state) => {
+ if (key !== storageKey()) return;
+ if (sameState(cache ?? emptyState(), state)) return;
+ cache = state;
+ emit();
+ },
+ compact: compactRecentOps,
+});
+
+/**
+ * 一次写入 = **同步乐观写**(热更强退不丢)+ 把 op 记进**当时那个 key** 的会话 op-log 并调度
+ * 一次锁内调和。owner 随后被切走也不放弃调和 —— 调和按捕获的 key 自洽运行。
+ */
+function commitOp(op: RecentModelsOp): void {
+ const base = freshState();
+ const next = applyOp(base, op);
+ if (next !== base) persist(next);
+ const key = storageKey();
+ reconciler.record(key, op);
+ reconciler.schedule(key);
+}
+
+// ── 订阅(供 useSyncExternalStore)──────────────────────────────────────────
+const listeners = new Set<() => void>();
+
+function emit(): void {
+ for (const listener of listeners) listener();
+}
+
+/**
+ * 落盘到**指定 key**。缓存与通知只在该 key 恰是当前 active 分区时才做(调和可能发生在
+ * 登出 / 切号之后的旧分区上)。
+ */
+function persistTo(key: string, next: RecentModelsState): void {
+ if (typeof window !== 'undefined') {
+ try {
+ // 同步写:见文件头(热更 relaunch 走 app.exit() 强退)。
+ window.localStorage.setItem(key, JSON.stringify(next));
+ } catch {
+ // localStorage 满 / 私密窗口禁写 —— 静默吞,内存态仍生效。
+ }
+ }
+ if (key !== storageKey()) return;
+ cache = next;
+ emit();
+}
+
+function persist(next: RecentModelsState): void {
+ persistTo(storageKey(), next);
+}
+
+function subscribe(listener: () => void): () => void {
+ listeners.add(listener);
+ return () => {
+ listeners.delete(listener);
+ };
+}
+
+function getItemsSnapshot(): readonly RecentModelItem[] {
+ return load().items;
+}
+
+const removeStorageListener = (() => {
+ if (typeof window === 'undefined' || typeof window.addEventListener !== 'function') return null;
+ /** 本 owner 分区的内存态跟外来写入对齐(重读真相,不采信 event.newValue)。 */
+ const refreshActive = (): void => {
+ const next = loadFromStorage();
+ if (sameState(cache ?? emptyState(), next)) return;
+ cache = next;
+ emit();
+ };
+ const onStorage = (event: StorageEvent): void => {
+ if (event.storageArea && event.storageArea !== window.localStorage) return;
+ // key === null 表示 storage.clear():本分区刷新,并让所有还有 op-log 的分区各自调和。
+ if (event.key === null) {
+ refreshActive();
+ for (const key of reconciler.loggedKeys()) reconciler.schedule(key);
+ return;
+ }
+ if (event.key === storageKey()) {
+ refreshActive();
+ // 外来写入可能正是「别窗用旧基底做的迟到覆盖」,抹掉了本窗刚记的 op:
+ // 在锁内把本分区的整条 op-log 重新断言一遍,无差异即终止。
+ reconciler.schedule(event.key);
+ return;
+ }
+ // 非 active 分区:只要 op-log 里还有它的记录就照样调和。
+ if (reconciler.hasOps(event.key)) reconciler.schedule(event.key);
+ };
+ window.addEventListener('storage', onStorage);
+ return () => window.removeEventListener('storage', onStorage);
+})();
+
+if (import.meta.hot) {
+ import.meta.hot.dispose(() => {
+ removeStorageListener?.();
+ });
+}
+
+/** 读全部记录(usedAt 倒序,含当前不可路由的条目 —— 过滤是面板的事)。数组视为只读。 */
+export function listRecentModels(): readonly RecentModelItem[] {
+ return getItemsSnapshot();
+}
+
+/**
+ * 记一次「用了这份配置」。非法入参静默 no-op(与收藏同一条防线)。
+ * `now` 只给测试注入用:生产路径一律取当前时刻。
+ */
+export function recordRecentModel(config: ModelConfigCopy, now: number = Date.now()): void {
+ const item = normalizeItem({ ...config, usedAt: now });
+ if (!item) return;
+ commitOp(item);
+}
+
+/** 订阅变更(非 React 调用方)。 */
+export function subscribeRecentModels(listener: () => void): () => void {
+ return subscribe(listener);
+}
+
+/**
+ * React hook —— 记录列表快照。数组身份只在真正写入 / 跨窗口同步时变化,
+ * 可直接进 useMemo 依赖(useSyncExternalStore 保证 StrictMode 双 render 安全)。
+ */
+export function useRecentModels(): readonly RecentModelItem[] {
+ return useSyncExternalStore(subscribe, getItemsSnapshot, getItemsSnapshot);
+}
+
+/** 随当前数据归属账号切换持久化命名空间(与 setModelFavoritesOwner 同形)。 */
+export function setRecentModelsOwner(ownerId: string | null): void {
+ const normalized = typeof ownerId === 'string' && ownerId.trim().length > 0 ? ownerId : null;
+ if (activeDataOwnerId === normalized) return;
+ activeDataOwnerId = normalized;
+ cache = null;
+ emit();
+}
+
+/** 测试用 —— 重置缓存 / owner / 订阅者 / op-log + 清 localStorage(其它代码不应调用)。 */
+export function __resetForTest(): void {
+ const keyBeforeReset = storageKey();
+ cache = null;
+ listeners.clear();
+ reconciler.__resetForTest();
+ if (typeof window !== 'undefined') {
+ try {
+ window.localStorage.removeItem(keyBeforeReset);
+ window.localStorage.removeItem(STORAGE_KEY);
+ } catch {
+ // ignore
+ }
+ }
+ activeDataOwnerId = null;
+}
+
+export const __STORAGE_KEY = STORAGE_KEY;
diff --git a/apps/desktop/src/renderer/state/storageOpReplay.ts b/apps/desktop/src/renderer/state/storageOpReplay.ts
index 6548d901d6..89e6deebf2 100644
--- a/apps/desktop/src/renderer/state/storageOpReplay.ts
+++ b/apps/desktop/src/renderer/state/storageOpReplay.ts
@@ -1,10 +1,10 @@
/**
- * storageOpReplay —— `modelFavorites` 与 `modelEnginePrefs` 两个 localStorage store 的
- * **跨 renderer 并发一致性**小工具。刻意只服务这两个文件,不做成通用存储框架:它依赖
- * 「写操作能表达成可重放且幂等的 op」这一前提,而那是那两个 store 自己的设计约束。
+ * storageOpReplay —— `modelFavorites` / `modelEnginePrefs` / `recentModels` 三个 localStorage
+ * store 的**跨 renderer 并发一致性**小工具。刻意只服务这三个文件,不做成通用存储框架:它依赖
+ * 「写操作能表达成可重放且幂等的 op」这一前提,而那是那三个 store 自己的设计约束。
*
* 要解决的问题(2026-08-17 review H1 / K1 / K2):
- * 两个 store 都是**整表写回**。「写前重读 localStorage」只能修「另一窗口先写完、事件还没
+ * 三个 store 都是**整表写回**。「写前重读 localStorage」只能修「另一窗口先写完、事件还没
* 到」那一路;两个 renderer 若**都在对方写回之前**读了同一份旧快照,后写者仍然整表覆盖
* 先写者 —— 新增丢失、编辑丢失,删除与编辑交错时已删的条目还会复活。localStorage 没有
* CAS,同进程 JS 单线程,但**跨 renderer 进程**的 getItem / setItem 可以任意交错,所以
@@ -27,7 +27,7 @@
* owner 是谁**(K1 修复点):调和按捕获的 key 自洽运行,登出 / 切号后旧分区的 log 继续有效;
* 仅当 key 恰好是当前 active 分区时才顺带刷新缓存 / 通知(config.persist / config.adopt
* 由 store 侧按 key 自行判断);
- * 4. 触发时机两处:a) 每次 commit 后;b) **storage 事件** —— 两个 store 的监听器都从「只认
+ * 4. 触发时机两处:a) 每次 commit 后;b) **storage 事件** —— 三个 store 的监听器都从「只认
* 当前 active key」放宽为「凡是 op-log 里有记录的 key 都认」。这是 K2 的收敛闭环:任何
* 迟到脏写抹掉本窗的 op,都会以 storage 事件的形式到达本窗,本窗随即在锁内把自己的
* op-log 重新施加到最新状态上 —— 被抹的 op 被重新断言,删除也是 op、同样重新断言;
diff --git a/docs/product-rules/model-selector-unified.md b/docs/product-rules/model-selector-unified.md
index 9acb819b27..894efd30f5 100644
--- a/docs/product-rules/model-selector-unified.md
+++ b/docs/product-rules/model-selector-unified.md
@@ -24,15 +24,17 @@
- **A 版是新旧用户唯一的模型选择面板**(2026-09-05)。删除 B 版与样式切换入口,不再读取历史 `xdt:modelPickerLayout:v1` 偏好,升级无需手动切换。仅在老被控端 capabilities-only 时保留兼容列表。固定引擎表单同样使用 A,候选锁定在该表单实际能保存的引擎。
- 全局入口:聊天、新任务、定时任务、IM 默认、Hook 工作目录、Worker、Subagent、视觉桥、辅助模型与插件快问快答复用同一面板。只存模型的入口不开放深度 / Fast 配置;仅存单引擎配置的入口不能选择其他引擎。专用模型白名单不得因界面统一而扩大,远程模型与来源来自被控端目录,不能写入本机记忆。
- 模型选择、配置编辑与“跟随默认”均等待保存结果;失败保留面板与原配置。选模型或跟随默认成功才收起,配置编辑保持浮层打开。无模型记忆表的设置入口编辑非当前模型时,直接应用其完整配置。已有待生效配置时再次远程选模,先展示最新用户选择;运行时当前配置的来源、模型、引擎、深度与 Fast 始终来自同一快照。
-- 结构:搜索框贴顶 → 左侧 rail(★收藏 / 全部 / 各供应商图标) → 右侧列表 → 底部「+配置模型」。
+- 结构:搜索框贴顶 → 左侧 rail(最近 / ★收藏 / 全部 / 各供应商图标) → 右侧列表 → 底部「+配置模型」。
+ 「最近」格在 ★ 之上(2026-09-16 裁决),与 ★ 一样常驻,图标用时钟回弹箭头(History),点击进入**独立的最近视图**;空列表时显示引导空态。常规视图(全部 / 各供应商 / 同引擎)**不**陈列最近区(与收藏上下叠放会产生视觉歧义)。
- 列表主体固定高 428px(指定可见行数的入口按其既有高度配置),不随供应商筛选、收藏、搜索或空结果改变高度;窗口空间不足时按可用高度收缩。模型列表与供应商侧栏分别内部滚动,搜索与底部操作保持可见。
- Mobile 从模型详情或来源子页返回时,保留进入前的列表滚动位置、搜索词与来源筛选,不重新初始化列表。iOS 保留原生 Form,Android 保留原列表 SheetSurface;详情使用独立滚动容器,隐藏列表禁止交互与读屏访问,不叠加第二个 Modal。完整关闭后重新打开仍沿用原有初始化规则。
- 宽度自适应:`max-content`,min 300px / max min(460px, 100vw-48px);优先保持紧凑,超出可用宽度的模型名显示省略号,hover title 保留全名,不为显示完整名称继续加宽(2026-09-17 截断原则;2026-09-21 将上限从 420px 调整为 460px,以完整显示「Codex GPT-6 Astra」量级的名称)。字段形态仍绑定字段宽度;视口和锚点可用空间不足时继续收缩。
- 行(双行):
- L1:厂商图标 · 模型名(弹性,截断) · 价格档/折扣/订阅徽标 · ☆ · 右侧**常驻三元组**`[引擎图标] 深度 [⚡]` · 选中勾。
- - L2:一句描述(截断)。
+ - L2:一句描述(截断)。收藏 / 最近 / 全部视图的 L2 改显 provider 来源(来源详情行,同名模型跨来源价格不同);仅单来源视图显描述。
- 三元组**所有行同构、永远显示**——引擎可见性靠一致的结构位,不靠出错才显示;自定义未收藏的行整组提亮一档(secondary)。
-- 分组:收藏 → 推荐(仅已有任务)→ 供应商分组。推荐区先放当前模型,再放同生效引擎的模型;推荐中的模型从下方供应商组移除,空组不渲染标题或间距。供应商侧栏仍基于完整目录。新任务不展示同引擎推荐。组间顺序遵循「设置 → 模型供应商」的拖动排序(本地会话;device-link 用被控端快照顺序,不套控制端本地序),组内按 group/sortOrder;订阅账号(OpenAI、Anthropic)有账号模型清单时 sortOrder 以账号返回顺序为准,只在目录里有的模型接在其后,目录 sortOrder 仅在拿不到账号清单时兜底,见 [模型排序](../dev-rules/model-catalog-maintenance.md#ordering)。收藏区条目**不**从供应商组中去重移除(收藏是配置副本,模型本体仍在原地)。
+- 分组:最近 → 收藏 → 推荐(仅已有任务)→ 供应商分组(2026-09-16 实测裁决:最近置于收藏之前)。推荐区先放当前模型,再放同生效引擎的模型;推荐中的模型从下方供应商组移除,空组不渲染标题或间距。供应商侧栏仍基于完整目录。新任务不展示同引擎推荐。组间顺序遵循「设置 → 模型供应商」的拖动排序(本地会话;device-link 用被控端快照顺序,不套控制端本地序),组内按 group/sortOrder;订阅账号(OpenAI、Anthropic)有账号模型清单时 sortOrder 以账号返回顺序为准,只在目录里有的模型接在其后,目录 sortOrder 仅在拿不到账号清单时兜底,见 [模型排序](../dev-rules/model-catalog-maintenance.md#ordering)。收藏区条目**不**从供应商组中去重移除(收藏是配置副本,模型本体仍在原地)。
+- **最近视图(2026-09-16)**:只由侧栏「最近」格进入,按最近一次使用时间倒序陈列最近 5 条**配置副本**(与收藏同一套语义:来源 + 模型 + 引擎 + 深度 + Fast;同一模型不同配置各占一行),行与收藏视图一致(L2 显 provider 来源)。点击一条按该副本的完整配置应用;已标星的行与收藏行同构(带上那条收藏的 uid,选中锚点 / 星标一致)。被收藏的副本标星——先按**来源 + 模型**圈定同一条目,再比解析后的引擎 / 深度 / Fast 一致即点亮(只看三元组会跨型号误命中,点星删错收藏);未收藏点星把这份副本存进收藏,已点亮再点星从收藏里移除。**取消收藏若删的正是当前选中的那份收藏**,与收藏视图完全同一口径:先把该模型的默认配置应用出去再删(否则正在跑的配置与显示分家);这是「删收藏」的通用语义,最近视图不另开一套。该视图是只读流水账:**不提供配置浮层**(改配置走模型行或收藏)——最近行不绑右键 / ←,也不宣告 `ArrowLeft` 快捷键(右键不抢原生菜单)。记录点只有对话里「选择真的应用成功」的那一下(新任务草稿 / 已建任务 / 任务内切换),记的是那一刻生效的整份配置;定时任务 / IM 默认 / Bot / Hook / Worker / 子代理与设置页的选择是配置动作,不记;SSH 与 device-link 远程也不记(被控端目录的模型在本机不一定可路由)。不可路由的条目不删只隐藏,数量不足时从更早的历史补足。首日为空是预期状态,不做事后回填。
- 折扣表达:价格档 `¥/$` 串按折后价连续填充(付费亮、折扣灰),后跟淡染徽标 `↓60%`;详情(title+浮层)写全「折扣中 · 标准价 X · 省 Y%」。中文计价 ¥,英文 $。
供应商图标下方以 22 × 3px 横线显示账号通用周限额的**剩余比例**;图标格统一高 38px,数据更新不改变布局。常态灰色,剩余低于 30% 为警示色,剩余不高于 10% 为严重色,复用额度语义 token。悬停与键盘聚焦的 Tip 显示完整连接名、周剩余百分比和“还有多久重置”。紧凑区域优先倒计时,使用上游重置时间计算,不把已过期窗口推断为已补满。
@@ -162,6 +164,11 @@
- 仍**不是用户配置**:不落库、不进 device-link payload、写失败静默吞;丢了只是回落模型行。
- 草稿发送建会话时,仍有效且**有显式来源**的草稿锚点写进该 sessionId 的会话槽(跟随默认路由的会话
`providerId` 为 null,与显式来源的锚点永不相等,存了也打不上勾,故不延续)。
+4. `xdt:recentModels:v1:<dataOwnerId>` —— 「最近」**配置副本**流水:
+ `{ items: [{ providerId, modelId, agent, effort?, fast?, usedAt }] }`(usedAt 倒序,本机保留
+ `RECENT_MODELS_KEEP = 20` 条,视图陈列前 5)。字段归一化与去重身份与收藏**共用同一份**
+ (modelConfigCopy):同一模型不同配置各占一行;跨窗口按副本身份取 `max(usedAt)` 并入
+ (与前三项同一套 op-log 调和,记录 op 幂等且无删除类)。记录写入在对话入口「选择真的应用成功」的回调里。
- 深度/Fast 的每模型记忆**沿用** `providerModelMemory` `<agent>:*` 槽(不迁移不改形——它同时是 device-link wire 形状)。
### 2.4 选中态与会话创建