koishi-plugin-my-pig-group-friends 1.1.3 → 1.1.4

package/README.md

@@ -2,15 +2,33 @@
 
 [![npm](https://img.shields.io/npm/v/koishi-plugin-my-pig-group-friends?style=flat-square)](https://www.npmjs.com/package/koishi-plugin-my-pig-group-friends)
 
-猪醒 - 虚拟旅行打卡插件，让你的猪猪群友环游世界。
+**猪醒** - 虚拟旅行打卡插件，让你的猪猪群友环游世界。
 
-## 功能特点
+> 你群里有没有那种作息混乱、日夜颠倒的猪猪朋友？现在，每当他们在奇怪的时间冒泡，就送他们去世界各地"旅行"吧！
 
-- **虚拟旅行打卡**：随机（或通过 LLM）生成全球旅行地点，生成精美毛玻璃效果足迹卡片
-- **作息异常检测（实验性）**：自动检测用户每日首条消息，根据当地日出时间判断作息是否异常并触发旅行
-- **高质量背景**：集成 Unsplash API 获取目的地真实风景图
-- **AI 生图支持**：支持通过 media-luna 插件生成小猪在当地旅行的 AI 插画
-- **存储集成**：深度集成 chatluna-storage-service 进行图片管理
+## 功能亮点
+
+- **虚拟旅行打卡** - 生成精美毛玻璃效果足迹卡片，记录猪猪的环球之旅
+- **智能日出选点** - LLM 会根据当前时间，选择正在迎接日出的地区作为目的地（毕竟是"猪醒"嘛）
+- **高质量风景图** - 集成 Unsplash / Pexels API，获取目的地真实风景照片
+- **AI 生图支持** - 可选生成小猪在当地旅行的 AI 插画
+- **作息异常检测（实验性）** - 自动检测用户每日首条消息时间，判断作息是否异常
+
+## 效果预览
+
+当触发旅行时，会生成类似这样的卡片：
+
+```
+┌─────────────────────────────┐
+│  [目的地风景照片背景]        │
+│                             │
+│  🐷 xxx 猪醒！              │
+│                             │
+│  去了 冰岛蓝湖温泉，冰岛！   │
+│                             │
+│  2024-01-15 06:32           │
+└─────────────────────────────┘
+```
 
 ## 安装
 
@@ -22,40 +40,86 @@ npm install koishi-plugin-my-pig-group-friends
 
 ### 必需
 - `database` - 存储用户状态和旅行日志
-- `cron` - 定时清理和报表生成
-- `puppeteer` - 生成精美卡片
+- `cron` - 定时清理任务
+- `puppeteer` - 渲染精美卡片
 
 ### 可选
-- `chatluna` - 用于 LLM 动态生成旅行地点
-- `chatluna_storage` - 用于高效管理和分发生成的图片卡片
-- `media-luna` - 用于 AI 绘图功能
+- `chatluna` - LLM 动态生成旅行地点（推荐）
+- `chatluna_storage` - 高效管理图片缓存
+- `media-luna` - AI 绘图功能
 
 ## 使用方法
 
 ### 指令
 
-- `pig [user]` - 触发一次虚拟旅行。如果不指定用户，则对自己生效。
-- `猪醒 [user]` - `pig` 指令的别名。
+| 指令 | 说明 |
+|------|------|
+| `pig` | 送自己去旅行 |
+| `pig @某人` | 送指定用户去旅行 |
+| `猪醒` | `pig` 的别名 |
+
+### 示例
+
+```
+> 猪醒 @张三
+🐷 张三 猪醒！去了 挪威罗弗敦群岛，挪威！
+[精美卡片图片]
+```
 
-## 配置项
+## 配置说明
 
 ### 基础设置
-- `outputMode`: 输出模式（image/text）。
-- `travelMessageTemplate`: 旅行消息模板。
+
+| 配置项 | 默认值 | 说明 |
+|--------|--------|------|
+| `outputMode` | `image` | 输出模式：`image` 生成卡片，`text` 纯文本 |
+| `travelMessageTemplate` | `去了 {landmark}，{country}！` | 旅行消息模板 |
 
 ### 地点与图片
-- `llmLocationEnabled`: 是否启用 LLM 动态生成地点。
-- `llmLocationModel`: 生成地点的 LLM 模型（推荐使用轻量快速模型）。
-- `unsplashAccessKey`: Unsplash API 访问密钥。
+
+| 配置项 | 默认值 | 说明 |
+|--------|--------|------|
+| `llmLocationEnabled` | `false` | 启用 LLM 动态生成地点 |
+| `llmLocationModel` | - | LLM 模型（推荐 gemini-flash 等快速模型） |
+| `llmLocationCustomContext` | - | 自定义偏好（如：北欧风格、赛博朋克建筑等） |
+| `imageSearchPrompt` | `{landmark} {country} landscape` | 图片搜索关键词模板 |
+| `unsplashAccessKey` | - | Unsplash API 密钥 |
+| `pexelsApiKey` | - | Pexels API 密钥（备用图源） |
 
 ### AI 生图（可选）
-- `aigcEnabled`: 是否启用 AI 绘图。
-- `aigcChannel`: media-luna 绘图渠道。
-- `aigcPrompt`: 绘图提示词模板。
+
+| 配置项 | 默认值 | 说明 |
+|--------|--------|------|
+| `aigcEnabled` | `false` | 启用 AI 绘图 |
+| `aigcChannel` | - | media-luna 绘图渠道 |
+| `aigcPrompt` | `一个可爱的卡通小猪正在...` | 绘图提示词模板 |
 
 ### 自动检测（实验性）
-- `experimentalAutoDetect`: 是否启用自动作息异常检测。
-- `abnormalThreshold`: 异常判定阈值（小时）。
+
+| 配置项 | 默认值 | 说明 |
+|--------|--------|------|
+| `experimentalAutoDetect` | `false` | 自动检测作息异常 |
+| `abnormalThreshold` | `3` | 异常判定阈值（小时） |
+
+### 存储设置
+
+| 配置项 | 默认值 | 说明 |
+|--------|--------|------|
+| `useStorageService` | `true` | 使用存储服务缓存图片 |
+| `storageCacheHours` | `24` | 图片缓存时间（小时） |
+| `logRetentionDays` | `45` | 旅行记录保留天数 |
+
+## 获取 API 密钥
+
+### Unsplash（推荐）
+1. 访问 [Unsplash Developers](https://unsplash.com/developers)
+2. 创建应用，获取 Access Key
+3. 免费额度：50 次/小时
+
+### Pexels（备用）
+1. 访问 [Pexels API](https://www.pexels.com/api/)
+2. 注册并获取 API Key
+3. 免费额度：200 次/小时
 
 ## License
 

package/lib/config.d.ts

@@ -21,6 +21,7 @@ export interface Config {
     backgroundFetchMode: 'auto' | 'always' | 'never';
     backgroundFetchTimeoutMs: number;
     logRetentionDays: number;
+    monthlySummaryEnabled: boolean;
     experimentalAutoDetect: boolean;
     debug: boolean;
 }

package/lib/database.d.ts

@@ -20,7 +20,10 @@ export interface PigTravelLog {
     platform: string;
     timestamp: Date;
     country: string;
+    countryZh: string;
     location: string;
+    locationZh: string;
+    timezone: string;
     imagePath: string;
     isAIGC: boolean;
 }

package/lib/index.js

@@ -45,7 +45,10 @@ function applyDatabase(ctx) {
     platform: "string",
     timestamp: "timestamp",
     country: "string",
+    countryZh: "string",
     location: "string",
+    locationZh: "string",
+    timezone: "string",
     imagePath: "string",
     isAIGC: "boolean"
   }, { primary: "id", autoInc: true });
@@ -146,8 +149,8 @@ async function generateFootprintCard(ctx, config, data, userInfo, platform, back
           },
           redirect: "follow"
         });
-        const contentType = response.headers.get("content-type") || "";
-        const contentLength = response.headers.get("content-length") || "unknown";
+        const contentType = response.headers?.["content-type"] || "";
+        const contentLength = response.headers?.["content-length"] || "unknown";
         if (config.debug) {
           ctx.logger("pig").debug(
             `Background fetch response: status=${response.status} url=${response.url} content-type=${contentType || "unknown"} content-length=${contentLength}`
@@ -1057,7 +1060,8 @@ async function searchUnsplashPhoto(ctx, accessKey, query, debug = false) {
       {
         params: {
           query,
-          per_page: 1,
+          per_page: 10,
+          // Fetch more results for variety
           orientation: "landscape"
         },
         headers: {
@@ -1068,13 +1072,15 @@ async function searchUnsplashPhoto(ctx, accessKey, query, debug = false) {
       }
     );
     if (response.results && response.results.length > 0) {
-      let photoUrl = response.results[0].urls.regular;
+      const randomIndex = Math.floor(Math.random() * response.results.length);
+      const selectedPhoto = response.results[randomIndex];
+      let photoUrl = selectedPhoto.urls.regular;
       if (photoUrl.includes("?")) {
         photoUrl += "&fm=webp&q=85";
       } else {
         photoUrl += "?fm=webp&q=85";
       }
-      if (debug) ctx.logger("pig").debug(`Unsplash: Found photo URL: ${photoUrl}`);
+      if (debug) ctx.logger("pig").debug(`Unsplash: Selected photo ${randomIndex + 1}/${response.results.length}, URL: ${photoUrl}`);
       return photoUrl;
     }
     if (debug) ctx.logger("pig").debug("Unsplash: No photos found for query");
@@ -1100,7 +1106,8 @@ async function searchPexelsPhoto(ctx, apiKey, query, debug = false) {
       {
         params: {
           query,
-          per_page: 1,
+          per_page: 10,
+          // Fetch more results for variety
           orientation: "landscape"
         },
         headers: {
@@ -1110,7 +1117,9 @@ async function searchPexelsPhoto(ctx, apiKey, query, debug = false) {
       }
     );
     if (response.photos && response.photos.length > 0) {
-      let photoUrl = response.photos[0].src.large2x || response.photos[0].src.large;
+      const randomIndex = Math.floor(Math.random() * response.photos.length);
+      const selectedPhoto = response.photos[randomIndex];
+      let photoUrl = selectedPhoto.src.large2x || selectedPhoto.src.large;
       if (photoUrl.includes("w=")) {
         photoUrl = photoUrl.replace(/w=\d+/, "w=1080");
       } else if (photoUrl.includes("?")) {
@@ -1118,7 +1127,7 @@ async function searchPexelsPhoto(ctx, apiKey, query, debug = false) {
       } else {
         photoUrl += "?w=1080";
       }
-      if (debug) ctx.logger("pig").debug(`Pexels: Found photo URL: ${photoUrl}`);
+      if (debug) ctx.logger("pig").debug(`Pexels: Selected photo ${randomIndex + 1}/${response.photos.length}, URL: ${photoUrl}`);
       return photoUrl;
     }
     if (debug) ctx.logger("pig").debug("Pexels: No photos found for query");
@@ -1397,7 +1406,10 @@ async function triggerTravelSequence(ctx, config, userInfo, platform) {
     platform,
     timestamp: now,
     country: location.country,
+    countryZh: location.countryZh || location.country,
     location: location.landmark,
+    locationZh: location.landmarkZh || location.landmark,
+    timezone: location.timezone || "UTC",
     imagePath: imageUrl || "",
     // 存储 URL 或空
     isAIGC
@@ -1412,6 +1424,630 @@ async function triggerTravelSequence(ctx, config, userInfo, platform) {
 }
 __name(triggerTravelSequence, "triggerTravelSequence");
 
+// src/services/summary.ts
+async function getMonthlyLogs(ctx, userId, platform, year, month) {
+  const startDate = new Date(year, month - 1, 1);
+  const endDate = new Date(year, month, 1);
+  const logs = await ctx.database.get("pig_travel_log", {
+    userId,
+    platform,
+    timestamp: {
+      $gte: startDate,
+      $lt: endDate
+    }
+  });
+  logs.sort((a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime());
+  return logs;
+}
+__name(getMonthlyLogs, "getMonthlyLogs");
+async function getUsersWithLogsInMonth(ctx, year, month) {
+  const startDate = new Date(year, month - 1, 1);
+  const endDate = new Date(year, month, 1);
+  const logs = await ctx.database.get("pig_travel_log", {
+    timestamp: {
+      $gte: startDate,
+      $lt: endDate
+    }
+  });
+  const userMap = /* @__PURE__ */ new Map();
+  for (const log of logs) {
+    const key = `${log.platform}:${log.userId}`;
+    if (!userMap.has(key)) {
+      userMap.set(key, { userId: log.userId, platform: log.platform });
+    }
+  }
+  return Array.from(userMap.values());
+}
+__name(getUsersWithLogsInMonth, "getUsersWithLogsInMonth");
+function formatTimezone(timezone) {
+  if (!timezone || timezone === "UTC") return "UTC";
+  try {
+    const now = /* @__PURE__ */ new Date();
+    const formatter = new Intl.DateTimeFormat("en-US", {
+      timeZone: timezone,
+      timeZoneName: "shortOffset"
+    });
+    const parts = formatter.formatToParts(now);
+    const tzPart = parts.find((p) => p.type === "timeZoneName");
+    if (tzPart) {
+      return tzPart.value.replace("GMT", "UTC");
+    }
+  } catch {
+  }
+  if (timezone.startsWith("UTC")) return timezone;
+  return "UTC";
+}
+__name(formatTimezone, "formatTimezone");
+async function generateMonthlySummaryCard(ctx, config, data) {
+  const { year, month, logs, username, totalTrips, countriesVisited, locationsVisited } = data;
+  let { avatarUrl } = data;
+  if (avatarUrl && avatarUrl.startsWith("http")) {
+    try {
+      if (config.debug) ctx.logger("pig").debug(`Fetching avatar: ${avatarUrl}`);
+      const response = await ctx.http(avatarUrl, {
+        responseType: "arraybuffer",
+        timeout: 5e3,
+        headers: {
+          "User-Agent": "Mozilla/5.0",
+          "Accept": "image/*"
+        }
+      });
+      const buffer = Buffer.from(response.data);
+      const contentType = response.headers?.["content-type"] || "image/jpeg";
+      avatarUrl = `data:${contentType};base64,${buffer.toString("base64")}`;
+      if (config.debug) ctx.logger("pig").debug(`Avatar fetched successfully, size: ${buffer.length}`);
+    } catch (e) {
+      if (config.debug) ctx.logger("pig").warn(`Failed to fetch avatar: ${e}`);
+      avatarUrl = "";
+    }
+  }
+  const monthNames = ["一月", "二月", "三月", "四月", "五月", "六月", "七月", "八月", "九月", "十月", "十一月", "十二月"];
+  const monthName = monthNames[month - 1];
+  const tripsHtml = logs.slice(0, 12).map((log, index) => {
+    const date = new Date(log.timestamp);
+    const dayStr = `${date.getMonth() + 1}/${date.getDate()}`;
+    const tz = formatTimezone(log.timezone);
+    return `
+      <div class="trip-item">
+        <div class="trip-index">${index + 1}</div>
+        <div class="trip-info">
+          <div class="trip-location">${escapeHtml2(log.locationZh || log.location)}</div>
+          <div class="trip-country">${escapeHtml2(log.countryZh || log.country)} · ${dayStr}</div>
+          <div class="trip-location-en">${escapeHtml2(log.location)}</div>
+        </div>
+        <div class="trip-tz">${tz}</div>
+      </div>
+    `;
+  }).join("");
+  const moreTripsHtml = logs.length > 12 ? `<div class="more-trips">... 还有 ${logs.length - 12} 次旅行</div>` : "";
+  const statsHtml = `
+    <div class="stats-grid">
+      <div class="stat-item bg-yellow">
+        <div class="stat-value">${totalTrips}</div>
+        <div class="stat-label">次旅行</div>
+        <div class="deco-dot"></div>
+      </div>
+      <div class="stat-item bg-pink">
+        <div class="stat-value">${countriesVisited.length}</div>
+        <div class="stat-label">个国家</div>
+        <div class="deco-line"></div>
+      </div>
+      <div class="stat-item bg-cyan">
+        <div class="stat-value">${locationsVisited.length}</div>
+        <div class="stat-label">个地点</div>
+        <div class="deco-triangle"></div>
+      </div>
+    </div>
+  `;
+  const html = `
+<!DOCTYPE html>
+<html>
+<head>
+<meta charset="UTF-8">
+<style>
+  @import url('https://fonts.googleapis.com/css2?family=Noto+Sans+SC:wght@400;700;900&display=swap');
+
+  * {
+    margin: 0;
+    padding: 0;
+    box-sizing: border-box;
+  }
+
+  body {
+    width: 1080px;
+    min-height: 1920px;
+    font-family: "Noto Sans SC", sans-serif, "Noto Color Emoji";
+    background-color: #F0F0F0;
+    background-image:
+      radial-gradient(#000 10%, transparent 11%),
+      radial-gradient(#000 10%, transparent 11%);
+    background-size: 30px 30px;
+    background-position: 0 0, 15px 15px;
+    background-color: #FFDEE9;
+    padding: 60px;
+  }
+
+  .twemoji {
+    font-family: "Twemoji", "Noto Color Emoji", sans-serif;
+  }
+
+  .container {
+    background: #fff;
+    border: 4px solid #000;
+    box-shadow: 20px 20px 0 #000;
+    padding: 60px;
+    position: relative;
+    overflow: hidden;
+  }
+
+  /* Memphis decorative elements */
+  .deco-shape-1 {
+    position: absolute;
+    top: -20px;
+    right: -20px;
+    width: 150px;
+    height: 150px;
+    background: #FFD700;
+    border: 4px solid #000;
+    border-radius: 50%;
+    z-index: 0;
+  }
+
+  .deco-shape-2 {
+    position: absolute;
+    bottom: 40px;
+    left: -30px;
+    width: 100px;
+    height: 100px;
+    background: #00CED1;
+    border: 4px solid #000;
+    transform: rotate(45deg);
+    z-index: 0;
+  }
+
+  .header {
+    display: flex;
+    align-items: center;
+    gap: 32px;
+    margin-bottom: 48px;
+    position: relative;
+    z-index: 1;
+    background: #fff;
+    border: 4px solid #000;
+    padding: 24px;
+    box-shadow: 8px 8px 0 #000;
+  }
+
+  .avatar-ring {
+    padding: 0;
+    border: 4px solid #000;
+    border-radius: 50%;
+    overflow: hidden;
+    background: #FF69B4;
+  }
+
+  .avatar {
+    width: 120px;
+    height: 120px;
+    object-fit: cover;
+    display: block;
+  }
+
+  .user-info {
+    flex: 1;
+  }
+
+  .username {
+    font-size: 48px;
+    font-weight: 900;
+    color: #000;
+    margin-bottom: 8px;
+    text-transform: uppercase;
+    letter-spacing: -1px;
+  }
+
+  .period {
+    font-size: 28px;
+    color: #000;
+    font-weight: 700;
+    background: #00CED1;
+    display: inline-block;
+    padding: 4px 12px;
+    border: 3px solid #000;
+    box-shadow: 4px 4px 0 #000;
+  }
+
+  .title-section {
+    text-align: center;
+    margin-bottom: 48px;
+    position: relative;
+    z-index: 1;
+    border-bottom: 4px solid #000;
+    padding-bottom: 24px;
+  }
+
+  .title {
+    font-size: 80px;
+    font-weight: 900;
+    color: #000;
+    margin-bottom: 16px;
+    text-shadow: 6px 6px 0 #FF69B4;
+    letter-spacing: 4px;
+  }
+
+  .subtitle {
+    font-size: 32px;
+    color: #000;
+    font-weight: 700;
+    background: #FFD700;
+    display: inline-block;
+    padding: 8px 24px;
+    border: 3px solid #000;
+    box-shadow: 6px 6px 0 #000;
+    transform: rotate(-2deg);
+  }
+
+  .stats-grid {
+    display: flex;
+    justify-content: space-between;
+    margin-bottom: 48px;
+    gap: 24px;
+    position: relative;
+    z-index: 1;
+  }
+
+  .stat-item {
+    text-align: center;
+    flex: 1;
+    padding: 32px 16px;
+    border: 4px solid #000;
+    box-shadow: 12px 12px 0 #000;
+    position: relative;
+    overflow: hidden;
+  }
+
+  .bg-yellow { background: #FFD700; }
+  .bg-pink { background: #FF69B4; }
+  .bg-cyan { background: #00CED1; }
+
+  .stat-value {
+    font-size: 72px;
+    font-weight: 900;
+    color: #000;
+    line-height: 1;
+    position: relative;
+    z-index: 2;
+  }
+
+  .stat-label {
+    font-size: 24px;
+    color: #000;
+    margin-top: 8px;
+    font-weight: 700;
+    text-transform: uppercase;
+    position: relative;
+    z-index: 2;
+  }
+
+  .trips-section {
+    margin-bottom: 32px;
+    position: relative;
+    z-index: 1;
+  }
+
+  .section-title {
+    font-size: 36px;
+    font-weight: 900;
+    color: #000;
+    margin-bottom: 24px;
+    padding: 12px 24px;
+    border: 4px solid #000;
+    display: inline-block;
+    background: #fff;
+    box-shadow: 8px 8px 0 #000;
+  }
+
+  .trips-list {
+    display: flex;
+    flex-direction: column;
+    gap: 20px;
+  }
+
+  .trip-item {
+    display: flex;
+    align-items: center;
+    gap: 20px;
+    padding: 20px 24px;
+    background: #fff;
+    border: 3px solid #000;
+    box-shadow: 8px 8px 0 #000;
+    transition: transform 0.2s;
+    position: relative;
+    overflow: hidden;
+  }
+
+  .trip-item:nth-child(odd) {
+    transform: rotate(0.5deg);
+  }
+
+  .trip-item:nth-child(even) {
+    transform: rotate(-0.5deg);
+  }
+
+  .trip-index {
+    width: 48px;
+    height: 48px;
+    background: #000;
+    color: #fff;
+    border-radius: 0;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    font-size: 24px;
+    font-weight: 700;
+    flex-shrink: 0;
+    box-shadow: 4px 4px 0 #FF69B4;
+    position: relative;
+    z-index: 2;
+  }
+
+  .trip-info {
+    flex: 1;
+    position: relative;
+    z-index: 2;
+  }
+
+  .trip-location {
+    font-size: 28px;
+    font-weight: 800;
+    color: #000;
+    margin-bottom: 4px;
+  }
+
+  .trip-location-en {
+    position: absolute;
+    right: 120px;
+    bottom: -10px;
+    font-size: 16px;
+    font-weight: 900;
+    color: rgba(0,0,0,0.08);
+    text-transform: uppercase;
+    letter-spacing: 1px;
+    pointer-events: none;
+    white-space: nowrap;
+    font-style: italic;
+    z-index: 1;
+  }
+
+  .trip-country {
+    font-size: 22px;
+    color: #000;
+    font-weight: 500;
+    background: #eee;
+    display: inline-block;
+    padding: 2px 8px;
+    border: 2px solid #000;
+  }
+
+  .trip-tz {
+    font-size: 18px;
+    font-weight: 700;
+    color: #000;
+    background: #FFD700;
+    padding: 6px 12px;
+    border: 2px solid #000;
+    box-shadow: 3px 3px 0 #000;
+    flex-shrink: 0;
+  }
+
+  .more-trips {
+    text-align: center;
+    padding: 20px;
+    color: #000;
+    font-size: 24px;
+    font-weight: 700;
+    background: #fff;
+    border: 3px dashed #000;
+    margin-top: 10px;
+  }
+
+  .footer {
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+    margin-top: 60px;
+    padding-top: 32px;
+    border-top: 6px solid #000;
+    position: relative;
+    z-index: 1;
+  }
+
+  .brand {
+    display: flex;
+    align-items: center;
+    gap: 12px;
+  }
+
+  .brand-icon {
+    font-size: 40px;
+    background: #FF69B4;
+    border: 3px solid #000;
+    padding: 4px;
+    line-height: 1;
+    box-shadow: 4px 4px 0 #000;
+  }
+
+  .brand-name {
+    font-size: 32px;
+    font-weight: 900;
+    text-transform: uppercase;
+    color: #000;
+    font-style: italic;
+  }
+
+  .generated-at {
+    font-size: 20px;
+    color: #000;
+    font-weight: 600;
+    background: #fff;
+    padding: 4px 12px;
+    border: 2px solid #000;
+  }
+
+  .empty-state {
+    text-align: center;
+    padding: 80px 40px;
+    border: 4px dashed #000;
+    background: #fff;
+    margin: 40px 0;
+  }
+
+  .empty-icon {
+    font-size: 80px;
+    margin-bottom: 24px;
+  }
+
+  .empty-text {
+    font-size: 32px;
+    font-weight: 700;
+    color: #000;
+  }
+</style>
+</head>
+<body>
+  <div class="deco-shape-1"></div>
+  <div class="deco-shape-2"></div>
+
+  <div class="container">
+    <div class="header">
+      <div class="avatar-ring">
+        <img class="avatar" src="${avatarUrl || "https://ui-avatars.com/api/?name=U&background=667eea&color=fff"}" onerror="this.src='https://ui-avatars.com/api/?name=U&background=667eea&color=fff'" />
+      </div>
+      <div class="user-info">
+        <div class="username">${escapeHtml2(username)}</div>
+        <div class="period">${year}年${monthName} 总结</div>
+      </div>
+    </div>
+
+    <div class="title-section">
+      <div class="title">猪猪日报</div>
+      <div class="subtitle">PIG DAILY SUMMARY</div>
+    </div>
+
+    ${totalTrips > 0 ? `
+      ${statsHtml}
+
+      <div class="trips-section">
+        <div class="section-title">本月足迹 TRACKS</div>
+        <div class="trips-list">
+          ${tripsHtml}
+          ${moreTripsHtml}
+        </div>
+      </div>
+    ` : `
+      <div class="empty-state">
+        <div class="empty-icon"><span class="twemoji">🐷</span></div>
+        <div class="empty-text">这个月还没有旅行记录哦~</div>
+      </div>
+    `}
+
+    <div class="footer">
+      <div class="brand">
+        <div class="brand-icon"><span class="twemoji">🐷</span></div>
+        <div class="brand-name">Pig Travel</div>
+      </div>
+      <div class="generated-at">${(/* @__PURE__ */ new Date()).toLocaleDateString("zh-CN")}</div>
+    </div>
+  </div>
+
+  <script>
+    async function waitForImages() {
+      const images = Array.from(document.images);
+      const promises = images.map(img => {
+        if (img.complete) return Promise.resolve();
+        return new Promise(resolve => {
+          img.onload = () => resolve();
+          img.onerror = () => resolve();
+        });
+      });
+      await Promise.all([
+        ...promises,
+        document.fonts.ready
+      ]);
+      await new Promise(r => setTimeout(r, 100));
+    }
+    window.renderReady = waitForImages();
+  </script>
+</body>
+</html>
+  `;
+  let page = null;
+  try {
+    page = await ctx.puppeteer.page();
+    if (config.debug) {
+      page.on("console", (msg) => ctx.logger("pig").debug(`[Summary] ${msg.text()}`));
+    }
+    const baseHeight = 1200;
+    const tripHeight = Math.min(logs.length, 12) * 90;
+    const extraHeight = logs.length > 12 ? 60 : 0;
+    const totalHeight = baseHeight + tripHeight + extraHeight + (logs.length === 0 ? 200 : 0);
+    await page.setViewport({ width: 1080, height: Math.max(1920, totalHeight), deviceScaleFactor: 1 });
+    await page.setContent(html, { waitUntil: "domcontentloaded" });
+    await page.evaluate(() => window["renderReady"]);
+    const buffer = await page.screenshot({ type: "png", fullPage: true });
+    const filename = `pig_summary_${data.userId}_${year}_${month}.png`;
+    ctx.logger("pig").info(`月度总结卡片已生成: ${filename}`);
+    return { buffer, filename };
+  } catch (e) {
+    ctx.logger("pig").error("Failed to generate summary card", e);
+    throw e;
+  } finally {
+    if (page) {
+      try {
+        await page.close();
+      } catch (closeError) {
+        if (config.debug) {
+          ctx.logger("pig").warn(`Failed to close puppeteer page: ${closeError}`);
+        }
+      }
+    }
+  }
+}
+__name(generateMonthlySummaryCard, "generateMonthlySummaryCard");
+async function prepareMonthlySummary(ctx, userId, platform, username, avatarUrl, year, month) {
+  const logs = await getMonthlyLogs(ctx, userId, platform, year, month);
+  const countriesSet = /* @__PURE__ */ new Set();
+  const locationsSet = /* @__PURE__ */ new Set();
+  for (const log of logs) {
+    countriesSet.add(log.country);
+    locationsSet.add(log.location);
+  }
+  return {
+    userId,
+    platform,
+    username,
+    avatarUrl,
+    year,
+    month,
+    logs,
+    totalTrips: logs.length,
+    countriesVisited: Array.from(countriesSet),
+    locationsVisited: Array.from(locationsSet)
+  };
+}
+__name(prepareMonthlySummary, "prepareMonthlySummary");
+function escapeHtml2(text) {
+  const map = {
+    "&": "&amp;",
+    "<": "&lt;",
+    ">": "&gt;",
+    '"': "&quot;",
+    "'": "&#039;"
+  };
+  return text.replace(/[&<>"']/g, (m) => map[m]);
+}
+__name(escapeHtml2, "escapeHtml");
+
 // src/config.ts
 var import_koishi = require("koishi");
 var Config = import_koishi.Schema.intersect([
@@ -1449,6 +2085,7 @@ var Config = import_koishi.Schema.intersect([
     useStorageService: import_koishi.Schema.boolean().default(true).description("使用 chatluna-storage-service 缓存图片（推荐）"),
     storageCacheHours: import_koishi.Schema.number().default(24).description("图片缓存时间（小时）"),
     logRetentionDays: import_koishi.Schema.number().default(45).description("旅行记录保留天数"),
+    monthlySummaryEnabled: import_koishi.Schema.boolean().default(false).description("每月1日自动生成上月旅行总结"),
     logPath: import_koishi.Schema.string().default("./data/pig/logs").description("本地日志存储路径（仅在不使用存储服务时生效）")
   }).description("存储设置 💾"),
   import_koishi.Schema.object({
@@ -1539,6 +2176,79 @@ function apply(ctx, config) {
     const result = await triggerTravelSequence(ctx, config, userInfo, platform);
     return formatTravelMessage(result, userId, config);
   });
+  ctx.command("pig.summary [year:number] [month:number]", "生成月度旅行总结（调试用）").option("all", "-a 生成所有用户的总结").action(async ({ session, options }, yearArg, monthArg) => {
+    const now = /* @__PURE__ */ new Date();
+    let year = yearArg ?? now.getFullYear();
+    let month = monthArg ?? now.getMonth();
+    if (!monthArg && now.getMonth() === 0) {
+      year = now.getFullYear() - 1;
+      month = 12;
+    } else if (!monthArg) {
+      month = now.getMonth();
+    }
+    if (month < 1 || month > 12) {
+      return "月份必须在 1-12 之间";
+    }
+    await session.send(`正在生成 ${year}年${month}月 的旅行总结...`);
+    try {
+      if (options.all) {
+        const users = await getUsersWithLogsInMonth(ctx, year, month);
+        if (users.length === 0) {
+          return `${year}年${month}月 没有任何旅行记录`;
+        }
+        await session.send(`找到 ${users.length} 位用户有旅行记录，开始生成...`);
+        for (const { userId, platform } of users) {
+          try {
+            const summaryData = await prepareMonthlySummary(
+              ctx,
+              userId,
+              platform,
+              userId,
+              "",
+              year,
+              month
+            );
+            const result = await generateMonthlySummaryCard(ctx, config, summaryData);
+            const base64 = result.buffer.toString("base64");
+            await session.send(`用户 ${userId} 的总结：
+${import_koishi2.segment.image(`base64://${base64}`)}`);
+          } catch (e) {
+            ctx.logger("pig").error(`Failed to generate summary for user ${userId}:`, e);
+            await session.send(`生成用户 ${userId} 的总结时出错: ${e}`);
+          }
+        }
+        return `已完成 ${users.length} 位用户的月度总结生成`;
+      } else {
+        const platform = session.platform;
+        const userId = session.userId;
+        let avatarUrl = session.author?.avatar || "";
+        if (!avatarUrl && (platform === "onebot" || platform === "qq" || platform.includes("qq"))) {
+          avatarUrl = `https://q.qlogo.cn/headimg_dl?dst_uin=${userId}&spec=640`;
+        }
+        const userInfo = {
+          userId,
+          username: session.author?.nickname || session.author?.name || session.username || userId,
+          avatarUrl
+        };
+        const summaryData = await prepareMonthlySummary(
+          ctx,
+          userId,
+          platform,
+          userInfo.username,
+          userInfo.avatarUrl,
+          year,
+          month
+        );
+        const result = await generateMonthlySummaryCard(ctx, config, summaryData);
+        const base64 = result.buffer.toString("base64");
+        return `${import_koishi2.segment.at(userId)} ${year}年${month}月 旅行总结
+${import_koishi2.segment.image(`base64://${base64}`)}`;
+      }
+    } catch (e) {
+      ctx.logger("pig").error("Failed to generate monthly summary:", e);
+      return `生成月度总结失败: ${e}`;
+    }
+  });
   ctx.middleware(async (session, next) => {
     if (!config.experimentalAutoDetect) return next();
     if (!session.userId || !session.content) return next();
@@ -1589,9 +2299,46 @@ function apply(ctx, config) {
     return next();
   });
   ctx.cron("0 0 1 * *", async () => {
+    if (!config.monthlySummaryEnabled) {
+      ctx.logger("pig").debug("Monthly summary is disabled, skipping...");
+      return;
+    }
     const now = /* @__PURE__ */ new Date();
-    const lastMonth = new Date(now.getFullYear(), now.getMonth() - 1, 1);
-    ctx.logger("pig").info("Generating monthly travel handbook...");
+    let year = now.getFullYear();
+    let month = now.getMonth();
+    if (month === 0) {
+      year -= 1;
+      month = 12;
+    }
+    ctx.logger("pig").info(`Generating monthly travel handbook for ${year}/${month}...`);
+    try {
+      const users = await getUsersWithLogsInMonth(ctx, year, month);
+      if (users.length === 0) {
+        ctx.logger("pig").info(`No travel logs found for ${year}/${month}`);
+        return;
+      }
+      ctx.logger("pig").info(`Found ${users.length} users with travel logs for ${year}/${month}`);
+      for (const { userId, platform } of users) {
+        try {
+          const summaryData = await prepareMonthlySummary(
+            ctx,
+            userId,
+            platform,
+            userId,
+            "",
+            year,
+            month
+          );
+          await generateMonthlySummaryCard(ctx, config, summaryData);
+          ctx.logger("pig").info(`Generated summary for user ${userId}`);
+        } catch (e) {
+          ctx.logger("pig").error(`Failed to generate summary for user ${userId}:`, e);
+        }
+      }
+      ctx.logger("pig").info(`Monthly handbook generation completed for ${year}/${month}`);
+    } catch (e) {
+      ctx.logger("pig").error("Failed to generate monthly travel handbook:", e);
+    }
   });
   ctx.cron("0 3 * * *", async () => {
     const cutoffDate = /* @__PURE__ */ new Date();

package/lib/services/pexels.d.ts

@@ -1,6 +1,7 @@
 import { Context } from 'koishi';
 /**
- * Search for a photo on Pexels and return the large-sized URL
+ * Search for a photo on Pexels and return a randomly selected large-sized URL
+ * Fetches multiple results and randomly selects one to avoid repetitive images
  * @returns The photo URL or null if not found/error
  */
 export declare function searchPexelsPhoto(ctx: Context, apiKey: string, query: string, debug?: boolean): Promise<string | null>;

package/lib/services/summary.d.ts

@@ -0,0 +1,38 @@
+import { Context } from 'koishi';
+import { Config } from '../config';
+import { PigTravelLog } from '../database';
+export interface MonthlySummaryData {
+    userId: string;
+    platform: string;
+    username: string;
+    avatarUrl: string;
+    year: number;
+    month: number;
+    logs: PigTravelLog[];
+    totalTrips: number;
+    countriesVisited: string[];
+    locationsVisited: string[];
+}
+export interface SummaryCardResult {
+    buffer: Buffer;
+    filename: string;
+}
+/**
+ * 获取指定用户指定月份的旅行记录
+ */
+export declare function getMonthlyLogs(ctx: Context, userId: string, platform: string, year: number, month: number): Promise<PigTravelLog[]>;
+/**
+ * 获取所有有旅行记录的用户（指定月份）
+ */
+export declare function getUsersWithLogsInMonth(ctx: Context, year: number, month: number): Promise<{
+    userId: string;
+    platform: string;
+}[]>;
+/**
+ * 生成月度总结卡片
+ */
+export declare function generateMonthlySummaryCard(ctx: Context, config: Config, data: MonthlySummaryData): Promise<SummaryCardResult>;
+/**
+ * 准备月度总结数据
+ */
+export declare function prepareMonthlySummary(ctx: Context, userId: string, platform: string, username: string, avatarUrl: string, year: number, month: number): Promise<MonthlySummaryData>;

package/lib/services/unsplash.d.ts

@@ -1,6 +1,7 @@
 import { Context } from 'koishi';
 /**
- * Search for a photo on Unsplash and return the regular-sized URL
+ * Search for a photo on Unsplash and return a randomly selected regular-sized URL
+ * Fetches multiple results and randomly selects one to avoid repetitive images
  * @returns The photo URL or null if not found/error
  */
 export declare function searchUnsplashPhoto(ctx: Context, accessKey: string, query: string, debug?: boolean): Promise<string | null>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koishi-plugin-my-pig-group-friends",
-  "version": "1.1.3",
+  "version": "1.1.4",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
   "files": [