Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
/**
* 桌面端「未起名会话标题」投影的出口清单。
*
* 不变量:会话标题的每个**用户可见**出口都必须过投影(`getSessionDisplayTitle` /
* `projectDraftSessionTitle` / `conversationSearchTitle`,三者共用
* `isDefaultDraftSessionTitle` 这一个判据),内部哨兵 `New Maker` 一处都不许原样渲染;
* 且投影只发生在渲染那一刻,不提前固化进 state / 缓存。
*
* 侧边栏行 / 卡片 / 会话头 / tab 有各自的行为测试;这里钉住那些散在大组件里、
* 没有独立渲染基座的出口(rail 置顶瓷砖、聊天里的会话 chip、等待横幅、通知 payload),
* 让「只修了一半」在测试里立刻可见 —— 本 PR 前四轮 review 反复栽在这上面。
*/
import { readFileSync } from 'node:fs';
import { resolve } from 'node:path';
import { describe, expect, it } from 'vitest';
const RENDERER_ROOT = resolve(__dirname, '..');
function read(relPath: string): string {
return readFileSync(resolve(RENDERER_ROOT, relPath), 'utf8').replace(/\r\n/g, '\n');
}
const railNav = read('features/cc-agent/sidebar/RailNav.tsx');
const linkChip = read('components/chat/SessionLinkChip.tsx');
const waitBanner = read('components/chat/CredentialSwitchWaitBanner.tsx');
const sidebarUpper = read('features/cc-agent/CCAgentSidebarUpper.tsx');
const draftRoute = read('features/cc-agent/NewMakerDraftRoute.tsx');
describe('desktop 会话标题投影出口', () => {
it('rail 置顶瓷砖、aria-label 与悬浮预览卡都用显示标题', () => {
expect(railNav).toContain(
"const displayTitle = getSessionDisplayTitle(session, t('ccAgent.common.unnamedSession'), t);",
);
expect(railNav).toContain('aria-label={displayTitle}');
expect(railNav).toContain('{pinnedTileLabel(displayTitle)}');
// 短标签会把 "New Maker" 截成 "New",比整串更难看出问题 —— 原始 title 不许再出现。
expect(railNav).not.toContain('pinnedTileLabel(session.title)');
expect(railNav).not.toContain('aria-label={session.title}');
});
it('聊天里的会话 chip 过投影', () => {
expect(linkChip).toContain("projectDraftSessionTitle(resolvedTitle, t('ccAgent.common.unnamedSession'))");
});
it('凭证等待横幅在渲染时投影,state 里仍存原始标题', () => {
expect(waitBanner).toContain(
"projectDraftSessionTitle(title, t('ccAgent.common.unnamedSession'))",
);
// 投影固化进 state 就意味着切语言后要重新拉一遍标题才会变(本 PR 第 8 条不变量)。
expect(waitBanner).toContain('setBlockerTitles(titles.filter(');
expect(waitBanner).toContain('.then((session) => session.title?.trim() || null)');
});
// 乐观预览必须有失败路径:交接失败(消息退回草稿 / setGoal 抛错)时权威标题永不回流,
// 不撤回就会永久盖着 DB 里的哨兵,会话显示一句**没发出去**的话。
it('新建会话的两条交接失败路径都撤回标题预览', () => {
// worktree 分支:所有「交接失败 → 还原草稿」的 return 都过 restoreFirstMessageDraft,
// 撤回放在那一处而不是各 return 前。
expect(draftRoute).toContain('emitAutoTitlePreviewCleared(newSession.id);');
const restoreFn = draftRoute.indexOf('const restoreFirstMessageDraft = () => {');
const clearInRestore = draftRoute.indexOf('emitAutoTitlePreviewCleared(newSession.id);', restoreFn);
const restoreFnEnd = draftRoute.indexOf('};', restoreFn);
expect(restoreFn).toBeGreaterThan(-1);
expect(clearInRestore).toBeGreaterThan(restoreFn);
expect(clearInRestore).toBeLessThan(restoreFnEnd);
// goal 分支:setGoal 抛错时撤回后照旧把异常抛给调用方。
expect(draftRoute).toContain('if (optimisticGoalTitle) emitAutoTitlePreviewCleared(newSession.id);');
// 普通 send 分支:rehomeDraftAttachments / setPending / navigate 在登记之后抛错时,
// 由外层 catch 撤回(它拿不到 newSession,靠 optimisticTitleSessionId 记住)。
expect(draftRoute).toContain('let optimisticTitleSessionId: string | null = null;');
expect(draftRoute).toContain(
'if (optimisticTitleSessionId) emitAutoTitlePreviewCleared(optimisticTitleSessionId);',
);
expect(draftRoute).toContain('let remoteOptimisticTitleSessionId: string | null = null;');
expect(draftRoute).toContain(
'remoteProjectsStore.clearPendingTitlePreview(remoteOptimisticTitleSessionId);',
);
// 远程归属切换会提前 return,撤回必须排在它前面,否则空会话会一直顶着没发出去的原文。
const remotePreviewClear = draftRoute.indexOf(
'remoteProjectsStore.clearPendingTitlePreview(remoteOptimisticTitleSessionId);',
);
const ownerChangedReturn = draftRoute.indexOf(
'if (isRemotePrecreatedWorktreeOwnerChangedError(err)) return;',
remotePreviewClear,
);
expect(remotePreviewClear).toBeGreaterThan(-1);
expect(ownerChangedReturn).toBeGreaterThan(remotePreviewClear);
// createSession 返回 null 是 return,不进外层 catch,必须就地撤回。
expect(draftRoute).toContain(
'if (optimisticTitleSessionId) emitAutoTitlePreviewCleared(optimisticTitleSessionId);\n toastCreateSessionFailed();',
);
expect(draftRoute).toContain(
'if (optimisticTitleSessionId) emitAutoTitlePreviewCleared(optimisticTitleSessionId);\n toastCreateSessionFailed();',
);
expect(draftRoute).toContain(
'if (optimisticGoalTitle) emitAutoTitlePreviewCleared(goalSessionId);',
);
const goalCatch = draftRoute.indexOf('} catch (error) {\n // 预览在 createSession 之前登记。');
expect(goalCatch).toBeGreaterThan(-1);
expect(draftRoute.indexOf(
'if (goalSessionId && optimisticGoalTitle) emitAutoTitlePreviewCleared(goalSessionId);',
goalCatch,
)).toBeGreaterThan(goalCatch);
// 预览必须在本机发送路径的 createSession 之前登记,否则 sessions:created
// 刷新会先画出「未命名任务」。文件前段还有 SSH / 远程建会话,不能拿第一处 create。
const previewBeforeCreate = draftRoute.indexOf('emitAutoTitlePreview(sessionId, optimisticTitle)');
const sendCreate = draftRoute.indexOf('const newSession = await createSession({', previewBeforeCreate);
expect(previewBeforeCreate).toBeGreaterThan(-1);
expect(sendCreate).toBeGreaterThan(previewBeforeCreate);
// 纯附件远程预览必须登记成系统合成标题,否则后续第一句文字无法即时覆盖。
expect(draftRoute).toContain('Boolean(normalizeAutoTitle(message))');
});
it('系统通知 / 飞书 / 手机推送的标题过投影,且语言走 ref 不被钉在首次渲染', () => {
expect(sidebarUpper).toContain(
'const title = projectDraftSessionTitle(session.title, unnamedLabelRef.current);',
);
// /review Reviewer tasks are checked first: they never notify on their own.
expect(sidebarUpper).toContain('if (await isReviewSessionNotificationTarget(sessionId)) return;');
expect(sidebarUpper).toContain('const botTitle = await botOwnedSessionNotificationTitle(sessionId);');
// The task sidebar is the only notification owner, also on /bots routes: group
// lanes never notify (docs/product-rules/bot-group-chat.md §3).
expect(sidebarUpper).toContain('if (botTitle === BOT_GROUP_LANE_SESSION) return;');
expect(sidebarUpper).toContain(
'sendSessionEventNotification(sessionId, botTitle ?? unnamedLabelRef.current, kind, options);',
);
expect(sidebarUpper).toContain("unnamedLabelRef.current = t('ccAgent.common.unnamedSession');");
});
});