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。

fix(desktop): 收口「最近」视图的评审发现(跨账号串写 / 无响应入口 / 写失败基底 / 调和使用)

Zhang Yunjin418d80f515e4
diff --git a/apps/desktop/src/renderer/__tests__/recentModels.test.ts b/apps/desktop/src/renderer/__tests__/recentModels.test.ts
index 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.tsx
index 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.tsx
index 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.ts
index 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.ts
index 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.ts
index 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.md
index 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 选中态与会话创建