@rexvane/piweb 0.3.1

package/src/lib/plugins-service.ts

@@ -0,0 +1,312 @@
+/**
+ * plugins-service：pi 包与扩展的清单、安装/卸载/更新/启用/停用（与 pi 运行时完全同步与持久化）。
+ */
+import fs from "node:fs/promises";
+import path from "node:path";
+import { randomUUID } from "node:crypto";
+import { getAgentDir, getPackageManager, getResourceLoader, getSettingsManager, reloadAllLoaders, resourceLoaderReady } from "./pi";
+import { reloadSessionsForCwd } from "./agent-manager";
+import { flushSettingsOrThrow, withExternalSettingsLock, withSettingsWriteLock } from "./settings-write-lock";
+
+export interface PackageView {
+	source: string;
+	scope: "user" | "project";
+	installedPath?: string;
+	resources: { extensions: number; skills: number; prompts: number; themes: number };
+	disabled: boolean;
+}
+
+export interface ExtensionView {
+	name: string;
+	path: string;
+	disabled: boolean;
+	/** 加载失败的原因（语法错误、依赖缺失等），来自 pi 资源加载器 */
+	error?: string;
+}
+
+/**
+ * pi 的启用/停用语义（core/package-manager.js isEnabledByOverrides）：
+ * settings.extensions 里 `-<path>` 强制排除、`+<path>` 强制包含，路径相对于该 settings 所在的基目录。
+ * 之前 PiWeb 写的 disabledExtensions 键 pi 根本不读，开关是假的。
+ */
+function extensionPattern(extPath: string, baseDir: string): string {
+	const rel = path.relative(baseDir, extPath).replace(/\\/g, "/");
+	return rel && !rel.startsWith("..") ? rel : extPath.replace(/\\/g, "/");
+}
+
+function isForceExcluded(extPath: string, patterns: string[], baseDir: string): boolean {
+	const rel = path.relative(baseDir, extPath).replace(/\\/g, "/");
+	const abs = extPath.replace(/\\/g, "/");
+	const norm = (p: string) => (p.startsWith("./") ? p.slice(2) : p).replace(/\\/g, "/");
+	return patterns.some((p) => p.startsWith("-") && [rel, abs].includes(norm(p.slice(1))));
+}
+
+/** 全部变更后的统一收尾：加载器就地重载 + 活跃会话 session.reload() + 广播新清单；全局变更影响所有目录 */
+async function applyResourceChange(cwd: string, scope: "user" | "project"): Promise<void> {
+	await reloadAllLoaders();
+	await reloadSessionsForCwd(scope === "project" ? cwd : undefined);
+}
+
+async function readSettingsFile(filePath: string): Promise<Record<string, unknown>> {
+	try {
+		return await readSettingsFileStrict(filePath);
+	} catch {
+		return {};
+	}
+}
+
+async function readSettingsFileStrict(filePath: string): Promise<Record<string, unknown>> {
+	let text: string;
+	try {
+		text = await fs.readFile(filePath, "utf8");
+	} catch (error) {
+		if ((error as NodeJS.ErrnoException).code === "ENOENT") return {};
+		throw error;
+	}
+	const parsed: unknown = JSON.parse(text.replace(/^\uFEFF/, ""));
+	if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) throw new Error(`${filePath} must contain a JSON object`);
+	return parsed as Record<string, unknown>;
+}
+
+async function prepareSettingsWrite(cwd: string, file: string): Promise<ReturnType<typeof getSettingsManager>> {
+	await readSettingsFileStrict(file);
+	const manager = getSettingsManager(cwd);
+	await flushSettingsOrThrow(manager);
+	// Another cwd's manager may have changed the same global array since our last read.
+	await manager.reload();
+	await flushSettingsOrThrow(manager);
+	return manager;
+}
+
+async function verifySettingsField(file: string, field: "extensions" | "packages", expected: unknown): Promise<void> {
+	const persisted = await readSettingsFileStrict(file);
+	if (JSON.stringify(persisted[field] ?? []) !== JSON.stringify(expected ?? [])) {
+		throw new Error(`Pi settings ${field} was not persisted`);
+	}
+}
+
+async function writeSettingsFile(filePath: string, data: Record<string, unknown>): Promise<void> {
+	await fs.mkdir(path.dirname(filePath), { recursive: true });
+	const temporary = `${filePath}.${process.pid}.${randomUUID()}.tmp`;
+	try {
+		await fs.writeFile(temporary, JSON.stringify(data, null, "\t"), "utf8");
+		await fs.rename(temporary, filePath);
+	} finally {
+		await fs.rm(temporary, { force: true }).catch(() => undefined);
+	}
+}
+
+async function countResources(installedPath: string): Promise<PackageView["resources"]> {
+	const out = { extensions: 0, skills: 0, prompts: 0, themes: 0 };
+	const dirs: (keyof PackageView["resources"] | "prompts")[] = ["extensions", "skills", "prompts", "themes"];
+	// 包可能直接就是资源目录，也可能带 src/dist；按约定目录统计
+	const candidates = [installedPath, path.join(installedPath, "dist")];
+	for (const base of candidates) {
+		for (const d of dirs) {
+			try {
+				const entries = await fs.readdir(path.join(base, d), { withFileTypes: true });
+				if (d === "extensions") {
+					out.extensions += entries.filter((e) => e.isFile() && /\.(ts|js)$/.test(e.name)).length;
+				} else if (d === "skills") {
+					out.skills += entries.filter((e) => e.isDirectory()).length;
+				} else if (d === "prompts") {
+					out.prompts += entries.filter((e) => e.isFile() && /\.md$/.test(e.name)).length;
+				} else if (d === "themes") {
+					out.themes += entries.filter((e) => e.isFile() && /\.json$/.test(e.name)).length;
+				}
+			} catch {
+				/* 目录不存在 */
+			}
+		}
+	}
+	return out;
+}
+
+export async function listPackages(cwd: string): Promise<PackageView[]> {
+	const pm = getPackageManager(cwd);
+	const configured = pm.listConfiguredPackages();
+
+	const globalSettings = await readSettingsFile(path.join(getAgentDir(), "settings.json"));
+	const projectSettings = await readSettingsFile(path.join(cwd, ".pi", "settings.json"));
+
+	const sourceOf = (p: unknown): string => (typeof p === "string" ? p : String((p as { source?: string } | null)?.source ?? ""));
+	const userDisabled = (Array.isArray(globalSettings.disabledPackages) ? globalSettings.disabledPackages : []).map(sourceOf).filter(Boolean);
+	const projectDisabled = (Array.isArray(projectSettings.disabledPackages) ? projectSettings.disabledPackages : []).map(sourceOf).filter(Boolean);
+
+	const out: PackageView[] = [];
+	const seen = new Set<string>();
+
+	// 1. 活跃配置包（已启用）
+	for (const p of configured) {
+		const key = `${p.scope}:${p.source}`;
+		seen.add(key);
+		const installedPath = p.installedPath ?? pm.getInstalledPath(p.source, p.scope);
+		const resources = installedPath ? await countResources(installedPath) : { extensions: 0, skills: 0, prompts: 0, themes: 0 };
+		out.push({ source: p.source, scope: p.scope, installedPath, resources, disabled: false });
+	}
+
+	// 2. 停用包（持久化在 disabledPackages）
+	for (const source of projectDisabled) {
+		const key = `project:${source}`;
+		if (seen.has(key)) continue;
+		seen.add(key);
+		const installedPath = pm.getInstalledPath(source, "project");
+		const resources = installedPath ? await countResources(installedPath) : { extensions: 0, skills: 0, prompts: 0, themes: 0 };
+		out.push({ source, scope: "project", installedPath, resources, disabled: true });
+	}
+
+	for (const source of userDisabled) {
+		const key = `user:${source}`;
+		if (seen.has(key)) continue;
+		seen.add(key);
+		const installedPath = pm.getInstalledPath(source, "user");
+		const resources = installedPath ? await countResources(installedPath) : { extensions: 0, skills: 0, prompts: 0, themes: 0 };
+		out.push({ source, scope: "user", installedPath, resources, disabled: true });
+	}
+
+	return out;
+}
+
+export async function listLoadedExtensions(cwd: string): Promise<ExtensionView[]> {
+	await resourceLoaderReady(cwd);
+	const loader = getResourceLoader(cwd);
+	const result = loader.getExtensions() as unknown as {
+		extensions?: Array<{ path?: string; name?: string }>;
+		errors?: Array<{ path: string; error: string }>;
+	};
+	const sm = getSettingsManager(cwd);
+	const globalPatterns = sm.getGlobalSettings().extensions ?? [];
+	const projectPatterns = sm.getProjectSettings().extensions ?? [];
+	const agentDir = getAgentDir();
+	const projectBase = path.join(cwd, ".pi");
+
+	const out: ExtensionView[] = [];
+	const seenPaths = new Set<string>();
+	for (const e of result?.extensions ?? []) {
+		const p = String(e.path ?? "");
+		if (!p) continue;
+		const name = String(e.name ?? path.basename(p).replace(/\.(ts|js)$/, ""));
+		seenPaths.add(p);
+		out.push({ name, path: p, disabled: false });
+	}
+	for (const err of result?.errors ?? []) {
+		if (seenPaths.has(err.path)) continue;
+		seenPaths.add(err.path);
+		out.push({ name: path.basename(err.path).replace(/\.(ts|js)$/, ""), path: err.path, disabled: false, error: err.error });
+	}
+	// 被 `-path` 排除的扩展不会出现在 loader 结果里：从两份 settings 的模式里补出来，让用户能重新启用
+	const excluded: Array<{ pattern: string; base: string }> = [
+		...globalPatterns.filter((p) => p.startsWith("-")).map((p) => ({ pattern: p.slice(1), base: agentDir })),
+		...projectPatterns.filter((p) => p.startsWith("-")).map((p) => ({ pattern: p.slice(1), base: projectBase })),
+	];
+	for (const { pattern, base } of excluded) {
+		const abs = path.isAbsolute(pattern) ? pattern : path.resolve(base, pattern);
+		if (seenPaths.has(abs)) continue;
+		seenPaths.add(abs);
+		out.push({ name: path.basename(abs).replace(/\.(ts|js)$/, ""), path: abs, disabled: true });
+	}
+	return out;
+}
+
+export async function togglePackage(
+	source: string,
+	disable: boolean,
+	scope: "user" | "project",
+	cwd: string
+): Promise<void> {
+	const settingsPath = scope === "project" ? path.join(cwd, ".pi", "settings.json") : path.join(getAgentDir(), "settings.json");
+	await withSettingsWriteLock(settingsPath, () => withExternalSettingsLock(settingsPath, async () => {
+		const settings = await readSettingsFileStrict(settingsPath);
+		const sourceOf = (p: unknown) => (typeof p === "string" ? p : (p as { source?: string } | null)?.source);
+		const packages: unknown[] = Array.isArray(settings.packages) ? settings.packages : [];
+		// 停用的包原样存到 disabledPackages（PiWeb 私有键，pi 不读）
+		const disabledPackages: unknown[] = Array.isArray(settings.disabledPackages) ? settings.disabledPackages : [];
+		if (disable) {
+			const moved = packages.filter((p) => sourceOf(p) === source);
+			settings.packages = packages.filter((p) => sourceOf(p) !== source);
+			settings.disabledPackages = [...disabledPackages.filter((p) => sourceOf(p) !== source), ...(moved.length ? moved : [source])];
+		} else {
+			const restored = disabledPackages.filter((p) => sourceOf(p) === source);
+			settings.disabledPackages = disabledPackages.filter((p) => sourceOf(p) !== source);
+			settings.packages = packages.some((p) => sourceOf(p) === source) ? packages : [...packages, ...(restored.length ? restored : [source])];
+		}
+		await writeSettingsFile(settingsPath, settings);
+	}));
+	await applyResourceChange(cwd, scope);
+}
+
+export async function toggleExtension(
+	extPath: string,
+	disable: boolean,
+	cwd: string
+): Promise<void> {
+	const norm = extPath.replace(/\\/g, "/").toLowerCase();
+	const isProject = norm.startsWith(`${path.resolve(cwd).replace(/\\/g, "/").toLowerCase()}/`);
+	const baseDir = isProject ? path.join(cwd, ".pi") : getAgentDir();
+	const settingsPath = isProject ? path.join(cwd, ".pi", "settings.json") : path.join(getAgentDir(), "settings.json");
+	await withSettingsWriteLock(settingsPath, async () => {
+		const sm = await prepareSettingsWrite(cwd, settingsPath);
+		const current = (isProject ? sm.getProjectSettings().extensions : sm.getGlobalSettings().extensions) ?? [];
+		const pattern = extensionPattern(extPath, baseDir);
+		const withoutOurs = current.filter((p) => !(p.startsWith("-") && [pattern, extPath.replace(/\\/g, "/")].includes((p.slice(1).startsWith("./") ? p.slice(3) : p.slice(1)).replace(/\\/g, "/"))));
+		const next = disable ? [...withoutOurs, `-${pattern}`] : withoutOurs;
+		if (!disable && isForceExcluded(extPath, next, baseDir)) {
+			for (let i = next.length - 1; i >= 0; i -= 1) if (isForceExcluded(extPath, [next[i]], baseDir)) next.splice(i, 1);
+		}
+		if (isProject) sm.setProjectExtensionPaths(next);
+		else sm.setExtensionPaths(next);
+		await flushSettingsOrThrow(sm);
+		await verifySettingsField(settingsPath, "extensions", next);
+	});
+	await applyResourceChange(cwd, isProject ? "project" : "user");
+}
+
+export async function installPackage(source: string, local: boolean, cwd: string): Promise<void> {
+	const pm = getPackageManager(cwd);
+	const settingsPath = local ? path.join(cwd, ".pi", "settings.json") : path.join(getAgentDir(), "settings.json");
+	await withSettingsWriteLock(settingsPath, async () => {
+		const sm = await prepareSettingsWrite(cwd, settingsPath);
+		await pm.installAndPersist(source, { local });
+		await flushSettingsOrThrow(sm);
+		await verifySettingsField(settingsPath, "packages", (local ? sm.getProjectSettings() : sm.getGlobalSettings()).packages);
+	});
+	await applyResourceChange(cwd, local ? "project" : "user");
+}
+
+export async function removePackage(source: string, local: boolean, cwd: string): Promise<boolean> {
+	const pm = getPackageManager(cwd);
+	const settingsPath = local ? path.join(cwd, ".pi", "settings.json") : path.join(getAgentDir(), "settings.json");
+	const removed = await withSettingsWriteLock(settingsPath, async () => {
+		const sm = await prepareSettingsWrite(cwd, settingsPath);
+		// SDK failures must surface before touching the disabled-package bookkeeping.
+		const removedActive = await pm.removeAndPersist(source, { local });
+		await flushSettingsOrThrow(sm);
+		await verifySettingsField(settingsPath, "packages", (local ? sm.getProjectSettings() : sm.getGlobalSettings()).packages);
+		const removedDisabled = await withExternalSettingsLock(settingsPath, async () => {
+			const settings = await readSettingsFileStrict(settingsPath);
+			const sourceOf = (p: unknown) => (typeof p === "string" ? p : (p as { source?: string } | null)?.source);
+			if (Array.isArray(settings.disabledPackages) && settings.disabledPackages.some((p) => sourceOf(p) === source)) {
+				settings.disabledPackages = settings.disabledPackages.filter((p) => sourceOf(p) !== source);
+				await writeSettingsFile(settingsPath, settings);
+				return true;
+			}
+			return false;
+		});
+		return removedActive || removedDisabled;
+	});
+	await applyResourceChange(cwd, local ? "project" : "user");
+	return removed;
+}
+
+export async function updatePackages(source: string | undefined, cwd: string): Promise<void> {
+	const pm = getPackageManager(cwd);
+	await withSettingsWriteLock(path.join(getAgentDir(), "settings.json"), () => pm.update(source));
+	await applyResourceChange(cwd, "user");
+}
+
+/** 热重载全部扩展（pi /reload 等价物）：加载器 + 所有活跃会话 */
+export async function reloadExtensions(cwd?: string): Promise<{ loaders: number; sessions: number }> {
+	const loaders = (await reloadAllLoaders()).length;
+	const sessions = await reloadSessionsForCwd(cwd);
+	return { loaders, sessions };
+}

package/src/lib/process-format.ts

@@ -0,0 +1,261 @@
+/**
+ * 对话过程行的纯文本整理：工具种类归类、命令去噪、路径相对化、思考首句、模型错误归类。
+ * 不依赖 React，便于单测（tests/process-format.test.ts）。
+ */
+
+export type ToolKind = "cmd" | "read" | "search" | "write" | "other";
+
+/** 工具名 → 种类（决定颜色与结果预览方式） */
+export function toolKind(name: string): ToolKind {
+	const n = name.toLowerCase();
+	if (n === "bash" || n === "powershell" || n === "pwsh" || n === "shell" || n === "sh" || n === "cmd") return "cmd";
+	if (n === "read") return "read";
+	if (n === "grep" || n === "glob" || n === "find" || n === "ls" || n === "search") return "search";
+	if (n === "edit" || n === "write" || n === "multiedit" || n === "multi_edit") return "write";
+	return "other";
+}
+
+/** 统一为正斜杠；去掉包裹引号；MSYS 形式 /d/AIApp → D:/AIApp */
+export function canonPath(p: string): string {
+	let s = p.trim().replace(/^"(.*)"$/, "$1").replace(/^'(.*)'$/, "$1").replace(/\\/g, "/");
+	const msys = s.match(/^\/([a-zA-Z])\/(.*)$/);
+	if (msys) s = `${msys[1].toUpperCase()}:/${msys[2]}`;
+	return s;
+}
+
+function stripTrailingSlash(p: string): string {
+	return p.replace(/\/+$/, "");
+}
+
+/** 工作区内的绝对路径显示为相对路径；工作区外原样（仅统一斜杠） */
+export function relativizePath(path: string, cwd?: string): string {
+	if (!path) return path;
+	const p = canonPath(path);
+	if (!cwd) return p;
+	const root = stripTrailingSlash(canonPath(cwd));
+	if (!root) return p;
+	const pl = p.toLowerCase();
+	const rl = root.toLowerCase();
+	if (pl === rl) return ".";
+	if (pl.startsWith(`${rl}/`)) return p.slice(root.length + 1);
+	return p;
+}
+
+export function basename(p: string): string {
+	const parts = canonPath(p).split("/").filter(Boolean);
+	return parts[parts.length - 1] ?? p;
+}
+
+/**
+ * 命令行摘要：去掉开头“cd <工作区> &&”这类噪音（目标恰为当前工作区时才去），
+ * 折叠空白，只取首行；返回总行数供“…N 行”提示。
+ */
+export function cleanCommand(command: string, cwd?: string): { text: string; lines: number } {
+	const raw = command.replace(/\r/g, "");
+	const lines = raw.split("\n").filter((l) => l.trim().length > 0);
+	let first = lines[0] ?? "";
+	if (cwd) {
+		const root = stripTrailingSlash(canonPath(cwd)).toLowerCase();
+		// 允许连着多个 cd（极少见），逐个剥
+		for (;;) {
+			const m = first.match(/^\s*(?:cd|pushd)\s+(?:\/d\s+)?("[^"]*"|'[^']*'|\S+)\s*(?:&&|;)\s*/);
+			if (!m) break;
+			const target = stripTrailingSlash(canonPath(m[1])).toLowerCase();
+			if (target !== root) break;
+			first = first.slice(m[0].length);
+		}
+	}
+	let text = first.replace(/\s+/g, " ").trim();
+	text = dropEchoSeparators(text);
+	if (cwd) text = relativizeInText(text, cwd);
+	return { text, lines: lines.length };
+}
+
+/** 按顶层的 ; && || 切分（引号内不切） */
+function splitTopLevel(cmd: string): string[] {
+	const parts: string[] = [];
+	let cur = "";
+	let quote: string | null = null;
+	for (let i = 0; i < cmd.length; i += 1) {
+		const ch = cmd[i];
+		if (quote) {
+			cur += ch;
+			if (ch === quote && cmd[i - 1] !== "\\") quote = null;
+			continue;
+		}
+		if (ch === '"' || ch === "'") {
+			quote = ch;
+			cur += ch;
+			continue;
+		}
+		if (ch === ";") {
+			parts.push(cur);
+			cur = "";
+			continue;
+		}
+		if ((ch === "&" && cmd[i + 1] === "&") || (ch === "|" && cmd[i + 1] === "|")) {
+			parts.push(cur);
+			cur = "";
+			i += 1;
+			continue;
+		}
+		cur += ch;
+	}
+	parts.push(cur);
+	return parts;
+}
+
+/**
+ * 去掉只起分隔/标题作用的 echo 段（echo "═══ rag ═══"; echo ---; echo ""），只留真正的命令。
+ * 带变量的 echo（echo "EXIT=$?"）是结果输出，保留。全是分隔段就原样返回。
+ */
+export function dropEchoSeparators(cmd: string): string {
+	const parts = splitTopLevel(cmd).map((p) => p.trim());
+	if (parts.length < 2) return cmd;
+	const isSeparator = (p: string): boolean => {
+		const m = p.match(/^echo(?:\s+-[ne]+)?\s*(?:"([^"]*)"|'([^']*)'|(\S*))?$/);
+		if (!m) return false;
+		const payload = m[1] ?? m[2] ?? m[3] ?? "";
+		if (payload.includes("$")) return false;
+		if (/^[\s\-=─═—#*~_.>]*$/.test(payload)) return true;
+		return /[─═=\-#*~]{3,}/.test(payload);
+	};
+	const kept = parts.filter((p) => p && !isSeparator(p));
+	if (!kept.length || kept.length === parts.filter(Boolean).length) return cmd;
+	return kept.join("; ");
+}
+
+const TOOL_DISPLAY: Record<string, string> = {
+	bash: "Bash",
+	powershell: "PowerShell",
+	pwsh: "PowerShell",
+	shell: "Shell",
+	read: "Read",
+	edit: "Edit",
+	multiedit: "MultiEdit",
+	multi_edit: "MultiEdit",
+	write: "Write",
+	grep: "Grep",
+	glob: "Glob",
+	find: "Find",
+	ls: "List",
+	search: "Search",
+};
+
+/** 工具名的展示写法（Claude Code 式的 Bash / Read / Edit…），未知工具首字母大写 */
+export function displayToolName(name: string): string {
+	const n = name.toLowerCase();
+	return TOOL_DISPLAY[n] ?? (name.charAt(0).toUpperCase() + name.slice(1));
+}
+
+const LIST_VERBS = new Set(["ls", "dir", "tree", "find", "fd"]);
+
+/** 命令的动词（去掉环境变量前缀与路径） */
+export function commandVerb(command: string): string {
+	const first = command.replace(/\r/g, "").split("\n").find((l) => l.trim().length > 0) ?? "";
+	const tokens = first.trim().replace(/^(?:\w+=\S*\s+)+/, "").split(/\s+/);
+	return basename(tokens[0] ?? "").replace(/\.exe$/i, "").toLowerCase();
+}
+
+/** 列目录类命令（Codex 的「Listed」） */
+export function isListCommand(command: string): boolean {
+	return LIST_VERBS.has(commandVerb(command));
+}
+
+function escapeRe(s: string): string {
+	return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+
+/** 把文本里出现的工作区绝对路径改成相对路径（正反斜杠、MSYS 形式都认）；单独出现的工作区本身变成 "." */
+export function relativizeInText(text: string, cwd: string): string {
+	const root = stripTrailingSlash(canonPath(cwd));
+	if (!root) return text;
+	const drive = root.match(/^([A-Za-z]):\/(.*)$/);
+	const rest = drive ? drive[2] : root.replace(/^\//, "");
+	// 路径分隔：正斜杠或（可能成对的）反斜杠
+	const sep = "(?:\\/|\\\\+)";
+	const restRe = escapeRe(rest).replace(/\//g, sep);
+	const prefixRe = drive ? `(?:${drive[1]}:${sep}|/${drive[1]}/)` : "/";
+	// 之后必须是分隔符、引号、空白或结尾，避免误伤 PiWebX 这类同前缀目录
+	const re = new RegExp(`${prefixRe}${restRe}(?=\\/|\\\\|["'\\s]|$)(${sep})?`, "gi");
+	return text.replace(re, (_m, tail?: string) => (tail ? "" : "."));
+}
+
+/** 思考摘要：取第一句（句末标点后接空白或结尾）；过短的首句退回整段截断 */
+export function firstSentence(text: string, max = 140): string {
+	const one = text.replace(/\s+/g, " ").trim();
+	if (!one) return "";
+	// 英文句号要求后接空白（避免 3.5 这种小数），中文句号不需要
+	const m = one.match(/^.*?(?:[.!?](?=\s|$)|[。！？])/);
+	let s = m ? m[0].trim() : one;
+	// 首句过短（"OK."）时退回整段；中文按字算，阈值更低
+	const min = /[㐀-鿿]/.test(s) ? 4 : 12;
+	if (s.length < min && one.length > s.length) s = one;
+	return s.length > max ? `${s.slice(0, max - 1).trimEnd()}…` : s;
+}
+
+export type ModelErrorKind = "rateLimit" | "billing" | "auth" | "notFound" | "context" | "timeout" | "server" | "network";
+
+/** 把供应商原始报错归到少数几类，界面给一句人话；认不出返回 null（只显示原文） */
+export function classifyModelError(message: string): ModelErrorKind | null {
+	const m = message.toLowerCase();
+	if (/\b429\b|rate.?limit|too many requests|requests per (minute|second)/.test(m)) return "rateLimit";
+	if (/\b402\b|insufficient (balance|credits|quota|funds)|billing|quota exceeded|余额/.test(m)) return "billing";
+	if (/\b401\b|\b403\b|unauthori[sz]ed|forbidden|invalid.*(api.?key|token)|authentication|permission denied/.test(m)) return "auth";
+	if (/\b404\b|model.*not (found|exist)|unknown model|no such model|not_found_error/.test(m)) return "notFound";
+	if (/context.*(length|window|limit)|too long|maximum.*tokens|prompt is too long|input length|exceeds the (limit|maximum)/.test(m)) return "context";
+	if (/timeout|timed out|etimedout|\b408\b|\b504\b/.test(m)) return "timeout";
+	if (/\b5\d\d\b|overloaded|server error|bad gateway|unavailable|internal error/.test(m)) return "server";
+	if (/econnrefused|econnreset|enotfound|eai_again|fetch failed|network|socket hang up/.test(m)) return "network";
+	return null;
+}
+
+/** 非空行（去 \r） */
+export function splitLines(raw: string): string[] {
+	return raw.replace(/\r/g, "").split("\n").filter((l) => l.trim().length > 0);
+}
+
+const EXT_LANG: Record<string, string> = {
+	ts: "TypeScript", tsx: "TSX", js: "JavaScript", jsx: "JSX", mjs: "JavaScript", cjs: "JavaScript",
+	py: "Python", rs: "Rust", go: "Go", java: "Java", kt: "Kotlin", rb: "Ruby", php: "PHP", cs: "C#",
+	c: "C", h: "C", cpp: "C++", hpp: "C++", swift: "Swift", vue: "Vue", svelte: "Svelte",
+	css: "CSS", scss: "SCSS", html: "HTML", json: "JSON", md: "Markdown", mdx: "MDX",
+	yml: "YAML", yaml: "YAML", toml: "TOML", sh: "Shell", bash: "Shell", ps1: "PowerShell", sql: "SQL",
+	xml: "XML", txt: "Text", lock: "Lock", env: "Env",
+};
+
+/** 由扩展名给一个语言名（read 行的元信息）；认不出返回空串 */
+export function langOfPath(p: string): string {
+	const name = basename(p).toLowerCase();
+	if (name === "dockerfile") return "Dockerfile";
+	if (name === "makefile") return "Makefile";
+	const ext = name.includes(".") ? name.slice(name.lastIndexOf(".") + 1) : "";
+	return EXT_LANG[ext] ?? "";
+}
+
+const HEAD_VERBS = new Set([
+	"cat", "ls", "dir", "tree", "find", "fd", "head", "tail", "type", "grep", "rg", "egrep", "fgrep", "ag", "sed", "awk",
+	"echo", "printf", "less", "more", "which", "where", "env", "printenv", "set", "stat", "file", "ps", "curl", "wget", "jq",
+]);
+const GIT_HEAD_SUBS = new Set(["log", "status", "diff", "show", "branch", "ls-files", "blame", "remote", "stash", "tag", "config", "grep"]);
+
+/** 命令输出预览取开头还是结尾：列表 / 查看类命令看开头，构建 / 测试 / 脚本类看结尾（结论在最后）；开头的 cd 一律跳过 */
+export function previewSide(command: string): "head" | "tail" {
+	let first = command.replace(/\r/g, "").split("\n").find((l) => l.trim().length > 0) ?? "";
+	for (;;) {
+		const m = first.match(/^\s*(?:cd|pushd)\s+(?:\/d\s+)?(?:"[^"]*"|'[^']*'|\S+)\s*(?:&&|;)\s*/);
+		if (!m) break;
+		first = first.slice(m[0].length);
+	}
+	const tokens = first.trim().replace(/^(?:\w+=\S*\s+)+/, "").split(/\s+/);
+	const verb = basename(tokens[0] ?? "").replace(/\.exe$/i, "").toLowerCase();
+	if (verb === "git") return GIT_HEAD_SUBS.has((tokens[1] ?? "").toLowerCase()) ? "head" : "tail";
+	return HEAD_VERBS.has(verb) ? "head" : "tail";
+}
+
+/** 去掉结尾只含括号 / 符号的行（"}"、");"、"$"），这些行做预览等于没看 */
+export function trimNoiseTail(lines: string[]): string[] {
+	let end = lines.length;
+	while (end > 0 && !/[\p{L}\p{N}]/u.test(lines[end - 1])) end -= 1;
+	return end === lines.length ? lines : lines.slice(0, end);
+}

package/src/lib/provider-display.ts

@@ -0,0 +1,57 @@
+const ICON_RULES: Array<[RegExp, string]> = [
+	[/^amazon-bedrock$/, "bedrock-color"],
+	[/^ant-ling$/, "antgroup-color"],
+	[/^anthropic$/, "anthropic"],
+	[/^azure-/, "azure-color"],
+	[/^baseten$/, "baseten"],
+	[/^cerebras$/, "cerebras-color"],
+	[/^cloudflare-/, "cloudflare-color"],
+	[/^deepseek$/, "deepseek-color"],
+	[/^fireworks$/, "fireworks-color"],
+	[/^github-copilot$/, "githubcopilot"],
+	[/^google-vertex(?:-|$)/, "googlecloud-color"],
+	[/^google$/, "google-color"],
+	[/^groq$/, "groq"],
+	[/^huggingface$/, "huggingface-color"],
+	[/^kimi(?:-|$)/, "kimi-color"],
+	[/^minimax/, "minimax-color"],
+	[/^mistral$/, "mistral-color"],
+	[/^moonshot(?:ai)?(?:-|$)/, "moonshot"],
+	[/^nvidia$/, "nvidia-color"],
+	[/^openai/, "openai"],
+	[/^opencode(?:-|$)/, "opencode"],
+	[/^openrouter$/, "openrouter-color"],
+	[/^qwen(?:-|$)/, "qwen-color"],
+	[/^together$/, "together-color"],
+	[/^vercel(?:-|$)/, "vercel"],
+	[/^xai$/, "xai"],
+	[/^xiaomi(?:-|$)/, "xiaomimimo"],
+	[/^zai(?:-|$)/, "zai"],
+];
+
+export const PROVIDER_ICON_SLUGS = [...new Set(ICON_RULES.map(([, slug]) => slug))];
+
+export function providerIconSlug(providerId: string): string | null {
+	return ICON_RULES.find(([pattern]) => pattern.test(providerId))?.[1] ?? null;
+}
+
+export function providerInitials(name: string, providerId: string): string {
+	const words = name.trim().split(/[\s_-]+/).filter(Boolean);
+	if (words.length >= 2) return (words[0][0] + words[1][0]).toUpperCase();
+	return (words[0] ?? providerId).slice(0, 2).toUpperCase();
+}
+
+export const CUSTOM_PROVIDER_ID_PATTERN = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/;
+
+export const FALLBACK_CUSTOM_APIS = [
+	"openai-completions",
+	"openai-responses",
+	"anthropic-messages",
+	"google-generative-ai",
+] as const;
+
+export function customApiOptions(providerApis: string[]): string[] {
+	const fallback = new Set<string>(FALLBACK_CUSTOM_APIS);
+	const discovered = [...new Set(providerApis.filter((api) => api && !fallback.has(api)))].sort();
+	return [...FALLBACK_CUSTOM_APIS, ...discovered];
+}