@stylewx/service 0.1.0

package/dist/analyze.d.ts

@@ -0,0 +1,18 @@
+export type ContentType = 'tech' | 'business' | 'literary' | 'government' | 'academic' | 'general';
+export interface AnalyzeResult {
+    content: {
+        type: ContentType;
+        typeLabel: string;
+        tone: string;
+        readingMinutes: number;
+        wordCount: number;
+    };
+    suggestedTheme: {
+        name: string;
+        description: string;
+        reason: string;
+    };
+    analysisText: string;
+}
+export declare function analyzeArticle(markdown: string): AnalyzeResult;
+//# sourceMappingURL=analyze.d.ts.map

package/dist/analyze.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../src/analyze.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,WAAW,GACnB,MAAM,GACN,UAAU,GACV,UAAU,GACV,YAAY,GACZ,UAAU,GACV,SAAS,CAAA;AAyDb,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE;QACP,IAAI,EAAE,WAAW,CAAA;QACjB,SAAS,EAAE,MAAM,CAAA;QACjB,IAAI,EAAE,MAAM,CAAA;QACZ,cAAc,EAAE,MAAM,CAAA;QACtB,SAAS,EAAE,MAAM,CAAA;KAClB,CAAA;IACD,cAAc,EAAE;QACd,IAAI,EAAE,MAAM,CAAA;QACZ,WAAW,EAAE,MAAM,CAAA;QACnB,MAAM,EAAE,MAAM,CAAA;KACf,CAAA;IACD,YAAY,EAAE,MAAM,CAAA;CACrB;AAaD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAuC9D"}

package/dist/analyze.js

@@ -0,0 +1,109 @@
+/**
+ * 文章内容分析（确定性启发式，无需 LLM）：
+ * 推断内容类型、情绪基调、建议主题方向、估算阅读时长。
+ * 该结论同时作为 generate_theme 的输入。
+ */
+import { countWords, estimateReadingMinutes } from '@stylewx/core';
+const TYPE_DEFS = {
+    tech: {
+        label: '技术 / 工程',
+        keywords: [
+            '代码', '函数', '开发', '接口', '部署', '前端', '后端', '数据库', '算法',
+            '编程', 'docker', 'api', 'git', 'rendered', 'variable', 'function', 'framework',
+            '性能', '优化', '架构', '微服务', 'serverless',
+        ],
+        themeName: 'tech-minimal',
+        themeReason: '技术内容适合冷峻清晰、留白充分的科技极简风。',
+    },
+    business: {
+        label: '商业 / 财经',
+        keywords: [
+            '营收', '增长', '市场', '投资', '估值', '融资', '财报', '战略', '品牌',
+            '客户', '商业', '行业', '公司', '产品', '利润', '收入', '营销', '招聘',
+        ],
+        themeName: 'business',
+        themeReason: '商业财经适合稳重藏蓝 + 金色点缀的商务风。',
+    },
+    literary: {
+        label: '文艺 / 生活',
+        keywords: [
+            '散文', '生活', '感悟', '旅行', '回忆', '情绪', '诗歌', '阅读', '人生',
+            '月光', '黄昏', '孤独', '温暖', '岁', '字', '篇',
+        ],
+        themeName: 'magazine',
+        themeReason: '文艺人文适合暖棕衬线、宽松行距的杂志风。',
+    },
+    government: {
+        label: '政务 / 官方',
+        keywords: [
+            '政务', '党建', '党员', '党委', '通知', '政策', '文件', '会议', '落实',
+            '精神', '人民', '服务', '基层', '政府', '法规', '条例', '号召',
+        ],
+        themeName: 'gov-red',
+        themeReason: '政务发布适合庄重中国红的官方风。',
+    },
+    academic: {
+        label: '学术 / 研究',
+        keywords: [
+            '研究', '论文', '文献', '实验', '数据', '假设', '结论', '综述', '方法论',
+            '学位', '期刊', '引用', '样本', '分析', '验证',
+        ],
+        themeName: 'academic',
+        themeReason: '学术内容适合中性克制、高可读的学术风。',
+    },
+    general: {
+        label: '通用',
+        keywords: [],
+        themeName: 'tech-minimal',
+        themeReason: '未能明确归类，推荐通用的科技极简风。',
+    },
+};
+function detectTone(markdown) {
+    const text = markdown.toLowerCase();
+    const positive = ['恭喜', '突破', '成功', '增长', '创新', '利好', '高效', '欣喜', '感动', '温暖'];
+    const negative = ['风险', '失败', '危机', '下跌', '亏损', '担忧', '警示', '压力', '争议'];
+    const po = positive.filter((k) => text.includes(k)).length;
+    const ne = negative.filter((k) => text.includes(k)).length;
+    if (po > ne)
+        return '积极 / 建设性';
+    if (ne > po)
+        return '严肃 / 审慎';
+    return '中性 / 客观';
+}
+export function analyzeArticle(markdown) {
+    const text = markdown.toLowerCase();
+    const wordCount = countWords(markdown);
+    const readingMinutes = estimateReadingMinutes(markdown);
+    let best = 'general';
+    let bestScore = 0;
+    for (const [type, def] of Object.entries(TYPE_DEFS)) {
+        if (type === 'general')
+            continue;
+        const score = def.keywords.filter((k) => text.includes(k)).length;
+        if (score > bestScore) {
+            bestScore = score;
+            best = type;
+        }
+    }
+    const def = TYPE_DEFS[best];
+    const tone = detectTone(markdown);
+    const analysisText = `内容类型：${def.label}；情绪基调：${tone}；` +
+        `字数约 ${wordCount}，预计阅读 ${readingMinutes} 分钟；` +
+        `建议主题：${def.themeName}（${def.themeReason}）`;
+    return {
+        content: {
+            type: best,
+            typeLabel: def.label,
+            tone,
+            readingMinutes,
+            wordCount,
+        },
+        suggestedTheme: {
+            name: def.themeName,
+            description: def.themeReason,
+            reason: def.themeReason,
+        },
+        analysisText,
+    };
+}
+//# sourceMappingURL=analyze.js.map

package/dist/analyze.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.js","sourceRoot":"","sources":["../src/analyze.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 统一的服务/工具错误格式：{ error: { code, message, hint } }。
+ * hint 面向 Agent，明确告诉下一步该怎么办。
+ */
+import { z } from 'zod';
+export declare const serviceErrorSchema: z.ZodObject<{
+    error: z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        hint: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type ServiceError = z.infer<typeof serviceErrorSchema>;
+/** 构建一个符合统一格式的错误对象。 */
+export declare function serviceError(code: string, message: string, hint: string): ServiceError;
+/** 把任意异常包装成统一错误（尽量保留中文可读提示）。 */
+export declare function asServiceError(error: unknown, fallbackCode?: string): ServiceError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,eAAO,MAAM,kBAAkB;;;;;;iBAM7B,CAAA;AAEF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAE7D,uBAAuB;AACvB,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,CAQtF;AAED,gCAAgC;AAChC,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,SAAmB,GAAG,YAAY,CAkB5F"}

package/dist/errors.js

@@ -0,0 +1,53 @@
+/**
+ * 统一的服务/工具错误格式：{ error: { code, message, hint } }。
+ * hint 面向 Agent，明确告诉下一步该怎么办。
+ */
+import { z } from 'zod';
+export const serviceErrorSchema = z.object({
+    error: z.object({
+        code: z.string(),
+        message: z.string(),
+        hint: z.string(),
+    }),
+});
+/** 构建一个符合统一格式的错误对象。 */
+export function serviceError(code, message, hint) {
+    return {
+        error: {
+            code,
+            message,
+            hint,
+        },
+    };
+}
+/** 把任意异常包装成统一错误（尽量保留中文可读提示）。 */
+export function asServiceError(error, fallbackCode = 'internal_error') {
+    // 若是已符合统一格式的错误对象（{ error: { code, message, hint } }），原样保留，避免被 String 成 [object Object]
+    if (error && typeof error === 'object' && 'error' in error) {
+        const e = error.error;
+        if (e && typeof e.code === 'string')
+            return { error: e };
+    }
+    if (error instanceof Error) {
+        return serviceError(codeFromMessage(error.message) ?? fallbackCode, error.message, '请根据错误信息修正输入后重试；如无法解决，请检查配置或联系管理员。');
+    }
+    return serviceError(fallbackCode, typeof error === 'string' ? error : String(error), '未预期的错误，请重试或检查输入。');
+}
+const CODE_PATTERNS = [
+    [/缺少|missing/i, 'missing_config'],
+    [/主题.*不合法|无法渲染|白名单/i, 'invalid_theme'],
+    [/标题|title/i, 'missing_title'],
+    [/封面|coverimage/i, 'missing_cover'],
+    [/凭证|凭据|app_id|app_secret/i, 'missing_wechat_credential'],
+    [/errcode/i, 'wechat_api_error'],
+    [/external|外链/i, 'external_image'],
+    [/playwright install|chromium/i, 'browser_not_installed'],
+];
+function codeFromMessage(message) {
+    for (const [regex, code] of CODE_PATTERNS) {
+        if (regex.test(message))
+            return code;
+    }
+    return undefined;
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;KACjB,CAAC;CACH,CAAC,CAAA;AAIF,uBAAuB;AACvB,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,OAAe,EAAE,IAAY;IACtE,OAAO;QACL,KAAK,EAAE;YACL,IAAI;YACJ,OAAO;YACP,IAAI;SACL;KACF,CAAA;AACH,CAAC;AAED,gCAAgC;AAChC,MAAM,UAAU,cAAc,CAAC,KAAc,EAAE,YAAY,GAAG,gBAAgB;IAC5E,uFAAuF;IACvF,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,EAAE,CAAC;QAC3D,MAAM,CAAC,GAAI,KAAsB,CAAC,KAAK,CAAA;QACvC,IAAI,CAAC,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,CAAA;IAC1D,CAAC;IACD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,YAAY,CACjB,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,YAAY,EAC9C,KAAK,CAAC,OAAO,EACb,mCAAmC,CACpC,CAAA;IACH,CAAC;IACD,OAAO,YAAY,CACjB,YAAY,EACZ,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EACjD,kBAAkB,CACnB,CAAA;AACH,CAAC;AAED,MAAM,aAAa,GAA4B;IAC7C,CAAC,aAAa,EAAE,gBAAgB,CAAC;IACjC,CAAC,mBAAmB,EAAE,eAAe,CAAC;IACtC,CAAC,WAAW,EAAE,eAAe,CAAC;IAC9B,CAAC,gBAAgB,EAAE,eAAe,CAAC;IACnC,CAAC,0BAA0B,EAAE,2BAA2B,CAAC;IACzD,CAAC,UAAU,EAAE,kBAAkB,CAAC;IAChC,CAAC,cAAc,EAAE,gBAAgB,CAAC;IAClC,CAAC,8BAA8B,EAAE,uBAAuB,CAAC;CAC1D,CAAA;AAED,SAAS,eAAe,CAAC,OAAe;IACtC,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,aAAa,EAAE,CAAC;QAC1C,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,OAAO,IAAI,CAAA;IACtC,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC"}

package/dist/generate.d.ts

@@ -0,0 +1,32 @@
+import type { Theme } from '@stylewx/theme';
+import type { LlmClient } from './llm.js';
+export interface GenerateThemeParams {
+    /** 文章全文（可选）。提供时会先让模型做一次内容分析。 */
+    article?: string;
+    /** 风格描述 / 设计需求（可选）。 */
+    prompt?: string;
+    /** 基础主题名（在预置主题基础上微调）。 */
+    baseTheme?: string;
+}
+export interface GenerateThemeResult {
+    theme: Theme;
+    /** 是否因多次修复失败而降级到预置主题。 */
+    fallback: boolean;
+    /** 尝试次数（含最终成功的那次）。 */
+    repairAttempts: number;
+    /** 生成失败时的修复建议（fallback=true 时有用）。 */
+    errorDetail?: string;
+    /** 内容分析结论（提供 article 时返回）。 */
+    analysis?: {
+        contentType: string;
+        tone: string;
+        industry: string;
+        designDirection: string;
+        text: string;
+    };
+    /** 用该主题渲染内置示例文章的截图（若已安装 Chromium）。 */
+    previewPng?: Buffer;
+}
+export declare const SAMPLE_ARTICLE = "# \u793A\u4F8B\u6587\u7AE0\n\n## \u4E00\u3001\u80CC\u666F\n\n\u5728\u5185\u5BB9\u521B\u4F5C\u4E2D\uFF0C\u6392\u7248\u5F80\u5F80\u88AB\u4F4E\u4F30\u3002\u597D\u7684\u6392\u7248\u80FD**\u663E\u8457\u63D0\u5347**\u9605\u8BFB\u4F53\u9A8C\uFF0C\u4E5F\u80FD\u8BA9\u54C1\u724C\u66F4\u6709\u8FA8\u8BC6\u5EA6\u3002\n\n> \u8FD9\u53EA\u662F\u4E00\u4E2A\u7528\u4E8E\u9A8C\u8BC1\u4E3B\u9898\u6548\u679C\u7684\u793A\u4F8B\u6BB5\u843D\u3002\n\n## \u4E8C\u3001\u6838\u5FC3\u8981\u70B9\n\n- \u4E00\u81F4\u6027\uFF1A\u5168\u5C40\u7EDF\u4E00\u5B57\u53F7\u3001\u884C\u8DDD\u4E0E\u914D\u8272\n- \u514B\u5236\uFF1A\u88C5\u9970\u5143\u7D20\u5B81\u7F3A\u6BCB\u6EE5\n- \u53EF\u8BFB\uFF1A\u5728\u624B\u673A\u4E0A\uFF0C\u7EBF\u6761\u4E0E\u7559\u767D\u80DC\u8FC7\u70AB\u6280\n\n## \u4E09\u3001\u4EE3\u7801\u793A\u4F8B\n\n```ts\nexport function hello(name: string): string {\n  return `Hello, ${name}`\n}\n```\n\n![\u793A\u4F8B\u914D\u56FE](https://mmbiz.qpic.cn/sz_mmbiz_png/placeholder/0?wx_fmt=png)\n\n---\n\n\u7ED3\u5C3E\u793A\u4F8B\u6587\u5B57\u3002\n";
+export declare function generateTheme(params: GenerateThemeParams, llm: LlmClient): Promise<GenerateThemeResult>;
+//# sourceMappingURL=generate.d.ts.map

package/dist/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAG3C,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,UAAU,CAAA;AAErD,MAAM,WAAW,mBAAmB;IAClC,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,KAAK,CAAA;IACZ,yBAAyB;IACzB,QAAQ,EAAE,OAAO,CAAA;IACjB,sBAAsB;IACtB,cAAc,EAAE,MAAM,CAAA;IACtB,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE;QACT,WAAW,EAAE,MAAM,CAAA;QACnB,IAAI,EAAE,MAAM,CAAA;QACZ,QAAQ,EAAE,MAAM,CAAA;QAChB,eAAe,EAAE,MAAM,CAAA;QACvB,IAAI,EAAE,MAAM,CAAA;KACb,CAAA;IACD,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAID,eAAO,MAAM,cAAc,wgCA2B1B,CAAA;AAmED,wBAAsB,aAAa,CACjC,MAAM,EAAE,mBAAmB,EAC3B,GAAG,EAAE,SAAS,GACb,OAAO,CAAC,mBAAmB,CAAC,CA+H9B"}

package/dist/generate.js

@@ -0,0 +1,229 @@
+/**
+ * AI 主题生成：LLM 结构化输出主题 JSON → zod + 白名单校验 → 失败自动修复（最多 2 次重试）
+ * → 仍失败则降级返回最接近的预置主题并标记 fallback: true。
+ * 生成成功后自动渲染一篇内置示例文章并截图。
+ */
+import { z } from 'zod';
+import { themeToJsonSchema, validateTheme, getPresetTheme, PRESET_THEMES, } from '@stylewx/theme';
+import { analyzeArticle } from './analyze.js';
+import { renderPreview } from './render.js';
+const MAX_REPAIRS = 2;
+export const SAMPLE_ARTICLE = `# 示例文章
+
+## 一、背景
+
+在内容创作中，排版往往被低估。好的排版能**显著提升**阅读体验，也能让品牌更有辨识度。
+
+> 这只是一个用于验证主题效果的示例段落。
+
+## 二、核心要点
+
+- 一致性：全局统一字号、行距与配色
+- 克制：装饰元素宁缺毋滥
+- 可读：在手机上，线条与留白胜过炫技
+
+## 三、代码示例
+
+\`\`\`ts
+export function hello(name: string): string {
+  return \`Hello, \${name}\`
+}
+\`\`\`
+
+![示例配图](https://mmbiz.qpic.cn/sz_mmbiz_png/placeholder/0?wx_fmt=png)
+
+---
+
+结尾示例文字。
+`;
+const contentAnalysisSchema = z.object({
+    contentType: z.enum(['tech', 'business', 'literary', 'government', 'academic', 'general']),
+    tone: z.string(),
+    industry: z.string(),
+    designDirection: z.string(),
+});
+function hexToRgb(hex) {
+    const m = /^#([0-9a-f]{6})$/i.exec(hex);
+    if (!m?.[1])
+        return null;
+    const v = m[1];
+    return [
+        parseInt(v.slice(0, 2), 16),
+        parseInt(v.slice(2, 4), 16),
+        parseInt(v.slice(4, 6), 16),
+    ];
+}
+function colorDistance(a, b) {
+    const ra = hexToRgb(a);
+    const rb = hexToRgb(b);
+    if (!ra || !rb)
+        return Number.MAX_SAFE_INTEGER;
+    return Math.sqrt((ra[0] - rb[0]) ** 2 + (ra[1] - rb[1]) ** 2 + (ra[2] - rb[2]) ** 2);
+}
+/** 选择与「目标主色」最接近的预置主题；无法比较时回退到首选。 */
+function closestPresetTheme(targetColor) {
+    if (targetColor) {
+        let best = PRESET_THEMES[0];
+        let bestDist = Number.MAX_SAFE_INTEGER;
+        for (const theme of PRESET_THEMES) {
+            const dist = colorDistance(theme.tokens.primaryColor, targetColor);
+            if (dist < bestDist) {
+                bestDist = dist;
+                best = theme;
+            }
+        }
+        return best;
+    }
+    return PRESET_THEMES[0];
+}
+function buildThemeSystemPrompt(baseTheme) {
+    const baseNotes = baseTheme
+        ? `请以预置主题「${baseTheme}」为基础进行微调，保持其整体气质，但可调整配色与细节。\n`
+        : '';
+    return `你是资深的公众号排版设计专家。请根据用户需求，输出一个「主题 JSON」。
+主题 JSON 必须严格符合给定的 JSON Schema。
+硬性约束：
+1. tokens 必须提供 primaryColor(十六进制)、textColor、fontSize(如 15px)、lineHeight(数字 0.8~4)、fontFamily、spacing.block。
+2. blocks 包含 h1,h2,h3,p,blockquote,ul,ol,li,code,pre,img,figcaption,hr,a,strong 十六个对象；每个对象的键是 CSS 属性。
+3. 所有 CSS 属性必须在微信白名单内（禁止 position/transform/animation/transition/float/box-shadow/伪类/外部字体等，这些微信会过滤）。
+4. 值可以用 {{primaryColor}}、{{textColor}}、{{fontSize}}、{{spacing.block}}、{{lineHeight}} 等 token 引用。
+5. description 请用中文写清楚风格与适用场景（供 Agent 选择时阅读），不要太短。
+6. 只输出 JSON 本身，不要输出任何多余文字或代码块标记。
+${baseNotes}`;
+}
+function themePromptForAttempt(instructions, fixNotes) {
+    const user = fixNotes
+        ? `${instructions}\n\n上一版主题未通过校验，请修复以下问题后再输出完整主题 JSON（只输出 JSON，不要解释）：\n${fixNotes}`
+        : instructions;
+    return user;
+}
+export async function generateTheme(params, llm) {
+    const instructions = params.prompt?.trim() || params.article?.trim() || '生成一款简洁大方、适合公众号的文章主题。';
+    // 若提供全文，先让模型做内容分析（结论随响应返回）
+    let analysis;
+    let analysisText = '';
+    if (params.article && params.article.trim()) {
+        const heuristic = analyzeArticle(params.article);
+        analysisText = heuristic.analysisText;
+        try {
+            const raw = await llm.completeJson([
+                { role: 'system', content: '你是内容分析助手。请分析下面文章的类型、情绪基调、所属行业，并给出排版设计方向建议（用中文，简洁）。' },
+                { role: 'user', content: params.article.slice(0, 6000) },
+            ], {
+                schema: z.toJSONSchema(contentAnalysisSchema),
+                name: 'content_analysis',
+                temperature: 0.3,
+                maxTokens: 500,
+            });
+            const parsed = contentAnalysisSchema.parse(raw);
+            analysis = {
+                contentType: parsed.contentType,
+                tone: parsed.tone,
+                industry: parsed.industry,
+                designDirection: parsed.designDirection,
+                text: `内容类型：${parsed.contentType}；基调：${parsed.tone}；行业：${parsed.industry}；` +
+                    `排版方向：${parsed.designDirection}\n` +
+                    `（启发式分析：${heuristic.analysisText}）`,
+            };
+        }
+        catch {
+            // LLM 分析失败则回退到启发式结论
+            analysis = {
+                contentType: heuristic.content.type,
+                tone: heuristic.content.tone,
+                industry: '',
+                designDirection: heuristic.suggestedTheme.reason,
+                text: heuristic.analysisText,
+            };
+        }
+    }
+    const scheme = themeToJsonSchema();
+    // 预置主题作为参考，给模型更稳定的起点
+    const base = params.baseTheme ? getPresetTheme(params.baseTheme) : undefined;
+    const genInstructions = `${instructions}\n` +
+        (params.article && params.article.trim() ? `\n文章全文（节选）：\n${params.article.slice(0, 6000)}\n` : '') +
+        (analysis ? `\n内容分析结论：\n${analysis.text}\n` : '') +
+        (base ? `\n基础主题 tokens 参考：${JSON.stringify(base.tokens)}\n` : '');
+    const messages = [
+        { role: 'system', content: buildThemeSystemPrompt(params.baseTheme) },
+        { role: 'user', content: themePromptForAttempt(genInstructions) },
+    ];
+    let theme = null;
+    let errorDetail = '';
+    let repairAttempts = 0;
+    let lastTargetColor;
+    for (let attempt = 0; attempt <= MAX_REPAIRS; attempt += 1) {
+        try {
+            const raw = await llm.completeJson(messages, {
+                schema: scheme,
+                name: 'mp_style_theme',
+                temperature: 0.5,
+                maxTokens: 3200,
+            });
+            const candidate = assignThemeDefaults(raw);
+            lastTargetColor = candidate.tokens?.primaryColor;
+            const validation = validateTheme(candidate);
+            if (validation.ok && validation.theme) {
+                theme = validation.theme;
+                repairAttempts = attempt + 1;
+                break;
+            }
+            // 失败 → 收集修复建议，回传给模型再试
+            const issues = validation.issues
+                .map((i) => `- ${i.path}: ${i.message}`)
+                .join('\n');
+            errorDetail = issues;
+            messages.push({
+                role: 'assistant',
+                content: '（上一版本无效主题）',
+            });
+            messages.push({
+                role: 'user',
+                content: themePromptForAttempt(genInstructions, `请修复：\n${issues}`),
+            });
+        }
+        catch (error) {
+            errorDetail = error instanceof Error ? error.message : String(error);
+            messages.push({
+                role: 'user',
+                content: themePromptForAttempt(genInstructions, `请重新输出一个完整、合法且完全符合 Schema 的主题 JSON。`),
+            });
+        }
+    }
+    let fallback = false;
+    if (!theme) {
+        fallback = true;
+        repairAttempts = MAX_REPAIRS + 1;
+        theme = closestPresetTheme(lastTargetColor);
+    }
+    // 自动渲染内置示例文章并截图（截图失败不致命）
+    let previewPng;
+    try {
+        const preview = await renderPreview(SAMPLE_ARTICLE, theme, { includeScreenshot: true });
+        previewPng = preview.screenshotPng;
+    }
+    catch {
+        // ignore
+    }
+    return {
+        theme,
+        fallback,
+        repairAttempts,
+        errorDetail: fallback ? errorDetail || '主题生成多次失败，已降级为预置主题。' : undefined,
+        analysis,
+        previewPng,
+    };
+}
+/** 为 LLM 可能缺省的字段补上合理默认值，提高首次通过率。 */
+function assignThemeDefaults(raw) {
+    const fallbackTheme = PRESET_THEMES[0];
+    const tokens = raw.tokens ?? fallbackTheme.tokens;
+    const blocks = raw.blocks ?? fallbackTheme.blocks;
+    return {
+        name: raw.name ?? '自定义主题',
+        description: raw.description ?? 'AI 生成的主题。',
+        tokens,
+        blocks,
+    };
+}
+//# sourceMappingURL=generate.js.map

package/dist/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export * from './errors.js';
+export * from './themes.js';
+export * from './theme-store.js';
+export * from './analyze.js';
+export * from './render.js';
+export * from './publish.js';
+export * from './llm.js';
+export * from './generate.js';
+export * from './optimize.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,UAAU,CAAA;AACxB,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA"}

package/dist/index.js

@@ -0,0 +1,10 @@
+export * from './errors.js';
+export * from './themes.js';
+export * from './theme-store.js';
+export * from './analyze.js';
+export * from './render.js';
+export * from './publish.js';
+export * from './llm.js';
+export * from './generate.js';
+export * from './optimize.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,UAAU,CAAA;AACxB,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA"}

package/dist/llm.d.ts

@@ -0,0 +1,54 @@
+/**
+ * OpenAI 兼容的 LLM 客户端（结构化输出）。
+ * 通过 JSON Schema 约束模型输出，供 generate_theme 使用。
+ *
+ * 环境变量：
+ *   - LLM_BASE_URL    OpenAI 兼容 API 基地址（如 https://api.openai.com/v1，或 opencode go 的 https://opencode.ai/zen/go/v1）
+ *   - LLM_API_KEY     API 密钥
+ *   - LLM_MODEL       模型名
+ *   - LLM_API_STYLE   端点风格：'chat'（/chat/completions，默认）或 'responses'（/responses，如 opencode go）
+ * 任何凭据都只从环境读取，绝不硬编码。
+ */
+export type ApiStyle = 'chat' | 'responses';
+export interface LlmConfig {
+    baseUrl: string;
+    apiKey: string;
+    model: string;
+    apiStyle?: ApiStyle;
+    fetchImpl?: typeof fetch;
+}
+export interface LlmMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+export interface LlmJsonOptions {
+    /** 用于约束输出的 JSON Schema。 */
+    schema: Record<string, unknown>;
+    /** 响应格式名称（用于 json_schema）。 */
+    name: string;
+    temperature?: number;
+    maxTokens?: number;
+}
+/** 从环境变量加载 LLM 配置；缺少关键项或 style 不合法时给出明确错误。 */
+export declare function loadLlmConfigFromEnv(env?: NodeJS.ProcessEnv): LlmConfig;
+export declare class LlmClient {
+    private readonly config;
+    private readonly fetchImpl;
+    constructor(config: LlmConfig);
+    private get apiStyle();
+    /** 组装 JSON 结构输出请求体（按端点风格差异）。 */
+    private buildJsonPayload;
+    /**
+     * 请求结构化 JSON 输出。
+     * 优先用 json_schema 约束模型；若端点报错，则退化到普通文本输出并从文本中提取 JSON。
+     */
+    completeJson(messages: LlmMessage[], options: LlmJsonOptions): Promise<unknown>;
+    /** 请求纯文本输出。 */
+    completeText(messages: LlmMessage[], options?: {
+        temperature?: number;
+        maxTokens?: number;
+    }): Promise<string>;
+    private endpoint;
+    private request;
+}
+//# sourceMappingURL=llm.d.ts.map

package/dist/llm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../src/llm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAA;AAE3C,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAA;IACrC,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,8CAA8C;AAC9C,wBAAgB,oBAAoB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,SAAS,CAgBpF;AAWD,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;gBAE5B,MAAM,EAAE,SAAS;IAK7B,OAAO,KAAK,QAAQ,GAEnB;IAED,gCAAgC;IAChC,OAAO,CAAC,gBAAgB;IA4CxB;;;OAGG;IACG,YAAY,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAWrF,eAAe;IACT,YAAY,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,OAAO,GAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAsBvH,OAAO,CAAC,QAAQ;YAKF,OAAO;CAuBtB"}