Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
import { describe, expect, it } from 'vitest';
import {
resolveDeviceLinkDraftDefaults,
resolveDeviceLinkWorktreeEnabled,
shouldReseedDeviceLinkDraftDefaults,
} from '../deviceLinkDraftDefaults';
import type { AgentCapabilities } from '@/hooks/useAgentCapabilities';
import type { CatalogModel, ProviderView } from '@cindy/model-providers';
function providerModel(
id: string,
efforts: CatalogModel['efforts'],
defaultEffort: CatalogModel['defaultEffort'],
): CatalogModel {
return {
id,
name: id,
contextWindow: 200_000,
efforts,
defaultEffort,
effortsUnknown: false,
supportsFastMode: false,
} as CatalogModel;
}
function provider(id: string, model: CatalogModel): ProviderView {
return {
id,
name: id,
source: 'user',
agents: ['pi'],
models: { pi: [model] },
routing: { pi: { upstream: 'https://provider.test', authStrategy: 'none' } },
auth: { method: 'api-key' },
connected: true,
} as unknown as ProviderView;
}
// 最小被控端 capabilities:两模型(Opus 支持 fast + 多 effort 档;Haiku 无 effort/fast)。
function caps(overrides: Partial<AgentCapabilities> = {}): AgentCapabilities {
return {
availableModels: [
{
id: 'claude-opus-4-8',
displayName: 'Opus 4.8',
contextWindow: 1_000_000,
efforts: ['high', 'xhigh'],
defaultEffort: 'high',
supportsFastMode: true,
},
{
id: 'claude-haiku-4-5',
displayName: 'Haiku 4.5',
contextWindow: 200_000,
efforts: [],
defaultEffort: null,
effortsUnknown: false,
supportsFastMode: false,
sortOrder: 10,
newSessionDefault: ['claude-code'],
},
],
hasFastMode: true,
effortLevels: [
{ id: 'high', displayName: 'High' },
{ id: 'xhigh', displayName: 'X-High' },
],
permissionModes: [
{ id: 'acceptEdits', displayName: 'Accept edits' },
{ id: 'bypassPermissions', displayName: 'Bypass' },
],
...overrides,
};
}
describe('resolveDeviceLinkDraftDefaults', () => {
it('被控端草稿值在清单内 → 原样镜像(model/effort/fast/permission/source)', () => {
const sel = resolveDeviceLinkDraftDefaults(caps(), {
model: 'claude-opus-4-8',
effort: 'xhigh',
fastMode: true,
permissionMode: 'bypassPermissions',
providerId: 'anthropic',
});
expect(sel).toEqual({
model: 'claude-opus-4-8',
effort: 'xhigh',
fastMode: true,
permissionMode: 'bypassPermissions',
providerId: 'anthropic',
});
});
it('remoteDraft=null(旧版被控端/拉取失败)→ 回落被控端 capabilities 默认,绝不取本地', () => {
const sel = resolveDeviceLinkDraftDefaults(caps(), null);
expect(sel.model).toBe('claude-opus-4-8'); // availableModels[0]
expect(sel.effort).toBe('high'); // 该模型 defaultEffort
expect(sel.fastMode).toBe(false); // 草稿没开 → 关
expect(sel.permissionMode).toBeUndefined(); // 无草稿权限 → 由 ChatInput 回落
expect(sel.providerId).toBeNull();
});
it('被控端草稿 model 不在清单 → reconcile 到 availableModels[0] + 其默认 effort', () => {
const sel = resolveDeviceLinkDraftDefaults(caps(), {
model: 'gpt-5.4', // 被控端 claude agent 不 offer
effort: 'low',
fastMode: true,
});
expect(sel.model).toBe('claude-opus-4-8');
expect(sel.effort).toBe('high'); // 'low' 不被 Opus 支持 → defaultEffort
});
it('被控端明确未选过模型 → 初始 seed 优先采用其区域目录默认', () => {
const sel = resolveDeviceLinkDraftDefaults(
caps(),
{
model: 'claude-opus-4-8',
modelChosenByUser: false,
effort: 'xhigh',
fastMode: true,
},
undefined,
'claude-code',
);
expect(sel.model).toBe('claude-haiku-4-5');
expect(sel.fastMode).toBe(false);
});
it('显式选择或旧端未知选择状态 → 保留被控端当前模型', () => {
expect(
resolveDeviceLinkDraftDefaults(
caps(),
{ model: 'claude-opus-4-8', modelChosenByUser: true },
undefined,
'claude-code',
).model,
).toBe('claude-opus-4-8');
expect(
resolveDeviceLinkDraftDefaults(caps(), { model: 'claude-opus-4-8' }, undefined, 'claude-code')
.model,
).toBe('claude-opus-4-8');
});
it('被控端已有来源偏好时不应用可能丢失该来源的区域默认', () => {
const sel = resolveDeviceLinkDraftDefaults(
caps(),
{
model: 'claude-opus-4-8',
modelChosenByUser: false,
providerId: 'anthropic',
},
undefined,
'claude-code',
);
expect(sel.model).toBe('claude-opus-4-8');
expect(sel.providerId).toBe('anthropic');
});
it('控制端本次显式 targetModel 优先于远端未选择标记', () => {
const sel = resolveDeviceLinkDraftDefaults(
caps(),
{ model: 'claude-opus-4-8', modelChosenByUser: false },
'claude-opus-4-8',
'claude-code',
);
expect(sel.model).toBe('claude-opus-4-8');
});
it('Pi 的远程新任务默认接受 v3 的 pi 标记', () => {
const capabilities = caps();
capabilities.availableModels[1]!.newSessionDefault = ['pi'];
const sel = resolveDeviceLinkDraftDefaults(
capabilities,
{ model: 'claude-opus-4-8', modelChosenByUser: false },
undefined,
'pi',
);
expect(sel.model).toBe('claude-haiku-4-5');
});
it('Pi 的远程新任务不借用 claude-code 默认标记', () => {
const sel = resolveDeviceLinkDraftDefaults(
caps(),
{ model: 'claude-opus-4-8', modelChosenByUser: false },
undefined,
'pi',
);
expect(sel.model).toBe('claude-opus-4-8');
});
it('effort 不被目标模型支持 → 落该模型 defaultEffort', () => {
const sel = resolveDeviceLinkDraftDefaults(caps(), {
model: 'claude-opus-4-8',
effort: 'low', // Opus 只支持 high/xhigh
});
expect(sel.effort).toBe('high');
});
it('已知无 effort 模型清掉远端草稿里的旧档位', () => {
const sel = resolveDeviceLinkDraftDefaults(caps(), {
model: 'claude-haiku-4-5',
effort: 'high',
fastMode: true,
});
expect(sel.effort).toBeNull();
});
it('按选中的供应商校准 effort,不被同名其他来源的空档位清掉', () => {
const model = 'qwen3:14b';
const capabilities = caps({
availableModels: [
{
id: model,
displayName: model,
contextWindow: 200_000,
efforts: [],
defaultEffort: null,
},
],
});
const sel = resolveDeviceLinkDraftDefaults(
capabilities,
{ model, providerId: 'ollama', effort: 'medium' },
undefined,
'pi',
[
provider('ollama', providerModel(model, ['medium', 'high'], 'high')),
provider('other', providerModel(model, [], null)),
],
);
expect(sel.effort).toBe('medium');
});
it('选中的供应商明确无 effort 时才清掉旧档位', () => {
const model = 'qwen3:14b';
const sel = resolveDeviceLinkDraftDefaults(
caps({
availableModels: [
{
id: model,
displayName: model,
contextWindow: 200_000,
efforts: ['medium', 'high'],
defaultEffort: 'high',
},
],
}),
{ model, providerId: 'ollama', effort: 'medium' },
undefined,
'pi',
[
provider('ollama', providerModel(model, [], null)),
provider('other', providerModel(model, ['medium', 'high'], 'high')),
],
);
expect(sel.effort).toBeNull();
});
it('档位能力尚未声明时保留远端草稿档位', () => {
const capabilities = caps();
capabilities.availableModels[1]!.effortsUnknown = true;
const sel = resolveDeviceLinkDraftDefaults(capabilities, {
model: 'claude-haiku-4-5',
effort: 'high',
});
expect(sel.effort).toBe('high');
});
it.each(['medium', 'high'])('旧主机缺少能力标记时保留远端草稿档位 (%s)', (effort) => {
const capabilities = caps();
delete capabilities.availableModels[1]!.effortsUnknown;
const sel = resolveDeviceLinkDraftDefaults(capabilities, {
model: 'claude-haiku-4-5', effort,
});
expect(sel.effort).toBe(effort);
});
it.each(['medium', 'high'])('旧主机来源条目缺少能力标记时不借用扁平目录清空档位 (%s)', (effort) => {
const model = providerModel('claude-haiku-4-5', [], null);
delete model.effortsUnknown;
const sel = resolveDeviceLinkDraftDefaults(
caps(), { model: model.id, providerId: 'legacy', effort }, undefined, 'pi',
[provider('legacy', model)],
);
expect(sel.effort).toBe(effort);
});
it('模型不支持 fast(或被控端 agent 无 fast 能力)→ fastMode 强制 false', () => {
// 选中无 fast 的 Haiku
const a = resolveDeviceLinkDraftDefaults(caps(), {
model: 'claude-haiku-4-5',
fastMode: true,
});
expect(a.fastMode).toBe(false);
// agent 整体无 fast 能力
const b = resolveDeviceLinkDraftDefaults(caps({ hasFastMode: false }), {
model: 'claude-opus-4-8',
fastMode: true,
});
expect(b.fastMode).toBe(false);
});
it('被控端不支持的 permission 档 → undefined(交 ChatInput 回落)', () => {
const sel = resolveDeviceLinkDraftDefaults(caps(), {
model: 'claude-opus-4-8',
permissionMode: 'plan', // 不在被控端 permissionModes
});
expect(sel.permissionMode).toBeUndefined();
});
// ─── targetModel:切到列表里其它模型时,还原被控端 per-model 记忆 ───────────────
it('切到非当前选中模型 → 用被控端 per-model 记忆,而非沿用上一个模型', () => {
const sel = resolveDeviceLinkDraftDefaults(
caps(),
{
model: 'claude-haiku-4-5', // 被控端当前选中 = Haiku(无 effort/fast)
effort: undefined,
fastMode: false,
effortByModel: { 'claude-opus-4-8': 'xhigh' }, // 被控端为 Opus 记的档
fastModeByModel: { 'claude-opus-4-8': true },
},
'claude-opus-4-8', // 用户在草稿里切到 Opus
);
expect(sel.model).toBe('claude-opus-4-8');
expect(sel.effort).toBe('xhigh'); // 来自 effortByModel[Opus],非当前选中 Haiku 的值
expect(sel.fastMode).toBe(true); // 来自 fastModeByModel[Opus]
});
it('切到的模型被控端无 per-model 记忆 → 回落该模型 capabilities 默认', () => {
const sel = resolveDeviceLinkDraftDefaults(
caps(),
{ model: 'claude-haiku-4-5', effortByModel: {}, fastModeByModel: {} },
'claude-opus-4-8',
);
expect(sel.effort).toBe('high'); // Opus defaultEffort
expect(sel.fastMode).toBe(false);
});
it('切回被控端当前选中模型 → 用草稿激活值(authoritative),不被 per-model 记忆覆盖', () => {
const sel = resolveDeviceLinkDraftDefaults(
caps(),
{
model: 'claude-opus-4-8',
effort: 'xhigh', // 激活档
fastMode: true,
effortByModel: { 'claude-opus-4-8': 'high' }, // 记忆里是 high(与激活档不同)
fastModeByModel: { 'claude-opus-4-8': false },
},
'claude-opus-4-8', // 切回当前模型
);
expect(sel.effort).toBe('xhigh'); // 用激活档,不是记忆的 high
expect(sel.fastMode).toBe(true);
});
it('首页当前显示模型也采用被控端全局模型预设', () => {
const sel = resolveDeviceLinkDraftDefaults(
caps(),
{
model: 'claude-opus-4-8',
effort: 'high',
fastMode: false,
providerModelMemory: {
'claude-code:*': {
effortByModel: { 'claude-opus-4-8': 'xhigh' },
fastByModel: { 'claude-opus-4-8': true },
},
},
},
undefined,
'claude-code',
);
expect(sel.effort).toBe('xhigh');
expect(sel.fastMode).toBe(true);
});
it('* 权威槽优先于 provider 兼容副本', () => {
const sel = resolveDeviceLinkDraftDefaults(
caps(),
{
model: 'claude-opus-4-8',
providerId: 'anthropic',
effort: 'high',
fastMode: false,
providerModelMemory: {
'claude-code:*': {
effortByModel: { 'claude-opus-4-8': 'xhigh' },
fastByModel: {},
},
'claude-code:anthropic': {
effortByModel: { 'claude-opus-4-8': 'high' },
fastByModel: { 'claude-opus-4-8': true },
},
},
},
undefined,
'claude-code',
);
// effort 取权威槽;fast 权威槽没记 → 回落来源副本。
expect(sel.effort).toBe('xhigh');
expect(sel.fastMode).toBe(true);
});
});
describe('shouldReseedDeviceLinkDraftDefaults', () => {
it('recalibrates the same untouched target when the remote explicitly has no model choice', () => {
expect(
shouldReseedDeviceLinkDraftDefaults({
currentSeedKey: 'device-a:claude-code',
nextSeedKey: 'device-a:claude-code',
capabilitiesChanged: true,
controllerTouched: false,
remoteModelChosenByUser: false,
}),
).toBe(true);
});
it('preserves controller edits and remote explicit or legacy-unknown choices', () => {
const base = {
currentSeedKey: 'device-a:claude-code',
nextSeedKey: 'device-a:claude-code',
};
expect(
shouldReseedDeviceLinkDraftDefaults({
...base,
capabilitiesChanged: true,
controllerTouched: true,
remoteModelChosenByUser: false,
}),
).toBe(false);
expect(
shouldReseedDeviceLinkDraftDefaults({
...base,
capabilitiesChanged: true,
controllerTouched: false,
remoteModelChosenByUser: true,
}),
).toBe(false);
expect(
shouldReseedDeviceLinkDraftDefaults({
...base,
capabilitiesChanged: true,
controllerTouched: false,
remoteModelChosenByUser: undefined,
}),
).toBe(false);
expect(
shouldReseedDeviceLinkDraftDefaults({
...base,
capabilitiesChanged: false,
controllerTouched: false,
remoteModelChosenByUser: false,
}),
).toBe(false);
});
it('always seeds a new device or agent target', () => {
expect(
shouldReseedDeviceLinkDraftDefaults({
currentSeedKey: 'device-a:claude-code',
nextSeedKey: 'device-b:codex',
capabilitiesChanged: false,
controllerTouched: true,
remoteModelChosenByUser: true,
}),
).toBe(true);
});
/**
* 统一面板的跨引擎选择(2026-08-17 review 第三轮 G1)。
*
* 「新目标一律重种」这条本身没错 —— 错的是**谁先到**:控制端在远程草稿里跨引擎选了一行,
* switchVendor 让下一帧的 agent 变成目标引擎,seed key 随之变新,于是这条规则拿被控端的
* 远程默认值把用户刚点的模型盖掉。修法是让那次显式选择**前置**把 key 推到目标引擎,
* 这一组就是那前后两种输入的对照。
*/
it('treats a cross-engine pick as its own seed once the key was advanced', () => {
// 没前置(旧行为):agent 一变就是「新目标」→ 无条件重种 → 用户刚选的模型被远程默认覆盖。
expect(
shouldReseedDeviceLinkDraftDefaults({
currentSeedKey: 'device-a:claude-code',
nextSeedKey: 'device-a:codex',
capabilitiesChanged: true,
controllerTouched: true,
remoteModelChosenByUser: true,
}),
).toBe(true);
// 前置之后:同一目标 + 控制端已编辑 → 不重种。目标引擎的 capabilities 到货那一帧只做
// 合法性夹紧(保留 current.model),用户的选择留在草稿里。
expect(
shouldReseedDeviceLinkDraftDefaults({
currentSeedKey: 'device-a:codex',
nextSeedKey: 'device-a:codex',
capabilitiesChanged: true,
controllerTouched: true,
remoteModelChosenByUser: true,
}),
).toBe(false);
// 重复渲染 / 重复播种窗口:key 已被显式选择占住,后续每一帧都判成同一目标,同样不重种。
expect(
shouldReseedDeviceLinkDraftDefaults({
currentSeedKey: 'device-a:codex',
nextSeedKey: 'device-a:codex',
capabilitiesChanged: false,
controllerTouched: true,
remoteModelChosenByUser: false,
}),
).toBe(false);
// 换设备仍然照常重种(这次前置只影响「同设备换引擎」,不能顺手把换机也挡掉)。
expect(
shouldReseedDeviceLinkDraftDefaults({
currentSeedKey: 'device-a:codex',
nextSeedKey: 'device-b:codex',
capabilitiesChanged: true,
controllerTouched: true,
remoteModelChosenByUser: true,
}),
).toBe(true);
});
});
// 回归:在远程电脑上选项目(设备域浏览器)时,新设备快照与切设备同批到达,旧实现的
// 「先镜像、后重置」两段 effect 把被控端已勾选的 worktree 压回未勾选,会话于是不建
// worktree、落在被控端仓库当前(默认)分支上,用户选的源分支被静默忽略。
describe('resolveDeviceLinkWorktreeEnabled', () => {
const ready = (worktreeEnabled?: boolean) => ({
status: 'ready' as const,
value: worktreeEnabled === undefined ? {} : { worktreeEnabled },
});
const deviceA = { deviceId: 'device-a', remoteDraftState: ready(false) };
it.each([
['切设备且同批带来新设备快照 → 采用被控端勾选记忆', deviceA, { deviceId: 'device-b', remoteDraftState: ready(true) }, true],
['切设备但快照仍是上一台那份 → 回到未勾选,不串台', deviceA, { deviceId: 'device-b', remoteDraftState: deviceA.remoteDraftState }, false],
['同设备快照缺字段 → 保持当前显示', deviceA, { deviceId: 'device-a', remoteDraftState: ready() }, null],
] as const)('%s', (_name, previous, current, expected) => {
expect(resolveDeviceLinkWorktreeEnabled(previous, current)).toBe(expected);
});
});
describe('capabilities refresh clamp contract', () => {
it('保留仍合法的控制端选择,但会夹紧已失效的模型与运行参数', () => {
const refreshed = caps();
refreshed.availableModels = [
{
id: 'claude-haiku-4-5',
displayName: 'Haiku',
contextWindow: 200_000,
efforts: ['low'],
defaultEffort: 'low',
supportsFastMode: false,
},
];
refreshed.permissionModes = [{ id: 'default', displayName: 'Default' }];
expect(
resolveDeviceLinkDraftDefaults(
refreshed,
{
model: 'removed-model',
modelChosenByUser: true,
effort: 'high',
fastMode: true,
permissionMode: 'bypassPermissions',
providerId: 'anthropic',
},
'removed-model',
),
).toEqual({
model: 'claude-haiku-4-5',
effort: 'low',
fastMode: false,
permissionMode: undefined,
providerId: 'anthropic',
});
});
});