Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
/**
* 外部主题导入的纯函数入口(无 IO)。main 侧只负责选文件、读字节、落盘。
*
* 详细设计见 `palette.ts`(模板来源)、`vscode.ts` / `obsidian.ts`(抽取规则)、
* `protected-tokens.ts`(语义豁免族)。
*/
import { buildThemeColorsFromPalette } from './palette';
import { UnsupportedThemePaletteError } from './errors';
import { stripProtectedTokens } from './protected-tokens';
import type {
ConvertedTheme,
ThemeConversionResult,
ThemeImportSource,
} from './types';
import { collectObsidianVars, extractObsidianPalette } from './obsidian';
import { extractVsCodePalette, parseVsCodeThemeJson } from './vscode';
export type { ConvertedTheme, ThemeConversionResult } from './types';
export { UnsupportedThemePaletteError };
export { TEMPLATE_TOKEN_IDS, buildThemeColorsFromPalette } from './palette';
export { isProtectedToken, stripProtectedTokens } from './protected-tokens';
/** 色板角色总数——报告里 "命中 N/13" 的分母。 */
export const PALETTE_ROLE_COUNT = 13;
const WINDOWS_RESERVED_RE = /^(con|prn|aux|nul|com[0-9]|lpt[0-9])$/i;
// Maximum slug length. Filesystem limit is 255 bytes; we need room for:
// `-dark` (5) + `-99` (3) + `-local` (6) + `.json` (5) = 19 chars overhead.
const MAX_SLUG_LENGTH = 200;
function toSlug(name: string): string {
let slug = name
.trim()
.toLowerCase()
.replace(/[^a-z0-9]+/g, '-')
.replace(/^-+|-+$/g, '');
if (slug.length === 0) return 'imported-theme';
if (WINDOWS_RESERVED_RE.test(slug)) slug = `theme-${slug}`;
if (slug.length > MAX_SLUG_LENGTH) {
slug = slug.slice(0, MAX_SLUG_LENGTH).replace(/-+$/, '');
}
return slug;
}
/**
* 展示名 → slug。既用作单产物的落盘 baseId,也用作双态产物的 family 键
* (writer 侧还会再消毒一次并处理文件重名)。
*/
export function themeFamilyId(name: string): string {
return toSlug(name);
}
/** VSCode 颜色主题 JSON → 转换结果。不是可用主题时返回 null。 */
export function convertVsCodeTheme(
raw: string,
fallbackName: string,
): ThemeConversionResult | null {
const parsed = parseVsCodeThemeJson(raw);
if (!parsed) return null;
const extracted = extractVsCodePalette(parsed, fallbackName);
if (!extracted) {
// 识别为主题 JSON 但无法抽取色板——可能通过 `include` 继承背景。
// 报告继承限制而非静默失败。
if (parsed.include) {
return {
themes: [],
report: {
source: 'vscode',
resolvedRoles: 0,
derivedRoles: [],
unresolved: [`include:${parsed.include}`],
skippedProtected: 0,
},
};
}
return null;
}
const built = buildThemeColorsFromPalette(
extracted.palette,
extracted.type,
extracted.markdown,
);
const { colors, skipped } = stripProtectedTokens(built);
return {
themes: [{ name: extracted.name, type: extracted.type, colors }],
report: {
source: 'vscode',
resolvedRoles: extracted.resolvedRoles,
derivedRoles: extracted.derivedRoles,
unresolved: extracted.unresolved,
skippedProtected: skipped.length,
},
};
}
/** Obsidian theme.css → 转换结果(双态 CSS 会产出 light + dark 两个主题)。 */
export function convertObsidianTheme(
css: string,
name: string,
): ThemeConversionResult | null {
const modes = collectObsidianVars(css);
if (modes.length === 0) return null;
const themes: ConvertedTheme[] = [];
const derivedRoles: string[] = [];
const unresolved: string[] = [];
const skippedIds = new Set<string>();
let resolvedRoles = 0;
for (const mode of modes) {
const extracted = extractObsidianPalette(mode);
if (!extracted) {
// Mode advertised by the stylesheet but background unresolvable — report it.
unresolved.push(`mode:${mode.type}`);
continue;
}
let built: Record<string, string>;
try {
built = buildThemeColorsFromPalette(
extracted.palette,
extracted.type,
extracted.markdown,
);
} catch (error) {
if (!(error instanceof UnsupportedThemePaletteError)) throw error;
unresolved.push(`mode:${mode.type}`);
continue;
}
const { colors, skipped } = stripProtectedTokens(built);
themes.push({ name, type: extracted.type, colors });
resolvedRoles = Math.max(resolvedRoles, extracted.resolvedRoles);
for (const id of skipped) skippedIds.add(id);
for (const role of extracted.derivedRoles) {
if (!derivedRoles.includes(role)) derivedRoles.push(role);
}
for (const item of extracted.unresolved) {
if (!unresolved.includes(item)) unresolved.push(item);
}
}
if (themes.length === 0) return null;
return {
themes,
report: {
source: 'obsidian',
resolvedRoles,
derivedRoles,
unresolved,
skippedProtected: skippedIds.size,
},
};
}
/** 按扩展名判定源格式;`.css` → Obsidian,`.json`/`.jsonc` → VSCode。 */
export function detectImportSource(fileName: string): ThemeImportSource | null {
const lower = fileName.toLowerCase();
if (lower.endsWith('.css')) return 'obsidian';
if (lower.endsWith('.json') || lower.endsWith('.jsonc')) return 'vscode';
return null;
}