@astro-minimax/cli 0.5.0 → 0.7.0

package/template/tools/generate-tags.ts

@@ -1,251 +0,0 @@
-#!/usr/bin/env npx tsx
-/**
- * AI 标签与分类自动生成工具
- *
- * 用法:
- *   pnpm run tools:tags <文章路径>              # 分析并推荐标签和分类
- *   pnpm run tools:tags <文章路径> --write      # 推荐并写入 frontmatter
- *   pnpm run tools:tags --all                    # 分析所有文章（dry-run）
- *
- * 环境变量:
- *   AI_API_KEY / OPENAI_API_KEY（可选，无 key 时使用关键词匹配）
- */
-
-import { readFile, writeFile } from "node:fs/promises";
-import { join } from "node:path";
-import { extractFrontmatter } from "./lib/frontmatter.js";
-import { stripMarkdown } from "./lib/markdown.js";
-import {
-  getAllPosts,
-  getExistingTaxonomy,
-  type PostMeta,
-} from "./lib/posts.js";
-import { chatCompletion, hasAPIKey } from "./lib/ai-provider.js";
-
-interface TagSuggestion {
-  tags: string[];
-  category: string;
-  reasoning: string;
-}
-
-const KEYWORD_TAG_MAP: Record<string, string[]> = {
-  astro: ["astro"],
-  react: ["reactjs"],
-  vue: ["vue"],
-  next: ["nextjs"],
-  tailwind: ["tailwindcss"],
-  typescript: ["typescript"],
-  javascript: ["javascript"],
-  css: ["css"],
-  html: ["html"],
-  markdown: ["markdown"],
-  mdx: ["markdown"],
-  api: ["api"],
-  database: ["database"],
-  docker: ["docker"],
-  git: ["git"],
-  python: ["python"],
-  rust: ["rust"],
-  node: ["nodejs"],
-  deploy: ["deployment"],
-  test: ["testing"],
-  performance: ["performance"],
-  seo: ["seo"],
-  a11y: ["accessibility"],
-  ai: ["ai"],
-  机器学习: ["ai", "machine-learning"],
-  深度学习: ["ai", "deep-learning"],
-  大模型: ["ai", "llm"],
-};
-
-function localTagSuggestion(
-  post: PostMeta,
-  existingTags: string[]
-): TagSuggestion {
-  const text = `${post.title} ${post.description} ${post.body}`.toLowerCase();
-  const suggestedTags = new Set<string>();
-
-  for (const [keyword, tags] of Object.entries(KEYWORD_TAG_MAP)) {
-    if (text.includes(keyword.toLowerCase())) {
-      tags.forEach(t => suggestedTags.add(t));
-    }
-  }
-
-  for (const tag of existingTags) {
-    if (text.includes(tag.toLowerCase()) && !suggestedTags.has(tag)) {
-      suggestedTags.add(tag);
-    }
-  }
-
-  const category = post.category || inferCategory(text);
-
-  return {
-    tags: Array.from(suggestedTags).slice(0, 6),
-    category,
-    reasoning: "基于关键词匹配（本地模式，无需 API Key）",
-  };
-}
-
-function inferCategory(text: string): string {
-  if (
-    text.includes("教程") ||
-    text.includes("tutorial") ||
-    text.includes("how to")
-  )
-    return "教程";
-  if (text.includes("配置") || text.includes("config")) return "教程/配置";
-  if (text.includes("发布") || text.includes("release")) return "发布";
-  if (
-    text.includes("示例") ||
-    text.includes("example") ||
-    text.includes("showcase")
-  )
-    return "示例";
-  return "技术";
-}
-
-async function aiTagSuggestion(
-  post: PostMeta,
-  existingTags: string[],
-  existingCategories: string[]
-): Promise<TagSuggestion> {
-  const contentPreview = post.body.slice(0, 3000);
-
-  const prompt = `分析以下博客文章，推荐合适的标签和分类。
-
-文章标题: ${post.title}
-文章描述: ${post.description}
-正文摘要: ${contentPreview}
-
-现有标签体系: ${existingTags.join(", ")}
-现有分类体系: ${existingCategories.join(", ")}
-
-请优先使用现有标签和分类以保持一致性。如果确实需要新标签也可以。
-
-回复 JSON 格式:
-{
-  "tags": ["tag1", "tag2", "tag3"],
-  "category": "分类名",
-  "reasoning": "推荐理由简述"
-}`;
-
-  const result = await chatCompletion(
-    [
-      {
-        role: "system",
-        content:
-          "你是一个技术博客编辑，擅长内容分类。只回复 JSON，不要其他文字。",
-      },
-      { role: "user", content: prompt },
-    ],
-    { maxTokens: 200, responseFormat: "json" }
-  );
-
-  return JSON.parse(result) as TagSuggestion;
-}
-
-async function main() {
-  const args = process.argv.slice(2);
-  const all = args.includes("--all");
-  const write = args.includes("--write");
-  const filePath = args.find(a => !a.startsWith("--"));
-
-  const allPosts = await getAllPosts();
-  const { tags: existingTags, categories: existingCategories } =
-    getExistingTaxonomy(allPosts);
-
-  console.log(
-    `📊 现有标签 (${existingTags.length}): ${existingTags.slice(0, 15).join(", ")}...`
-  );
-  console.log(
-    `📁 现有分类 (${existingCategories.length}): ${existingCategories.join(", ")}\n`
-  );
-
-  const postsToAnalyze: PostMeta[] = [];
-
-  if (all) {
-    postsToAnalyze.push(...allPosts);
-  } else if (filePath) {
-    const fullPath = join(process.cwd(), filePath);
-    const content = await readFile(fullPath, "utf-8");
-    const fm = extractFrontmatter(content);
-
-    postsToAnalyze.push({
-      id: filePath,
-      filePath: fullPath,
-      lang: "zh",
-      title: (fm.data.title as string) || "",
-      description: (fm.data.description as string) || "",
-      tags: Array.isArray(fm.data.tags) ? (fm.data.tags as string[]) : [],
-      category: (fm.data.category as string) || "",
-      body: stripMarkdown(content),
-    });
-  } else {
-    console.error(
-      "用法: pnpm run tools:tags <文章路径> [--write] 或 pnpm run tools:tags --all"
-    );
-    process.exit(1);
-  }
-
-  const mode = hasAPIKey() ? "AI" : "关键词匹配";
-  console.log(
-    `🔍 使用 ${mode} 模式分析 ${postsToAnalyze.length} 篇文章...\n`
-  );
-
-  for (const post of postsToAnalyze) {
-    let suggestion: TagSuggestion;
-
-    try {
-      if (hasAPIKey()) {
-        suggestion = await aiTagSuggestion(
-          post,
-          existingTags,
-          existingCategories
-        );
-      } else {
-        suggestion = localTagSuggestion(post, existingTags);
-      }
-    } catch (err) {
-      console.error(
-        `❌ 分析失败 [${post.title}]:`,
-        (err as Error).message
-      );
-      continue;
-    }
-
-    console.log(`📝 【${post.title}】`);
-    console.log(`   当前标签: [${post.tags.join(", ")}]`);
-    console.log(`   推荐标签: [${suggestion.tags.join(", ")}]`);
-    console.log(`   当前分类: ${post.category || "(无)"}`);
-    console.log(`   推荐分类: ${suggestion.category}`);
-    console.log(`   理由: ${suggestion.reasoning}\n`);
-
-    if (write && !all) {
-      const content = await readFile(post.filePath, "utf-8");
-      let newContent = content;
-
-      const tagsYaml = suggestion.tags.map(t => `  - ${t}`).join("\n");
-      newContent = newContent.replace(
-        /^tags:\n((?:\s+-\s+.*\n)*)/m,
-        `tags:\n${tagsYaml}\n`
-      );
-
-      if (post.category) {
-        newContent = newContent.replace(
-          /^category:.*$/m,
-          `category: ${suggestion.category}`
-        );
-      } else {
-        newContent = newContent.replace(
-          /^(tags:\n(?:\s+-\s+.*\n)*)/,
-          `$1category: ${suggestion.category}\n`
-        );
-      }
-
-      await writeFile(post.filePath, newContent, "utf-8");
-      console.log(`   ✍️  已更新 frontmatter\n`);
-    }
-  }
-}
-
-main().catch(console.error);

package/template/tools/lib/ai-provider.ts

@@ -1,240 +0,0 @@
-import { fetch, ProxyAgent, type Dispatcher } from "undici";
-
-/**
- * 通用 AI Provider 抽象层
- *
- * 统一管理所有 AI API 调用，支持多种 provider 和自定义端点。
- * 工具脚本不应直接调用任何 AI API，而是通过此模块调用。
- *
- * 配置方式（环境变量）:
- *   AI_PROVIDER     — 使用的 provider: "openai" | "anthropic" | "custom" (默认 "openai")
- *   AI_API_KEY      — API Key（也兼容 OPENAI_API_KEY / ANTHROPIC_API_KEY）
- *   AI_BASE_URL     — 自定义 API 基础 URL（用于兼容 OpenAI 接口的第三方服务）
- *   AI_MODEL        — 默认模型名称
- */
-
-export type AIProvider = "openai" | "anthropic" | "custom";
-
-export interface AIConfig {
-  provider: AIProvider;
-  apiKey: string;
-  baseUrl: string;
-  model: string;
-}
-
-export interface ChatMessage {
-  role: "system" | "user" | "assistant";
-  content: string;
-}
-
-export interface ChatOptions {
-  model?: string;
-  maxTokens?: number;
-  responseFormat?: "text" | "json";
-}
-
-export interface EmbeddingOptions {
-  model?: string;
-  batchSize?: number;
-}
-
-export interface ImageOptions {
-  model?: string;
-  size?: string;
-  quality?: string;
-}
-
-function resolveConfig(): AIConfig {
-  const provider = (process.env.AI_PROVIDER || "openai") as AIProvider;
-  const apiKey =
-    process.env.AI_API_KEY ||
-    process.env.OPENAI_API_KEY ||
-    process.env.ANTHROPIC_API_KEY ||
-    "";
-  const baseUrl =
-    process.env.AI_BASE_URL ||
-    (provider === "anthropic"
-      ? "https://api.anthropic.com"
-      : "https://api.openai.com");
-  const model = process.env.AI_MODEL || "gpt-4o-mini";
-
-  return { provider, apiKey, baseUrl, model };
-}
-
-export function getConfig(): AIConfig {
-  return resolveConfig();
-}
-
-export function hasAPIKey(): boolean {
-  const cfg = resolveConfig();
-  return cfg.apiKey.length > 0;
-}
-
-/**
- * 获取代理 dispatcher（如果配置了代理）
- */
-function getProxyDispatcher(): Dispatcher | undefined {
-  const proxyUrl = process.env.HTTPS_PROXY || process.env.https_proxy ||
-                   process.env.HTTP_PROXY || process.env.http_proxy;
-  if (proxyUrl) {
-    return new ProxyAgent(proxyUrl);
-  }
-  return undefined;
-}
-
-export async function chatCompletion(
-  messages: ChatMessage[],
-  options?: ChatOptions
-): Promise<string> {
-  const cfg = resolveConfig();
-  if (!cfg.apiKey) {
-    throw new Error(
-      "AI API Key 未设置。请设置 AI_API_KEY 或 OPENAI_API_KEY 环境变量。"
-    );
-  }
-
-  const model = options?.model || cfg.model;
-  const maxTokens = options?.maxTokens || 1024;
-
-  // 处理 baseUrl 可能已经包含 /v1 的情况
-  const baseUrl = cfg.baseUrl.replace(/\/v1\/?$/, '');
-  const url = `${baseUrl}/v1/chat/completions`;
-  const body: Record<string, unknown> = {
-    model,
-    messages,
-    max_tokens: maxTokens,
-  };
-
-  if (options?.responseFormat === "json") {
-    body.response_format = { type: "json_object" };
-  }
-
-  let response: Awaited<ReturnType<typeof fetch>>;
-  try {
-    const dispatcher = getProxyDispatcher();
-    response = await fetch(url, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        Authorization: `Bearer ${cfg.apiKey}`,
-      },
-      body: JSON.stringify(body),
-      ...(dispatcher && { dispatcher }),
-    });
-  } catch (fetchErr) {
-    const err = fetchErr as Error;
-    throw new Error(
-      `网络请求失败: ${err.message}\n` +
-        `  请检查: API URL 是否正确 (${cfg.baseUrl})\n` +
-        `         网络是否可访问该端点`
-    );
-  }
-
-  if (!response.ok) {
-    const errText = await response.text();
-    throw new Error(`API 错误 (${response.status}): ${errText.slice(0, 200)}`);
-  }
-
-  const data = (await response.json()) as {
-    choices?: { message?: { content?: string } }[];
-  };
-
-  return data.choices?.[0]?.message?.content?.trim() || "";
-}
-
-export async function generateEmbeddings(
-  texts: string[],
-  options?: EmbeddingOptions
-): Promise<number[][]> {
-  const cfg = resolveConfig();
-  if (!cfg.apiKey) {
-    throw new Error("AI API Key 未设置。");
-  }
-
-  const model = options?.model || "text-embedding-3-small";
-  const batchSize = options?.batchSize || 20;
-  const allEmbeddings: number[][] = [];
-
-  for (let i = 0; i < texts.length; i += batchSize) {
-    const batch = texts.slice(i, i + batchSize).map(t => t.slice(0, 8000));
-
-    const dispatcher = getProxyDispatcher();
-    const baseUrl = cfg.baseUrl.replace(/\/v1\/?$/, '');
-    const response = await fetch(`${baseUrl}/v1/embeddings`, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        Authorization: `Bearer ${cfg.apiKey}`,
-      },
-      body: JSON.stringify({ model, input: batch }),
-      ...(dispatcher && { dispatcher }),
-    });
-
-    if (!response.ok) {
-      const errText = await response.text();
-      throw new Error(`Embeddings API 错误 (${response.status}): ${errText}`);
-    }
-
-    const data = (await response.json()) as {
-      data: { embedding: number[] }[];
-    };
-
-    allEmbeddings.push(...data.data.map(d => d.embedding));
-
-    if (i + batchSize < texts.length) {
-      await new Promise(r => setTimeout(r, 200));
-    }
-  }
-
-  return allEmbeddings;
-}
-
-export async function generateImage(
-  prompt: string,
-  options?: ImageOptions
-): Promise<Uint8Array> {
-  const cfg = resolveConfig();
-  if (!cfg.apiKey) {
-    throw new Error("AI API Key 未设置。");
-  }
-
-  const model = options?.model || "dall-e-3";
-  const size = options?.size || "1792x1024";
-  const quality = options?.quality || "standard";
-
-  const dispatcher = getProxyDispatcher();
-  const baseUrl = cfg.baseUrl.replace(/\/v1\/?$/, '');
-  const response = await fetch(`${baseUrl}/v1/images/generations`, {
-    method: "POST",
-    headers: {
-      "Content-Type": "application/json",
-      Authorization: `Bearer ${cfg.apiKey}`,
-    },
-    body: JSON.stringify({
-      model,
-      prompt,
-      n: 1,
-      size,
-      quality,
-      response_format: "b64_json",
-    }),
-    ...(dispatcher && { dispatcher }),
-  });
-
-  if (!response.ok) {
-    const errText = await response.text();
-    throw new Error(`Image API 错误 (${response.status}): ${errText}`);
-  }
-
-  const result = (await response.json()) as {
-    data: { b64_json: string; revised_prompt?: string }[];
-  };
-
-  if (result.data[0].revised_prompt) {
-    console.log(
-      `   修正后的提示词: ${result.data[0].revised_prompt.slice(0, 100)}...`
-    );
-  }
-
-  return new Uint8Array(Buffer.from(result.data[0].b64_json, "base64"));
-}

package/template/tools/lib/frontmatter.ts

@@ -1,94 +0,0 @@
-/**
- * Frontmatter 解析与更新工具
- */
-
-export interface FrontmatterResult {
-  raw: string;
-  body: string;
-  data: Record<string, unknown>;
-}
-
-export function extractFrontmatter(content: string): FrontmatterResult {
-  const match = content.match(/^(---\n[\s\S]*?\n---)\n?([\s\S]*)/);
-  if (!match) return { raw: "", body: content, data: {} };
-
-  const raw = match[1];
-  const body = match[2];
-  const data: Record<string, unknown> = {};
-
-  const lines = raw.replace(/^---\n/, "").replace(/\n---$/, "").split("\n");
-  let currentKey = "";
-  let arrayValues: string[] = [];
-  let inArray = false;
-
-  for (const line of lines) {
-    if (inArray) {
-      if (line.match(/^\s+-\s+/)) {
-        arrayValues.push(line.replace(/^\s+-\s+/, "").trim());
-        continue;
-      } else {
-        data[currentKey] = arrayValues;
-        inArray = false;
-        arrayValues = [];
-      }
-    }
-
-    const colonIndex = line.indexOf(":");
-    if (colonIndex === -1) continue;
-
-    const key = line.slice(0, colonIndex).trim();
-    const value = line.slice(colonIndex + 1).trim();
-
-    if (value === "") {
-      currentKey = key;
-      inArray = true;
-      arrayValues = [];
-      continue;
-    }
-
-    if (value === "true") data[key] = true;
-    else if (value === "false") data[key] = false;
-    else data[key] = value;
-  }
-
-  if (inArray) data[currentKey] = arrayValues;
-
-  return { raw, body, data };
-}
-
-export function updateFrontmatterField(
-  content: string,
-  field: string,
-  value: string | string[]
-): string {
-  const lines = content.split("\n");
-  const closingIdx = lines.indexOf("---", 1);
-  if (closingIdx < 0) return content;
-
-  const fieldRegex = new RegExp(`^${field}:`);
-  const existingIdx = lines.findIndex(
-    (l, i) => i > 0 && i < closingIdx && fieldRegex.test(l)
-  );
-
-  if (Array.isArray(value)) {
-    const yamlArray = value.map(v => `  - ${v}`).join("\n");
-    const newBlock = `${field}:\n${yamlArray}`;
-
-    if (existingIdx >= 0) {
-      let endIdx = existingIdx + 1;
-      while (endIdx < closingIdx && lines[endIdx].match(/^\s+-\s+/)) endIdx++;
-      lines.splice(existingIdx, endIdx - existingIdx, newBlock);
-    } else {
-      lines.splice(closingIdx, 0, newBlock);
-    }
-  } else {
-    const newLine = `${field}: ${value}`;
-    if (existingIdx >= 0) {
-      lines[existingIdx] = newLine;
-    } else {
-      lines.splice(closingIdx, 0, newLine);
-    }
-  }
-
-  return lines.join("\n");
-}

package/template/tools/lib/markdown.ts

@@ -1,40 +0,0 @@
-/**
- * Markdown 文本处理工具
- */
-
-export function stripMarkdown(content: string): string {
-  return content
-    .replace(/^---[\s\S]*?---\n?/, "")
-    .replace(/^import\s+.*$/gm, "")
-    .replace(/<[^>]+\/>/g, "")
-    .replace(/<[^>]+>[\s\S]*?<\/[^>]+>/g, "")
-    .replace(/```[\s\S]*?```/g, "")
-    .replace(/`[^`]*`/g, "")
-    .replace(/!\[.*?\]\(.*?\)/g, "")
-    .replace(/\[([^\]]*)\]\(.*?\)/g, "$1")
-    .replace(/#{1,6}\s+/g, "")
-    .replace(/[*_~]+/g, "")
-    .replace(/^\s*[-*+]\s+/gm, "")
-    .replace(/^\s*\d+\.\s+/gm, "")
-    .replace(/\n{3,}/g, "\n\n")
-    .trim();
-}
-
-export function chunkText(
-  text: string,
-  size: number = 500,
-  overlap: number = 50
-): string[] {
-  const words = text.split(/\s+/);
-  const chunks: string[] = [];
-
-  for (let i = 0; i < words.length; i += size - overlap) {
-    const chunk = words.slice(i, i + size).join(" ");
-    if (chunk.trim().length > 20) {
-      chunks.push(chunk.trim());
-    }
-    if (i + size >= words.length) break;
-  }
-
-  return chunks.length > 0 ? chunks : [text.slice(0, 2000)];
-}

package/template/tools/lib/posts.ts

@@ -1,89 +0,0 @@
-/**
- * 博客文章读取与遍历工具
- */
-
-import { readdir, readFile } from "node:fs/promises";
-import { join } from "node:path";
-import { extractFrontmatter } from "./frontmatter.js";
-import { stripMarkdown } from "./markdown.js";
-
-export const BLOG_PATH = join(process.cwd(), "src/data/blog");
-
-export interface PostMeta {
-  id: string;
-  filePath: string;
-  lang: string;
-  title: string;
-  description: string;
-  tags: string[];
-  category: string;
-  body: string;
-  draft?: boolean;
-}
-
-export function getPostURL(id: string): string {
-  const parts = id.split("/");
-  const lang = parts[0];
-  const slug = parts.slice(1).join("/");
-  return `/${lang}/posts/${slug}/`;
-}
-
-export async function getAllPosts(opts?: {
-  includeDrafts?: boolean;
-  stripBody?: boolean;
-}): Promise<PostMeta[]> {
-  const posts: PostMeta[] = [];
-
-  async function walk(dir: string) {
-    const entries = await readdir(dir, { withFileTypes: true });
-    for (const entry of entries) {
-      const fullPath = join(dir, entry.name);
-      if (entry.isDirectory() && !entry.name.startsWith("_")) {
-        await walk(fullPath);
-      } else if (entry.name.endsWith(".md") || entry.name.endsWith(".mdx")) {
-        const content = await readFile(fullPath, "utf-8");
-        const fm = extractFrontmatter(content);
-        const isDraft = fm.data.draft === true;
-
-        if (isDraft && !opts?.includeDrafts) continue;
-
-        const relativePath = fullPath.replace(BLOG_PATH + "/", "");
-        const lang = relativePath.startsWith("en/") ? "en" : "zh";
-        const id = relativePath.replace(/\.(md|mdx)$/, "");
-
-        posts.push({
-          id,
-          filePath: fullPath,
-          lang,
-          title: (fm.data.title as string) || "",
-          description: (fm.data.description as string) || "",
-          tags: Array.isArray(fm.data.tags) ? (fm.data.tags as string[]) : [],
-          category: (fm.data.category as string) || "",
-          body: opts?.stripBody === false ? fm.body : stripMarkdown(content),
-          draft: isDraft,
-        });
-      }
-    }
-  }
-
-  await walk(BLOG_PATH);
-  return posts;
-}
-
-export function getExistingTaxonomy(posts: PostMeta[]): {
-  tags: string[];
-  categories: string[];
-} {
-  const tagSet = new Set<string>();
-  const catSet = new Set<string>();
-
-  for (const post of posts) {
-    post.tags.forEach(t => tagSet.add(t));
-    if (post.category) catSet.add(post.category);
-  }
-
-  return {
-    tags: Array.from(tagSet).sort(),
-    categories: Array.from(catSet).sort(),
-  };
-}