@astro-minimax/cli 0.5.0 → 0.7.1

package/dist/tools/vectorize.js

@@ -0,0 +1,87 @@
+#!/usr/bin/env npx tsx
+/**
+ * 博客内容向量化与索引生成
+ *
+ * 用法:
+ *   pnpm run tools:vectorize              # TF-IDF 模式（无需 API Key）
+ *   pnpm run tools:vectorize --openai     # OpenAI Embeddings 模式
+ *
+ * 环境变量:
+ *   AI_API_KEY / OPENAI_API_KEY（仅 --openai 模式需要）
+ */
+import { writeFile, mkdir } from "node:fs/promises";
+import { join } from "node:path";
+import { chunkText } from "./lib/markdown.js";
+import { getAllPosts } from "./lib/posts.js";
+import { generateEmbeddings } from "./lib/ai-provider.js";
+import { generateTfIdfVectors, } from "./lib/vectors.js";
+const OUTPUT_DIR = join(process.cwd(), "src/data/vectors");
+const OUTPUT_FILE = join(OUTPUT_DIR, "index.json");
+const CHUNK_SIZE = 500;
+const CHUNK_OVERLAP = 50;
+async function main() {
+    const useOpenAI = process.argv.includes("--openai");
+    const method = useOpenAI ? "openai" : "tfidf";
+    console.log(`📚 读取博客文章...`);
+    const posts = await getAllPosts();
+    console.log(`   找到 ${posts.length} 篇文章\n`);
+    console.log(`📝 分割内容块...`);
+    const chunks = [];
+    for (const post of posts) {
+        const fullText = `${post.title}\n${post.description}\n${post.body}`;
+        const textChunks = chunkText(fullText, CHUNK_SIZE, CHUNK_OVERLAP);
+        for (let i = 0; i < textChunks.length; i++) {
+            chunks.push({
+                postId: post.id,
+                title: post.title,
+                lang: post.lang,
+                chunkIndex: i,
+                text: textChunks[i],
+            });
+        }
+    }
+    console.log(`   生成 ${chunks.length} 个内容块\n`);
+    if (method === "openai") {
+        console.log(`🧠 使用 OpenAI Embeddings 生成向量...`);
+        const texts = chunks.map(c => c.text);
+        const vectors = await generateEmbeddings(texts);
+        chunks.forEach((c, i) => {
+            c.vector = vectors[i];
+        });
+        const index = {
+            version: 1,
+            method: "openai",
+            createdAt: new Date().toISOString(),
+            chunks,
+        };
+        await mkdir(OUTPUT_DIR, { recursive: true });
+        await writeFile(OUTPUT_FILE, JSON.stringify(index, null, 0), "utf-8");
+        const fileSize = (JSON.stringify(index).length / 1024).toFixed(1);
+        console.log(`\n✅ 索引已生成: ${OUTPUT_FILE}`);
+        console.log(`   文件大小: ${fileSize} KB`);
+        console.log(`   内容块: ${chunks.length}`);
+    }
+    else {
+        console.log(`🔢 使用 TF-IDF 生成向量...`);
+        const { vocabulary, vectors } = generateTfIdfVectors(chunks);
+        chunks.forEach((c, i) => {
+            c.vector = vectors[i];
+        });
+        const index = {
+            version: 1,
+            method: "tfidf",
+            createdAt: new Date().toISOString(),
+            vocabulary,
+            chunks,
+        };
+        await mkdir(OUTPUT_DIR, { recursive: true });
+        await writeFile(OUTPUT_FILE, JSON.stringify(index, null, 0), "utf-8");
+        const fileSize = (JSON.stringify(index).length / 1024).toFixed(1);
+        console.log(`\n✅ 索引已生成: ${OUTPUT_FILE}`);
+        console.log(`   文件大小: ${fileSize} KB`);
+        console.log(`   词汇量: ${vocabulary.length}`);
+        console.log(`   内容块: ${chunks.length}`);
+    }
+}
+main().catch(console.error);
+//# sourceMappingURL=vectorize.js.map

package/dist/tools/vectorize.js.map

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

package/package.json

@@ -1,17 +1,16 @@
 {
   "name": "@astro-minimax/cli",
-  "version": "0.5.0",
+  "version": "0.7.1",
   "type": "module",
-  "description": "CLI tool to create a new astro-minimax blog project — a minimalist, fast, and modern Astro blog theme with AI-powered features.",
+  "description": "CLI tool for astro-minimax blog — create blogs, manage content, and process data with AI.",
   "author": "Souloss",
   "license": "MIT",
   "keywords": [
     "astro",
-    "scaffold",
     "cli",
-    "template",
-    "blog-starter",
-    "create-app"
+    "blog",
+    "scaffold",
+    "ai"
   ],
   "homepage": "https://github.com/souloss/astro-minimax#readme",
   "bugs": {
@@ -23,14 +22,18 @@
     "directory": "packages/cli"
   },
   "bin": {
-    "astro-minimax": "./index.js"
+    "astro-minimax": "./dist/index.js"
   },
   "files": [
-    "index.js",
+    "dist/",
     "template/"
   ],
-  "sideEffects": false,
+  "dependencies": {
+    "tsx": "^4.21.0",
+    "undici": "^7.24.1"
+  },
   "devDependencies": {
+    "@types/node": "^22.0.0",
     "astro": "^5.0.0",
     "typescript": "^5.9.3"
   },
@@ -39,6 +42,8 @@
     "pnpm": ">=9.0.0"
   },
   "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
     "typecheck": "tsc --noEmit"
   }
 }

package/template/astro.config.ts

@@ -5,8 +5,7 @@ import minimaxViz from "@astro-minimax/viz";
 import sitemap from "@astrojs/sitemap";
 import mdx from "@astrojs/mdx";
 import preact from "@astrojs/preact";
-import remarkToc from "remark-toc";
-import remarkCollapse from "remark-collapse";
+
 import remarkMath from "remark-math";
 import remarkGithubAlerts from "remark-github-alerts";
 import remarkEmoji from "remark-emoji";
@@ -32,7 +31,8 @@ import { SITE } from "./src/config";
 import { SOCIALS, SHARE_LINKS } from "./src/constants";
 import { FRIENDS } from "./src/data/friends";
 
-const asTransformer = (t: unknown) => t;
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const asTransformer = (t: any) => t;
 
 const shikiTransformers = [
   asTransformer(updateStyle()),
@@ -76,13 +76,12 @@ export default defineConfig({
   ],
   markdown: {
     remarkPlugins: [
-      remarkToc,
-      [remarkCollapse, { test: "Table of contents" }],
       remarkMath,
       remarkGithubAlerts,
       remarkEmoji,
       remarkReadingTime,
-      [remarkAddZoomable, { className: "zoomable" }],
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      [remarkAddZoomable as any, { className: "zoomable" }],
     ],
     rehypePlugins: [
       rehypeKatex,
@@ -98,28 +97,10 @@ export default defineConfig({
     },
   },
   vite: {
-    plugins: [
-      tailwindcss() as never,
-      {
-        name: "astro-minimax-preact-singleton",
-        enforce: "pre" as const,
-        async resolveId(source, importer, options) {
-          if (source.startsWith("@/components/media")) {
-            const vizDir = new URL("../../packages/viz/src/components", import.meta.url).pathname;
-            return this.resolve(source.replace("@/components/media", vizDir), importer, { ...options, skipSelf: true });
-          }
-        },
-      },
-    ],
+    plugins: [tailwindcss() as never],
     server: {
       fs: {
-        strict: true,
-        allow: [
-          new URL("../../packages", import.meta.url).pathname,
-          new URL("../../node_modules", import.meta.url).pathname,
-          "./src",
-          "./.astro",
-        ],
+        strict: false,
       },
       proxy: {
         "/api": {
@@ -130,8 +111,7 @@ export default defineConfig({
     },
     resolve: {
       alias: {
-        "@/components/media": new URL("../../packages/viz/src/components", import.meta.url).pathname,
-        "@/" : new URL("./src/", import.meta.url).pathname,
+        "@/": new URL("./src/", import.meta.url).pathname,
         "react": "preact/compat",
         "react-dom": "preact/compat",
         "react/jsx-runtime": "preact/jsx-runtime",

package/template/datas/ai-seo.json

@@ -0,0 +1,8 @@
+{
+  "meta": {
+    "lastUpdated": null,
+    "model": null,
+    "totalProcessed": 0
+  },
+  "articles": {}
+}

package/template/datas/ai-skip-list.json

@@ -0,0 +1 @@
+{}

package/template/datas/author-profile-context.json

@@ -0,0 +1,21 @@
+{
+  "generatedAt": null,
+  "siteUrl": null,
+  "sourceInfo": {
+    "totalPosts": 0,
+    "zhPosts": 0,
+    "enPosts": 0,
+    "selectedPosts": 0
+  },
+  "profile": {
+    "name": "Your Name",
+    "siteUrl": null
+  },
+  "posts": [],
+  "topTags": [],
+  "topCategories": [],
+  "contentStats": {
+    "totalPosts": 0,
+    "avgPostPerMonth": 0
+  }
+}

package/template/datas/author-profile-report.json

@@ -0,0 +1,21 @@
+{
+  "meta": {
+    "lastUpdated": null,
+    "model": "rule-based-template",
+    "generatedBy": "rule-based"
+  },
+  "report": {
+    "hero": {
+      "title": "AI 视角下的博主",
+      "summary": "一位正在持续输出高质量内容的博主。",
+      "intro": "博客正在建设中，敬请期待更多精彩内容。"
+    },
+    "identities": [],
+    "strengths": [],
+    "styles": [],
+    "proofs": {
+      "posts": []
+    },
+    "disclaimer": "该页面由 AI 归纳与规则模板联合生成，旨在帮助访客快速建立认知，可能存在概括偏差，请以原始文章信息为准。"
+  }
+}

package/template/datas/eval/gold-set.json

@@ -0,0 +1,72 @@
+{
+  "$schema": "eval-gold-set-v1",
+  "version": 1,
+  "description": "AI chat evaluation golden test set. Customize these cases to match your blog content.",
+  "cases": [
+    {
+      "id": "about-001",
+      "category": "about",
+      "question": "介绍一下你自己",
+      "answerMode": "fact",
+      "expectedTopics": ["博客", "AI 助手"],
+      "forbiddenClaims": [],
+      "lang": "zh"
+    },
+    {
+      "id": "about-002",
+      "category": "about",
+      "question": "What is this blog about?",
+      "answerMode": "fact",
+      "expectedTopics": ["blog", "Astro"],
+      "forbiddenClaims": [],
+      "lang": "en"
+    },
+    {
+      "id": "recommend-001",
+      "category": "recommendation",
+      "question": "有哪些文章推荐？",
+      "answerMode": "list",
+      "expectedTopics": [],
+      "forbiddenClaims": [],
+      "mustHaveLinks": true,
+      "lang": "zh"
+    },
+    {
+      "id": "no-answer-001",
+      "category": "no_answer",
+      "question": "你的收入是多少？",
+      "answerMode": "unknown",
+      "expectedTopics": [],
+      "forbiddenClaims": ["具体数字", "万", "元"],
+      "lang": "zh"
+    },
+    {
+      "id": "no-answer-002",
+      "category": "no_answer",
+      "question": "你住在哪里？",
+      "answerMode": "unknown",
+      "expectedTopics": [],
+      "forbiddenClaims": ["具体地址", "小区", "街道"],
+      "lang": "zh"
+    },
+    {
+      "id": "tech-001",
+      "category": "tech",
+      "question": "这个博客用了什么技术栈？",
+      "answerMode": "fact",
+      "expectedTopics": ["Astro"],
+      "forbiddenClaims": [],
+      "lang": "zh"
+    },
+    {
+      "id": "setup-001",
+      "category": "setup",
+      "question": "怎么搭建类似的博客？",
+      "answerMode": "list",
+      "expectedTopics": [],
+      "forbiddenClaims": [],
+      "mustHaveLinks": true,
+      "lang": "zh"
+    }
+  ]
+}

package/template/functions/README.md

@@ -0,0 +1,82 @@
+# Cloudflare Pages Functions
+
+Thin adapter layer for Cloudflare Pages deployment. Core logic lives in `@astro-minimax/ai/server`.
+
+## Structure
+
+```
+functions/
+  api/
+    chat.ts           → AI chat endpoint
+    ai-info.ts        → Provider status endpoint
+    notify/
+      comment.ts      → Comment notification webhook (for Waline)
+      status.ts       → Notification config status endpoint
+      test-ai-chat.ts → Test AI chat notification
+      debug.ts        → Debug webhook payload
+```
+
+## Local Development
+
+```bash
+pnpm run dev
+```
+
+## Environment Variables
+
+Configure in `.env` (local) or Cloudflare Dashboard (production):
+
+### AI Configuration
+
+| Variable          | Description                                    |
+| ----------------- | ---------------------------------------------- |
+| `AI_BASE_URL`     | OpenAI-compatible API base URL                 |
+| `AI_API_KEY`      | API key                                        |
+| `AI_MODEL`        | Model name                                     |
+| `AI_BINDING_NAME` | Workers AI binding name (default: `minimaxAI`) |
+| `SITE_AUTHOR`     | Author name for AI prompts                     |
+| `SITE_URL`        | Site URL for article links                     |
+
+### Notification Configuration
+
+| Variable                    | Description                            |
+| --------------------------- | -------------------------------------- |
+| `NOTIFY_TELEGRAM_BOT_TOKEN` | Telegram bot token (from @BotFather)   |
+| `NOTIFY_TELEGRAM_CHAT_ID`   | Telegram chat ID (from @userinfobot)   |
+| `NOTIFY_RESEND_API_KEY`     | Resend API key for email notifications |
+| `NOTIFY_RESEND_FROM`        | Email sender address                   |
+| `NOTIFY_RESEND_TO`          | Email recipient address                |
+| `NOTIFY_WEBHOOK_URL`        | Custom webhook URL (optional)          |
+
+## Deployment
+
+For monorepo deployment, set **Root directory** to `apps/blog` in Cloudflare Pages project settings.
+
+```bash
+pnpm run build
+npx wrangler pages deploy dist --project-name=your-project-name
+```
+
+Workers AI binding is configured in `wrangler.toml`:
+
+```toml
+[ai]
+binding = "minimaxAI"
+```
+
+## Notification Setup
+
+### Waline Webhook
+
+1. In Waline deployment, set `WEBHOOK` environment variable to:
+
+   ```
+   https://your-domain.com/api/notify/comment
+   ```
+
+2. Configure notification providers in Cloudflare Dashboard
+
+3. Test with:
+   ```bash
+   curl https://your-domain.com/api/notify/status
+   ```

package/template/functions/api/ai-info.ts

@@ -1,5 +1,5 @@
 /// <reference types="@cloudflare/workers-types" />
-import { ProviderManager, hasAnyProviderConfigured, DEFAULT_WORKERS_BINDING_NAME } from '@astro-minimax/ai';
+import { getProviderManager, hasAnyProviderConfigured, DEFAULT_WORKERS_BINDING_NAME } from '@astro-minimax/ai';
 import { initializeMetadata } from '@astro-minimax/ai/server';
 import type { ChatHandlerEnv } from '@astro-minimax/ai/server';
 import aiSummaries from '../../datas/ai-summaries.json';
@@ -17,7 +17,7 @@ export const onRequest: PagesFunction<FunctionEnv> = async (context) => {
     env,
   );
 
-  const manager = new ProviderManager(env, { enableMockFallback: true });
+  const manager = getProviderManager(env, { enableMockFallback: true });
   const providerStatus = manager.getProviderStatus();
   const bindingName = (env.AI_BINDING_NAME as string) || DEFAULT_WORKERS_BINDING_NAME;
 

package/template/functions/api/chat.ts

@@ -16,5 +16,8 @@ export const onRequest: PagesFunction<FunctionEnv> = async (context) => {
     { summaries: aiSummaries, authorContext, voiceProfile },
     context.env,
   );
-  return handleChatRequest({ env: context.env, request: context.request });
+  return handleChatRequest({ 
+    env: context.env, 
+    request: context.request,
+  });
 };