koishi-plugin-my-pig-group-friends 1.1.1 → 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

@@ -14,10 +14,15 @@ export interface Config {
     logPath: string;
     llmLocationEnabled: boolean;
     llmLocationModel: string;
+    llmLocationCustomContext: string;
+    imageSearchPrompt: string;
     unsplashAccessKey: string;
+    pexelsApiKey: string;
+    backgroundFetchMode: 'auto' | 'always' | 'never';
+    backgroundFetchTimeoutMs: number;
     logRetentionDays: number;
+    monthlySummaryEnabled: boolean;
     experimentalAutoDetect: boolean;
     debug: boolean;
-    emojiFont: 'Noto Color Emoji' | 'Twemoji' | 'System';
 }
 export declare const Config: Schema<Config>;

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;
 }