@morehao/dsh-github-trending 0.4.2 → 0.4.4

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## [v0.4.4] - 2026-10-31
+
+### 变更
+
+- **概览榜单支持日/周/月三周期切换**：概览页「最近榜单」区块此前只展示日榜，现在按日榜 / 周榜 / 月榜分段展示，每个周期各自显示最近若干期，点格子可直接跳到榜单页对应期数；分段按钮上显示各周期期数。仅在调度启用多个周期时出现分段控件。
+- **精简空日期展示**：不再把没有记录的日期逐个铺成「无记录」卡片，只渲染真正有记录的期数；完全无记录时显示空状态提示。今天尚未运行且调度开启时，日榜末尾保留一个「等待 {时间}」状态位。
+
+### 修复
+
+- **时间格式统一为 24 小时制**：`localTime` / `shortTime` / 下次运行时间等展示改用 `hourCycle: 'h23'`，避免不同环境下出现 12 小时制与 24 小时制混用。
+
+## [v0.4.3] - 2026-10-31
+
+### 变更
+
+- **默认三周期全产出，无需勾选**：`schedule.periods` 固定收敛为 `daily,weekly,monthly`，定时运行默认产出日榜、周榜、月榜；设置页移除周期多选框，改为静态说明。旧配置（只有 `daily` 或空数组）在归一化时自动升级为三周期。相应地移除了「调度开启却未选周期」的校验（周期已恒为三项）。
+- **手动/工具运行也默认三榜**：新增 `Runner.runMany()`，`POST /run` 与 `trending_run` 在省略 `period` 时按顺序依次跑日/周/月三个周期（各自独立 id、日志、历史记录、`periodSuccess`），响应新增 `summaries` 数组；显式传 `period` 时仍只跑单周期。批次期间由 `batching` 标志挡住外部并发触发。
+
 ## [v0.4.2] - 2026-10-31
 
 ### Features

package/README.md

@@ -97,7 +97,7 @@ dsh plugin --profile <profile> add @morehao/dsh-github-trending
 | `trending.since` / `languages` / `topN` | `daily` / `all,typescript,python,go,rust` / `25` | `since` 是单次运行周期（`daily`/`weekly`/`monthly`，抓取窗口=标的周期由核心保证）；实际支持范围由核心决定 |
 | `output.dir` | `trending` | 仓库内相对目录 |
 | `schedule.enabled` / `time` / `timezone` | `true` / `08:30:00` / `Asia/Shanghai` | 插件自己的 60 s tick 驱动 |
-| `schedule.periods` | `daily` | 定时自动产出的周期（`daily`/`weekly`/`monthly` 多选）：日=每天、周=周日、月=月末触发 |
+| `schedule.periods` | `daily,weekly,monthly` | 定时自动产出的周期：默认三周期全产出（无需勾选），日=每天、周=周日、月=月末触发；旧配置自动升级为三周期 |
 | `corePath` | 空 | 等价于 `TRENDING_DIGEST_CORE`（仅开发/排障，界面不提供入口，用环境变量或直接改 `settings.json`；设了就完全不下载） |
 | `coreAutoDownload` | `true` | 缓存缺失时是否自动下载核心；关掉后只报 `CORE_NOT_DOWNLOADED`，由你在设置页点「下载核心」 |
 

package/client.js

@@ -143,6 +143,7 @@ var DICT = {
     "card.schedule.title": "调度",
     "schedule.enabled": "定时运行",
     "schedule.periods": "自动产出周期",
+    "schedule.periods.value": "日榜 / 周榜 / 月榜（默认全部产出，无需勾选）",
     "schedule.time": "时间",
     "schedule.timezone": "时区",
     "schedule.next": "下次运行",
@@ -279,9 +280,10 @@ var DICT = {
     "overview.ready.repo": "仓库",
     "overview.ready.github": "GitHub",
     "overview.ready.view": "查看",
-    "overview.week.title": "最近 7 天（日榜）",
+    "overview.week.title": "最近榜单",
     "overview.week.all": "全部运行记录",
-    "overview.week.none": "无记录",
+    "overview.week.empty": "还没有运行记录",
+    "overview.week.selectPeriod": "选择榜单周期",
     "overview.week.wait": "等待 {time}",
     "overview.live.title": "正在运行",
     "overview.live.core": "核心执行中",
@@ -469,6 +471,7 @@ var DICT = {
     "card.schedule.title": "Schedule",
     "schedule.enabled": "Scheduled runs",
     "schedule.periods": "Auto periods",
+    "schedule.periods.value": "Daily / Weekly / Monthly (all produced by default, no selection needed)",
     "schedule.time": "Time",
     "schedule.timezone": "Time zone",
     "schedule.next": "Next run",
@@ -605,9 +608,10 @@ var DICT = {
     "overview.ready.repo": "Repository",
     "overview.ready.github": "GitHub",
     "overview.ready.view": "View",
-    "overview.week.title": "Last 7 days (daily)",
+    "overview.week.title": "Recent leaderboards",
     "overview.week.all": "All runs",
-    "overview.week.none": "No record",
+    "overview.week.empty": "No runs yet",
+    "overview.week.selectPeriod": "Choose leaderboard period",
     "overview.week.wait": "Waiting for {time}",
     "overview.live.title": "Running",
     "overview.live.core": "Core is working",
@@ -968,7 +972,7 @@ var CSS = `
 .dshgt-md a:hover{text-decoration:underline;}
 
 /* ——— 周期标签 / 分段 ——— */
-.dshgt-pchip{display:inline-flex;align-items:center;height:20px;padding:0 8px;border-radius:999px;font-size:11px;font-weight:600;line-height:18px;white-space:nowrap;border:1px solid var(--gt-border);color:var(--gt-muted);background:var(--gt-bg);}
+.dshgt-pchip{display:inline-flex;align-items:center;justify-content:center;height:20px;padding:0 8px;border-radius:999px;font-size:11px;font-weight:600;line-height:18px;white-space:nowrap;border:1px solid var(--gt-border);color:var(--gt-muted);background:var(--gt-bg);}
 .dshgt-pchip.daily{color:var(--gt-accent);border-color:color-mix(in srgb,var(--gt-accent) 35%,var(--gt-border));background:color-mix(in srgb,var(--gt-accent) 9%,var(--gt-bg));}
 .dshgt-pchip.weekly{color:#7c3aed;border-color:#ddd6fe;background:#f5f3ff;}
 .dshgt-pchip.monthly{color:#0f766e;border-color:#99f6e4;background:#f0fdfa;}
@@ -978,6 +982,8 @@ var CSS = `
 .dshgt-period-seg button.on{background:var(--gt-bg);color:var(--gt-fg);font-weight:600;box-shadow:0 1px 2px rgba(15,23,42,.08);}
 .dshgt-period-count{font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:11px;color:var(--gt-muted);background:color-mix(in srgb,var(--gt-fg) 6%,var(--gt-bg));border-radius:999px;padding:0 6px;line-height:16px;}
 .dshgt-period-seg button.on .dshgt-period-count{color:var(--gt-accent);background:color-mix(in srgb,var(--gt-accent) 12%,var(--gt-bg));}
+.dshgt-overview-seg{margin-bottom:8px;}
+.dshgt-overview-empty{padding:14px 2px;}
 
 /* ——— 运行记录 ——— */
 .dshgt-runs-head{display:flex;align-items:center;gap:10px;flex-wrap:wrap;}
@@ -1200,7 +1206,15 @@ function localTime(iso) {
   if (iso === null || iso === void 0) return "—";
   const date = new Date(iso);
   if (Number.isNaN(date.getTime())) return "—";
-  return date.toLocaleString();
+  return date.toLocaleString(void 0, {
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit",
+    second: "2-digit",
+    hourCycle: "h23"
+  });
 }
 async function copyText(value) {
   try {
@@ -1215,7 +1229,13 @@ function shortTime(iso) {
   if (iso === null || iso === void 0) return "—";
   const date = new Date(iso);
   if (Number.isNaN(date.getTime())) return "—";
-  return date.toLocaleString(void 0, { month: "2-digit", day: "2-digit", hour: "2-digit", minute: "2-digit" });
+  return date.toLocaleString(void 0, {
+    month: "2-digit",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit",
+    hourCycle: "h23"
+  });
 }
 
 // client/api.ts
@@ -1785,19 +1805,7 @@ function SettingsView(props) {
     h(
       Row,
       { label: t("schedule.periods") },
-      ...["daily", "weekly", "monthly"].map(
-        (period) => h(Toggle, {
-          key: period,
-          checked: draft.schedule.periods.includes(period),
-          onChange: (on) => update((next) => {
-            const set = new Set(next.schedule.periods);
-            if (on) set.add(period);
-            else set.delete(period);
-            next.schedule.periods = ["daily", "weekly", "monthly"].filter((p) => set.has(p));
-          }),
-          label: t(`scope.${period}`)
-        })
-      )
+      h("span", { className: "dshgt-hint" }, t("schedule.periods.value"))
     ),
     h("p", { className: "dshgt-hint" }, t("schedule.source"))
   );
@@ -2198,38 +2206,6 @@ function digestTarget(record, timeZone) {
   const period = recordPeriod(record);
   return { period, bucket: periodBucket(period, info.date) };
 }
-function buildDigestDates(records, options) {
-  const now = options.now ?? /* @__PURE__ */ new Date();
-  const today = zonedDateString(now, options.timeZone);
-  const earliest = addDays(today, -(DIGEST_WINDOW_DAYS - 1));
-  const groups = /* @__PURE__ */ new Map();
-  for (const record of records) {
-    if (recordPeriod(record) !== "daily") continue;
-    const info = recordDate(record, options.timeZone);
-    if (info === void 0) continue;
-    if (info.date < earliest || info.date > today) continue;
-    const group = groups.get(info.date);
-    if (group === void 0) groups.set(info.date, { records: [record], derivedFromAt: info.derivedFromAt });
-    else {
-      group.records.push(record);
-      group.derivedFromAt = group.derivedFromAt || info.derivedFromAt;
-    }
-  }
-  const days = [];
-  for (const [date, group] of groups) {
-    const sorted = [...group.records].sort((a, b) => b.at.localeCompare(a.at));
-    const preferred = sorted.find(
-      (record2) => record2.preview !== void 0 && record2.ok && record2.kind !== "dry-run" && !record2.skipped
-    );
-    const record = preferred ?? sorted[0];
-    if (record === void 0) continue;
-    const info = recordDate(record, options.timeZone);
-    const legacy = record.legacy === true || info?.derivedFromAt === true || group.derivedFromAt;
-    days.push({ date, record, status: digestStatus(record), legacy });
-  }
-  days.sort((a, b) => b.date.localeCompare(a.date));
-  return days;
-}
 function buildPeriodGroups(records, options) {
   const now = options.now ?? /* @__PURE__ */ new Date();
   const today = zonedDateString(now, options.timeZone);
@@ -2275,11 +2251,6 @@ function buildPeriodGroups(records, options) {
     return { period, days, previewCount: days.filter((day) => day.status === "preview").length };
   });
 }
-function recentDates(today, count) {
-  const dates = [];
-  for (let offset = count - 1; offset >= 0; offset -= 1) dates.push(addDays(today, -offset));
-  return dates;
-}
 function formatDayLabel(date, lang) {
   let weekday = "";
   try {
@@ -2379,6 +2350,7 @@ function readyRows(t, state) {
 function OverviewView(props) {
   const { t, lang, store, controller } = props;
   const state = store.state;
+  const [activePeriod, setActivePeriod] = import_react.default.useState("daily");
   if (state === null) {
     return h("div", { className: "dshgt-empty" }, store.error ?? t("quickfill.loading"));
   }
@@ -2388,9 +2360,15 @@ function OverviewView(props) {
   const readyCount = rows.filter((row) => row.ok).length;
   const timeZone = state.schedule.timezone;
   const today = zonedDateString(/* @__PURE__ */ new Date(), timeZone);
-  const days = buildDigestDates(state.status.history, { timeZone });
-  const byDate = new Map(days.map((day) => [day.date, day]));
-  const week = recentDates(today, 7);
+  const groups = buildPeriodGroups(state.status.history, { timeZone });
+  const groupMap = new Map(groups.map((group) => [group.period, group]));
+  const enabledPeriods = PERIODS.filter((period2) => state.schedule.periods.includes(period2));
+  const periods = enabledPeriods.length > 0 ? enabledPeriods : PERIODS;
+  const period = periods.includes(activePeriod) ? activePeriod : periods[0] ?? "daily";
+  const activeDays = groupMap.get(period)?.days ?? [];
+  const recent = period === "daily" ? activeDays.slice(0, 7) : activeDays;
+  const todayHasDaily = groupMap.get("daily")?.days.some((day) => day.date === today) ?? false;
+  const showWaiting = period === "daily" && !todayHasDaily && state.schedule.enabled;
   const lastTarget = last === null ? void 0 : digestTarget(last, timeZone);
   return h(
     "div",
@@ -2502,42 +2480,59 @@ function OverviewView(props) {
         t("overview.week.title"),
         h("button", { type: "button", className: "dshgt-linkbtn dshgt-section-tail", onClick: props.onOpenRuns }, t("overview.week.all"))
       ),
-      h(
+      periods.length > 1 ? h(
         "div",
-        { className: "dshgt-week" },
-        week.map((date) => {
-          const day = byDate.get(date);
-          if (day === void 0) {
-            const waiting = date === today && state.schedule.enabled;
-            return h(
-              "div",
-              { className: "dshgt-day", key: date },
-              h("div", { className: "dshgt-day-date" }, date.slice(5).replace("-", "/")),
-              h("div", { className: "dshgt-day-status" }, waiting ? t("overview.week.wait", { time: state.schedule.time }) : t("overview.week.none"))
-            );
-          }
+        { className: "dshgt-period-seg dshgt-overview-seg", role: "tablist", "aria-label": t("overview.week.selectPeriod") },
+        periods.map((item) => {
+          const on = item === period;
+          const count = groupMap.get(item)?.days.length ?? 0;
           return h(
             "button",
             {
+              key: item,
               type: "button",
-              className: "dshgt-day dshgt-day-clickable",
-              key: date,
-              onClick: () => props.onOpenDigest({ period: "daily", bucket: date }),
-              title: day.record.errorCode === void 0 ? formatDayLabel(date, lang) : `${formatDayLabel(date, lang)} · ${day.record.errorCode}`
+              role: "tab",
+              "aria-selected": on ? "true" : "false",
+              className: on ? "on" : "",
+              onClick: () => setActivePeriod(item)
             },
-            h("div", { className: "dshgt-day-date" }, date.slice(5).replace("-", "/")),
-            h(
-              "div",
-              { className: "dshgt-day-status" },
-              h("span", { className: `dshgt-lamp ${STATUS_LAMP[day.status]}` }),
-              dayLabel(t, day)
-            )
+            h("span", null, t(`period.${item}`)),
+            h("span", { className: "dshgt-period-count" }, String(count))
           );
         })
+      ) : null,
+      recent.length === 0 && !showWaiting ? h("div", { className: "dshgt-hint dshgt-overview-empty" }, t("overview.week.empty")) : h(
+        "div",
+        { className: "dshgt-week" },
+        recent.map(
+          (day) => h(
+            "button",
+            {
+              type: "button",
+              className: "dshgt-day dshgt-day-clickable",
+              key: day.bucket,
+              onClick: () => props.onOpenDigest({ period, bucket: day.bucket }),
+              title: day.record.errorCode === void 0 ? formatBucketLabel(period, day.bucket, lang) : `${formatBucketLabel(period, day.bucket, lang)} · ${day.record.errorCode}`
+            },
+            h("div", { className: "dshgt-day-date" }, shortBucket(period, day.bucket)),
+            h("div", { className: "dshgt-day-status" }, h("span", { className: `dshgt-lamp ${STATUS_LAMP[day.status]}` }), dayLabel(t, day))
+          )
+        ),
+        showWaiting ? h(
+          "div",
+          { className: "dshgt-day" },
+          h("div", { className: "dshgt-day-date" }, today.slice(5).replace("-", "/")),
+          h("div", { className: "dshgt-day-status" }, t("overview.week.wait", { time: state.schedule.time }))
+        ) : null
       )
     )
   );
 }
+function shortBucket(period, bucket) {
+  if (period === "daily") return bucket.slice(5).replace("-", "/");
+  if (period === "weekly") return bucket.slice(5);
+  return bucket.slice(2).replace("-", "/");
+}
 
 // client/runs.ts
 var FILTERS = [
@@ -3902,7 +3897,13 @@ function nextRunText(iso) {
   if (iso === void 0) return "—";
   const date = new Date(iso);
   if (Number.isNaN(date.getTime())) return "—";
-  return date.toLocaleString(void 0, { month: "numeric", day: "numeric", hour: "2-digit", minute: "2-digit" });
+  return date.toLocaleString(void 0, {
+    month: "numeric",
+    day: "numeric",
+    hour: "2-digit",
+    minute: "2-digit",
+    hourCycle: "h23"
+  });
 }
 function apply(ctx) {
   const slots = ctx.get?.("slots");

package/lib/{chunk-WTVBXQYN.js → chunk-GBXP2NGW.js}

@@ -56,7 +56,7 @@ var DEFAULT_SETTINGS = {
   github: { authMode: "gh", tokenRef: "GITHUB_TOKEN" },
   trending: { since: "daily", languages: ["all", "typescript", "python", "go", "rust"], topN: 25 },
   output: { dir: "trending" },
-  schedule: { enabled: true, time: "08:30:00", timezone: "Asia/Shanghai", periods: ["daily"] },
+  schedule: { enabled: true, time: "08:30:00", timezone: "Asia/Shanghai", periods: ["daily", "weekly", "monthly"] },
   corePath: "",
   coreAutoDownload: true
 };
@@ -117,10 +117,8 @@ function strArray(value, fallback) {
   const items = value.filter((item) => typeof item === "string" && item.trim() !== "");
   return items.length > 0 ? items.map((item) => item.trim()) : fallback;
 }
-function periodList(value, fallback) {
-  if (value === void 0 || !Array.isArray(value)) return [...fallback];
-  const set = new Set(value.filter(isPeriod));
-  return PERIODS.filter((period) => set.has(period));
+function periodList(_value, _fallback) {
+  return [...PERIODS];
 }
 function normalizeSettings(input) {
   const raw = typeof input === "object" && input !== null ? input : {};
@@ -243,9 +241,6 @@ function validateSettings(settings, providers = CORE_PROVIDERS) {
   if (!isValidTimezone(schedule.timezone)) {
     problems.push({ field: "schedule.timezone", code: "CONFIG_INVALID", message: "\u65F6\u533A\u5FC5\u987B\u662F IANA \u540D\u79F0\uFF08\u5982 Asia/Shanghai\uFF09" });
   }
-  if (schedule.enabled && schedule.periods.length === 0) {
-    problems.push({ field: "schedule.periods", code: "CONFIG_INVALID", message: "\u5B9A\u65F6\u8FD0\u884C\u5F00\u542F\u65F6\u81F3\u5C11\u8981\u9009\u62E9\u4E00\u4E2A\u4EA7\u51FA\u5468\u671F\uFF08\u65E5/\u5468/\u6708\uFF09" });
-  }
   return problems;
 }
 function effectiveBaseURL(model) {
@@ -2170,7 +2165,7 @@ var Scheduler = class {
     for (const key of this.attempts.keys()) {
       if (!key.endsWith(`:${today}`)) this.attempts.delete(key);
     }
-    const periods = schedule.periods.length > 0 ? schedule.periods : ["daily"];
+    const periods = schedule.periods.length > 0 ? schedule.periods : PERIODS;
     let ran = false;
     for (const period of periods) {
       if (!isPeriodTriggerDay(period, now, schedule.timezone)) continue;
@@ -2215,7 +2210,7 @@ var Scheduler = class {
   next() {
     const schedule = this.readSchedule();
     if (!schedule.enabled) return void 0;
-    const periods = schedule.periods.length > 0 ? schedule.periods : ["daily"];
+    const periods = schedule.periods.length > 0 ? schedule.periods : PERIODS;
     try {
       const now = /* @__PURE__ */ new Date();
       let earliest;
@@ -2304,6 +2299,8 @@ function periodFileBase(period, date) {
 }
 var Runner = class {
   active;
+  /** 批量运行（一次触发跑多个周期）期间为 true，挡住外部并发触发。 */
+  batching = false;
   deps;
   constructor(deps) {
     this.deps = deps;
@@ -2316,13 +2313,13 @@ var Runner = class {
     this.active.controller.abort();
     return true;
   }
-  async run(options) {
+  async run(options, _internal = false) {
     const env = this.deps.env ?? process.env;
     const store = this.deps.store;
     const settings = store.readSettings();
     const credentials = credentialServices(this.deps.get);
-    if (this.active !== void 0) {
-      throw new IpcError("CONFIG_INVALID", `\u5DF2\u6709\u4E00\u6B21\u8FD0\u884C\u5728\u8FDB\u884C\u4E2D\uFF08${this.active.id}\uFF09\uFF0C\u8BF7\u5148\u7B49\u5F85\u6216\u53D6\u6D88`);
+    if (!_internal && (this.active !== void 0 || this.batching)) {
+      throw new IpcError("CONFIG_INVALID", `\u5DF2\u6709\u4E00\u6B21\u8FD0\u884C\u5728\u8FDB\u884C\u4E2D\uFF08${this.active?.id ?? "\u6279\u91CF\u8FD0\u884C"}\uFF09\uFF0C\u8BF7\u5148\u7B49\u5F85\u6216\u53D6\u6D88`);
     }
     const problems = validateSettings(settings);
     if (problems.length > 0) {
@@ -2444,6 +2441,28 @@ var Runner = class {
       this.active = void 0;
     }
   }
+  /**
+   * 批量运行：按顺序对多个周期各跑一次（手动/工具触发时默认产出日/周/月三榜）。
+   * 每次内部独享 id / 日志 / 摘要；整个批次期间置 `batching`，挡住外部并发触发。
+   * 取消只中止当前周期，批次继续跑后续周期（用户取消单次即可）。
+   */
+  async runMany(options) {
+    if (this.active !== void 0 || this.batching) {
+      throw new IpcError("CONFIG_INVALID", `\u5DF2\u6709\u4E00\u6B21\u8FD0\u884C\u5728\u8FDB\u884C\u4E2D\uFF08${this.active?.id ?? "\u6279\u91CF\u8FD0\u884C"}\uFF09\uFF0C\u8BF7\u5148\u7B49\u5F85\u6216\u53D6\u6D88`);
+    }
+    const periods = options.periods !== void 0 && options.periods.length > 0 ? options.periods : [...PERIODS];
+    this.batching = true;
+    const summaries = [];
+    try {
+      for (const period of periods) {
+        summaries.push(await this.run({ ...options, period }, true));
+      }
+    } finally {
+      this.batching = false;
+      this.active = void 0;
+    }
+    return summaries;
+  }
   summarize(input) {
     const { outcome } = input;
     const error = outcome.error === void 0 ? void 0 : (() => {
@@ -3341,13 +3360,17 @@ async function dispatch(method, pathname, url, request, deps) {
   }
   if (method === "POST" && pathname === "/run") {
     const body = await readBody2(request);
-    const summary = await deps.runner.run({
+    const base = {
       dryRun: body.dryRun === true,
       ...typeof body.date === "string" && body.date !== "" ? { date: body.date } : {},
-      ...isPeriod(body.period) ? { period: body.period } : {},
       trigger: "manual"
-    });
-    return { summary };
+    };
+    if (isPeriod(body.period)) {
+      const summary = await deps.runner.run({ ...base, period: body.period });
+      return { summary, summaries: [summary] };
+    }
+    const summaries = await deps.runner.runMany(base);
+    return { summary: summaries[summaries.length - 1], summaries };
   }
   if (method === "POST" && pathname === "/run/cancel") {
     return { cancelled: deps.runner.cancel() };
@@ -3617,11 +3640,11 @@ function describeRecord(record) {
 function createTrendingRunTool(runner) {
   return {
     name: "trending_run",
-    description: "\u6267\u884C\u4E00\u6B21 GitHub \u8D8B\u52BF\u699C\u5355\uFF1A\u5B9A\u4F4D\u5E76\u63E1\u624B\u672C\u5730\u6838\u5FC3\uFF0Cspawn \u4E00\u6B21 run\uFF0C\u8FD4\u56DE\u7ED3\u6784\u5316\u6458\u8981\uFF08\u6587\u4EF6\u6570\u3001commit\u3001PR\u3001\u9519\u8BEF\u7801\uFF09\u3002dryRun=true \u53EA\u6293\u53D6\u4E0E\u6E32\u67D3\u3001\u4E0D\u5199\u6587\u4EF6\u4E5F\u4E0D\u63D0\u4EA4\u3002\u540C\u65E5\u540C\u5185\u5BB9\u91CD\u8DD1\u4F1A\u8FD4\u56DE skipped=true\uFF08\u96F6\u65B0\u589E commit\uFF09\u3002",
+    description: "\u6267\u884C GitHub \u8D8B\u52BF\u699C\u5355\uFF1A\u5B9A\u4F4D\u5E76\u63E1\u624B\u672C\u5730\u6838\u5FC3\uFF0Cspawn \u6838\u5FC3 run\uFF0C\u8FD4\u56DE\u7ED3\u6784\u5316\u6458\u8981\uFF08\u6587\u4EF6\u6570\u3001commit\u3001PR\u3001\u9519\u8BEF\u7801\uFF09\u3002\u7701\u7565 period \u65F6\u9ED8\u8BA4\u4EA7\u51FA\u65E5/\u5468/\u6708\u4E09\u699C\uFF08\u4F9D\u6B21\u8FD0\u884C\u4E09\u6B21\uFF0C\u8FD4\u56DE summaries\uFF09\u3002dryRun=true \u53EA\u6293\u53D6\u4E0E\u6E32\u67D3\u3001\u4E0D\u5199\u6587\u4EF6\u4E5F\u4E0D\u63D0\u4EA4\u3002\u540C\u65E5\u540C\u5185\u5BB9\u91CD\u8DD1\u4F1A\u8FD4\u56DE skipped=true\uFF08\u96F6\u65B0\u589E commit\uFF09\u3002",
     parameters: {
       dryRun: { type: "boolean", description: "\u53EA\u8BD5\u8DD1\uFF1A\u4E0D\u5199\u6587\u4EF6\u3001\u4E0D\u63D0\u4EA4\u3001\u4E0D\u5F00 PR" },
       date: { type: "string", description: "\u6307\u5B9A\u65E5\u671F\uFF08YYYY-MM-DD\uFF09\uFF1B\u7701\u7565\u5219\u7528\u8C03\u5EA6\u65F6\u533A\u7684\u4ECA\u5929" },
-      period: { type: "string", enum: ["daily", "weekly", "monthly"], description: "\u4EA7\u51FA\u5468\u671F\uFF1B\u7701\u7565\u5219\u7528\u8BBE\u7F6E\u91CC\u7684\u9ED8\u8BA4\u5468\u671F" }
+      period: { type: "string", enum: ["daily", "weekly", "monthly"], description: "\u53EA\u8DD1\u6307\u5B9A\u5468\u671F\uFF1B\u7701\u7565\u5219\u9ED8\u8BA4\u4EA7\u51FA\u65E5/\u5468/\u6708\u4E09\u699C" }
     },
     output: {
       schema: RUN_OUTPUT_SCHEMA,
@@ -3629,37 +3652,51 @@ function createTrendingRunTool(runner) {
     },
     async execute(args = {}, exec = {}) {
       void exec;
-      const summary = await runner.run({
+      const base = {
         dryRun: args.dryRun === true,
         ...typeof args.date === "string" && args.date !== "" ? { date: args.date } : {},
-        ...isPeriod(args.period) ? { period: args.period } : {},
         trigger: "tool"
-      });
+      };
+      const summaries = isPeriod(args.period) ? [await runner.run({ ...base, period: args.period })] : await runner.runMany(base);
       const lines = [];
-      const head = summary.ok ? summary.skipped ? "\u65E0\u53D8\u66F4\uFF08skipped\uFF09" : summary.dryRun ? "\u8BD5\u8DD1\u5B8C\u6210" : "\u8FD0\u884C\u6210\u529F" : `\u8FD0\u884C\u5931\u8D25\uFF1A${summary.error?.code ?? "INTERNAL"}`;
-      lines.push(`${summary.ok ? "\u2713" : "\u2717"} ${head}`);
-      lines.push(`\xB7 \u6838\u5FC3 ${summary.coreVersion || "(\u672A\u77E5)"} \xB7 ${formatDuration(summary.durationMs)} \xB7 ${summary.files} \u4E2A\u6587\u4EF6`);
-      if (summary.contentHash !== void 0) lines.push(`\xB7 contentHash ${summary.contentHash.slice(0, 12)}`);
-      if (summary.branch !== void 0) lines.push(`\xB7 \u5206\u652F ${summary.branch}`);
-      if (summary.prUrl !== void 0) lines.push(`\xB7 PR ${summary.prUrl}`);
-      if (summary.error !== void 0) {
-        lines.push(`\xB7 ${summary.error.message}`);
-        lines.push(`\xB7 \u4E0B\u4E00\u6B65\uFF1A${summary.error.hint}`);
+      for (const summary of summaries) {
+        const periodLabel = summary.period ?? "\u2014";
+        const head = summary.ok ? summary.skipped ? "\u65E0\u53D8\u66F4\uFF08skipped\uFF09" : summary.dryRun ? "\u8BD5\u8DD1\u5B8C\u6210" : "\u8FD0\u884C\u6210\u529F" : `\u8FD0\u884C\u5931\u8D25\uFF1A${summary.error?.code ?? "INTERNAL"}`;
+        lines.push(`${summary.ok ? "\u2713" : "\u2717"} [${periodLabel}] ${head}`);
+        lines.push(`\xB7 \u6838\u5FC3 ${summary.coreVersion || "(\u672A\u77E5)"} \xB7 ${formatDuration(summary.durationMs)} \xB7 ${summary.files} \u4E2A\u6587\u4EF6`);
+        if (summary.contentHash !== void 0) lines.push(`\xB7 contentHash ${summary.contentHash.slice(0, 12)}`);
+        if (summary.branch !== void 0) lines.push(`\xB7 \u5206\u652F ${summary.branch}`);
+        if (summary.prUrl !== void 0) lines.push(`\xB7 PR ${summary.prUrl}`);
+        if (summary.error !== void 0) {
+          lines.push(`\xB7 ${summary.error.message}`);
+          lines.push(`\xB7 \u4E0B\u4E00\u6B65\uFF1A${summary.error.hint}`);
+        }
       }
-      if (summary.dryRun) lines.push("\xB7 \u8FD9\u662F\u8BD5\u8DD1\uFF0C\u6CA1\u6709\u5199\u6587\u4EF6\u3001\u6CA1\u6709\u63D0\u4EA4");
+      if (summaries.length > 1) lines.push(`\xB7 \u672C\u6B21\u5171\u8DD1 ${summaries.length} \u4E2A\u5468\u671F\uFF08\u65E5/\u5468/\u6708\uFF09`);
+      if (summaries.some((summary) => summary.dryRun)) lines.push("\xB7 \u8FD9\u662F\u8BD5\u8DD1\uFF0C\u6CA1\u6709\u5199\u6587\u4EF6\u3001\u6CA1\u6709\u63D0\u4EA4");
+      const ok = summaries.every((summary) => summary.ok);
+      const primary = summaries[summaries.length - 1];
       return {
-        id: summary.id,
-        ok: summary.ok,
-        skipped: summary.skipped,
-        dryRun: summary.dryRun,
-        durationMs: summary.durationMs,
-        coreVersion: summary.coreVersion,
-        files: summary.files,
-        ...summary.contentHash === void 0 ? {} : { contentHash: summary.contentHash },
-        ...summary.branch === void 0 ? {} : { branch: summary.branch },
-        ...summary.prUrl === void 0 ? {} : { prUrl: summary.prUrl },
-        ...summary.error === void 0 ? {} : { errorCode: summary.error.code, errorMessage: summary.error.message, errorHint: summary.error.hint },
-        warnings: summary.warnings,
+        ok,
+        summaries: summaries.map((summary) => ({
+          id: summary.id,
+          period: summary.period,
+          ok: summary.ok,
+          skipped: summary.skipped,
+          dryRun: summary.dryRun,
+          durationMs: summary.durationMs,
+          files: summary.files,
+          ...summary.branch === void 0 ? {} : { branch: summary.branch },
+          ...summary.prUrl === void 0 ? {} : { prUrl: summary.prUrl },
+          ...summary.error === void 0 ? {} : { errorCode: summary.error.code, errorMessage: summary.error.message }
+        })),
+        id: primary?.id,
+        skipped: summaries.every((summary) => summary.skipped),
+        dryRun: base.dryRun,
+        durationMs: summaries.reduce((sum, summary) => sum + summary.durationMs, 0),
+        files: summaries.reduce((sum, summary) => sum + summary.files, 0),
+        warnings: summaries.flatMap((summary) => summary.warnings),
+        ...primary?.error === void 0 ? {} : { errorCode: primary.error.code, errorMessage: primary.error.message, errorHint: primary.error.hint },
         markdown: lines.join("\n")
       };
     }

package/lib/index.js

@@ -8,7 +8,7 @@ import {
   createTrendingRunTool,
   createUpdateService,
   readPluginInfo
-} from "./chunk-WTVBXQYN.js";
+} from "./chunk-GBXP2NGW.js";
 import "./chunk-XLIFTAVL.js";
 
 // src/index.ts

package/lib/internal.d.ts

@@ -222,6 +222,8 @@ interface ScheduleSettings {
     /**
      * 定时自动产出的周期（插件侧调度概念，核心无此字段）。
      * 每个周期按自己的节奏触发：日=每天、周=周日、月=月末。
+     * 现在固定为三周期全产出（`['daily','weekly','monthly']`），不再由用户勾选；
+     * 保留该字段以兼容旧设置、并驱动调度与去重逻辑。
      */
     periods: Period[];
 }
@@ -1272,6 +1274,8 @@ declare function isoWeekName(date: string): string;
 declare function periodFileBase(period: Period, date: string): string;
 declare class Runner {
     private active;
+    /** 批量运行（一次触发跑多个周期）期间为 true，挡住外部并发触发。 */
+    private batching;
     private readonly deps;
     constructor(deps: RunnerDeps);
     get running(): {
@@ -1279,7 +1283,15 @@ declare class Runner {
         startedAt: string;
     } | undefined;
     cancel(): boolean;
-    run(options: RunRequestOptions): Promise<RunSummary>;
+    run(options: RunRequestOptions, _internal?: boolean): Promise<RunSummary>;
+    /**
+     * 批量运行：按顺序对多个周期各跑一次（手动/工具触发时默认产出日/周/月三榜）。
+     * 每次内部独享 id / 日志 / 摘要；整个批次期间置 `batching`，挡住外部并发触发。
+     * 取消只中止当前周期，批次继续跑后续周期（用户取消单次即可）。
+     */
+    runMany(options: RunRequestOptions & {
+        periods?: Period[];
+    }): Promise<RunSummary[]>;
     private summarize;
     private failureSummary;
     /**
@@ -1324,17 +1336,6 @@ declare namespace pluginInfo {
   export { type pluginInfo_PluginInfo as PluginInfo, pluginInfo_normalizeRepositoryUrl as normalizeRepositoryUrl, pluginInfo_readPluginInfo as readPluginInfo };
 }
 
-/**
- * 调度（FR-P-08 / 规格 §9）。
- *
- * 规格原本设想「复用宿主 schedule 服务」，但实测：宿主的 `ctx.schedule` 是 **会话本地**
- * 的提醒（rc.5 才引入，create 需要 sessionId，冷会话不投递），而本插件的运行完全不依赖会话。
- * 因此这里实现规格 §9 已经写明的兜底：宿主 `timer` 服务（或 `setInterval`）60 s tick、
- * 按 IANA 时区判当日、6 h 内补跑、同日不重复。
- *
- * 「下一次运行」也由同一份时区算术给出，界面与工具都用它。
- */
-
 interface ScheduleConfig {
     enabled: boolean;
     time: string;
@@ -1591,21 +1592,30 @@ declare function createTrendingRunTool(runner: Runner): {
     }, exec?: {
         signal?: AbortSignal;
     }): Promise<{
-        warnings: string[];
         markdown: string;
         errorCode?: string | undefined;
         errorMessage?: string | undefined;
         errorHint?: string | undefined;
-        prUrl?: string | undefined;
-        branch?: string | undefined;
-        contentHash?: string | undefined;
-        id: string;
         ok: boolean;
+        summaries: {
+            errorCode?: string | undefined;
+            errorMessage?: string | undefined;
+            prUrl?: string | undefined;
+            branch?: string | undefined;
+            id: string;
+            period: Period | undefined;
+            ok: boolean;
+            skipped: boolean;
+            dryRun: boolean;
+            durationMs: number;
+            files: number;
+        }[];
+        id: string | undefined;
         skipped: boolean;
         dryRun: boolean;
         durationMs: number;
-        coreVersion: string;
         files: number;
+        warnings: string[];
     }>;
 };
 declare function createTrendingHistoryTool(store: Store, scheduler: Scheduler): {

package/lib/internal.js

@@ -24,7 +24,7 @@ import {
   state_exports,
   tools_exports,
   update_exports
-} from "./chunk-WTVBXQYN.js";
+} from "./chunk-GBXP2NGW.js";
 import {
   exec_exports
 } from "./chunk-XLIFTAVL.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@morehao/dsh-github-trending",
-  "version": "0.4.2",
+  "version": "0.4.4",
   "description": "GitHub 趋势日报插件：每天定时 spawn 本地 trendradar 核心，抓取 Trending、生成中文简介与总结，提交到你的仓库并自动合并 PR。",
   "type": "module",
   "main": "lib/index.js",