feat: replace avatar pool config with local avatar files and update illustrations

- Remove avatars.pool config from env.ts, use randomAvatarUrl() from local avatar images
- Add 10 avatar images and blender-rendered report images
- Update all 12 zodiac daily illustrations to higher resolution
- Add daily-scribe API docs and blender image download script

Co-authored-by: Claude <noreply@anthropic.com>

Author: zcoderr

api/src/libs/env.ts

@@ -482,22 +482,6 @@ function parseConfigFromPreferences() {
       return this._database;
     },
 
-    avatars: {
-      _pool: undefined as string[] | undefined,
-      get pool() {
-        if (!this._pool) {
-          const old = tryParse(process.env.AVATARS_POOL);
-          const { error, value } = Joi.array<string[]>()
-            .items(Joi.string())
-            .required()
-            .validate((preferences.avatars_pool || old?.join('\n') || '').split(/\s+/).filter(Boolean));
-          if (error) throw new Error(`validate avatars pool configuration error: ${error.message}`);
-          this._pool = value;
-        }
-        return this._pool;
-      },
-    },
-
     _predictReportTemplate: undefined as ReturnType<typeof parseReportTemplateConfiguration> | undefined,
     get predictReportTemplate() {
       if (!this._predictReportTemplate) {

api/src/routes/ai/handlers/auth.ts

@@ -1,8 +1,8 @@
-import { omit, sample } from 'lodash';
+import { omit } from 'lodash';
 import { Op } from 'sequelize';
 
+import { randomAvatarUrl } from '../../../ai/image';
 import { authService, generateUserDid, getAppleUserInfo, getGoogleUserInfo } from '../../../libs/auth';
-import { config } from '../../../libs/env';
 import Message, { MessageType } from '../../../store/models/message';
 import User from '../../../store/models/user';
 import { getTranslation } from '../translations';
@@ -25,7 +25,7 @@ export const handleLogin: ChatHandle<MessageType.Login> = async ({ stream, userI
       : await getGoogleUserInfo(googleIdToken)
     : await getAppleUserInfo(appleIdToken);
 
-  const avatar = thirdUser.avatar || sample(config.avatars.pool);
+  const avatar = thirdUser.avatar || randomAvatarUrl();
 
   const username =
     thirdUser.name || thirdUser.email?.split('@')[0] || `User-${Math.random().toString(36).slice(2, 10)}`;

docs/daily-scribe-api.md

@@ -0,0 +1,233 @@
+# Daily Scribe API
+
+每日运势 / 年度运势内容 API，为 12 个星座提供 AI 生成的多语言运势内容。
+
+## 基础信息
+
+- **基础路径**: `/api/daily`
+- **兼容路径**: `/daily/api`（通过 Blocklet Server rewrite 转发，兼容旧客户端）
+- **内容生成**: 每天 UTC 00:00 由 cron 自动为 12 个星座生成；首次请求未生成的内容时也会触发按需生成
+
+## 星座列表
+
+| key | 名称 | 符号 | 日期范围 |
+|-----|------|------|----------|
+| `aquarius` | Aquarius | ♒ | 01-21 ~ 02-19 |
+| `pisces` | Pisces | ♓ | 02-20 ~ 03-20 |
+| `aries` | Aries | ♈ | 03-21 ~ 04-19 |
+| `taurus` | Taurus | ♉ | 04-20 ~ 05-20 |
+| `gemini` | Gemini | ♊ | 05-21 ~ 06-21 |
+| `cancer` | Cancer | ♋ | 06-22 ~ 07-22 |
+| `leo` | Leo | ♌ | 07-23 ~ 08-22 |
+| `virgo` | Virgo | ♍ | 08-23 ~ 09-22 |
+| `libra` | Libra | ♎ | 09-23 ~ 10-23 |
+| `scorpio` | Scorpio | ♏ | 10-24 ~ 11-21 |
+| `sagittarius` | Sagittarius | ♐ | 11-22 ~ 12-20 |
+| `capricorn` | Capricorn | ♑ | 12-21 ~ 01-20 |
+
+## 支持的语言
+
+| locale | 语言 |
+|--------|------|
+| `en` | English |
+| `zh` | 简体中文 |
+| `zh-t` | 繁體中文 |
+| `ja` | 日本語 |
+
+---
+
+## API 端点
+
+### 1. 获取每日运势
+
+```
+GET /api/daily/content/:key
+```
+
+**权限**: 公开，无需认证
+
+**路径参数**:
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `key` | string | 是 | 星座标识，如 `aries`、`leo` |
+
+**Query 参数**:
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `locale` | string | 否 | 语言代码，默认从 cookie `nf_lang` 读取，兜底 `en` |
+| `date` | string | 否 | 日期 `YYYY-MM-DD`，不传则获取最新记录 |
+
+**成功响应** (200):
+
+```json
+{
+  "code": 0,
+  "msg": "get content success",
+  "data": {
+    "id": "694073960970584064",
+    "createdAt": "2026-03-31T06:42:07.566Z",
+    "updatedAt": "2026-03-31T06:42:07.566Z",
+    "title": "在自我与和谐之间，找寻平衡的力量",
+    "content": "在坚守个性的同时拥抱合作，将一时的冲动转化为深邃的智慧。",
+    "pageKey": "aries",
+    "bg": "https://xxx.did.abtnet.io/aistro/daily/bg/aries.png",
+    "smallBg": "https://xxx.did.abtnet.io/aistro/daily/small-bg/aries.png",
+    "locale": "zh",
+    "illustration": "https://xxx.did.abtnet.io/aistro/daily/illustration/aries.png",
+    "date": "2026-03-31",
+    "horoscope": "勇敢的白羊座，随着太阳继续在你的星座展开...",
+    "symbol": "♈",
+    "star": "Aries"
+  }
+}
+```
+
+**失败响应** (200):
+
+```json
+{
+  "code": 1,
+  "msg": "get content fail"
+}
+```
+
+**行为说明**:
+- 数据库已有记录 → 直接返回（毫秒级）
+- 数据库无记录 → 触发 AI 生成，每 5 秒轮询一次，最多等待 60 秒
+- 超时仍未生成 → 返回 `code: 1`
+
+**curl 示例**:
+
+```bash
+curl "https://xxx.did.abtnet.io/aistro/api/daily/content/aries?locale=zh"
+curl "https://xxx.did.abtnet.io/aistro/api/daily/content/leo?locale=en&date=2026-03-31"
+```
+
+---
+
+### 2. 获取年度运势
+
+```
+GET /api/daily/content/year/:key
+```
+
+**权限**: 公开，无需认证
+
+**路径参数**:
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `key` | string | 是 | 星座标识 |
+
+**Query 参数**:
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `locale` | string | 否 | 语言代码，默认 `en` |
+| `year` | string | 否 | 年份 `YYYY`，不传则获取最新记录 |
+
+**响应**: 结构与每日运势相同，`date` 字段替换为 `year`。
+
+**curl 示例**:
+
+```bash
+curl "https://xxx.did.abtnet.io/aistro/api/daily/content/year/aries?locale=zh"
+curl "https://xxx.did.abtnet.io/aistro/api/daily/content/year/leo?locale=ja&year=2026"
+```
+
+---
+
+### 3. 重新生成每日运势
+
+```
+GET /api/daily/regenerate-content/:key
+```
+
+**权限**: 需要 `admin` 或 `owner` 角色
+
+**路径参数**:
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `key` | string | 是 | 星座标识 |
+
+**Query 参数**:
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `locale` | string | 否 | 语言代码 |
+| `date` | string | 否 | 日期 `YYYY-MM-DD` |
+
+**行为说明**:
+1. 删除该星座该日期的任务标记（Task Flag）
+2. 删除该星座该日期的所有语言记录
+3. 重新触发 AI 生成并返回新内容
+
+**curl 示例**:
+
+```bash
+curl "https://xxx.did.abtnet.io/aistro/api/daily/regenerate-content/aries?date=2026-03-31&locale=zh"
+```
+
+---
+
+### 4. 重新生成年度运势
+
+```
+GET /api/daily/regenerate-content/year/:key
+```
+
+**权限**: 需要 `admin` 或 `owner` 角色
+
+**路径参数**:
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `key` | string | 是 | 星座标识 |
+
+**Query 参数**:
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `locale` | string | 否 | 语言代码 |
+| `year` | string | 否 | 年份 `YYYY` |
+
+**curl 示例**:
+
+```bash
+curl "https://xxx.did.abtnet.io/aistro/api/daily/regenerate-content/year/aries?year=2026&locale=zh"
+```
+
+---
+
+## 响应字段说明
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `id` | string | 记录唯一 ID |
+| `title` | string | AI 生成的标题（对应 locale 语言） |
+| `content` | string | AI 生成的短文（1-3 句话的每日座右铭） |
+| `pageKey` | string | 星座标识 |
+| `bg` | string | 大背景图完整 URL（540px） |
+| `smallBg` | string | 小背景图完整 URL（200px） |
+| `illustration` | string | 插图完整 URL（540px） |
+| `locale` | string | 语言代码 |
+| `date` / `year` | string | 日期 `YYYY-MM-DD` 或年份 `YYYY` |
+| `horoscope` | string | AI 生成的详细运势文本（对应 locale 语言） |
+| `symbol` | string | 星座符号（如 ♈） |
+| `star` | string | 星座英文名（如 Aries） |
+
+## 旧客户端兼容
+
+通过 Blocklet Server URL rewrite 规则 `daily/* → aistro/daily/*`，旧客户端的请求路径无需修改：
+
+| 旧路径 | 实际转发到 |
+|--------|-----------|
+| `daily/api/content/:key` | `aistro/daily/api/content/:key` |
+| `daily/api/content/year/:key` | `aistro/daily/api/content/year/:key` |
+| `daily/api/regenerate-content/:key` | `aistro/daily/api/regenerate-content/:key` |
+| `daily/api/regenerate-content/year/:key` | `aistro/daily/api/regenerate-content/year/:key` |
+
+服务端同时挂载了 `/api/daily/*`（新路径）和 `/daily/api/*`（兼容路径），两者指向同一个 handler。