@astro-minimax/cli 0.5.0 → 0.7.0

package/template/functions/api/notify/status.ts

@@ -0,0 +1,97 @@
+/// <reference types="@cloudflare/workers-types" />
+
+interface NotifyStatusEnv {
+  NOTIFY_TELEGRAM_BOT_TOKEN?: string;
+  NOTIFY_TELEGRAM_CHAT_ID?: string;
+  NOTIFY_WEBHOOK_URL?: string;
+  NOTIFY_RESEND_API_KEY?: string;
+  NOTIFY_RESEND_FROM?: string;
+  NOTIFY_RESEND_TO?: string;
+  SITE_URL?: string;
+  [key: string]: unknown;
+}
+
+interface ProviderStatus {
+  configured: boolean;
+  missingFields?: string[];
+}
+
+interface NotifyStatusResponse {
+  timestamp: string;
+  environment: 'production' | 'preview' | 'unknown';
+  providers: {
+    telegram: ProviderStatus;
+    email: ProviderStatus;
+    webhook: ProviderStatus;
+  };
+  siteUrl: {
+    configured: boolean;
+    value?: string;
+  };
+  summary: {
+    totalProviders: number;
+    configuredProviders: number;
+    hasAnyProvider: boolean;
+  };
+}
+
+export const onRequest: PagesFunction<NotifyStatusEnv> = async (context) => {
+  const env = context.env;
+  
+  const telegramMissing = [
+    !env.NOTIFY_TELEGRAM_BOT_TOKEN && 'NOTIFY_TELEGRAM_BOT_TOKEN',
+    !env.NOTIFY_TELEGRAM_CHAT_ID && 'NOTIFY_TELEGRAM_CHAT_ID',
+  ].filter(Boolean) as string[];
+  
+  const emailMissing = [
+    !env.NOTIFY_RESEND_API_KEY && 'NOTIFY_RESEND_API_KEY',
+    !env.NOTIFY_RESEND_FROM && 'NOTIFY_RESEND_FROM',
+    !env.NOTIFY_RESEND_TO && 'NOTIFY_RESEND_TO',
+  ].filter(Boolean) as string[];
+  
+  const webhookMissing = [
+    !env.NOTIFY_WEBHOOK_URL && 'NOTIFY_WEBHOOK_URL',
+  ].filter(Boolean) as string[];
+  
+  const environment = context.request.headers.get('x-cf-env') || 'unknown';
+  
+  const providers = {
+    telegram: {
+      configured: telegramMissing.length === 0,
+      missingFields: telegramMissing.length > 0 ? telegramMissing : undefined,
+    },
+    email: {
+      configured: emailMissing.length === 0,
+      missingFields: emailMissing.length > 0 ? emailMissing : undefined,
+    },
+    webhook: {
+      configured: webhookMissing.length === 0,
+      missingFields: webhookMissing.length > 0 ? webhookMissing : undefined,
+    },
+  };
+  
+  const configuredProviders = Object.values(providers).filter(p => p.configured).length;
+  
+  const response: NotifyStatusResponse = {
+    timestamp: new Date().toISOString(),
+    environment: environment as 'production' | 'preview' | 'unknown',
+    providers,
+    siteUrl: {
+      configured: !!env.SITE_URL,
+      value: env.SITE_URL ? '[CONFIGURED]' : undefined,
+    },
+    summary: {
+      totalProviders: 3,
+      configuredProviders,
+      hasAnyProvider: configuredProviders > 0,
+    },
+  };
+  
+  return new Response(JSON.stringify(response, null, 2), {
+    status: 200,
+    headers: {
+      'Content-Type': 'application/json',
+      'Cache-Control': 'no-store, no-cache, must-revalidate',
+    },
+  });
+};

package/template/functions/api/notify/test-ai-chat.ts

@@ -0,0 +1,67 @@
+/// <reference types="@cloudflare/workers-types" />
+
+import { notifyAiChat } from '@astro-minimax/ai/server';
+
+interface TestEnv {
+  NOTIFY_TELEGRAM_BOT_TOKEN?: string;
+  NOTIFY_TELEGRAM_CHAT_ID?: string;
+  NOTIFY_WEBHOOK_URL?: string;
+  NOTIFY_RESEND_API_KEY?: string;
+  NOTIFY_RESEND_FROM?: string;
+  NOTIFY_RESEND_TO?: string;
+  SITE_URL?: string;
+  [key: string]: unknown;
+}
+
+export const onRequest: PagesFunction<TestEnv> = async (context) => {
+  const env = context.env;
+  
+  const result = await notifyAiChat({
+    env,
+    sessionId: `test-${Date.now()}`,
+    messages: [
+      { id: '1', role: 'user', parts: [{ type: 'text', text: '这是一条测试消息' }] }
+    ],
+    aiResponse: '这是一条测试 AI 回复',
+    referencedArticles: [
+      { title: '测试文章', url: '/posts/test' }
+    ],
+    model: {
+      name: 'test-model',
+      provider: 'test',
+    },
+    usage: {
+      total: 150,
+      input: 100,
+      output: 50,
+    },
+    timing: {
+      total: 1000,
+      keywordExtraction: 100,
+      search: 200,
+      evidenceAnalysis: 100,
+      generation: 600,
+    },
+  });
+  
+  return new Response(JSON.stringify({
+    success: !!result,
+    result: result ? {
+      event: result.event,
+      success: result.success,
+      channels: result.results.map(r => ({
+        channel: r.channel,
+        success: r.success,
+        error: r.error,
+      })),
+    } : null,
+    envCheck: {
+      hasTelegram: !!env.NOTIFY_TELEGRAM_BOT_TOKEN,
+      hasChatId: !!env.NOTIFY_TELEGRAM_CHAT_ID,
+      hasResend: !!env.NOTIFY_RESEND_API_KEY,
+    },
+  }, null, 2), {
+    status: 200,
+    headers: { 'Content-Type': 'application/json' },
+  });
+};

package/template/package.json

@@ -5,29 +5,32 @@
   "scripts": {
     "dev": "astro dev",
     "dev:ai": "pnpm exec astro-ai-dev",
-    "dev:full": "concurrently -n \"astro,ai\" -c \"blue,green\" \"astro dev\" \"pnpm exec astro-ai-dev\"",
     "build": "astro check && astro build && pagefind --site dist && cp -r dist/pagefind public/",
     "preview": "wrangler pages dev dist",
     "preview:astro": "astro preview",
     "lint": "eslint .",
-    "tools:summarize": "tsx tools/summarize.ts",
-    "tools:generate-related": "tsx tools/generate-related.ts",
-    "tools:translate": "tsx tools/translate.ts",
-    "tools:vectorize": "tsx tools/vectorize.ts",
-    "tools:cover": "tsx tools/generate-cover.ts",
-    "tools:tags": "tsx tools/generate-tags.ts",
-    "ai:process": "tsx tools/ai-process.ts",
-    "context:build": "tsx tools/build-author-context.ts",
-    "voice:build": "tsx tools/build-voice-profile.ts",
-    "profile:generate": "tsx tools/generate-author-profile.ts"
+    "cli": "astro-minimax",
+    "ai:process": "astro-minimax ai process",
+    "ai:seo": "astro-minimax ai seo",
+    "ai:summary": "astro-minimax ai summary",
+    "ai:eval": "astro-minimax ai eval",
+    "profile:build": "astro-minimax profile build",
+    "profile:context": "astro-minimax profile context",
+    "profile:voice": "astro-minimax profile voice",
+    "profile:report": "astro-minimax profile report",
+    "post:new": "astro-minimax post new",
+    "post:list": "astro-minimax post list",
+    "post:stats": "astro-minimax post stats",
+    "data:status": "astro-minimax data status",
+    "data:clear": "astro-minimax data clear"
   },
   "dependencies": {
     "@ai-sdk/openai-compatible": "^2.0.35",
     "@ai-sdk/react": "^3.0.118",
-    "@astro-minimax/ai": "^0.1.0",
-    "@astro-minimax/core": "^0.1.0",
-    "@astro-minimax/notify": "^0.1.0",
-    "@astro-minimax/viz": "^0.1.4",
+    "@astro-minimax/ai": "^0.5.0",
+    "@astro-minimax/core": "^0.5.0",
+    "@astro-minimax/notify": "^0.5.0",
+    "@astro-minimax/viz": "^0.5.0",
     "@astrojs/mdx": "^5.0.0",
     "@astrojs/preact": "^5.0.0",
     "@astrojs/rss": "^4.0.17",
@@ -44,34 +47,28 @@
     "mermaid": "^11.12.3",
     "preact": "^10.29.0",
     "rehype-katex": "^7.0.1",
-    "remark-collapse": "^0.1.2",
     "remark-emoji": "^5.0.2",
     "remark-github-alerts": "^0.1.1",
     "remark-markmap": "^1.1.5",
     "remark-math": "^6.0.0",
-    "remark-toc": "^9.0.0",
     "satori": "^0.18.0",
     "sharp": "^0.34.5",
     "slugify": "^1.6.6",
     "tailwindcss": "^4.2.1"
   },
   "devDependencies": {
+    "@astro-minimax/cli": "^0.6.0",
     "@astrojs/check": "^0.9.6",
     "@cloudflare/workers-types": "^4.20260313.1",
     "@pagefind/default-ui": "^1.4.0",
-    "@shikijs/transformers": "^4.0.0",
+    "@shikijs/transformers": "^4.0.2",
     "@types/lodash.kebabcase": "^4.1.9",
-    "@types/mdast": "^4.0.4",
-    "concurrently": "^9.1.2",
     "eslint": "^9.39.3",
     "eslint-plugin-astro": "^1.6.0",
-    "globals": "^16.2.0",
+    "globals": "^16.5.0",
     "pagefind": "^1.4.0",
-    "tsx": "^4.21.0",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.39.0",
-    "undici": "^7.24.1",
-    "unist-util-visit": "^5.1.0",
+    "typescript-eslint": "^8.56.1",
     "wrangler": "^4.73.0"
   }
 }

package/template/src/config.ts

@@ -87,6 +87,17 @@ export const SITE: SiteConfig = {
   //   src: "https://your-umami-instance.com/script.js",
   // },
 
+  // Search provider: 'pagefind' (default, static) or 'docsearch' (Algolia)
+  // search: {
+  //   provider: 'docsearch',
+  //   docsearch: {
+  //     appId: 'YOUR_ALGOLIA_APP_ID',
+  //     apiKey: 'YOUR_ALGOLIA_SEARCH_API_KEY',
+  //     indexName: 'YOUR_INDEX_NAME',
+  //     placeholder: 'Search docs...',
+  //   },
+  // },
+
   copyright: {
     license: "CC BY-NC-SA 4.0",
     licenseUrl: "https://creativecommons.org/licenses/by-nc-sa/4.0/",

package/template/src/content.config.ts

@@ -1,27 +1,40 @@
 import { defineCollection } from "astro:content";
 import { z } from "astro/zod";
 import { glob } from "astro/loaders";
+import { SITE } from "@/config";
+
+export const BLOG_PATH = "src/data/blog";
 
 const blog = defineCollection({
   loader: glob({
     pattern: "**/[^_]*.{md,mdx}",
-    base: "./src/data/blog",
-    generateId: ({ entry }) => entry.replace(/\.(md|mdx)$/, ""),
-  }),
-  schema: z.object({
-    title: z.string(),
-    description: z.string(),
-    pubDatetime: z.date(),
-    modDatetime: z.date().optional().nullable(),
-    author: z.string().optional(),
-    tags: z.array(z.string()).default(["others"]),
-    category: z.string().optional(),
-    series: z.object({ name: z.string(), order: z.number() }).optional(),
-    featured: z.boolean().optional(),
-    draft: z.boolean().optional(),
-    ogImage: z.string().optional(),
-    canonicalURL: z.string().optional(),
+    base: `./${BLOG_PATH}`,
+    generateId: ({ entry }) => {
+      return entry.replace(/\.(md|mdx)$/, "");
+    },
   }),
+  schema: ({ image }) =>
+    z.object({
+      author: z.string().default(SITE.author),
+      pubDatetime: z.date(),
+      modDatetime: z.date().optional().nullable(),
+      title: z.string(),
+      featured: z.boolean().optional(),
+      draft: z.boolean().optional(),
+      tags: z.array(z.string()).default(["others"]),
+      category: z.string().optional(),
+      series: z
+        .object({
+          name: z.string(),
+          order: z.number(),
+        })
+        .optional(),
+      ogImage: image().or(z.string()).optional(),
+      description: z.string(),
+      canonicalURL: z.string().optional(),
+      hideEditPost: z.boolean().optional(),
+      timezone: z.string().optional(),
+    }),
 });
 
 export const collections = { blog };

package/template/src/env.d.ts

@@ -1,9 +1,4 @@
 /// <reference types="astro/content" />
-declare module "remark-collapse" {
-  import type { Plugin } from "unified";
-  const plugin: Plugin;
-  export default plugin;
-}
 declare module "remark-github-alerts" {
   import type { Plugin } from "unified";
   const plugin: Plugin;

package/index.js

@@ -1,36 +0,0 @@
-#!/usr/bin/env node
-import { cpSync, mkdirSync, existsSync, readFileSync, writeFileSync } from "node:fs";
-import { join, resolve, basename } from "node:path";
-import { fileURLToPath } from "node:url";
-
-const __dirname = fileURLToPath(new URL(".", import.meta.url));
-const templateDir = join(__dirname, "template");
-
-const projectName = process.argv[2];
-if (!projectName) {
-  console.error("Usage: astro-minimax <project-name>");
-  console.error("       npx @astro-minimax/cli <project-name>");
-  process.exit(1);
-}
-
-const targetDir = resolve(process.cwd(), projectName);
-
-if (existsSync(targetDir)) {
-  console.error(`Directory "${projectName}" already exists.`);
-  process.exit(1);
-}
-
-mkdirSync(targetDir, { recursive: true });
-cpSync(templateDir, targetDir, { recursive: true });
-
-const pkgPath = join(targetDir, "package.json");
-const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
-pkg.name = basename(targetDir);
-writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
-
-console.log(`\n  ✅ Created "${projectName}" successfully!\n`);
-console.log("  Next steps:\n");
-console.log(`    cd ${projectName}`);
-console.log("    pnpm install");
-console.log("    pnpm dev\n");
-console.log("  Docs: https://github.com/souloss/astro-minimax\n");

package/template/tools/README.md

@@ -1,169 +0,0 @@
-# AI 数据构建工具
-
-本目录包含用于博客内容处理和 AI 功能数据构建的工具脚本。
-
-## 环境配置
-
-在 `.env` 文件中配置以下环境变量：
-
-```bash
-# AI API 配置（必需，用于 AI 相关脚本）
-AI_API_KEY=your_api_key
-AI_BASE_URL=https://api.openai.com    # 或其他 OpenAI 兼容 API
-AI_MODEL=gpt-4o-mini                   # 模型名称
-
-# 站点配置（可选）
-SITE_URL=https://your-domain.com
-SITE_AUTHOR=博主名称
-SITE_DESCRIPTION=站点描述
-```
-
-## 脚本列表
-
-### 内容处理
-
-| 脚本 | 命令 | 说明 |
-|------|------|------|
-| `ai-process.ts` | `pnpm ai:process` | AI 文章批处理（摘要、SEO） |
-| `summarize.ts` | `pnpm tools:summarize` | 生成文章摘要 |
-| `generate-related.ts` | `pnpm tools:generate-related` | 生成相关文章 |
-| `generate-tags.ts` | `pnpm tools:tags` | 生成文章标签 |
-| `translate.ts` | `pnpm tools:translate` | 文章翻译 |
-| `vectorize.ts` | `pnpm tools:vectorize` | 生成文章向量 |
-| `generate-cover.ts` | `pnpm tools:cover` | 生成文章封面 |
-| `generate-og.ts` | `pnpm og` | 生成 OG 图片 |
-
-### AI 分身数据构建
-
-| 脚本 | 命令 | 说明 |
-|------|------|------|
-| `build-author-context.ts` | `pnpm context:build` | 构建作者上下文数据 |
-| `build-voice-profile.ts` | `pnpm voice:build` | 构建表达风格画像 |
-| `generate-author-profile.ts` | `pnpm profile:generate` | 生成作者画像报告 |
-
-## 详细说明
-
-### ai-process.ts — AI 文章批处理
-
-为文章生成 AI 摘要和 SEO 元数据。
-
-```bash
-# 处理所有文章
-pnpm ai:process
-
-# 只处理中文文章
-pnpm ai:process --lang=zh
-
-# 只处理指定文章
-pnpm ai:process --slug=zh/getting-started
-
-# 只生成摘要
-pnpm ai:process --task=summary
-
-# 预览模式
-pnpm ai:process --dry-run
-
-# 强制重新处理
-pnpm ai:process --force
-
-# 清空跳过列表后重试
-pnpm ai:process --clear-skip
-```
-
-**输出文件**:
-- `datas/ai-summaries.json` — 文章摘要数据
-- `datas/ai-seo.json` — SEO 元数据
-- `datas/ai-skip-list.json` — 失败文章跳过列表
-
-### build-author-context.ts — 构建作者上下文
-
-聚合博客文章数据，为 AI 分身对话提供上下文。
-
-```bash
-pnpm context:build
-```
-
-**输出文件**:
-- `datas/author-context.json` — 作者上下文数据
-- `datas/sources/blog-digest.json` — 文章摘要
-
-### build-voice-profile.ts — 构建表达风格画像
-
-从博客标题、正文中提取作者的表达风格特征。纯本地分析，不调用 AI。
-
-```bash
-pnpm voice:build
-```
-
-**输出文件**:
-- `datas/voice-profile.json` — 表达风格画像
-
-### generate-author-profile.ts — 生成作者画像报告
-
-基于上下文数据生成用于 About 页面的结构化简介。
-
-```bash
-# AI 生成（需要配置 AI API）
-pnpm profile:generate
-
-# 使用规则模板（不需要 AI）
-pnpm profile:generate --no-ai
-```
-
-**输出文件**:
-- `datas/author-profile-report.json` — 画像报告
-- `datas/author-profile-context.json` — 生成上下文
-
-## 输出目录结构
-
-```
-datas/
-├── ai-summaries.json          # AI 生成的文章摘要
-├── ai-seo.json               # AI 生成的 SEO 数据
-├── ai-skip-list.json         # AI 处理失败的文章列表
-├── author-context.json       # 作者上下文（AI 分身使用）
-├── author-profile-report.json # 作者画像报告
-├── author-profile-context.json
-├── voice-profile.json        # 表达风格画像
-└── sources/
-    └── blog-digest.json      # 文章摘要数据
-```
-
-## 开发说明
-
-### 共享模块
-
-- `lib/ai-provider.ts` — AI API 调用封装（支持代理）
-- `lib/utils.ts` — 通用工具函数
-- `lib/posts.ts` — 文章读取工具
-- `lib/frontmatter.ts` — Frontmatter 解析
-- `lib/markdown.ts` — Markdown 处理
-
-### AI Provider 使用
-
-```typescript
-import { chatCompletion, hasAPIKey, getConfig } from "./lib/ai-provider.js";
-
-if (hasAPIKey()) {
-  const result = await chatCompletion([
-    { role: "system", content: "系统提示" },
-    { role: "user", content: "用户输入" },
-  ], { maxTokens: 2000, responseFormat: "json" });
-}
-```
-
-### URL 策略
-
-工具脚本生成的 URL 均为**相对路径**（如 `/zh/my-post`），不包含域名前缀。在 AI 对话运行时，`initializeMetadata()` 会根据 `SITE_URL` 环境变量动态拼接完整 URL。这使得生成的数据文件与部署环境无关。
-
-### 数据文件与 AI 对话的关系
-
-`datas/` 目录中的 JSON 文件在运行时被 `@astro-minimax/ai/server` 的 `initializeMetadata()` 加载，用于构建搜索索引和系统提示词上下文。
-
-### 代理支持
-
-脚本自动支持 `HTTP_PROXY` / `HTTPS_PROXY` 环境变量，无需额外配置。
-
-```bash
-export HTTPS_PROXY=http://127.0.0.1:7890
-```