Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
fix(desktop): 收口「最近」视图的评审发现(跨账号串写 / 无响应入口 / 写失败基底 / 调和使用)
Zhang Yunjin418d80f515e4
diff --git a/apps/desktop/src/renderer/__tests__/recentModels.test.ts b/apps/desktop/src/renderer/__tests__/recentModels.test.tsindex b5b1630af5..98869769de 100644--- a/apps/desktop/src/renderer/__tests__/recentModels.test.ts+++ b/apps/desktop/src/renderer/__tests__/recentModels.test.ts@@ -68,6 +68,29 @@ function installStorageBus(): void {};}+/** `navigator.locks` 的最小串行队列 polyfill(node env 没有 Web Locks;同 modelEnginePrefs.test)。 */+function installLocks(): void {+ const tails = new Map<string, Promise<unknown>>();+ vi.stubGlobal('navigator', {+ locks: {+ request: (name: string, callback: () => unknown) => {+ const previous = tails.get(name) ?? Promise.resolve();+ const run = previous.then(() => callback());+ tails.set(+ name,+ run.catch(() => undefined),+ );+ return run;+ },+ },+ });+}++/** 等锁内调和跑完(microtask + 事件队列各让几轮)。 */+async function flushAsync(): Promise<void> {+ for (let i = 0; i < 4; i += 1) await new Promise((resolve) => setTimeout(resolve, 0));+}+async function loadModule() {return await import('@/state/recentModels');}@@ -191,6 +214,98 @@ describe('recentModels store', () => {]);});+ it('写失败后再写成功:磁盘旧快照不能把只存在内存里的那条顶掉', async () => {+ const m = await loadModule();+ m.recordRecentModel(OPUS, 1000);+ // 配额满:B 没落盘,只活在内存里(缓存仍更新)。+ vi.spyOn(memStorage, 'setItem').mockImplementationOnce(() => {+ throw new Error('quota');+ });+ m.recordRecentModel(SOL, 2000);+ expect(m.listRecentModels().map((item) => item.modelId)).toEqual([+ 'gpt-5.6-sol',+ 'claude-opus-5',+ ]);+ // 下一次成功写入的基底 = 磁盘真相 ∪ 内存态,不能只看磁盘(否则 B 被抹掉)。+ m.recordRecentModel({ providerId: 'anthropic', modelId: 'claude-sonnet-5', agent: 'cc' }, 3000);+ expect(+ m+ .listRecentModels()+ .map((item) => item.modelId)+ .sort(),+ ).toEqual(['claude-opus-5', 'claude-sonnet-5', 'gpt-5.6-sol']);+ const persisted = JSON.parse(memStorage.getItem(m.__STORAGE_KEY) as string) as {+ items: Array<{ modelId: string }>;+ };+ expect(persisted.items.map((item) => item.modelId).sort()).toEqual([+ 'claude-opus-5',+ 'claude-sonnet-5',+ 'gpt-5.6-sol',+ ]);+ });++ it('跨窗口迟到覆盖:锁内重放 op-log 把本窗的记录重新断言(两份都留;重复调和幂等)', async () => {+ installLocks();+ 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 }],+ }),+ );+ await flushAsync();+ // 本窗的 op 被重新断言:A 回来了(按 usedAt 排在 B 后面)。+ expect(m.listRecentModels().map((item) => item.modelId)).toEqual([+ 'gpt-5.6-sol',+ 'claude-opus-5',+ ]);+ // 再广播一次:无差异不写,状态收敛(不活锁)。+ const diskBefore = memStorage.getItem(m.__STORAGE_KEY);+ 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 flushAsync();+ expect(memStorage.getItem(m.__STORAGE_KEY)).toBe(diskBefore);+ expect(m.listRecentModels()).toHaveLength(2);+ });++ it('切换 owner 后旧分区仍按原 key 调和,不写进新分区', async () => {+ installLocks();+ installStorageBus();+ const m = await loadModule();+ m.setRecentModelsOwner('user-a');+ const keyA = `${m.__STORAGE_KEY}:user-a`;+ m.recordRecentModel(OPUS, 1000);+ m.setRecentModelsOwner('user-b');+ // 别窗迟到覆盖 A 分区。+ memStorage.setItem(+ keyA,+ JSON.stringify({+ items: [{ providerId: 'openai', modelId: 'gpt-5.6-sol', agent: 'codex', usedAt: 2000 }],+ }),+ );+ await flushAsync();+ const persistedA = JSON.parse(memStorage.getItem(keyA) as string) as {+ items: Array<{ modelId: string }>;+ };+ expect(persistedA.items.map((item) => item.modelId).sort()).toEqual([+ 'claude-opus-5',+ 'gpt-5.6-sol',+ ]);+ // B 分区不受影响,当前视图也不串数据。+ expect(memStorage.getItem(`${m.__STORAGE_KEY}:user-b`)).toBeNull();+ expect(m.listRecentModels()).toEqual([]);+ });+it('storage 事件重读真相,且不采信迟到的旧事件', async () => {installStorageBus();const m = await loadModule();diff --git a/apps/desktop/src/renderer/__tests__/unifiedModelPanelRendering.test.tsx b/apps/desktop/src/renderer/__tests__/unifiedModelPanelRendering.test.tsxindex 883ac07bc0..9da88089a1 100644--- a/apps/desktop/src/renderer/__tests__/unifiedModelPanelRendering.test.tsx+++ b/apps/desktop/src/renderer/__tests__/unifiedModelPanelRendering.test.tsx@@ -226,6 +226,7 @@ import {__resetForTest as resetRecentModels,listRecentModels,recordRecentModel,+ setRecentModelsOwner,} from '@/state/recentModels';import { setModelEngineOverride } from '@/state/modelEnginePrefs';@@ -4181,6 +4182,56 @@ describe('统一面板 · 最近使用记录与陈列', () => {expect(listRecentModels().map((item) => item.modelId)).toEqual(['gpt-5.6']);});+ it('选择在途时切换归属:不把记录写进新分区(2026-09-17 review P1 跨账号串写)', async () => {+ let settle: ((applied: boolean) => void) | null = null;+ const pending = new Promise<boolean>((resolve) => {+ settle = resolve;+ });+ renderPanel({+ recordRecentUsage: true,+ onProviderChange: vi.fn(() => pending),+ currentProviderId: 'openai',+ modelId: 'gpt-5.5',+ });+ await act(async () => {+ fireEvent.click(rowFor('GPT-5.6'));+ });+ // 选择还在飞:用户登出 / 切到本地模式(另一个分区)。+ await act(async () => {+ setRecentModelsOwner('user-b');+ });+ await act(async () => {+ settle?.(true);+ await pending;+ });+ // 异步链条(选模回调 → 记录判定)还要再让一拍,避免 act 警告。+ await act(async () => {+ await Promise.resolve();+ });+ // 旧 Promise 落地时归属已变 → 整条丢弃,新分区看不到这条记录。+ expect(listRecentModels()).toEqual([]);+ });++ it('设置类入口(configurationEnabled=false)不渲染无响应的自定义按钮 / 不宣告 ←', async () => {+ renderPanel({ configurationEnabled: false });+ const row = rowFor('GPT-5.5');+ // 之前只靠面板层 noop 中和,按钮与快捷键仍宣告存在(点了没反应)。+ expect(row.querySelector('[data-row-customize]')).toBeNull();+ expect(row.getAttribute('aria-keyshortcuts')).toBeNull();+ const contextMenu = new MouseEvent('contextmenu', { bubbles: true, cancelable: true });+ row.dispatchEvent(contextMenu);+ expect(contextMenu.defaultPrevented).toBe(false);+ await act(async () => {+ fireEvent.keyDown(row, { key: 'ArrowLeft' });+ });+ expect(screen.queryByTestId('unified-model-config-flyout')).toBeNull();+ // 选模型本身不受影响。+ await act(async () => {+ fireEvent.click(row);+ });+ expect(onProviderChange).toHaveBeenCalledWith('xd', 'gpt-5.5', 'high', false);+ });+it('rail 的「最近」格在收藏之上,点击后只留最近区', async () => {recordRecentModel({ providerId: 'openai', modelId: 'gpt-5.6', agent: 'codex' }, 1000);renderPanel();diff --git a/apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx b/apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsxindex f9c91de47f..66eba24aa2 100644--- a/apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx+++ b/apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx@@ -96,7 +96,7 @@ export function UnifiedModelRow({const priceSymbol = priceDisplay?.symbol ?? '$';const engineOption = agentOptionOf(config.engine);const openConfig = (element: HTMLElement, toggle = false) => {- if (paymentRequired || !customizeEnabled) return;+ if (paymentRequired || !customizeEnabled || !configurationEnabled) return;onReveal(anchor, element, toggle);};const tripleTitle = `${engineOption.label}${@@ -117,9 +117,10 @@ export function UnifiedModelRow({'aria-disabled': interactionDisabled ? true : undefined,'aria-label': paymentRequiredActionLabel,// ← 开配置浮层是这一行唯一的键盘入口,不声明就只有摸索得到(读屏用户尤甚)。- // 最近行是只读配置副本(customizeEnabled=false):既没有浮层入口,就不能再宣告这个快捷键,- // 否则读屏用户按过去什么都不到。- 'aria-keyshortcuts': paymentRequired || !customizeEnabled ? undefined : 'ArrowLeft',+ // 没有浮层入口的行不再宣告这个快捷键:最近行是只读配置副本(customizeEnabled=false),+ // 设置类入口不出配置浮层(configurationEnabled=false)—— 两者按过去都什么都不发生。+ 'aria-keyshortcuts':+ paymentRequired || !customizeEnabled || !configurationEnabled ? 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).@@ -127,9 +128,9 @@ export function UnifiedModelRow({'data-state': active ? 'open' : selected ? 'checked' : undefined,'data-unified-anchor': anchorKey(anchor),onContextMenu: (event: ReactMouseEvent<HTMLDivElement>) => {- // 没有配置入口的行(付费行 / 最近行)**不抢**右键:不 preventDefault,把原生菜单留给用户,- // 否则右键变成「什么都不发生、原生菜单也被吃掉」(2026-09-16 review P1)。- if (!customizeEnabled || interactionDisabled || paymentRequired) return;+ // 没有配置入口的行(付费行 / 最近行 / 设置类入口)**不抢**右键:不 preventDefault,+ // 把原生菜单留给用户,否则右键变成「什么都不发生、原生菜单也被吃掉」(2026-09-16 review P1)。+ if (!customizeEnabled || !configurationEnabled || interactionDisabled || paymentRequired) return;event.preventDefault();openConfig(event.currentTarget);},@@ -148,7 +149,7 @@ export function UnifiedModelRow({return;}if (event.key === 'ArrowLeft') {- if (!customizeEnabled) return;+ if (!customizeEnabled || !configurationEnabled) return;event.preventDefault();onRevealForKeyboard(anchor, event.currentTarget);return;@@ -283,7 +284,7 @@ export function UnifiedModelRow({/>)}{starButton}- {customizeEnabled && customizeButton}+ {configurationEnabled && 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.tsindex 129e15f5ce..ee3094dc87 100644--- a/apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts+++ b/apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts@@ -616,8 +616,8 @@ export function buildUnifiedListSections(args: {// ── 最近视图 ── **只服务侧栏的「最近」格**(2026-09-16 实测裁决:各供应商 / 全部视图// 不再陈列最近区 —— 它与收藏上下叠放会产生「这两区到底有什么不同」的视觉歧义)。// 因此这里不把最近并入常规列表,而是单独成页:白名单是 store 里最近的 UNIFIED_RECENT_MODELS_LIMIT- // 条可路由模型,行身份就是模型本体(点击等价于点供应商组里那一行,生效配置由既有合成规则- // 重新解析,见 recentModels 文件头)。+ // 条可路由模型;每行拿的是记录时的**配置副本**(模型 + 引擎 + 深度 + Fast),行身份就是+ // 这份副本(同一模型不同配置各占一行,锚点 key 即副本身份,见 recentModels 文件头)。if (rail.kind === 'recent') {const recentRows: UnifiedListRow[] = [];for (const item of args.recentModels ?? []) {diff --git a/apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts b/apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.tsindex 886787aae8..5e7553c655 100644--- a/apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts+++ b/apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts@@ -35,7 +35,7 @@ import {type ModelFavoriteConfig,type ModelFavoriteItem,} from '@/state/modelFavorites';-import { recordRecentModel } from '@/state/recentModels';+import { getRecentModelsOwner, recordRecentModel } from '@/state/recentModels';import type { ModelMemoryAccessors } from './ModelSelector';import type { UnifiedSelectedRow } from './UnifiedModelPanel';diff --git a/apps/desktop/src/renderer/state/recentModels.ts b/apps/desktop/src/renderer/state/recentModels.tsindex a5fda53782..429fbc7263 100644--- a/apps/desktop/src/renderer/state/recentModels.ts+++ b/apps/desktop/src/renderer/state/recentModels.ts@@ -233,12 +233,44 @@ const reconciler = createStorageReconciler<RecentModelsState, RecentModelsOp>({compact: compactRecentOps,});+/**+ * 两份状态取并集:同一副本身份取 max(usedAt),按时间倒序并裁到 KEEP 条。+ * 只增不减(本 store 没有删除类 op)—— 把「本窗已记但没落盘」的条目并回写基底。+ * 没有新身份 / 时间没前进时**返回入参对象本身**,调用方据此判断要不要落盘。+ */+function mergeState(base: RecentModelsState, extra: RecentModelsState | null): RecentModelsState {+ if (!extra || extra.items.length === 0) return base;+ const byKey = new Map(base.items.map((item) => [modelConfigCopyIdentity(item), item]));+ let changed = false;+ for (const item of extra.items) {+ const key = modelConfigCopyIdentity(item);+ const existing = byKey.get(key);+ if (!existing) {+ byKey.set(key, item);+ changed = true;+ continue;+ }+ if (item.usedAt > existing.usedAt) {+ byKey.set(key, item);+ changed = true;+ }+ }+ if (!changed) return base;+ return {+ items: [...byKey.values()].sort((a, b) => b.usedAt - a.usedAt).slice(0, RECENT_MODELS_KEEP),+ };+}+/*** 一次写入 = **同步乐观写**(热更强退不丢)+ 把 op 记进**当时那个 key** 的会话 op-log 并调度* 一次锁内调和。owner 随后被切走也不放弃调和 —— 调和按捕获的 key 自洽运行。+ *+ * 写基底 = **磁盘真相 ∪ 本窗内存态**(2026-09-16 review P2):上一次写若失败(配额 / 私密+ * 窗口),那条记录只活在本窗内存里,而 `freshState()` 只按 key 读回磁盘 —— 拿它当基底再写一次+ * 会把「刚记下但没落盘」的那条顺手抹掉(磁盘上有旧快照时尤其明显)。并集只增不减,重复写无害。*/function commitOp(op: RecentModelsOp): void {- const base = freshState();+ const base = mergeState(freshState(), cache);const next = applyOp(base, op);if (next !== base) persist(next);const key = storageKey();@@ -360,6 +392,14 @@ export function setRecentModelsOwner(ownerId: string | null): void {emit();}+/**+ * 当前分区归属(可能为 null = 未登录 / 本地模式)。调用方在**发起异步选择时**捕获它,回调落地+ * 前再比一次 —— 归属变了就不能把记录写进新分区(`xdt:recentModels:v1:<dataOwnerId>`)。+ */+export function getRecentModelsOwner(): string | null {+ return activeDataOwnerId;+}+/** 测试用 —— 重置缓存 / owner / 订阅者 / op-log + 清 localStorage(其它代码不应调用)。 */export function __resetForTest(): void {const keyBeforeReset = storageKey();diff --git a/docs/product-rules/model-selector-unified.md b/docs/product-rules/model-selector-unified.mdindex 894efd30f5..dfba068b33 100644--- a/docs/product-rules/model-selector-unified.md+++ b/docs/product-rules/model-selector-unified.md@@ -33,7 +33,7 @@- L1:厂商图标 · 模型名(弹性,截断) · 价格档/折扣/订阅徽标 · ☆ · 右侧**常驻三元组**`[引擎图标] 深度 [⚡]` · 选中勾。- L2:一句描述(截断)。收藏 / 最近 / 全部视图的 L2 改显 provider 来源(来源详情行,同名模型跨来源价格不同);仅单来源视图显描述。- 三元组**所有行同构、永远显示**——引擎可见性靠一致的结构位,不靠出错才显示;自定义未收藏的行整组提亮一档(secondary)。-- 分组:最近 → 收藏 → 推荐(仅已有任务)→ 供应商分组(2026-09-16 实测裁决:最近置于收藏之前)。推荐区先放当前模型,再放同生效引擎的模型;推荐中的模型从下方供应商组移除,空组不渲染标题或间距。供应商侧栏仍基于完整目录。新任务不展示同引擎推荐。组间顺序遵循「设置 → 模型供应商」的拖动排序(本地会话;device-link 用被控端快照顺序,不套控制端本地序),组内按 group/sortOrder;订阅账号(OpenAI、Anthropic)有账号模型清单时 sortOrder 以账号返回顺序为准,只在目录里有的模型接在其后,目录 sortOrder 仅在拿不到账号清单时兜底,见 [模型排序](../dev-rules/model-catalog-maintenance.md#ordering)。收藏区条目**不**从供应商组中去重移除(收藏是配置副本,模型本体仍在原地)。+- 分组:收藏 → 推荐(仅已有任务)→ 供应商分组。最近**不是**常规视图里的一区(2026-09-16 实测裁决)——它只在侧栏「最近」格(位于收藏之上,见上一节 rail 说明)单开一页,不参与本行顺序。推荐区先放当前模型,再放同生效引擎的模型;推荐中的模型从下方供应商组移除,空组不渲染标题或间距。供应商侧栏仍基于完整目录。新任务不展示同引擎推荐。组间顺序遵循「设置 → 模型供应商」的拖动排序(本地会话;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%」。中文计价 ¥,英文 $。@@ -168,7 +168,7 @@`{ items: [{ providerId, modelId, agent, effort?, fast?, usedAt }] }`(usedAt 倒序,本机保留`RECENT_MODELS_KEEP = 20` 条,视图陈列前 5)。字段归一化与去重身份与收藏**共用同一份**(modelConfigCopy):同一模型不同配置各占一行;跨窗口按副本身份取 `max(usedAt)` 并入- (与前三项同一套 op-log 调和,记录 op 幂等且无删除类)。记录写入在对话入口「选择真的应用成功」的回调里。+ (与前三项同一套 op-log 调和,记录 op 幂等且无删除类)。记录写入在对话入口「选择真的应用成功」的回调里:选择是异步的(跨引擎事务 / 远程写),回调落地时若归属已变(登出 / 切本地模式)则整条丢弃,不写进新分区;写基底 = 磁盘真相 ∪ 本窗内存态 —— 上一次写失败(配额 / 私密窗口)时那条记录只活在内存里,不能被下次 `freshState()` 读到的磁盘旧快照顶掉。- 深度/Fast 的每模型记忆**沿用** `providerModelMemory` `<agent>:*` 槽(不迁移不改形——它同时是 device-link wire 形状)。### 2.4 选中态与会话创建