koishi-plugin-codex-reset 0.1.2 → 0.1.4

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 lumia1998
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 lumia1998
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,57 +1,56 @@
-# koishi-plugin-codex-reset
-
-监控 [AIHOT Codex 重置 API](https://aihot.news/api/v1/codex-resets) 的 Koishi 插件。
-
-## 功能
-
-- 定时轮询 AIHOT 的 Codex / ChatGPT Work 重置事件快照。
-- 支持推送新的重置预告、已确认的全员重置和重置卡事件。
-- 目标支持平台 + 频道配置，例如 `onebot` + `123456789`。
-- `codex.probability` / `重置概率`：生成精美的概率统计卡片图片；没有 Puppeteer 时回退为纯文本。
-- `codex.event` / `最近重置`：统计上一次已确认重置距今多少小时。
-- `codex.calendar` / `重置日历`：生成本月的 PNG 日历图片，右侧详情固定为命令执行当天。
-- `codex.history` / `重置历史`：生成公开重置事件的历史时间线图片。
-- 日历中的 Tibo 头像作为本地资源随插件发布，不依赖用户访问 X 或运行时下载图片。
-
-## 命令
-
-命令目前都不接收额外参数：
-
-- `codex.probability`，别名 `重置概率`：读取当前 API 快照，生成概率统计卡片，展示未来 24 小时和 7 天概率、样本概览、事件构成和最近确认日期；没有 Puppeteer 时回退为纯文本。
-- `codex.event`，别名 `最近重置`：显示上一次已确认重置发生时间、距今小时数、类型和事件名称。
-- `codex.calendar`，别名 `重置日历`：发送本月日历 PNG；右侧详情固定显示命令执行当天（北京时间）的事件。
-- `codex.history`，别名 `重置历史`：发送按北京时间排列的历史重置时间线 PNG。
-
-概率、日历和历史时间线命令需要安装并启用 `koishi-plugin-puppeteer` 才会发送图片；没有 Puppeteer 时概率命令仍会回退为纯文本。三个图片命令都可以在配置中单独关闭。
+# koishi-plugin-codex-reset
+
+监控 [AIHOT Codex 重置 API](https://aihot.news/api/v1/codex-resets) 的 Koishi 插件。
+
+## 功能
+
+- 定时轮询 AIHOT 的 Codex / ChatGPT Work 重置事件快照。
+- 支持推送新的重置预告、已确认的全员重置和重置卡事件。
+- 目标支持平台 + 频道配置，例如 `onebot` + `123456789`。
+- `codex.probability` / `重置概率`：生成精美的概率统计卡片图片；没有 Puppeteer 时回退为纯文本。
+- `codex.event` / `最近重置`：生成最近一次已确认重置的浅色卡片，展示距今时间、类型和来源帖子。
+- `codex.calendar` / `重置日历`：生成本月的 PNG 日历图片，右侧固定展示最近发布的 2 条来源动态。
+- `codex.history` / `重置历史`：生成公开重置事件的历史时间线图片，默认展示最近 1 个月。
+- 日历中的 Tibo 头像作为本地资源随插件发布，不依赖用户访问 X 或运行时下载图片。
+
+## 命令
+
+命令都可以直接使用；历史时间线支持时间范围参数：
+
+- `codex.probability`，别名 `重置概率`：读取当前 API 快照，生成概率统计卡片，展示未来 24 小时和 7 天概率、样本概览、事件构成和最近确认日期；没有 Puppeteer 时回退为纯文本。
+- `codex.event`，别名 `最近重置`：发送最近一次已确认重置的浅色卡片；没有 Puppeteer 时回退为文本。
+- `codex.calendar`，别名 `重置日历`：发送本月日历 PNG；右侧固定显示最近发布的 2 条动态。
+- `codex.history`，别名 `重置历史`：发送历史时间线 PNG；`重置历史` 查看最近 1 个月，`重置历史 -3` 查看最近 3 个月，`重置历史 -a` 查看全部历史。
+
+概率、最近重置、日历和历史时间线命令始终启用；安装并启用 `koishi-plugin-puppeteer` 后会发送对应图片，没有 Puppeteer 时概率和最近重置会回退为纯文本，日历和历史时间线会提示安装 Puppeteer。
+
+日历、月度统计及右侧动态仅展示已确认且日期不晚于今天的事件，不展示预告。日期优先使用实际发生日期，缺失时使用北京时间的确认日期；两者均缺失时不展示，不使用预计时间窗口代替实际日期。
 
 首次轮询只建立本地基线，不会把 API 返回的历史事件全部推送；后续轮询只处理新增事件或 `announced` → `confirmed` 的状态变化。插件重启后会重新建立基线。
-
-## 安装
-
-```bash
-npm install koishi-plugin-codex-reset
-```
-
-如果需要概率卡片、日历或历史时间线图片，再安装并启用 `koishi-plugin-puppeteer`。不安装 Puppeteer 时，监控、最近重置和概率分析仍然可以使用，概率命令回退为纯文本，其他图片命令会给出提示。
-
-## 配置
-
-- `监控接口地址`：监控 API 地址，默认 `https://aihot.news/api/v1/codex-resets`。
-- `监控间隔`：轮询间隔，单位为秒，默认 300 秒。
-- `请求超时时间`：单次 API 请求超时时间，单位为毫秒，默认 15000 毫秒。
-- `推送目标`：推送目标表，填写“平台”和“频道或群组 ID”；平台留空会按频道尝试在线 Bot，同一平台/频道只发送一次。
-- `推送重置预告`：是否推送预告。
-- `推送已确认重置`：是否推送已确认的重置/重置卡事件。
-- `艾特全体`：推送通知时是否艾特全体，默认关闭；需要目标平台支持全体艾特。
-- `启用重置概率命令`：是否启用概率命令。
-- `启用重置日历命令`：是否启用日历图片命令。
-- `启用重置历史命令`：是否启用历史时间线图片命令。
-
-API 是只读公开接口，不需要 API Key。插件使用 `ETag` 条件请求，并保留来源链接。请遵守 [AIHOT 公开使用规则](https://aihot.news/terms)：公开可访问不等于自动获得对外商业使用、镜像或转售授权。
-
-## 开发
-
-```bash
-npm install
-npm test
-```
+
+## 安装
+
+```bash
+npm install koishi-plugin-codex-reset
+```
+
+如果需要概率卡片、最近重置卡片、日历或历史时间线图片，再安装并启用 `koishi-plugin-puppeteer`。不安装 Puppeteer 时，监控、最近重置和概率分析仍然可以使用，概率与最近重置命令回退为纯文本，日历和历史命令会给出提示。
+
+## 配置
+
+- `监控接口地址`：监控 API 地址，默认 `https://aihot.news/api/v1/codex-resets`。
+- `监控间隔`：轮询间隔，单位为秒，默认 300 秒。
+- `请求超时时间`：单次 API 请求超时时间，单位为毫秒，默认 15000 毫秒。
+- `推送目标`：推送目标表，填写“平台”和“频道或群组 ID”；平台留空会按频道尝试在线 Bot，同一平台/频道只发送一次。
+- `推送重置预告`：是否推送预告。
+- `推送已确认重置`：是否推送已确认的重置/重置卡事件。
+- `艾特全体`：推送通知时是否艾特全体，默认关闭；需要目标平台支持全体艾特。
+
+API 是只读公开接口，不需要 API Key。插件使用 `ETag` 条件请求，并保留来源链接。请遵守 [AIHOT 公开使用规则](https://aihot.news/terms)：公开可访问不等于自动获得对外商业使用、镜像或转售授权。
+
+## 开发
+
+```bash
+npm install
+npm test
+```

package/lib/calendar.js

@@ -45,7 +45,8 @@ function parseDateKey(value) {
 function timestampDateKey(value) {
     if (!value)
         return null;
-    return value.match(/^(\d{4}-\d{2}-\d{2})/)?.[1] ?? null;
+    const date = new Date(value);
+    return Number.isFinite(date.getTime()) ? beijingDateKey(date) : null;
 }
 function beijingDateKey(now) {
     const parts = new Intl.DateTimeFormat('en-US', {
@@ -69,13 +70,10 @@ function escapeHtml(value) {
         .replaceAll("'", ''');
 }
 function getEventDateRange(event) {
-    if (event.status === 'confirmed' && event.occurredOn)
-        return [event.occurredOn, event.occurredOn];
-    const from = timestampDateKey(event.schedule?.from) ?? timestampDateKey(event.confirmedAt) ?? timestampDateKey(event.createdAt);
-    if (!from)
+    if (event.status !== 'confirmed')
         return null;
-    const through = timestampDateKey(event.schedule?.through) ?? from;
-    return [from, through];
+    const date = event.occurredOn ?? timestampDateKey(event.confirmedAt);
+    return date ? [date, date] : null;
 }
 function buildMonthMarks(events, start) {
     const end = monthStart(start, 1);
@@ -98,15 +96,6 @@ function buildMonthMarks(events, start) {
     }
     return marks;
 }
-function formatDateHeader(value) {
-    const date = parseDateKey(value);
-    if (!date)
-        return { day: value, year: '' };
-    return {
-        day: `${date.getUTCMonth() + 1} 月 ${date.getUTCDate()} 日`,
-        year: String(date.getUTCFullYear()),
-    };
-}
 function formatPublishedAt(value) {
     const date = new Date(value);
     if (Number.isNaN(date.getTime()))
@@ -142,10 +131,10 @@ function renderDayCell(date, month, marks, selectedDate, today) {
         const className = mark.type === 'direct_reset' ? 'reset-mark' : 'credit-mark';
         return `<span class="${className}">${label}</span>`;
     }).join('');
-    return `<div class="${classes.join(' ')}" aria-label="${escapeHtml(labels)}">
-    <span class="number">${date.getUTCDate()}</span>
-    ${key === today ? '<span class="today-dot"></span>' : ''}
-    <div class="marks">${marksHtml}</div>
+    return `<div class="${classes.join(' ')}" aria-label="${escapeHtml(labels)}">
+    <span class="number">${date.getUTCDate()}</span>
+    ${key === today ? '<span class="today-dot"></span>' : ''}
+    <div class="marks">${marksHtml}</div>
   </div>`;
 }
 function renderCalendarGrid(month, marks, selectedDate, today) {
@@ -162,126 +151,129 @@ function renderCalendarGrid(month, marks, selectedDate, today) {
 }
 function renderPostCard(event, post) {
     const text = post.text || post.originalText;
-    const schedule = event.schedule?.label ? `<div class="schedule">原预告：${escapeHtml(event.schedule.label)}</div>` : '';
     const avatar = TIBO_AVATAR
         ? `<img class="avatar-image" src="${TIBO_AVATAR}" alt="">`
         : '<span class="avatar-fallback">T</span>';
-    return `<article class="post-card">
-    <div class="post-head">
-      <div class="avatar">${avatar}</div>
-      <div class="author"><strong>Tibo</strong><span>@thsottiaux</span></div>
-      <time>${escapeHtml(formatPublishedAt(post.publishedAt))}</time>
-    </div>
-    <p class="post-text">${escapeHtml(text)}</p>
-    ${schedule}
-    <div class="post-foot">${escapeHtml(post.stage)}</div>
+    return `<article class="post-card">
+    <div class="post-head">
+      <div class="avatar">${avatar}</div>
+      <div class="author"><strong>Tibo</strong><span>@thsottiaux</span></div>
+      <time>${escapeHtml(formatPublishedAt(post.publishedAt))}</time>
+    </div>
+    <p class="post-text">${escapeHtml(text)}</p>
+    <div class="post-foot">${escapeHtml(post.stage)}</div>
   </article>`;
 }
-function renderDetails(selectedDate, marks) {
-    const header = formatDateHeader(selectedDate);
-    const selectedEvents = [...new Map((marks.get(selectedDate) ?? []).map((mark) => [mark.event.id, mark.event])).values()];
-    const groups = selectedEvents.map((event) => {
+function renderDetails(events) {
+    const latestPosts = events
+        .flatMap((event) => event.posts.map((post) => ({ event, post })))
+        .sort((a, b) => Date.parse(b.post.publishedAt) - Date.parse(a.post.publishedAt))
+        .slice(0, 2);
+    const groups = latestPosts.map(({ event, post }) => {
         const status = event.status === 'confirmed' ? '已重置' : '未重置预告';
         const statusClass = event.status === 'confirmed' ? 'confirmed-state' : 'announced-state';
-        const posts = event.posts.slice(0, 3).map((post) => renderPostCard(event, post)).join('');
-        return `<section class="event-group">
-      <div class="event-state ${statusClass}"><span class="state-icon">${event.status === 'confirmed' ? '✓' : '◷'}</span>${status}</div>
-      <h2>${escapeHtml(event.title)}</h2>
-      ${posts || '<div class="post-card empty-post">暂无来源帖子内容</div>'}
+        return `<section class="event-group">
+      <div class="event-state ${statusClass}"><span class="state-icon">${event.status === 'confirmed' ? '✓' : '◷'}</span>${status}</div>
+      <h2>${escapeHtml(event.title)}</h2>
+      ${renderPostCard(event, post)}
     </section>`;
     }).join('');
-    return `<aside class="details-pane">
-    <div class="details-header"><h2>${header.day}</h2><span>${header.year}</span></div>
-    <div class="details-body">${groups || '<div class="empty-state">这一天没有记录</div>'}</div>
+    return `<aside class="details-pane">
+    <div class="details-header"><h2>最近 2 条动态</h2><span>北京时间</span></div>
+    <div class="details-body">${groups || '<div class="empty-state">暂无来源帖子内容</div>'}</div>
   </aside>`;
 }
 function renderCalendarHtml(events, now = new Date()) {
     const today = beijingDateKey(now);
+    events = events.filter((event) => {
+        const range = getEventDateRange(event);
+        return range !== null && parseDateKey(range[0]) !== null && range[0] <= today;
+    });
     const todayDate = parseDateKey(today) ?? new Date();
     const month = monthStart(todayDate);
     const marks = buildMonthMarks(events, month);
-    // A static image has no interactive selection. The detail pane always represents
-    // the Beijing calendar date on which the command was invoked.
+    // The selected day remains the command date on the calendar grid, while the
+    // detail pane shows the two most recently published source posts.
     const selectedDate = today;
     const monthEvents = [...new Map([...marks.values()].flat().map((mark) => [mark.event.id, mark.event])).values()];
     const resetCount = monthEvents.filter((event) => event.type === 'direct_reset').length;
     const creditCount = monthEvents.filter((event) => event.type === 'reset_credit').length;
     const monthLabel = `${month.getUTCFullYear()} 年 ${MONTH_NAMES[month.getUTCMonth()]}`;
-    return `<!doctype html>
-<html lang="zh-CN">
-<head>
-  <meta charset="utf-8">
-  <style>
-    * { box-sizing: border-box; }
-    body { margin: 0; padding: 16px; background: #f5f6f4; color: #25313a; font-family: Inter, "Microsoft YaHei", "Noto Sans CJK SC", sans-serif; }
-    .calendar-card { width: 1248px; min-height: 578px; display: grid; grid-template-columns: 1.46fr 1fr; overflow: hidden; border: 1px solid #d2dadd; border-radius: 14px; background: #fff; }
-    .calendar-pane { padding: 30px 24px 22px; }
-    .calendar-header { display: flex; justify-content: space-between; align-items: flex-start; padding: 0 0 18px; }
-    .calendar-header h1 { margin: 0; font-size: 23px; line-height: 1.3; letter-spacing: .2px; }
-    .month-summary { margin-top: 20px; color: #617079; font-size: 12px; }
-    .calendar-nav { display: flex; align-items: center; gap: 22px; padding-top: 3px; color: #617079; font-size: 11px; }
-    .calendar-nav .arrow { color: #617079; font-size: 20px; font-weight: 300; line-height: 1; }
-    .weekday-row, .calendar-grid { display: grid; grid-template-columns: repeat(7, 1fr); gap: 4px; }
-    .weekday-row { margin-bottom: 6px; color: #65737b; font-size: 12px; text-align: center; }
-    .weekday-row span { padding: 8px 0; }
-    .calendar-grid { grid-auto-rows: 70px; }
-    .day { position: relative; min-width: 0; padding: 11px 12px 7px; border: 1px solid transparent; border-radius: 10px; background: #fafafa; }
-    .day.outside { color: #adb6b9; background: #fcfcfc; }
-    .day.selected { border-color: #147487; background: #edf7f6; box-shadow: inset 0 0 0 1px rgba(20, 116, 135, .12); }
-    .day.has-reset { background: #eef6f2; }
-    .day.has-credit { background: #f7f3ec; }
-    .day.selected.has-reset, .day.selected.has-credit { background: #e8f3f2; }
-    .number { display: inline-block; font-size: 14px; line-height: 1; }
-    .outside .number { color: #aeb7ba; }
-    .today-dot { position: absolute; top: 11px; right: 13px; width: 4px; height: 4px; border-radius: 50%; background: #147487; }
-    .marks { display: flex; flex-direction: column; gap: 2px; margin-top: 12px; overflow: hidden; }
-    .marks span { overflow: hidden; color: #347465; font-size: 9px; line-height: 1.2; text-overflow: ellipsis; white-space: nowrap; }
-    .marks .credit-mark { color: #967044; }
-    .outside .marks span { color: #b6d0c9; }
-    .outside .marks .credit-mark { color: #cbbda6; }
-    .calendar-note { margin-top: 18px; color: #617079; font-size: 11px; }
-    .details-pane { min-width: 0; padding: 26px 24px 20px; border-left: 1px solid #d9dfe0; }
-    .details-header { display: flex; justify-content: space-between; align-items: center; padding: 0 0 17px; border-bottom: 1px solid #d9dfe0; }
-    .details-header h2 { margin: 0; font-size: 18px; }
-    .details-header span { color: #65737b; font-size: 11px; }
-    .details-body { padding-top: 18px; }
-    .event-group + .event-group { margin-top: 22px; }
-    .event-state { display: flex; align-items: center; gap: 7px; margin-bottom: 12px; font-size: 11px; font-weight: 700; }
-    .confirmed-state { color: #29735f; }
-    .announced-state { color: #98713d; }
-    .state-icon { font-size: 16px; font-weight: 500; }
-    .event-group h2 { margin: 0 0 16px; font-size: 18px; line-height: 1.35; }
-    .post-card { margin-bottom: 12px; padding: 16px; border: 1px solid #d2dadd; border-radius: 13px; background: #fff; }
-    .post-head { display: flex; align-items: center; min-width: 0; }
-    .avatar { display: grid; flex: 0 0 auto; width: 36px; height: 36px; place-items: center; overflow: hidden; border-radius: 50%; background: linear-gradient(145deg, #a57954, #d3aa7d); color: #fff; font-size: 18px; font-weight: 700; }
-    .avatar-image { display: block; width: 100%; height: 100%; object-fit: cover; }
-    .avatar-fallback { display: block; }
-    .author { display: flex; flex-direction: column; margin-left: 9px; line-height: 1.25; }
-    .author strong { font-size: 13px; }
-    .author span { color: #6f7d83; font-size: 10px; }
-    .post-head time { margin-left: auto; color: #6f7d83; font-size: 10px; }
-    .post-text { margin: 14px 0 10px; color: #27343c; font-size: 14px; line-height: 1.65; }
-    .schedule { margin: 0 0 10px; color: #08768b; font-size: 11px; }
-    .post-foot { color: #6f7d83; font-size: 10px; }
-    .empty-state, .empty-post { color: #7a888d; font-size: 13px; text-align: center; }
-    .empty-state { padding: 56px 0; }
-    .empty-post { padding: 24px 12px; }
-  </style>
-</head>
-<body>
-  <main class="calendar-card">
-    <section class="calendar-pane">
-      <header class="calendar-header">
-        <div><h1>${monthLabel}</h1><div class="month-summary">本月：${resetCount} 条全员重置&nbsp;&nbsp;·&nbsp;&nbsp;${creditCount} 张重置卡</div></div>
-        <div class="calendar-nav"><span>回到最近</span><span class="arrow">‹</span><span class="arrow">›</span></div>
-      </header>
-      <div class="weekday-row">${WEEK_NAMES.map((name) => `<span>${name}</span>`).join('')}</div>
-      <div class="calendar-grid">${renderCalendarGrid(month, marks, selectedDate, today)}</div>
-      <div class="calendar-note">按北京时间记录；发放日期不明确的事件，按来源帖子日期展示。</div>
-    </section>
-    ${renderDetails(selectedDate, marks)}
-  </main>
-</body>
+    return `<!doctype html>
+<html lang="zh-CN">
+<head>
+  <meta charset="utf-8">
+  <style>
+    * { box-sizing: border-box; }
+    body { margin: 0; padding: 16px; background: #f5f6f4; color: #25313a; font-family: Inter, "Microsoft YaHei", "Noto Sans CJK SC", sans-serif; }
+    .calendar-card { width: 1248px; min-height: 578px; display: grid; grid-template-columns: 1.46fr 1fr; overflow: hidden; border: 1px solid #d2dadd; border-radius: 14px; background: #fff; }
+    .calendar-pane { padding: 30px 24px 22px; }
+    .calendar-header { display: flex; justify-content: space-between; align-items: flex-start; padding: 0 0 18px; }
+    .calendar-header h1 { margin: 0; font-size: 23px; line-height: 1.3; letter-spacing: .2px; }
+    .month-summary { margin-top: 20px; color: #617079; font-size: 12px; }
+    .calendar-nav { display: flex; align-items: center; gap: 22px; padding-top: 3px; color: #617079; font-size: 11px; }
+    .calendar-nav .arrow { color: #617079; font-size: 20px; font-weight: 300; line-height: 1; }
+    .weekday-row, .calendar-grid { display: grid; grid-template-columns: repeat(7, 1fr); gap: 4px; }
+    .weekday-row { margin-bottom: 6px; color: #65737b; font-size: 12px; text-align: center; }
+    .weekday-row span { padding: 8px 0; }
+    .calendar-grid { grid-auto-rows: 70px; }
+    .day { position: relative; min-width: 0; padding: 11px 12px 7px; border: 1px solid transparent; border-radius: 10px; background: #fafafa; }
+    .day.outside { color: #adb6b9; background: #fcfcfc; }
+    .day.selected { border-color: #147487; background: #edf7f6; box-shadow: inset 0 0 0 1px rgba(20, 116, 135, .12); }
+    .day.has-reset { background: #eef6f2; }
+    .day.has-credit { background: #f7f3ec; }
+    .day.selected.has-reset, .day.selected.has-credit { background: #e8f3f2; }
+    .number { display: inline-block; font-size: 14px; line-height: 1; }
+    .outside .number { color: #aeb7ba; }
+    .today-dot { position: absolute; top: 11px; right: 13px; width: 4px; height: 4px; border-radius: 50%; background: #147487; }
+    .marks { display: flex; flex-direction: column; gap: 2px; margin-top: 12px; overflow: hidden; }
+    .marks span { overflow: hidden; color: #347465; font-size: 9px; line-height: 1.2; text-overflow: ellipsis; white-space: nowrap; }
+    .marks .credit-mark { color: #967044; }
+    .outside .marks span { color: #b6d0c9; }
+    .outside .marks .credit-mark { color: #cbbda6; }
+    .calendar-note { margin-top: 18px; color: #617079; font-size: 11px; }
+    .details-pane { min-width: 0; padding: 26px 24px 20px; border-left: 1px solid #d9dfe0; }
+    .details-header { display: flex; justify-content: space-between; align-items: center; padding: 0 0 17px; border-bottom: 1px solid #d9dfe0; }
+    .details-header h2 { margin: 0; font-size: 18px; }
+    .details-header span { color: #65737b; font-size: 11px; }
+    .details-body { padding-top: 18px; }
+    .event-group + .event-group { margin-top: 22px; }
+    .event-state { display: flex; align-items: center; gap: 7px; margin-bottom: 12px; font-size: 11px; font-weight: 700; }
+    .confirmed-state { color: #29735f; }
+    .announced-state { color: #98713d; }
+    .state-icon { font-size: 16px; font-weight: 500; }
+    .event-group h2 { margin: 0 0 16px; font-size: 18px; line-height: 1.35; }
+    .post-card { margin-bottom: 12px; padding: 16px; border: 1px solid #d2dadd; border-radius: 13px; background: #fff; }
+    .post-head { display: flex; align-items: center; min-width: 0; }
+    .avatar { display: grid; flex: 0 0 auto; width: 36px; height: 36px; place-items: center; overflow: hidden; border-radius: 50%; background: linear-gradient(145deg, #a57954, #d3aa7d); color: #fff; font-size: 18px; font-weight: 700; }
+    .avatar-image { display: block; width: 100%; height: 100%; object-fit: cover; }
+    .avatar-fallback { display: block; }
+    .author { display: flex; flex-direction: column; margin-left: 9px; line-height: 1.25; }
+    .author strong { font-size: 13px; }
+    .author span { color: #6f7d83; font-size: 10px; }
+    .post-head time { margin-left: auto; color: #6f7d83; font-size: 10px; }
+    .post-text { margin: 14px 0 10px; color: #27343c; font-size: 14px; line-height: 1.65; }
+    .schedule { margin: 0 0 10px; color: #08768b; font-size: 11px; }
+    .post-foot { color: #6f7d83; font-size: 10px; }
+    .empty-state, .empty-post { color: #7a888d; font-size: 13px; text-align: center; }
+    .empty-state { padding: 56px 0; }
+    .empty-post { padding: 24px 12px; }
+  </style>
+</head>
+<body>
+  <main class="calendar-card">
+    <section class="calendar-pane">
+      <header class="calendar-header">
+        <div><h1>${monthLabel}</h1><div class="month-summary">本月：${resetCount} 条全员重置&nbsp;&nbsp;·&nbsp;&nbsp;${creditCount} 张重置卡</div></div>
+        <div class="calendar-nav"><span>回到最近</span><span class="arrow">‹</span><span class="arrow">›</span></div>
+      </header>
+      <div class="weekday-row">${WEEK_NAMES.map((name) => `<span>${name}</span>`).join('')}</div>
+      <div class="calendar-grid">${renderCalendarGrid(month, marks, selectedDate, today)}</div>
+      <div class="calendar-note">仅显示已确认事件；按北京时间记录实际发生日期，缺失时按确认日期展示；不含预告。</div>
+    </section>
+    ${renderDetails(events)}
+  </main>
+</body>
 </html>`;
 }
 async function renderCalendarImage(browser, events, now = new Date()) {

package/lib/event.d.ts

@@ -0,0 +1,4 @@
+import type { CalendarBrowser } from './calendar';
+import type { LatestResetSummary } from './stats';
+export declare function renderLatestResetHtml(summary: LatestResetSummary, now?: Date): string;
+export declare function renderLatestResetImage(browser: CalendarBrowser, summary: LatestResetSummary, now?: Date): Promise<Buffer>;

package/lib/event.js

@@ -0,0 +1,145 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderLatestResetHtml = renderLatestResetHtml;
+exports.renderLatestResetImage = renderLatestResetImage;
+const calendar_1 = require("./calendar");
+function escapeHtml(value) {
+    return value
+        .replaceAll('&', '&')
+        .replaceAll('<', '&lt;')
+        .replaceAll('>', '&gt;')
+        .replaceAll('"', '&quot;')
+        .replaceAll("'", '&#39;');
+}
+function formatDateTime(timestamp) {
+    return new Intl.DateTimeFormat('zh-CN', {
+        timeZone: 'Asia/Shanghai',
+        year: 'numeric',
+        month: 'numeric',
+        day: 'numeric',
+        hour: '2-digit',
+        minute: '2-digit',
+        hour12: false,
+    }).format(new Date(timestamp));
+}
+function formatElapsed(timestamp, now) {
+    const elapsedHours = Math.max(0, (now.getTime() - timestamp) / (60 * 60 * 1000));
+    if (elapsedHours < 1)
+        return `${Math.max(1, Math.round(elapsedHours * 60))} 分钟前`;
+    if (elapsedHours < 24)
+        return `${Math.round(elapsedHours * 10) / 10} 小时前`;
+    return `${Math.round(elapsedHours / 24 * 10) / 10} 天前`;
+}
+function typeLabel(summary) {
+    return summary.event.type === 'direct_reset' ? '全员重置' : '重置卡';
+}
+function latestPost(summary) {
+    return [...summary.event.posts]
+        .sort((a, b) => Date.parse(b.publishedAt) - Date.parse(a.publishedAt))[0] ?? null;
+}
+function renderSourcePost(summary) {
+    const post = latestPost(summary);
+    if (!post)
+        return '<div class="post-empty">暂无来源帖子内容</div>';
+    const avatar = (0, calendar_1.getTiboAvatarDataUri)()
+        ? `<img class="avatar-image" src="${(0, calendar_1.getTiboAvatarDataUri)()}" alt="">`
+        : '<span class="avatar-fallback">T</span>';
+    const text = post.text || post.originalText;
+    const publishedAt = Date.parse(post.publishedAt);
+    const time = Number.isFinite(publishedAt) ? formatDateTime(publishedAt) : '时间未知';
+    return `<article class="post-card">
+    <div class="post-head">
+      <div class="avatar">${avatar}</div>
+      <div class="author"><strong>Tibo</strong><span>@thsottiaux</span></div>
+      <time>${escapeHtml(time)} 发布</time>
+    </div>
+    <p class="post-text">${escapeHtml(text)}</p>
+    <div class="post-foot">${escapeHtml(post.stage)}</div>
+  </article>`;
+}
+function renderLatestResetHtml(summary, now = new Date()) {
+    const approximate = summary.approximate ? '时间按公开日期估算' : '已记录精确确认时间';
+    const event = summary.event;
+    return `<!doctype html>
+<html lang="zh-CN">
+<head>
+  <meta charset="utf-8">
+  <style>
+    * { box-sizing: border-box; }
+    html, body { margin: 0; padding: 0; background: #f4f6f5; color: #27343c; font-family: "Avenir Next", "PingFang SC", "Microsoft YaHei", sans-serif; }
+    body { padding: 24px; }
+    .card { position: relative; display: grid; grid-template-columns: .92fr 1.08fr; width: 1120px; min-height: 520px; overflow: hidden; border: 1px solid #d2dadd; border-radius: 16px; background: #fff; box-shadow: 0 16px 38px rgba(42, 58, 64, .10); }
+    .card::before { content: ""; position: absolute; inset: 0; pointer-events: none; background: radial-gradient(circle at 7% 12%, rgba(8, 118, 139, .11), transparent 34%), radial-gradient(circle at 95% 96%, rgba(184, 134, 59, .10), transparent 34%); }
+    .overview, .source { position: relative; z-index: 1; padding: 38px 40px; }
+    .overview { display: flex; flex-direction: column; border-right: 1px solid #d9dfe0; background: linear-gradient(145deg, rgba(237, 247, 246, .8), rgba(255, 255, 255, .96) 64%); }
+    .source { background: linear-gradient(160deg, rgba(250, 246, 238, .68), rgba(255, 255, 255, .98) 55%); }
+    .eyebrow { color: #08768b; font-size: 11px; font-weight: 700; letter-spacing: .18em; }
+    .source .eyebrow { color: #a27831; }
+    h1 { margin: 18px 0 7px; color: #27343c; font-size: 31px; letter-spacing: -.04em; }
+    .subtitle { margin: 0; color: #6f7d83; font-size: 13px; line-height: 1.6; }
+    .elapsed { margin-top: 40px; color: #08768b; font-family: Georgia, "Times New Roman", serif; font-size: 54px; font-weight: 700; letter-spacing: -.06em; line-height: 1; }
+    .elapsed-label { margin-top: 8px; color: #617079; font-size: 12px; }
+    .facts { display: grid; grid-template-columns: 1fr 1fr; gap: 12px; margin-top: auto; padding-top: 32px; }
+    .fact { padding: 13px 14px; border: 1px solid #c8dedd; border-radius: 11px; background: rgba(255, 255, 255, .72); }
+    .fact-label { color: #6f7d83; font-size: 10px; }
+    .fact-value { margin-top: 5px; color: #27343c; font-size: 14px; font-weight: 700; }
+    .note { margin-top: 16px; color: #7a888d; font-size: 10px; line-height: 1.6; }
+    .source-header { display: flex; align-items: flex-start; justify-content: space-between; padding-bottom: 17px; border-bottom: 1px solid #e0e5e6; }
+    .source-header h2 { margin: 0; color: #27343c; font-size: 19px; }
+    .source-header span { color: #6f7d83; font-size: 10px; }
+    .event-title { margin: 25px 0 19px; color: #27343c; font-size: 22px; line-height: 1.4; }
+    .post-card { padding: 18px; border: 1px solid #d2dadd; border-radius: 13px; background: rgba(255, 255, 255, .86); }
+    .post-head { display: flex; align-items: center; min-width: 0; }
+    .avatar { display: grid; flex: 0 0 auto; width: 42px; height: 42px; place-items: center; overflow: hidden; border-radius: 50%; background: linear-gradient(145deg, #a57954, #d3aa7d); color: #fff; font-size: 19px; font-weight: 700; }
+    .avatar-image { display: block; width: 100%; height: 100%; object-fit: cover; }
+    .avatar-fallback { display: block; }
+    .author { display: flex; flex-direction: column; margin-left: 10px; line-height: 1.3; }
+    .author strong { font-size: 14px; }
+    .author span { color: #6f7d83; font-size: 10px; }
+    .post-head time { margin-left: auto; color: #6f7d83; font-size: 10px; }
+    .post-text { display: -webkit-box; margin: 19px 0 15px; overflow: hidden; color: #27343c; font-size: 15px; line-height: 1.7; -webkit-box-orient: vertical; -webkit-line-clamp: 5; }
+    .post-foot { color: #6f7d83; font-size: 10px; }
+    .post-empty { padding: 45px 20px; border: 1px dashed #d2dadd; border-radius: 13px; color: #7a888d; font-size: 13px; text-align: center; }
+    .source-note { margin-top: 17px; color: #7a888d; font-size: 10px; line-height: 1.6; }
+    .mark { margin-top: 34px; color: #a27831; font-size: 10px; font-weight: 700; letter-spacing: .12em; }
+  </style>
+</head>
+<body>
+  <main class="card">
+    <section class="overview">
+      <div class="eyebrow">CODEX RESET / LATEST</div>
+      <h1>最近重置</h1>
+      <p class="subtitle">AIHOT 公开快照中的最近一次已确认事件</p>
+      <div class="elapsed">${escapeHtml(formatElapsed(summary.timestamp, now))}</div>
+      <div class="elapsed-label">距离这次重置已经过去</div>
+      <div class="facts">
+        <div class="fact"><div class="fact-label">发生时间</div><div class="fact-value">${escapeHtml(formatDateTime(summary.timestamp))}</div></div>
+        <div class="fact"><div class="fact-label">事件类型</div><div class="fact-value">${typeLabel(summary)}</div></div>
+      </div>
+      <p class="note">${escapeHtml(approximate)}。数据来自 AIHOT 当前历史快照，不代表你的账户一定获得重置。</p>
+    </section>
+    <section class="source">
+      <header class="source-header"><h2>事件来源</h2><span>北京时间</span></header>
+      <h2 class="event-title">${escapeHtml(event.title)}</h2>
+      ${renderSourcePost(summary)}
+      <p class="source-note">${escapeHtml(event.scope ? `范围：${event.scope}` : '公开来源帖子记录')}</p>
+      <div class="mark">RESET MONITOR</div>
+    </section>
+  </main>
+</body>
+</html>`;
+}
+async function renderLatestResetImage(browser, summary, now = new Date()) {
+    let page = null;
+    try {
+        page = await browser.page();
+        await page.setViewport({ width: 1120, height: 570, deviceScaleFactor: 1 });
+        await page.setContent(renderLatestResetHtml(summary, now), { waitUntil: 'domcontentloaded', timeout: 15000 });
+        const image = await page.screenshot({ type: 'png', fullPage: true });
+        return Buffer.from(image);
+    }
+    finally {
+        if (page)
+            await page.close();
+    }
+}

package/lib/history.d.ts

@@ -1,4 +1,6 @@
 import type { CodexResetEvent } from './types';
 import { CalendarBrowser } from './calendar';
+export type HistoryRange = number | 'all';
+export declare function filterHistoryEvents(events: CodexResetEvent[], now?: Date, range?: HistoryRange): CodexResetEvent[];
 export declare function renderHistoryHtml(events: CodexResetEvent[], now?: Date): string;
 export declare function renderHistoryImage(browser: CalendarBrowser, events: CodexResetEvent[], now?: Date): Promise<Buffer>;