pi-model-manager 0.1.0

package/tui/persistent-menu.ts

@@ -0,0 +1,349 @@
+// tui/persistent-menu.ts
+//
+// 共享的"光标记忆"菜单组件，用 ctx.ui.custom 实现。
+// 调用方在循环间持有 cursor: { index } 引用，菜单进出时光标位置不丢。
+//
+// 设计：列表页保留 KISS 的键盘模型，同时支持摘要、列头、详情区、底部快捷键。
+// 表单页另有 Ctrl+S 保存；列表页可注册单键快捷操作，并用 / 做轻量过滤。
+
+import type { ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
+import { Key, matchesKey, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+
+export interface MenuRow {
+	id: string;
+	label: string;
+	description?: string | readonly string[];
+}
+
+export interface PersistentMenuOptions {
+	summaryLines?: readonly string[];
+	tableHeader?: string;
+	getDetailLines?: (selectedRow: MenuRow | undefined) => readonly string[];
+	footer?: string;
+	emptyLabel?: string;
+	visibleRows?: number;
+	searchable?: boolean;
+}
+
+export interface PersistentFormMenuOptions extends PersistentMenuOptions {
+	adjustableRowIds?: readonly string[];
+}
+
+export type MenuAction =
+	| { type: "pick"; id: string }
+	| { type: "cancel" };
+
+export type HorizontalDirection = "left" | "right";
+export type FormMenuAction = MenuAction | { type: "save" } | { type: "adjust"; id: string; direction: HorizontalDirection };
+
+export type ShortcutMenuAction<TShortcut extends string = string> = MenuAction | { type: "shortcut"; shortcut: TShortcut };
+
+export interface MenuShortcut<TShortcut extends string = string> {
+	input: string;
+	shortcut: TShortcut;
+}
+
+export interface MenuCursor {
+	index: number;
+}
+
+function clampIndex(index: number, length: number): number {
+	if (length <= 0) return 0;
+	return Math.min(Math.max(0, index), length - 1);
+}
+
+function padToVisibleWidth(text: string, targetWidth: number): string {
+	const pad = Math.max(0, targetWidth - visibleWidth(text));
+	return text + " ".repeat(pad);
+}
+
+export function padLabel(label: string, columns: number): string {
+	return padToVisibleWidth(label, columns);
+}
+
+function getDescriptionLines(row: MenuRow): string[] {
+	const source = row.description;
+	return typeof source === "string" ? source.split("\n") : [...(source ?? [])];
+}
+
+function getSearchText(row: MenuRow): string {
+	return [row.id, row.label, ...getDescriptionLines(row)].join("\n").toLocaleLowerCase();
+}
+
+function filterRows(rows: MenuRow[], query: string): MenuRow[] {
+	const needle = query.trim().toLocaleLowerCase();
+	if (!needle) return rows;
+	return rows.filter((row) => getSearchText(row).includes(needle));
+}
+
+function isSearchTextInput(data: string): boolean {
+	return data.length > 0 && !data.startsWith("\x1b") && !/[\u0000-\u001f\u007f]/.test(data);
+}
+
+function createPersistentMenu<TAction extends MenuAction | FormMenuAction | ShortcutMenuAction>(
+	ctx: ExtensionCommandContext,
+	title: string,
+	help: string,
+	rows: MenuRow[],
+	cursor: MenuCursor,
+	createSaveAction: (() => TAction) | undefined,
+	shortcuts: MenuShortcut[],
+	createAdjustAction: ((id: string, direction: HorizontalDirection) => TAction) | undefined = undefined,
+	adjustableRowIds: ReadonlySet<string> = new Set(),
+	options: PersistentMenuOptions = {},
+): Promise<TAction> {
+	cursor.index = clampIndex(cursor.index, rows.length);
+	return ctx.ui.custom<TAction>((tui, theme, _keybindings, done) => {
+		let selectedIndex = clampIndex(cursor.index, rows.length);
+		let searchActive = false;
+		let searchQuery = "";
+		const visibleRows = options.visibleRows ?? 18;
+		const searchable = options.searchable ?? false;
+
+		const getActiveRows = (): MenuRow[] => searchable ? filterRows(rows, searchQuery) : rows;
+
+		const syncCursor = (activeRows: MenuRow[]): void => {
+			const row = activeRows[selectedIndex];
+			cursor.index = row ? rows.indexOf(row) : rows.length;
+		};
+
+		const requestRender = (): void => {
+			const activeRows = getActiveRows();
+			selectedIndex = clampIndex(selectedIndex, activeRows.length);
+			syncCursor(activeRows);
+			tui.requestRender();
+		};
+
+		const clearSearch = (): boolean => {
+			if (!searchable || (!searchActive && !searchQuery)) return false;
+			searchActive = false;
+			searchQuery = "";
+			selectedIndex = clampIndex(cursor.index, rows.length);
+			requestRender();
+			return true;
+		};
+
+		const pickSelected = (): void => {
+			const activeRows = getActiveRows();
+			const row = activeRows[selectedIndex];
+			if (!row) return;
+			syncCursor(activeRows);
+			done({ type: "pick", id: row.id } as TAction);
+		};
+
+		const moveSelection = (nextIndex: number): void => {
+			selectedIndex = nextIndex;
+			requestRender();
+		};
+
+		return {
+			invalidate(): void {},
+			handleInput(data: string): void {
+				if (createSaveAction && matchesKey(data, Key.ctrl("s"))) {
+					syncCursor(getActiveRows());
+					done(createSaveAction());
+					return;
+				}
+				const horizontalDirection: HorizontalDirection | undefined = matchesKey(data, Key.left)
+					? "left"
+					: matchesKey(data, Key.right)
+						? "right"
+						: undefined;
+				if (horizontalDirection && createAdjustAction) {
+					const row = getActiveRows()[selectedIndex];
+					if (row && adjustableRowIds.has(row.id)) {
+						syncCursor(getActiveRows());
+						done(createAdjustAction(row.id, horizontalDirection));
+					}
+					return;
+				}
+
+				if (searchable && (matchesKey(data, Key.escape) || matchesKey(data, Key.ctrl("c")))) {
+					if (clearSearch()) return;
+					done({ type: "cancel" } as TAction);
+					return;
+				}
+
+				// 搜索激活后，可打印字符必须进入查询，不能触发同名的菜单快捷键。
+				if (searchable && searchActive) {
+					if (matchesKey(data, Key.backspace)) {
+						searchQuery = searchQuery.slice(0, -1);
+						selectedIndex = 0;
+						requestRender();
+						return;
+					}
+					if (matchesKey(data, Key.enter)) {
+						pickSelected();
+						return;
+					}
+					if (isSearchTextInput(data)) {
+						searchQuery += data;
+						selectedIndex = 0;
+						requestRender();
+						return;
+					}
+				}
+
+				const shortcut = shortcuts.find((candidate) => candidate.input === data);
+				if (shortcut) {
+					syncCursor(getActiveRows());
+					done({ type: "shortcut", shortcut: shortcut.shortcut } as TAction);
+					return;
+				}
+				if (searchable && data === "/") {
+					searchActive = true;
+					requestRender();
+					return;
+				}
+
+				if (matchesKey(data, Key.escape) || matchesKey(data, Key.ctrl("c"))) {
+					done({ type: "cancel" } as TAction);
+					return;
+				}
+				if (matchesKey(data, Key.enter)) {
+					pickSelected();
+					return;
+				}
+
+				const activeRows = getActiveRows();
+				if (matchesKey(data, Key.up)) {
+					moveSelection(Math.max(0, selectedIndex - 1));
+					return;
+				}
+				if (matchesKey(data, Key.down)) {
+					moveSelection(Math.min(activeRows.length - 1, selectedIndex + 1));
+					return;
+				}
+				if (matchesKey(data, Key.pageUp)) {
+					moveSelection(Math.max(0, selectedIndex - visibleRows));
+					return;
+				}
+				if (matchesKey(data, Key.pageDown)) {
+					moveSelection(Math.min(activeRows.length - 1, selectedIndex + visibleRows));
+					return;
+				}
+				if (matchesKey(data, Key.home)) {
+					moveSelection(0);
+					return;
+				}
+				if (matchesKey(data, Key.end)) {
+					moveSelection(activeRows.length - 1);
+					return;
+				}
+			},
+			render(width: number): string[] {
+				const activeRows = getActiveRows();
+				selectedIndex = clampIndex(selectedIndex, activeRows.length);
+				syncCursor(activeRows);
+				const windowStart = Math.max(
+					0,
+					Math.min(selectedIndex - Math.floor(visibleRows / 2), Math.max(0, activeRows.length - visibleRows)),
+				);
+				const shownRows = activeRows.slice(windowStart, windowStart + visibleRows);
+
+				const border = theme.fg("borderMuted", "─".repeat(Math.max(0, Math.min(width, 100))));
+				const summaryLines = options.summaryLines ?? (help ? help.split("\n") : []);
+				const lines: string[] = [
+					border,
+					truncateToWidth(theme.fg("accent", theme.bold(title)), width),
+				];
+
+				for (const line of summaryLines) {
+					lines.push(truncateToWidth(theme.fg("dim", line), width));
+				}
+				if (searchable && searchActive) {
+					lines.push(truncateToWidth(theme.fg("accent", `搜索：${searchQuery || "<输入关键词>"}`), width));
+				}
+				lines.push("");
+
+				if (options.tableHeader) {
+					lines.push(truncateToWidth(theme.fg("dim", options.tableHeader), width));
+				}
+
+				if (shownRows.length === 0) {
+					const emptyLabel = searchQuery ? `无匹配项：${searchQuery}` : options.emptyLabel ?? "暂无条目";
+					lines.push(truncateToWidth(theme.fg("dim", `  ${emptyLabel}`), width));
+				} else {
+					for (let i = 0; i < shownRows.length; i += 1) {
+						const absoluteIndex = windowStart + i;
+						const row = shownRows[i]!;
+						const selected = absoluteIndex === selectedIndex;
+						const prefix = selected ? "❯ " : "  ";
+						const line = `${prefix}${row.label}`;
+						lines.push(truncateToWidth(selected ? theme.fg("accent", line) : line, width));
+						for (const description of getDescriptionLines(row)) {
+							lines.push(truncateToWidth(theme.fg("dim", `    ${description}`), width));
+						}
+					}
+				}
+
+				const detailLines = options.getDetailLines?.(activeRows[selectedIndex]) ?? [];
+				if (detailLines.length > 0) {
+					lines.push("", border);
+					for (const line of detailLines) {
+						lines.push(truncateToWidth(theme.fg("dim", line), width));
+					}
+				}
+
+				const footerLines = options.footer ? options.footer.split("\n") : [];
+				if (searchable) {
+					footerLines.push(searchActive ? `/ 搜索：${searchQuery || "<输入关键词>"}   Backspace 删除   Esc 清空` : "/ 搜索");
+				}
+				if (footerLines.length > 0) {
+					lines.push("");
+					for (const line of footerLines) {
+						lines.push(truncateToWidth(theme.fg("dim", line), width));
+					}
+				}
+
+				lines.push(border);
+				return lines.map((line) => truncateToWidth(line, width));
+			},
+		};
+	});
+}
+
+export async function showPersistentMenu(
+	ctx: ExtensionCommandContext,
+	title: string,
+	help: string,
+	rows: MenuRow[],
+	cursor: MenuCursor,
+	options: PersistentMenuOptions = {},
+): Promise<MenuAction> {
+	return createPersistentMenu<MenuAction>(ctx, title, help, rows, cursor, undefined, [], undefined, undefined, options);
+}
+
+export async function showPersistentFormMenu(
+	ctx: ExtensionCommandContext,
+	title: string,
+	help: string,
+	rows: MenuRow[],
+	cursor: MenuCursor,
+	options: PersistentFormMenuOptions = {},
+): Promise<FormMenuAction> {
+	return createPersistentMenu<FormMenuAction>(
+		ctx,
+		title,
+		help,
+		rows,
+		cursor,
+		() => ({ type: "save" }),
+		[],
+		(id, direction) => ({ type: "adjust", id, direction }),
+		new Set(options.adjustableRowIds ?? []),
+		options,
+	);
+}
+
+export async function showPersistentShortcutMenu<TShortcut extends string>(
+	ctx: ExtensionCommandContext,
+	title: string,
+	help: string,
+	rows: MenuRow[],
+	cursor: MenuCursor,
+	shortcuts: MenuShortcut<TShortcut>[],
+	options: PersistentMenuOptions = {},
+): Promise<ShortcutMenuAction<TShortcut>> {
+	return createPersistentMenu<ShortcutMenuAction<TShortcut>>(ctx, title, help, rows, cursor, undefined, shortcuts, undefined, undefined, { searchable: true, ...options });
+}

package/tui/ui-helpers.ts

@@ -0,0 +1,289 @@
+// tui/ui-helpers.ts
+//
+// 共用展示助手：把 stored / draft 数据格式化成 UI 字符串。
+//
+// dashboard 行设计准则：信息密度千万不要满。
+//   - 主列表使用固定列 + 选中详情；行内只放扫描所需信息
+//   - api 用短标签（Responses / Claude），详情区再显示完整上下文
+//   - auth 状态文本化为 key/env/cmd/auth?，避免把可选的外部认证误报成缺失
+//   - contextWindow 用 K/M 简写
+
+import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+import { getApiKeyEnvVarName, getAuthStatusText, getProviderDisplayName } from "../state-document.ts";
+import { CLIENT_HEADER_PROFILE_LABELS, getClientHeaderProfileDisplay, resolveClientHeaderProfile } from "../presets/client-headers.ts";
+import type {
+	ApiKind,
+	ClientHeaderProfileId,
+	ModelInputKind,
+	StoredModel,
+	StoredProvider,
+	StoredRequestHeaderProfile,
+} from "../types.ts";
+
+export function maskSecret(value: string | undefined): string {
+	if (!value) return "<未填写>";
+	if (getApiKeyEnvVarName(value) || value.startsWith("!")) return value;
+	return "********";
+}
+
+function authIcon(apiKey: string | undefined): string {
+	const status = getAuthStatusText(apiKey);
+	if (status === "no apiKey") return "?";
+	if (status === "command apiKey") return "$";
+	if (status.startsWith("env missing:")) return "⚠";
+	if (status.startsWith("env ")) return "✓";
+	return "•";
+}
+
+function formatContextWindow(contextWindow: number): string {
+	if (contextWindow >= 1_000_000) return `${(contextWindow / 1_000_000).toFixed(contextWindow % 1_000_000 === 0 ? 0 : 1)}M`;
+	if (contextWindow >= 1_000) return `${Math.round(contextWindow / 1_000)}K`;
+	return String(contextWindow);
+}
+
+
+type ColumnAlign = "left" | "right";
+
+interface FixedColumn {
+	text: string;
+	width: number;
+	align?: ColumnAlign;
+}
+
+export function fitColumn(text: string, columns: number, align: ColumnAlign = "left"): string {
+	const clipped = truncateToWidth(text, columns, "…");
+	const pad = " ".repeat(Math.max(0, columns - visibleWidth(clipped)));
+	return align === "right" ? pad + clipped : clipped + pad;
+}
+
+export function joinFixedColumns(columns: readonly FixedColumn[], gap = "  "): string {
+	return columns.map((column) => fitColumn(column.text, column.width, column.align)).join(gap).trimEnd();
+}
+
+export function formatTableHeader(line: string): string {
+	return `  ${line}`;
+}
+
+function sanitizeEndpoint(value: string): string {
+	return value.replace(/([?&](?:key|api_key|api-key)=)[^&]+/gi, "$1REDACTED");
+}
+
+export function formatApiShort(api: ApiKind): string {
+	if (api === "openai-responses") return "Responses";
+	if (api === "openai-completions") return "Chat";
+	if (api === "anthropic-messages") return "Claude";
+	if (api === "google-generative-ai") return "Gemini";
+	return api;
+}
+
+function getAuthKind(apiKey: string | undefined): string {
+	const status = getAuthStatusText(apiKey);
+	if (status === "no apiKey") return "auth?";
+	if (status === "command apiKey") return "cmd";
+	if (status.startsWith("env missing:")) return "miss";
+	if (status.startsWith("env ")) return "env";
+	return "key";
+}
+
+function getProviderStatus(provider: StoredProvider): string {
+	const auth = getAuthKind(provider.apiKey);
+	return auth === "miss" || auth === "auth?" ? "check" : "ready";
+}
+
+function getProviderProxyText(provider: StoredProvider): string {
+	return provider.httpProxyEnabled ? "proxy" : "direct";
+}
+
+export function formatProviderHeaderProfile(
+	provider: StoredProvider,
+	requestHeaderProfiles: Record<string, StoredRequestHeaderProfile> = {},
+): string {
+	if (provider.clientHeaderProfile === "recommended") {
+		const resolved = resolveClientHeaderProfile(provider.clientHeaderProfile, provider.api);
+		return `Auto→${CLIENT_HEADER_PROFILE_LABELS[resolved]}`;
+	}
+	if (provider.clientHeaderProfile === "disabled") return "Off";
+	if (provider.clientHeaderProfile === "custom") {
+		if (provider.requestHeaderProfileId) {
+			const profile = requestHeaderProfiles[provider.requestHeaderProfileId];
+			return profile ? `Custom:${profile.name}` : `Custom:${provider.requestHeaderProfileId}`;
+		}
+		const inlineCount = Object.keys(provider.customClientHeaders ?? {}).length;
+		return inlineCount > 0 ? `Inline(${inlineCount})` : "Custom?";
+	}
+	return CLIENT_HEADER_PROFILE_LABELS[provider.clientHeaderProfile];
+}
+
+export const PROVIDER_CONSOLE_HEADER = formatTableHeader(joinFixedColumns([
+	{ text: "接入", width: 22 },
+	{ text: "API", width: 9 },
+	{ text: "模型", width: 6, align: "right" },
+	{ text: "请求头", width: 15 },
+	{ text: "代理", width: 6 },
+	{ text: "认证", width: 6 },
+	{ text: "状态", width: 5 },
+]));
+
+function getModelListColumns(provider: StoredProvider): FixedColumn[] {
+	const columns: FixedColumn[] = [
+		{ text: "模型 ID", width: 30 },
+		{ text: "显示名", width: 16 },
+		{ text: "输入", width: 10 },
+		{ text: "Thinking", width: 8 },
+		{ text: "上下文", width: 7, align: "right" },
+		{ text: "输出", width: 7, align: "right" },
+	];
+	if (provider.api === "openai-responses") columns.push({ text: "Fast", width: 8 });
+	return columns;
+}
+
+export function formatModelListHeader(provider: StoredProvider): string {
+	return formatTableHeader(joinFixedColumns(getModelListColumns(provider)));
+}
+
+export function formatProviderConsoleRow(
+	providerId: string,
+	provider: StoredProvider,
+	requestHeaderProfiles: Record<string, StoredRequestHeaderProfile> = {},
+): string {
+	const name = getProviderDisplayName(providerId, provider);
+	const displayName = name === providerId ? providerId : `${name} (${providerId})`;
+	return joinFixedColumns([
+		{ text: displayName, width: 22 },
+		{ text: formatApiShort(provider.api), width: 9 },
+		{ text: String(provider.models.length), width: 6, align: "right" },
+		{ text: formatProviderHeaderProfile(provider, requestHeaderProfiles), width: 15 },
+		{ text: getProviderProxyText(provider), width: 6 },
+		{ text: getAuthKind(provider.apiKey), width: 6 },
+		{ text: getProviderStatus(provider), width: 5 },
+	]);
+}
+export function formatProviderRow(providerId: string, provider: StoredProvider): string {
+	const name = getProviderDisplayName(providerId, provider);
+	const head = name === providerId ? providerId : `${name} (${providerId})`;
+	return `${head} · ${provider.api} · ${provider.models.length}模型 · ${authIcon(provider.apiKey)}`;
+}
+
+export function formatProviderDetailLines(
+	providerId: string,
+	provider: StoredProvider,
+	requestHeaderProfiles: Record<string, StoredRequestHeaderProfile> = {},
+): string[] {
+	const name = getProviderDisplayName(providerId, provider);
+	const title = name === providerId ? providerId : `${name} (${providerId})`;
+	const modelIds = provider.models.map((model) => model.id).join(", ") || "<无模型>";
+	return [
+		title,
+		`  endpoint  ${sanitizeEndpoint(provider.baseUrl)}`,
+		`  proxy     ${provider.httpProxyEnabled ? sanitizeEndpoint(provider.httpProxyUrl ?? "http://127.0.0.1:7890") : "direct"}`,
+		`  api       ${formatApiShort(provider.api)} · headers ${formatProviderHeaderProfile(provider, requestHeaderProfiles)} · auth ${getAuthKind(provider.apiKey)}`,
+		`  models    ${modelIds}`,
+	];
+}
+
+export function formatProviderSummaryLine(
+	provider: StoredProvider,
+	requestHeaderProfiles: Record<string, StoredRequestHeaderProfile> = {},
+): string {
+	return `${formatApiShort(provider.api)} · ${provider.models.length} 模型 · headers ${formatProviderHeaderProfile(provider, requestHeaderProfiles)} · proxy ${getProviderProxyText(provider)} · auth ${getAuthKind(provider.apiKey)}`;
+}
+
+export function formatProviderEndpointLine(provider: StoredProvider): string {
+	const proxy = provider.httpProxyEnabled ? ` · proxy ${sanitizeEndpoint(provider.httpProxyUrl ?? "http://127.0.0.1:7890")}` : "";
+	return `endpoint  ${sanitizeEndpoint(provider.baseUrl)}${proxy}`;
+}
+
+function getThinkingFlag(model: StoredModel): string | undefined {
+	if (!model.reasoning) return undefined;
+	const map = model.thinkingLevelMap;
+	if (map?.max === "max" && map.xhigh === "xhigh") return "think:xhigh/max";
+	if (map?.max === "max") return "think:max";
+	return "think";
+}
+
+export function formatModelRow(model: StoredModel): string {
+	const flags: string[] = [];
+	const thinkingFlag = getThinkingFlag(model);
+	if (thinkingFlag) flags.push(thinkingFlag);
+	flags.push(model.input.includes("image") ? "视觉" : "文本");
+	flags.push(`${formatContextWindow(model.contextWindow)}ctx`);
+	const suffix = model.name && model.name !== model.id ? ` “${model.name}”` : "";
+	return `${model.id}${suffix} · ${flags.join(" · ")}`;
+}
+
+function formatModelNameCell(model: StoredModel): string {
+	return model.name && model.name !== model.id ? model.name : "默认";
+}
+
+function formatModelInputCell(model: StoredModel): string {
+	return model.input.includes("image") ? "文本,视觉" : "文本";
+}
+
+function formatModelThinkingCell(model: StoredModel): string {
+	return model.reasoning ? "开" : "关";
+}
+
+export function formatModelConsoleRow(model: StoredModel): string {
+	return joinFixedColumns([
+		{ text: model.id, width: 34 },
+		{ text: formatModelInputCell(model), width: 12 },
+		{ text: formatModelThinkingCell(model), width: 8 },
+		{ text: formatContextWindow(model.contextWindow), width: 7, align: "right" },
+		{ text: formatContextWindow(model.maxTokens), width: 7, align: "right" },
+		{ text: model.openAIServiceTier === "priority" ? "priority" : "-", width: 8 },
+	]);
+}
+
+export function formatModelListRow(provider: StoredProvider, model: StoredModel): string {
+	const columns: FixedColumn[] = [
+		{ text: model.id, width: 30 },
+		{ text: formatModelNameCell(model), width: 16 },
+		{ text: formatModelInputCell(model), width: 10 },
+		{ text: formatModelThinkingCell(model), width: 8 },
+		{ text: formatContextWindow(model.contextWindow), width: 7, align: "right" },
+		{ text: formatContextWindow(model.maxTokens), width: 7, align: "right" },
+	];
+	if (provider.api === "openai-responses") {
+		columns.push({ text: model.openAIServiceTier === "priority" ? "priority" : "off", width: 8 });
+	}
+	return joinFixedColumns(columns);
+}
+
+export const API_CHOICES: { id: ApiKind; label: string }[] = [
+	{ id: "openai-responses", label: "OpenAI Responses · 标准 instructions/input wire" },
+	{ id: "openai-completions", label: "OpenAI Chat · 传统 chat/completions 兼容" },
+	{ id: "anthropic-messages", label: "Anthropic Messages · Claude / Claude Code 兼容" },
+	{ id: "google-generative-ai", label: "Google Gemini · Gemini 原生 API" },
+];
+
+export const BUILT_IN_PROFILE_CHOICES: { id: Exclude<ClientHeaderProfileId, "custom">; label: string }[] = [
+	{ id: "recommended", label: "自动推荐" },
+	{ id: "disabled", label: "不添加" },
+	{ id: "claude-code", label: "ClaudeCode" },
+	{ id: "codex-cli", label: "Codex" },
+];
+
+export function describeProfile(
+	profile: ClientHeaderProfileId,
+	api: ApiKind,
+	requestHeaderProfileId?: string,
+	requestHeaderProfiles: Record<string, StoredRequestHeaderProfile> = {},
+): string {
+	if (profile !== "custom") return getClientHeaderProfileDisplay(profile, api);
+	if (!requestHeaderProfileId) return "自定义请求头（未选择）";
+	const selected = requestHeaderProfiles[requestHeaderProfileId];
+	return selected ? `${selected.name} (${requestHeaderProfileId})` : `自定义请求头缺失：${requestHeaderProfileId}`;
+}
+
+export const VISION_INPUT_CHOICES: { enabled: boolean; kinds: ModelInputKind[]; label: string }[] = [
+	{ enabled: false, kinds: ["text"], label: "关闭 — 仅文本输入" },
+	{ enabled: true, kinds: ["text", "image"], label: "开启 — 支持视觉（文本 + 图片）" },
+];
+
+export function supportsVisionInput(kinds: ModelInputKind[]): boolean {
+	return kinds.includes("image");
+}
+
+export function describeVisionInput(kinds: ModelInputKind[]): string {
+	return supportsVisionInput(kinds) ? "开启 · 支持视觉" : "关闭 · 仅文本";
+}