@morehao/dsh-github-trending 0.3.1 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.4.0 - 2026-10-31
+
+### 变更
+
+- **适配核心 0.4.0 的三周期产物布局**：`dsh.core.version` 升到 `0.4.0`。核心产物改为 `trending/<period>/<bucket>/<name>.{md,json}`（daily/weekly/monthly），分支为 `trending/<period>/<name>`；插件每次运行按标的周期传 `run --period daily|weekly|monthly`，保证「抓取窗口 = 标注周期」。
+- **预览按周期选取**：从本次 artifact 里挑本期 digest 的 `.md`（daily=`YYYY-MM-DD.md`、weekly=`YYYY-Wnn.md`、monthly=`YYYY-MM.md`），并排除 `index.md`；日榜预览行为不变。
+- **调度按周期**：新增 `schedule.periods`（日/周/月多选，默认 `daily`）。日榜每天、周榜周日（ISO 周末）、月榜月末触发；去重键含周期与本地日期，同一周期当天只成功一次；「下次运行」取所有已启用周期里最近的一次。
+- `trending_run` 工具与 `POST /run` 增加可选 `period` 参数（缺省用 `trending.since`）。
+
+## 0.3.2 - 2026-10-31
+
+### 改进
+
+- **更新入口更显眼**：概览页新增「插件更新」卡片——当前 / 最新版本、检查更新、更新到 vX、本地安装时的手动命令都在这里；侧栏包名在有新版时显示红点。关于弹层与概览共用同一个 controller（模块级单例），打开多个位置不会重复请求。
+- 关于弹层的更新区块改为复用同一组件（`client/update-panel.ts`），行为不变。
+
 ## 0.3.1 - 2026-10-31
 
 ### 新增

package/README.md

@@ -3,7 +3,7 @@
 [![check](https://github.com/morehao/dsh-github-trending/actions/workflows/check.yml/badge.svg)](https://github.com/morehao/dsh-github-trending/actions/workflows/check.yml)
 [![npm version](https://img.shields.io/npm/v/@morehao/dsh-github-trending.svg)](https://www.npmjs.com/package/@morehao/dsh-github-trending)
 
-> GitHub 趋势日报的 **DSH 入口**：每天定时 spawn 本地 [`trendradar`](https://github.com/morehao/trendradar) 核心，抓取 Trending、生成中文简介与当日总结，提交到你自己的仓库并自动合并 PR。
+> GitHub 趋势榜的 **DSH 入口**：按日/周/月周期定时 spawn 本地 [`trendradar`](https://github.com/morehao/trendradar) 核心，抓取 Trending、生成中文简介与周期总结，提交到你自己的仓库并自动合并 PR。
 
 **状态：0.3.0。** 插件侧（配置、调度、核心调用、状态与工作台、两个工具）已完成。核心二进制走 **GitHub Release**：首次运行按 `os/arch` 下载、用 `checksums.txt` 校验 sha256、缓存到插件数据目录，之后离线复用。核心仓库打 tag 出资产之前，运行会明确报 `CORE_NOT_DOWNLOADED` / `CORE_UNAVAILABLE` 并给出下载地址——不会写空文件，也不会退回旧内容。
 
@@ -94,9 +94,10 @@ dsh plugin --profile <profile> add @morehao/dsh-github-trending
 | `pr.titleTemplate` | `chore(trending): add {date} digest` | 默认规则，界面不展示 |
 | `github.authMode` | `gh` | `gh`（本机 gh 登录态）/ `pat` |
 | `github.tokenRef` | `GITHUB_TOKEN` | `ctx.credentials` 引用名（`pat` 用） |
-| `trending.since` / `languages` / `topN` | `daily` / `all,typescript,python,go,rust` / `25` | 实际支持范围由核心决定 |
+| `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` 多选）：日=每天、周=周日、月=月末触发 |
 | `corePath` | 空 | 等价于 `TRENDING_DIGEST_CORE`（仅开发/排障，界面不提供入口，用环境变量或直接改 `settings.json`；设了就完全不下载） |
 | `coreAutoDownload` | `true` | 缓存缺失时是否自动下载核心；关掉后只报 `CORE_NOT_DOWNLOADED`，由你在设置页点「下载核心」 |
 
@@ -104,7 +105,7 @@ dsh plugin --profile <profile> add @morehao/dsh-github-trending
 
 | 工具 | 参数 | 返回 |
 |---|---|---|
-| `trending_run` | `{ dryRun?: boolean, date?: string }` | 结构化摘要：文件数、commit/分支、PR、内容哈希、错误码与下一步 |
+| `trending_run` | `{ dryRun?: boolean, date?: string, period?: 'daily'\|'weekly'\|'monthly' }` | 结构化摘要：文件数、commit/分支、PR、内容哈希、错误码与下一步 |
 | `trending_history` | `{ limit?: number }` | 上次/下次运行、最近 N 条记录、核心版本、模型、未合并 PR |
 
 工具名是稳定对外接口：**只新增不改名**。
@@ -141,7 +142,7 @@ dsh plugin --profile <profile> add @morehao/dsh-github-trending
 1. **结果信封**：核心 `run --config <path> --json` 输出契约 v2 `RunResult`（`ipcSchema=2`，可选 `branch/commit/prUrl/contentHash`）；插件只解析这一种形状，旧核心的 `runOutput` 不再兼容。
 2. **密钥传输**：POSIX 上配置经 **FIFO** 交给核心（文件系统里不出现明文）；Windows 无 FIFO，退化为 0600 临时文件并在读完后立即删除。
 3. **GitHub token** 经子进程环境变量传给核心（核心只认 `GITHUB_TOKEN`/`GH_TOKEN`）；不进 argv、不进配置、不进日志。
-4. **调度**用插件自己的 60 s tick（宿主 `schedule` 是会话本地提醒，覆盖不到无人值守场景）。
+4. **调度**用插件自己的 60 s tick（宿主 `schedule` 是会话本地提醒，覆盖不到无人值守场景）。按 `schedule.periods` 分别触发：日榜每天、周榜周日（ISO 周末）、月榜月末；去重键含周期与本地日期，同一周期当天只成功一次。
 5. **二进制改为下载**（2026-10-30 决策 B）：不再随包发 npm 平台分包。首次运行需要能访问 GitHub Release；断网环境请用 `TRENDING_DIGEST_CORE` 指向本地核心。核心版本由 `package.json` 的 `dsh.core.version` 固定（用 `node scripts/set-core-version.mjs <x.y.z>` 写入）。
 6. **核心版本固定**：`package.json` 的 `dsh.core.version` 是首次运行下载哪个核心 Release 的唯一来源（用 `node scripts/set-core-version.mjs <x.y.z>` 写入）；下载失败会给出下载地址与错误码，不会退回旧内容。
 7. **预览副本是派生数据**：不是第二份真相；仓库里的 canonical 文件才是。旧记录没有 `preview` 元数据，日报里只能看到对应的空状态，不承诺回填。

package/client.js

@@ -137,10 +137,12 @@ var DICT = {
     "scope.period": "周期",
     "scope.daily": "每日",
     "scope.weekly": "每周",
+    "scope.monthly": "每月",
     "scope.languages": "语言",
     "scope.topN": "每语言条数",
     "card.schedule.title": "调度",
     "schedule.enabled": "定时运行",
+    "schedule.periods": "自动产出周期",
     "schedule.time": "时间",
     "schedule.timezone": "时区",
     "schedule.next": "下次运行",
@@ -357,7 +359,8 @@ var DICT = {
     "about.update.manual": "当前是本地 {kind} 安装，不能一键更新（会把开发链接换成 npm 版）。手动更新：",
     "about.update.copy": "复制命令",
     "about.update.copied": "已复制",
-    "about.update.hint": "只检查 npm 上的 latest 稳定版；更新后需要重启 DSH。"
+    "about.update.hint": "只检查 npm 上的 latest 稳定版；更新后需要重启 DSH。",
+    "update.badge": "有新版本可用"
   },
   en: {
     "section.title": "GitHub Trending",
@@ -451,10 +454,12 @@ var DICT = {
     "scope.period": "Period",
     "scope.daily": "Daily",
     "scope.weekly": "Weekly",
+    "scope.monthly": "Monthly",
     "scope.languages": "Languages",
     "scope.topN": "Per language",
     "card.schedule.title": "Schedule",
     "schedule.enabled": "Scheduled runs",
+    "schedule.periods": "Auto periods",
     "schedule.time": "Time",
     "schedule.timezone": "Time zone",
     "schedule.next": "Next run",
@@ -671,7 +676,8 @@ var DICT = {
     "about.update.manual": "Installed from a local {kind} spec; one-click update is disabled (it would replace the dev link). Update manually:",
     "about.update.copy": "Copy command",
     "about.update.copied": "Copied",
-    "about.update.hint": "Checks the npm latest stable tag only; applying requires a DSH restart."
+    "about.update.hint": "Checks the npm latest stable tag only; applying requires a DSH restart.",
+    "update.badge": "Update available"
   }
 };
 function activeLang(locale) {
@@ -952,6 +958,9 @@ var CSS = `
 .dshgt-update-manual{margin-top:9px;padding:9px 10px;border:1px solid color-mix(in srgb,var(--gt-warn) 35%,var(--gt-border));border-radius:8px;background:color-mix(in srgb,var(--gt-warn) 6%,var(--gt-card));}
 .dshgt-update-manual .dshgt-update-warn{margin:0 0 6px;}
 .dshgt-update-cmd{display:block;font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:11.5px;line-height:1.5;color:var(--gt-fg);word-break:break-all;user-select:all;}
+.dshgt-update-dot{display:inline-block;width:6px;height:6px;margin-left:6px;border-radius:50%;background:var(--gt-err);vertical-align:middle;flex:none;}
+.dshgt-update-bare{margin-top:0;padding-top:0;border-top:0;}
+.dshgt-update-card .dshgt-card-h{margin-bottom:2px;}
 
 @media (max-width:1100px){
   .dshgt-app{grid-template-columns:190px minmax(0,1fr);}
@@ -1658,10 +1667,11 @@ function SettingsView(props) {
         value: draft.trending.since,
         options: [
           { value: "daily", label: t("scope.daily") },
-          { value: "weekly", label: t("scope.weekly") }
+          { value: "weekly", label: t("scope.weekly") },
+          { value: "monthly", label: t("scope.monthly") }
         ],
         onChange: (value) => update((next) => {
-          next.trending.since = value === "weekly" ? "weekly" : "daily";
+          next.trending.since = value === "weekly" ? "weekly" : value === "monthly" ? "monthly" : "daily";
         })
       }),
       h("span", { className: "dshgt-hint" }, t("scope.topN")),
@@ -1699,6 +1709,23 @@ function SettingsView(props) {
         next.schedule.timezone = value;
       }) })
     ),
+    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("p", { className: "dshgt-hint" }, t("schedule.source"))
   );
   const currentCard = section === "source" ? sourceCard : section === "model" ? modelCard : section === "repo" ? repoCard : section === "auth" ? authCard : section === "scope" ? scopeCard : scheduleCard;
@@ -1995,6 +2022,196 @@ function LiveRun(props) {
   );
 }
 
+// node_modules/@morehao/dsh-plugin-kit/dist/update-client.js
+var IDLE = { status: "idle", view: null, error: null };
+function errorOf(error) {
+  if (error !== null && typeof error === "object") {
+    const value = error;
+    const message = typeof value.message === "string" && value.message !== "" ? value.message : "操作失败";
+    return typeof value.code === "string" ? { code: value.code, message } : { message };
+  }
+  return { message: String(error ?? "操作失败") };
+}
+function createUpdateController(options) {
+  const now = options.now ?? Date.now;
+  let state = { ...IDLE };
+  const listeners = /* @__PURE__ */ new Set();
+  let inFlight = null;
+  function emit(next) {
+    state = next;
+    options.onChange?.(state);
+    for (const listener of listeners) listener(state);
+  }
+  async function check(checkOptions = {}) {
+    if (inFlight !== null) return;
+    inFlight = "check";
+    emit({ ...state, status: "checking", error: null });
+    try {
+      const view = await options.request.check(checkOptions);
+      const checkedAt = new Date(now()).toISOString();
+      if (view.checkFailed) {
+        emit({
+          status: "failed",
+          view,
+          error: { code: "CHECK_FAILED", message: "检查更新失败：拿不到 registry 上的最新版本" },
+          checkedAt
+        });
+      } else {
+        emit({ status: view.updateAvailable ? "available" : "current", view, error: null, checkedAt });
+      }
+    } catch (error) {
+      emit({ ...state, status: "failed", error: errorOf(error) });
+    } finally {
+      inFlight = null;
+    }
+  }
+  async function apply2() {
+    if (inFlight !== null) return;
+    const view = state.view;
+    if (view === null || !view.updateAvailable) {
+      emit({ ...state, status: "failed", error: { code: "NO_UPDATE", message: "没有可更新的版本，请先检查更新" } });
+      return;
+    }
+    if (!view.canApply) {
+      emit({
+        ...state,
+        status: "failed",
+        error: { code: "NO_APPLY", message: `当前环境不支持一键更新，请执行：${view.manualCommand}` }
+      });
+      return;
+    }
+    inFlight = "apply";
+    emit({ ...state, status: "applying", error: null });
+    try {
+      const result = await options.request.apply();
+      const restartRequired = result.restartRequired ?? result.application !== "applied";
+      emit({ ...state, status: restartRequired ? "restart-required" : "applied", error: null });
+    } catch (error) {
+      emit({ ...state, status: "failed", error: errorOf(error) });
+    } finally {
+      inFlight = null;
+    }
+  }
+  return {
+    getState: () => state,
+    subscribe: (listener) => {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    },
+    check,
+    apply: apply2,
+    reset: () => emit({ ...IDLE })
+  };
+}
+
+// client/update-panel.ts
+var singleton = null;
+function getUpdateController() {
+  if (singleton === null) {
+    singleton = createUpdateController({
+      request: {
+        check: (options) => getPluginUpdate(options.fresh === true ? { fresh: true } : {}),
+        apply: () => applyPluginUpdate()
+      }
+    });
+  }
+  return singleton;
+}
+function usePluginUpdate() {
+  const controller = getUpdateController();
+  const [state, setState] = import_react.default.useState(() => controller.getState());
+  import_react.default.useEffect(() => {
+    const unsubscribe = controller.subscribe(setState);
+    if (controller.getState().status === "idle") void controller.check();
+    return unsubscribe;
+  }, [controller]);
+  return [state, controller];
+}
+function UpdateDot(props) {
+  const [state] = usePluginUpdate();
+  if (state.view?.updateAvailable !== true) return null;
+  return h("span", { className: "dshgt-update-dot", title: props.t("update.badge") });
+}
+function PluginUpdateSection(props) {
+  const { t } = props;
+  const [state, controller] = usePluginUpdate();
+  const [confirming, setConfirming] = import_react.default.useState(false);
+  const [copied, setCopied] = import_react.default.useState(false);
+  import_react.default.useEffect(() => {
+    if (state.status === "applying" || state.status === "restart-required" || state.status === "applied") setConfirming(false);
+  }, [state.status]);
+  const copyCommand = () => {
+    const command = state.view?.manualCommand;
+    if (command === void 0) return;
+    void copyText(command).then((ok) => {
+      if (!ok) return;
+      setCopied(true);
+      setTimeout(() => setCopied(false), 1600);
+    });
+  };
+  const view = state.view;
+  const status = state.status;
+  const target = view !== null && view.updateAvailable ? view.latestVersion ?? "" : "";
+  const busy = status === "checking" || status === "applying";
+  const settled = status === "restart-required" || status === "applied";
+  const actionable = view !== null && view.updateAvailable && view.canApply && !settled && !busy;
+  const manual = view !== null && (!view.canApply || view.checkFailed) ? view.manualCommand : null;
+  const statusLine = () => {
+    if (status === "checking" || view === null) return t("about.update.checking");
+    if (status === "applying") return t("about.update.applying", { version: target });
+    if (status === "restart-required") return t("about.update.done", { version: view.latestVersion ?? target });
+    if (status === "applied") return t("about.update.applied", { version: view.latestVersion ?? target });
+    if (status === "failed") {
+      if (state.error?.code === "CHECK_FAILED") return t("about.update.checkFailed");
+      return t("about.update.failed", { message: state.error?.message ?? "" });
+    }
+    if (view.checkFailed) return t("about.update.checkFailed");
+    if (view.updateAvailable) return t("about.update.available", { latest: view.latestVersion ?? "", current: view.currentVersion });
+    return t("about.update.current", { version: view.currentVersion });
+  };
+  const actions = [
+    h(Btn, { key: "check", small: true, disabled: busy, onClick: () => void controller.check({ fresh: true }) }, t("about.update.check")),
+    manual === null ? null : h(Btn, { key: "copy", small: true, onClick: copyCommand }, copied ? t("about.update.copied") : t("about.update.copy")),
+    actionable ? confirming ? [
+      h(
+        Btn,
+        {
+          key: "confirm",
+          small: true,
+          variant: "danger",
+          onClick: () => {
+            setConfirming(false);
+            void controller.apply();
+          }
+        },
+        t("about.update.confirmYes")
+      ),
+      h(Btn, { key: "cancel", small: true, onClick: () => setConfirming(false) }, t("about.update.cancel"))
+    ] : h(Btn, { key: "apply", small: true, variant: "primary", onClick: () => setConfirming(true) }, t("about.update.apply", { version: target })) : null
+  ].filter((item) => item !== null);
+  return h(
+    "div",
+    { className: `dshgt-update${props.bare === true ? " dshgt-update-bare" : ""}` },
+    props.bare === true ? null : h(
+      "div",
+      { className: "dshgt-update-head" },
+      h("h4", null, t("about.update.title")),
+      h("span", { className: "dshgt-hint" }, t("about.update.hint"))
+    ),
+    h("p", { className: `dshgt-update-line${status === "failed" ? " dshgt-update-err" : ""}` }, statusLine()),
+    confirming ? h("p", { className: "dshgt-update-warn" }, t("about.update.confirm", { version: target })) : null,
+    h("div", { className: "dshgt-update-actions" }, actions),
+    manual === null ? null : h(
+      "div",
+      { className: "dshgt-update-manual" },
+      h("p", { className: "dshgt-update-warn" }, t("about.update.manual", { kind: view?.installKind ?? "unknown" })),
+      h("code", { className: "dshgt-update-cmd" }, manual)
+    )
+  );
+}
+
 // client/digest-core.ts
 var DIGEST_WINDOW_DAYS = 30;
 var DATE_RE = /^(\d{4})-(\d{2})-(\d{2})$/;
@@ -2328,6 +2545,12 @@ function OverviewView(props) {
             )
           );
         })
+      ),
+      h(
+        "section",
+        { className: "dshgt-card dshgt-update-card" },
+        h("div", { className: "dshgt-card-h" }, h("h3", null, t("about.update.title"))),
+        h(PluginUpdateSection, { t, bare: true })
       )
     )
   );
@@ -3179,117 +3402,10 @@ function metaLine(rendered) {
   );
 }
 
-// node_modules/@morehao/dsh-plugin-kit/dist/update-client.js
-var IDLE = { status: "idle", view: null, error: null };
-function errorOf(error) {
-  if (error !== null && typeof error === "object") {
-    const value = error;
-    const message = typeof value.message === "string" && value.message !== "" ? value.message : "操作失败";
-    return typeof value.code === "string" ? { code: value.code, message } : { message };
-  }
-  return { message: String(error ?? "操作失败") };
-}
-function createUpdateController(options) {
-  const now = options.now ?? Date.now;
-  let state = { ...IDLE };
-  const listeners = /* @__PURE__ */ new Set();
-  let inFlight = null;
-  function emit(next) {
-    state = next;
-    options.onChange?.(state);
-    for (const listener of listeners) listener(state);
-  }
-  async function check(checkOptions = {}) {
-    if (inFlight !== null) return;
-    inFlight = "check";
-    emit({ ...state, status: "checking", error: null });
-    try {
-      const view = await options.request.check(checkOptions);
-      const checkedAt = new Date(now()).toISOString();
-      if (view.checkFailed) {
-        emit({
-          status: "failed",
-          view,
-          error: { code: "CHECK_FAILED", message: "检查更新失败：拿不到 registry 上的最新版本" },
-          checkedAt
-        });
-      } else {
-        emit({ status: view.updateAvailable ? "available" : "current", view, error: null, checkedAt });
-      }
-    } catch (error) {
-      emit({ ...state, status: "failed", error: errorOf(error) });
-    } finally {
-      inFlight = null;
-    }
-  }
-  async function apply2() {
-    if (inFlight !== null) return;
-    const view = state.view;
-    if (view === null || !view.updateAvailable) {
-      emit({ ...state, status: "failed", error: { code: "NO_UPDATE", message: "没有可更新的版本，请先检查更新" } });
-      return;
-    }
-    if (!view.canApply) {
-      emit({
-        ...state,
-        status: "failed",
-        error: { code: "NO_APPLY", message: `当前环境不支持一键更新，请执行：${view.manualCommand}` }
-      });
-      return;
-    }
-    inFlight = "apply";
-    emit({ ...state, status: "applying", error: null });
-    try {
-      const result = await options.request.apply();
-      const restartRequired = result.restartRequired ?? result.application !== "applied";
-      emit({ ...state, status: restartRequired ? "restart-required" : "applied", error: null });
-    } catch (error) {
-      emit({ ...state, status: "failed", error: errorOf(error) });
-    } finally {
-      inFlight = null;
-    }
-  }
-  return {
-    getState: () => state,
-    subscribe: (listener) => {
-      listeners.add(listener);
-      return () => {
-        listeners.delete(listener);
-      };
-    },
-    check,
-    apply: apply2,
-    reset: () => emit({ ...IDLE })
-  };
-}
-
 // client/about.ts
 function AboutDialog(props) {
   const { t, state } = props;
   const [copied, setCopied] = import_react.default.useState(false);
-  const [copiedCommand, setCopiedCommand] = import_react.default.useState(false);
-  const [confirming, setConfirming] = import_react.default.useState(false);
-  const controllerRef = import_react.default.useRef(null);
-  if (controllerRef.current === null) {
-    controllerRef.current = createUpdateController({
-      request: {
-        check: (options) => getPluginUpdate(options.fresh === true ? { fresh: true } : {}),
-        apply: () => applyPluginUpdate()
-      }
-    });
-  }
-  const controller = controllerRef.current;
-  const [updateState, setUpdateState] = import_react.default.useState(() => controller.getState());
-  import_react.default.useEffect(() => {
-    const unsubscribe = controller.subscribe(setUpdateState);
-    if (controller.getState().status === "idle") void controller.check();
-    return unsubscribe;
-  }, [controller]);
-  import_react.default.useEffect(() => {
-    if (updateState.status === "applying" || updateState.status === "restart-required" || updateState.status === "applied") {
-      setConfirming(false);
-    }
-  }, [updateState.status]);
   const plugin = state.plugin;
   const fullName = `${plugin.name}@v${plugin.version}`;
   const repository = plugin.repository;
@@ -3309,59 +3425,6 @@ function AboutDialog(props) {
       setTimeout(() => setCopied(false), 1600);
     });
   };
-  const copyCommand = () => {
-    const command = updateState.view?.manualCommand;
-    if (command === void 0) return;
-    void copyText(command).then((ok) => {
-      if (!ok) return;
-      setCopiedCommand(true);
-      setTimeout(() => setCopiedCommand(false), 1600);
-    });
-  };
-  const view = updateState.view;
-  const status = updateState.status;
-  const target = view !== null && view.updateAvailable ? view.latestVersion ?? "" : "";
-  const busy = status === "checking" || status === "applying";
-  const settled = status === "restart-required" || status === "applied";
-  const actionable = view !== null && view.updateAvailable && view.canApply && !settled && !busy;
-  const manual = view !== null && (!view.canApply || view.checkFailed) ? view.manualCommand : null;
-  const statusLine = () => {
-    if (status === "checking" || view === null) return t("about.update.checking");
-    if (status === "applying") return t("about.update.applying", { version: target });
-    if (status === "restart-required") return t("about.update.done", { version: view.latestVersion ?? target });
-    if (status === "applied") return t("about.update.applied", { version: view.latestVersion ?? target });
-    if (status === "failed") {
-      if (updateState.error?.code === "CHECK_FAILED") return t("about.update.checkFailed");
-      return t("about.update.failed", { message: updateState.error?.message ?? "" });
-    }
-    if (view.checkFailed) return t("about.update.checkFailed");
-    if (view.updateAvailable) return t("about.update.available", { latest: view.latestVersion ?? "", current: view.currentVersion });
-    return t("about.update.current", { version: view.currentVersion });
-  };
-  const updateActions = [
-    h(Btn, { key: "check", small: true, disabled: busy, onClick: () => void controller.check({ fresh: true }) }, t("about.update.check")),
-    manual === null ? null : h(
-      Btn,
-      { key: "copy-command", small: true, onClick: copyCommand },
-      copiedCommand ? t("about.update.copied") : t("about.update.copy")
-    ),
-    actionable ? confirming ? [
-      h(
-        Btn,
-        {
-          key: "confirm",
-          small: true,
-          variant: "danger",
-          onClick: () => {
-            setConfirming(false);
-            void controller.apply();
-          }
-        },
-        t("about.update.confirmYes")
-      ),
-      h(Btn, { key: "cancel", small: true, onClick: () => setConfirming(false) }, t("about.update.cancel"))
-    ] : h(Btn, { key: "apply", small: true, variant: "primary", onClick: () => setConfirming(true) }, t("about.update.apply", { version: target })) : null
-  ].filter((item) => item !== null);
   const dialog = h(
     "div",
     { className: "dshgt-modal-mask", onClick: (event) => {
@@ -3393,25 +3456,7 @@ function AboutDialog(props) {
           [t("about.env"), t("about.env.value")]
         ]
       }),
-      h(
-        "div",
-        { className: "dshgt-update" },
-        h(
-          "div",
-          { className: "dshgt-update-head" },
-          h("h4", null, t("about.update.title")),
-          h("span", { className: "dshgt-hint" }, t("about.update.hint"))
-        ),
-        h("p", { className: `dshgt-update-line${status === "failed" ? " dshgt-update-err" : ""}` }, statusLine()),
-        confirming ? h("p", { className: "dshgt-update-warn" }, t("about.update.confirm", { version: target })) : null,
-        h("div", { className: "dshgt-update-actions" }, updateActions),
-        manual === null ? null : h(
-          "div",
-          { className: "dshgt-update-manual" },
-          h("p", { className: "dshgt-update-warn" }, t("about.update.manual", { kind: view?.installKind ?? "unknown" })),
-          h("code", { className: "dshgt-update-cmd" }, manual)
-        )
-      )
+      h(PluginUpdateSection, { t })
     )
   );
   return h("div", { className: "dshgt-root" }, dialog);
@@ -3659,7 +3704,8 @@ function apply(ctx) {
                 onClick: () => setAboutOpen(true),
                 title: plugin === void 0 ? "" : fullName
               },
-              plugin?.name ?? t("section.title")
+              plugin?.name ?? t("section.title"),
+              h(UpdateDot, { t })
             ),
             h(
               "div",

package/lib/{chunk-NMINPPWO.js → chunk-QXAKMNHQ.js}

@@ -9,9 +9,11 @@ var config_exports = {};
 __export(config_exports, {
   CORE_PROVIDERS: () => CORE_PROVIDERS,
   DEFAULT_SETTINGS: () => DEFAULT_SETTINGS,
+  PERIODS: () => PERIODS,
   PROVIDER_BASE_URLS: () => PROVIDER_BASE_URLS,
   SETTINGS_SECTIONS: () => SETTINGS_SECTIONS,
   effectiveBaseURL: () => effectiveBaseURL,
+  isPeriod: () => isPeriod,
   isValidTimezone: () => isValidTimezone,
   mergeSettingsSection: () => mergeSettingsSection,
   normalizeSettings: () => normalizeSettings,
@@ -21,6 +23,10 @@ __export(config_exports, {
   validateSettings: () => validateSettings
 });
 import path from "path";
+var PERIODS = ["daily", "weekly", "monthly"];
+function isPeriod(value) {
+  return value === "daily" || value === "weekly" || value === "monthly";
+}
 var DEFAULT_SETTINGS = {
   model: {
     provider: "deepseek",
@@ -50,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" },
+  schedule: { enabled: true, time: "08:30:00", timezone: "Asia/Shanghai", periods: ["daily"] },
   corePath: "",
   coreAutoDownload: true
 };
@@ -111,6 +117,11 @@ 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 normalizeSettings(input) {
   const raw = typeof input === "object" && input !== null ? input : {};
   const model = raw.model ?? {};
@@ -155,7 +166,7 @@ function normalizeSettings(input) {
       tokenRef: str(github.tokenRef, DEFAULT_SETTINGS.github.tokenRef).trim() || DEFAULT_SETTINGS.github.tokenRef
     },
     trending: {
-      since: since === "weekly" ? "weekly" : "daily",
+      since: isPeriod(since) ? since : "daily",
       languages: strArray(trending.languages, DEFAULT_SETTINGS.trending.languages),
       topN: Math.round(num(trending.topN, DEFAULT_SETTINGS.trending.topN))
     },
@@ -165,7 +176,8 @@ function normalizeSettings(input) {
     schedule: {
       enabled: bool(schedule.enabled, DEFAULT_SETTINGS.schedule.enabled),
       time: str(schedule.time, DEFAULT_SETTINGS.schedule.time),
-      timezone: str(schedule.timezone, DEFAULT_SETTINGS.schedule.timezone)
+      timezone: str(schedule.timezone, DEFAULT_SETTINGS.schedule.timezone),
+      periods: periodList(schedule.periods, DEFAULT_SETTINGS.schedule.periods)
     },
     corePath: str(raw.corePath, DEFAULT_SETTINGS.corePath).trim(),
     coreAutoDownload: bool(raw.coreAutoDownload, DEFAULT_SETTINGS.coreAutoDownload)
@@ -231,12 +243,15 @@ 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) {
   return model.baseURL !== "" ? model.baseURL : PROVIDER_BASE_URLS[model.provider] ?? "";
 }
-function toCoreConfig(settings, apiKey, baseURLOverride) {
+function toCoreConfig(settings, apiKey, baseURLOverride, period) {
   const config = {
     model: {
       provider: settings.model.provider,
@@ -262,7 +277,7 @@ function toCoreConfig(settings, apiKey, baseURLOverride) {
     },
     trending: {
       languages: settings.trending.languages,
-      since: settings.trending.since,
+      since: period ?? settings.trending.since,
       perLanguage: settings.trending.topN
     },
     output: {
@@ -1339,6 +1354,7 @@ function buildCoreArgs(channelPath, options) {
   const args = ["run", "--config", channelPath, "--json"];
   if (options.dryRun) args.push("--dry-run");
   if (options.date !== void 0 && options.date !== "") args.push("--date", options.date);
+  if (options.period !== void 0) args.push("--period", options.period);
   return args;
 }
 async function runCore(options) {
@@ -1346,10 +1362,10 @@ async function runCore(options) {
   const startedAt = nowIso();
   const started = Date.now();
   const channel = await openConfigChannel();
-  const yaml = `${toYaml(toCoreConfig(options.settings, options.apiKey, options.baseURLOverride))}
+  const yaml = `${toYaml(toCoreConfig(options.settings, options.apiKey, options.baseURLOverride, options.period))}
 `;
   const secrets = [options.apiKey, options.token, ...options.secrets ?? []];
-  const child = spawn2(options.core.path, buildCoreArgs(channel.path, { dryRun: options.dryRun, date: options.date }), {
+  const child = spawn2(options.core.path, buildCoreArgs(channel.path, { dryRun: options.dryRun, date: options.date, period: options.period }), {
     env: sanitizedEnv(process.env, {
       GITHUB_TOKEN: options.token,
       GH_TOKEN: options.token,
@@ -1985,8 +2001,11 @@ function authorized(request, token) {
 var schedule_exports = {};
 __export(schedule_exports, {
   Scheduler: () => Scheduler,
+  daysInMonth: () => daysInMonth,
   isDue: () => isDue,
+  isPeriodTriggerDay: () => isPeriodTriggerDay,
   nextOccurrence: () => nextOccurrence,
+  nextOccurrenceFor: () => nextOccurrenceFor,
   parseClock: () => parseClock,
   zonedDateString: () => zonedDateString,
   zonedTimeToUtc: () => zonedTimeToUtc
@@ -2066,6 +2085,35 @@ function isDue(now, schedule) {
   const late = nowMinutes - targetMinutes;
   return late >= 0 && late <= CATCH_UP_MINUTES;
 }
+function daysInMonth(year, month) {
+  return new Date(Date.UTC(year, month, 0)).getUTCDate();
+}
+function isPeriodTriggerDate(period, year, month, day) {
+  if (period === "weekly") {
+    return new Date(Date.UTC(year, month - 1, day)).getUTCDay() === 0;
+  }
+  if (period === "monthly") return day === daysInMonth(year, month);
+  return true;
+}
+function isPeriodTriggerDay(period, now, timezone) {
+  const parts = partsOf(now, timezone);
+  return isPeriodTriggerDate(period, parts.year, parts.month, parts.day);
+}
+function nextOccurrenceFor(period, now, schedule) {
+  const { hour, minute, second } = parseClock(schedule.time);
+  const today = partsOf(now, schedule.timezone);
+  const start = Date.UTC(today.year, today.month - 1, today.day);
+  for (let i = 0; i < 400; i += 1) {
+    const d = new Date(start + i * 864e5);
+    const year = d.getUTCFullYear();
+    const month = d.getUTCMonth() + 1;
+    const day = d.getUTCDate();
+    if (!isPeriodTriggerDate(period, year, month, day)) continue;
+    const candidate = zonedTimeToUtc(year, month, day, hour, minute, second, schedule.timezone);
+    if (candidate.getTime() > now.getTime()) return candidate;
+  }
+  return nextOccurrence(now, schedule);
+}
 var Scheduler = class {
   deps;
   timerHandle;
@@ -2104,41 +2152,63 @@ var Scheduler = class {
     if (!schedule.enabled) return "disabled";
     if (!isDue(now, schedule)) return "skipped";
     const today = zonedDateString(now, schedule.timezone);
-    const state = this.deps.store.readState();
-    const lastSuccess = state.lastSuccessAt === void 0 ? void 0 : zonedDateString(new Date(state.lastSuccessAt), schedule.timezone);
-    if (lastSuccess === today) return "skipped";
-    const attempt = this.attempts.get(today);
-    if (attempt !== void 0) {
-      if (attempt.count >= MAX_ATTEMPTS_PER_DAY) return "skipped";
-      if (now.getTime() - attempt.lastAt < RETRY_GAP_MS) return "skipped";
-    }
-    if (this.deps.isRunning()) return "busy";
     for (const key of this.attempts.keys()) {
-      if (key !== today) this.attempts.delete(key);
+      if (!key.endsWith(`:${today}`)) this.attempts.delete(key);
+    }
+    const periods = schedule.periods.length > 0 ? schedule.periods : ["daily"];
+    let ran = false;
+    for (const period of periods) {
+      if (!isPeriodTriggerDay(period, now, schedule.timezone)) continue;
+      const state = this.deps.store.readState();
+      if (this.succeededToday(state, period, today, schedule.timezone)) continue;
+      const key = `${period}:${today}`;
+      const attempt = this.attempts.get(key);
+      if (attempt !== void 0) {
+        if (attempt.count >= MAX_ATTEMPTS_PER_DAY) continue;
+        if (now.getTime() - attempt.lastAt < RETRY_GAP_MS) continue;
+      }
+      if (this.deps.isRunning()) return "busy";
+      this.attempts.set(key, { count: (attempt?.count ?? 0) + 1, lastAt: now.getTime() });
+      try {
+        await this.deps.run("schedule", period);
+        ran = true;
+      } catch (error) {
+        this.deps.onError?.(error);
+      }
     }
-    this.attempts.set(today, { count: (attempt?.count ?? 0) + 1, lastAt: now.getTime() });
-    try {
-      await this.deps.run("schedule");
-      return "ran";
-    } catch (error) {
-      this.deps.onError?.(error);
-      return "skipped";
+    return ran ? "ran" : "skipped";
+  }
+  /** 该周期今天是否已经成功过（含无变更跳过）。 */
+  succeededToday(state, period, today, timezone) {
+    const stamp = state.periodSuccess?.[period];
+    if (stamp !== void 0 && zonedDateString(new Date(stamp), timezone) === today) return true;
+    if (period === "daily" && state.lastSuccessAt !== void 0 && zonedDateString(new Date(state.lastSuccessAt), timezone) === today) {
+      return true;
     }
+    return false;
   }
   readSchedule() {
     const settings = this.deps.store.readSettings();
     return {
       enabled: settings.schedule.enabled,
       time: settings.schedule.time,
-      timezone: settings.schedule.timezone
+      timezone: settings.schedule.timezone,
+      periods: settings.schedule.periods
     };
   }
-  /** 下一次运行（禁用时为 undefined）。 */
+  /** 下一次运行（取所有已启用周期里最近的一次；禁用时为 undefined）。 */
   next() {
     const schedule = this.readSchedule();
     if (!schedule.enabled) return void 0;
+    const periods = schedule.periods.length > 0 ? schedule.periods : ["daily"];
     try {
-      return nextOccurrence(/* @__PURE__ */ new Date(), schedule);
+      const now = /* @__PURE__ */ new Date();
+      let earliest;
+      for (const period of periods) {
+        const occurrence = nextOccurrenceFor(period, now, schedule);
+        if (earliest === void 0 || occurrence.getTime() < earliest.getTime()) earliest = occurrence;
+      }
+      return earliest;
     } catch {
       return void 0;
     }
@@ -2150,6 +2220,7 @@ var Scheduler = class {
       enabled: schedule.enabled,
       time: schedule.time,
       timezone: schedule.timezone,
+      periods: schedule.periods,
       ...next === void 0 ? {} : { nextRunAt: next.toISOString() },
       ...state.lastRunAt === void 0 ? {} : { lastRunDate: zonedDateString(new Date(state.lastRunAt), schedule.timezone) },
       catchUpMinutes: CATCH_UP_MINUTES,
@@ -2161,7 +2232,9 @@ var Scheduler = class {
 // src/host/runner.ts
 var runner_exports = {};
 __export(runner_exports, {
-  Runner: () => Runner
+  Runner: () => Runner,
+  isoWeekName: () => isoWeekName,
+  periodFileBase: () => periodFileBase
 });
 import { createHash as createHash2 } from "crypto";
 import { existsSync as existsSync4, readFileSync as readFileSync3, realpathSync, statSync as statSync5 } from "fs";
@@ -2195,6 +2268,25 @@ function normalizeSha256(value) {
   const hex = value.trim().replace(/^sha256:/i, "").toLowerCase();
   return /^[0-9a-f]{64}$/.test(hex) ? hex : void 0;
 }
+function isoWeekName(date) {
+  const match = /^(\d{4})-(\d{2})-(\d{2})$/.exec(date);
+  if (match === null) return date;
+  const d = new Date(Date.UTC(Number(match[1]), Number(match[2]) - 1, Number(match[3])));
+  if (Number.isNaN(d.getTime())) return date;
+  const dayIdx = (d.getUTCDay() + 6) % 7;
+  d.setUTCDate(d.getUTCDate() - dayIdx + 3);
+  const isoYear = d.getUTCFullYear();
+  const firstThursday = new Date(Date.UTC(isoYear, 0, 4));
+  const firstIdx = (firstThursday.getUTCDay() + 6) % 7;
+  firstThursday.setUTCDate(firstThursday.getUTCDate() - firstIdx + 3);
+  const week = 1 + Math.round((d.getTime() - firstThursday.getTime()) / (7 * 864e5));
+  return `${isoYear}-W${String(week).padStart(2, "0")}`;
+}
+function periodFileBase(period, date) {
+  if (period === "monthly") return date.slice(0, 7);
+  if (period === "weekly") return isoWeekName(date);
+  return date;
+}
 var Runner = class {
   active;
   deps;
@@ -2226,6 +2318,7 @@ var Runner = class {
     if (repoIssue !== void 0) throw new IpcError(repoIssue.code, repoIssue.message);
     const dryRun = options.dryRun === true;
     const date = options.date !== void 0 && options.date !== "" ? options.date : runDate(settings);
+    const period = options.period ?? settings.trending.since;
     const id = newRunId();
     const controller = new AbortController();
     const startedAt = (/* @__PURE__ */ new Date()).toISOString();
@@ -2282,6 +2375,7 @@ var Runner = class {
         apiKey,
         ...github.token === void 0 ? {} : { token: github.token },
         date,
+        period,
         dryRun,
         trigger: options.trigger === "schedule" ? "schedule" : "manual",
         ...baseURLOverride === void 0 ? {} : { baseURLOverride },
@@ -2295,6 +2389,7 @@ var Runner = class {
         outcome,
         dryRun,
         date,
+        period,
         logFile,
         channel: result.channelKind,
         proxy: proxy !== void 0,
@@ -2304,6 +2399,7 @@ var Runner = class {
       const preview = this.capturePreview({
         id,
         date,
+        period,
         settings,
         outcome,
         secrets: [apiKey, github.token]
@@ -2318,6 +2414,7 @@ var Runner = class {
         error: cancelled && !(error instanceof IpcError && error.code === "CORE_CANCELLED") ? new IpcError("CORE_CANCELLED", "\u8FD0\u884C\u5DF2\u53D6\u6D88\uFF1A\u6838\u5FC3\u8FDB\u7A0B\u5DF2\u7EC8\u6B62\uFF0C\u672A\u63D0\u4EA4\u4EFB\u4F55\u72B6\u6001") : error,
         dryRun,
         date,
+        period,
         logFile,
         durationMs: Date.now() - startedMs
       });
@@ -2353,6 +2450,7 @@ var Runner = class {
       skipped: outcome.skipped,
       dryRun: input.dryRun,
       ...input.date === void 0 ? {} : { date: input.date },
+      ...input.period === void 0 ? {} : { period: input.period },
       durationMs: outcome.durationMs,
       coreVersion: outcome.coreVersion,
       files: outcome.files.length,
@@ -2379,6 +2477,7 @@ var Runner = class {
       skipped: false,
       dryRun: input.dryRun,
       ...input.date === void 0 ? {} : { date: input.date },
+      ...input.period === void 0 ? {} : { period: input.period },
       durationMs: input.durationMs ?? 0,
       coreVersion: "",
       files: 0,
@@ -2396,7 +2495,7 @@ var Runner = class {
    * - 任何一步失败都只记日志，返回 undefined；运行结果不受影响。
    */
   capturePreview(input) {
-    const { outcome, settings, date, id } = input;
+    const { outcome, settings, date, period, id } = input;
     if (!outcome.ok || outcome.dryRun || outcome.skipped || date === void 0) return void 0;
     const skip = (reason, extra = {}) => {
       this.deps.logger?.("preview.skip", { id, reason, ...extra });
@@ -2404,12 +2503,14 @@ var Runner = class {
     };
     const markdown = outcome.files.filter((file) => {
       const ext = path8.extname(file.path).toLowerCase();
-      return ext === ".md" && path8.basename(file.path).toLowerCase() !== "readme.md";
+      const base = path8.basename(file.path).toLowerCase();
+      return ext === ".md" && base !== "readme.md" && base !== "index.md";
     });
     if (markdown.length === 0) return skip("no-markdown");
-    const dated = markdown.filter((file) => path8.basename(file.path) === `${date}.md`);
-    const chosen = dated.length > 0 ? dated[0] : markdown.length === 1 ? markdown[0] : void 0;
-    if (chosen === void 0) return skip("ambiguous", { candidates: markdown.length });
+    const expected = period === void 0 ? `${date}.md` : `${periodFileBase(period, date)}.md`;
+    const named = markdown.filter((file) => path8.basename(file.path) === expected);
+    const chosen = named.length > 0 ? named[0] : markdown.length === 1 ? markdown[0] : void 0;
+    if (chosen === void 0) return skip("ambiguous", { candidates: markdown.length, expected, period: period ?? null });
     const repoPath = settings.repo.path;
     const resolved = path8.resolve(repoPath, chosen.path);
     if (!isInside(repoPath, resolved)) return skip("outside-repo", { path: chosen.path });
@@ -2467,6 +2568,7 @@ var Runner = class {
       durationMs: summary.durationMs,
       files: summary.files,
       ...summary.date === void 0 ? {} : { date: summary.date },
+      ...summary.period === void 0 ? {} : { period: summary.period },
       ...summary.contentHash === void 0 ? {} : { contentHash: summary.contentHash },
       ...summary.branch === void 0 ? {} : { branch: summary.branch },
       ...summary.commit === void 0 ? {} : { commit: summary.commit },
@@ -2479,9 +2581,12 @@ var Runner = class {
       logFile: summary.logFile
     };
     const state = store.readState();
+    const periodSuccess = { ...state.periodSuccess ?? {} };
+    if (summary.ok && summary.period !== void 0) periodSuccess[summary.period] = record.at;
     const next = {
       lastRunAt: record.at,
       ...summary.ok ? { lastSuccessAt: record.at } : {},
+      ...summary.ok && summary.period !== void 0 ? { periodSuccess } : {},
       ...summary.ok && summary.prUrl !== void 0 ? { pendingPr: { url: summary.prUrl, createdAt: record.at, ...summary.date === void 0 ? {} : { date: summary.date } } } : {},
       ...summary.ok && !summary.skipped && summary.contentHash !== void 0 ? {
         lastDigest: {
@@ -3224,6 +3329,7 @@ async function dispatch(method, pathname, url, request, deps) {
     const summary = await deps.runner.run({
       dryRun: body.dryRun === true,
       ...typeof body.date === "string" && body.date !== "" ? { date: body.date } : {},
+      ...isPeriod(body.period) ? { period: body.period } : {},
       trigger: "manual"
     });
     return { summary };
@@ -3496,10 +3602,11 @@ function describeRecord(record) {
 function createTrendingRunTool(runner) {
   return {
     name: "trending_run",
-    description: "\u6267\u884C\u4E00\u6B21 GitHub \u8D8B\u52BF\u65E5\u62A5\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\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",
     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" }
+      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" }
     },
     output: {
       schema: RUN_OUTPUT_SCHEMA,
@@ -3510,6 +3617,7 @@ function createTrendingRunTool(runner) {
       const summary = await runner.run({
         dryRun: args.dryRun === true,
         ...typeof args.date === "string" && args.date !== "" ? { date: args.date } : {},
+        ...isPeriod(args.period) ? { period: args.period } : {},
         trigger: "tool"
       });
       const lines = [];

package/lib/index.js

@@ -8,7 +8,7 @@ import {
   createTrendingRunTool,
   createUpdateService,
   readPluginInfo
-} from "./chunk-NMINPPWO.js";
+} from "./chunk-QXAKMNHQ.js";
 import "./chunk-XLIFTAVL.js";
 
 // src/index.ts
@@ -53,9 +53,9 @@ function apply(ctx, config = {}) {
     store,
     isRunning: () => runner.running !== void 0,
     getTimer: () => get("timer"),
-    run: async () => {
-      const summary = await runner.run({ trigger: "schedule" });
-      log("schedule.run", { ok: summary.ok, skipped: summary.skipped, error: summary.error?.code });
+    run: async (_trigger, period) => {
+      const summary = await runner.run({ trigger: "schedule", period });
+      log("schedule.run", { period, ok: summary.ok, skipped: summary.skipped, error: summary.error?.code });
     },
     onError: (error) => ctx.logger?.warn?.(`[dsh-github-trending] \u5B9A\u65F6\u8FD0\u884C\u5931\u8D25\uFF1A${error instanceof Error ? error.message : String(error)}`)
   });

package/lib/internal.d.ts

@@ -164,7 +164,16 @@ type Provider = string;
 type CommitMode = 'branch' | 'direct';
 /** 只保留两种真正可用的方式：本机 `gh` 登录态、手动 PAT。历史的 `device` 在归一化时迁移为 `gh`。 */
 type AuthMode = 'pat' | 'gh';
-type Since = 'daily' | 'weekly';
+/**
+ * 榜单周期（core 0.4.0 的 `--period` 三取值）。
+ * `trending.since` 复用同一枚举：单次运行「抓取窗口 = 标注周期」由核心保证
+ * （`run --period` 会覆盖 `config.trending.since`）。
+ */
+type Period = 'daily' | 'weekly' | 'monthly';
+type Since = Period;
+/** 规范顺序（索引分组、去重、UI 展示都以它为准）。 */
+declare const PERIODS: readonly Period[];
+declare function isPeriod(value: unknown): value is Period;
 interface ModelSettings {
     provider: Provider;
     /** `direct` = 密钥经配置通道直传核心；`proxy` = 宿主 provider 无可导出密钥，走回环代理。 */
@@ -210,6 +219,11 @@ interface ScheduleSettings {
     /** `HH:MM:SS`（本地墙钟，按 timezone 解释）。 */
     time: string;
     timezone: string;
+    /**
+     * 定时自动产出的周期（插件侧调度概念，核心无此字段）。
+     * 每个周期按自己的节奏触发：日=每天、周=周日、月=月末。
+     */
+    periods: Period[];
 }
 interface Settings {
     model: ModelSettings;
@@ -293,9 +307,10 @@ interface CoreConfig {
 }
 /**
  * 生成核心配置。`apiKey` 单独传入：它只能来自宿主凭据或用户当次输入，
- * 绝不来自 settings.json。
+ * 绝不来自 settings.json。`period` 是本次运行的标的周期；核心 `run --period`
+ * 会用它覆盖 `trending.since`，这里同步写入以免旧核心/调试时口径不一致。
  */
-declare function toCoreConfig(settings: Settings, apiKey: string, baseURLOverride?: string): CoreConfig;
+declare function toCoreConfig(settings: Settings, apiKey: string, baseURLOverride?: string, period?: Period): CoreConfig;
 /**
  * 极简 YAML 序列化：只覆盖「对象/数组/字符串/数字/布尔」。
  * 字符串一律用 JSON 双引号形式——JSON 字符串是合法 YAML 标量，且能避免
@@ -311,8 +326,10 @@ declare const config_DEFAULT_SETTINGS: typeof DEFAULT_SETTINGS;
 type config_GithubSettings = GithubSettings;
 type config_ModelSettings = ModelSettings;
 type config_OutputSettings = OutputSettings;
+declare const config_PERIODS: typeof PERIODS;
 declare const config_PROVIDER_BASE_URLS: typeof PROVIDER_BASE_URLS;
 type config_PRSettings = PRSettings;
+type config_Period = Period;
 type config_Problem = Problem;
 type config_Provider = Provider;
 type config_RepoSettings = RepoSettings;
@@ -323,6 +340,7 @@ type config_SettingsSection = SettingsSection;
 type config_Since = Since;
 type config_TrendingSettings = TrendingSettings;
 declare const config_effectiveBaseURL: typeof effectiveBaseURL;
+declare const config_isPeriod: typeof isPeriod;
 declare const config_isValidTimezone: typeof isValidTimezone;
 declare const config_mergeSettingsSection: typeof mergeSettingsSection;
 declare const config_normalizeSettings: typeof normalizeSettings;
@@ -331,7 +349,7 @@ declare const config_toCoreConfig: typeof toCoreConfig;
 declare const config_toYaml: typeof toYaml;
 declare const config_validateSettings: typeof validateSettings;
 declare namespace config {
-  export { type config_AuthMode as AuthMode, config_CORE_PROVIDERS as CORE_PROVIDERS, type config_CommitMode as CommitMode, type config_CoreConfig as CoreConfig, config_DEFAULT_SETTINGS as DEFAULT_SETTINGS, type config_GithubSettings as GithubSettings, type config_ModelSettings as ModelSettings, type config_OutputSettings as OutputSettings, config_PROVIDER_BASE_URLS as PROVIDER_BASE_URLS, type config_PRSettings as PRSettings, type config_Problem as Problem, type config_Provider as Provider, type config_RepoSettings as RepoSettings, config_SETTINGS_SECTIONS as SETTINGS_SECTIONS, type config_ScheduleSettings as ScheduleSettings, type config_Settings as Settings, type config_SettingsSection as SettingsSection, type config_Since as Since, type config_TrendingSettings as TrendingSettings, config_effectiveBaseURL as effectiveBaseURL, config_isValidTimezone as isValidTimezone, config_mergeSettingsSection as mergeSettingsSection, config_normalizeSettings as normalizeSettings, config_sectionOfField as sectionOfField, config_toCoreConfig as toCoreConfig, config_toYaml as toYaml, config_validateSettings as validateSettings };
+  export { type config_AuthMode as AuthMode, config_CORE_PROVIDERS as CORE_PROVIDERS, type config_CommitMode as CommitMode, type config_CoreConfig as CoreConfig, config_DEFAULT_SETTINGS as DEFAULT_SETTINGS, type config_GithubSettings as GithubSettings, type config_ModelSettings as ModelSettings, type config_OutputSettings as OutputSettings, config_PERIODS as PERIODS, config_PROVIDER_BASE_URLS as PROVIDER_BASE_URLS, type config_PRSettings as PRSettings, type config_Period as Period, type config_Problem as Problem, type config_Provider as Provider, type config_RepoSettings as RepoSettings, config_SETTINGS_SECTIONS as SETTINGS_SECTIONS, type config_ScheduleSettings as ScheduleSettings, type config_Settings as Settings, type config_SettingsSection as SettingsSection, type config_Since as Since, type config_TrendingSettings as TrendingSettings, config_effectiveBaseURL as effectiveBaseURL, config_isPeriod as isPeriod, config_isValidTimezone as isValidTimezone, config_mergeSettingsSection as mergeSettingsSection, config_normalizeSettings as normalizeSettings, config_sectionOfField as sectionOfField, config_toCoreConfig as toCoreConfig, config_toYaml as toYaml, config_validateSettings as validateSettings };
 }
 
 declare const PLUGIN_DIR_NAME = "github-trending";
@@ -397,6 +415,8 @@ interface RunRecord {
     files: number;
     /** 运行所属的调度时区日期（YYYY-MM-DD）；旧记录可能没有。 */
     date?: string;
+    /** 本次产出周期（daily|weekly|monthly）；旧记录可能没有。 */
+    period?: Period;
     contentHash?: string;
     branch?: string;
     commit?: string;
@@ -421,8 +441,10 @@ interface PendingPr {
 }
 interface PluginState {
     lastRunAt?: string;
-    /** 最近一次成功（ok=true，含 skipped）的运行时间；调度用它锁当天。 */
+    /** 最近一次成功（ok=true，含 skipped）的运行时间；工具与界面读它。 */
     lastSuccessAt?: string;
+    /** 各周期最近一次成功的 ISO 时间；调度按「周期 + 本地日期」判重。 */
+    periodSuccess?: Partial<Record<Period, string>>;
     lastDigest?: DigestIdentity;
     lastResult?: RunRecord;
     pendingPr?: PendingPr;
@@ -729,6 +751,8 @@ interface RunCoreOptions {
     /** GitHub token；核心只从 env 读（GITHUB_TOKEN/GH_TOKEN）。 */
     token?: string;
     date?: string;
+    /** 本次运行的标的周期（daily|weekly|monthly）；核心 `--period` 覆盖抓取 since。 */
+    period: Period;
     dryRun: boolean;
     /** 谁触发的运行：核心用它在定时运行时尊重「人工关闭的 PR」。 */
     trigger?: 'manual' | 'schedule';
@@ -749,6 +773,7 @@ interface RunCoreResult {
 declare function buildCoreArgs(channelPath: string, options: {
     dryRun: boolean;
     date?: string;
+    period?: Period;
 }): string[];
 declare function runCore(options: RunCoreOptions): Promise<RunCoreResult>;
 
@@ -1187,6 +1212,8 @@ interface RunSummary {
     skipped: boolean;
     dryRun: boolean;
     date?: string;
+    /** 本次产出周期（daily|weekly|monthly）。 */
+    period?: Period;
     durationMs: number;
     coreVersion: string;
     files: number;
@@ -1218,6 +1245,8 @@ interface RunSummary {
 interface RunRequestOptions {
     dryRun?: boolean;
     date?: string;
+    /** 标的周期；缺省取 settings.trending.since（手动/工具运行）。 */
+    period?: Period;
     trigger: 'manual' | 'schedule' | 'tool';
 }
 interface RunnerDeps {
@@ -1229,6 +1258,13 @@ interface RunnerDeps {
     /** 预览副本这类「可失败但不阻断运行」的事件走这里，不写进 warnings。 */
     logger?: (event: string, data?: Record<string, unknown>) => void;
 }
+/**
+ * 与 core `render.NameOf` 对齐的产物基名（不含扩展名）：
+ *   daily → YYYY-MM-DD；weekly → YYYY-Wnn（ISO 周年/周）；monthly → YYYY-MM。
+ * 用于在 outcome.files 里按周期精确挑出本期 digest 的 `.md`（而不是猜）。
+ */
+declare function isoWeekName(date: string): string;
+declare function periodFileBase(period: Period, date: string): string;
 declare class Runner {
     private active;
     private readonly deps;
@@ -1261,8 +1297,10 @@ type runner_RunSummary = RunSummary;
 type runner_Runner = Runner;
 declare const runner_Runner: typeof Runner;
 type runner_RunnerDeps = RunnerDeps;
+declare const runner_isoWeekName: typeof isoWeekName;
+declare const runner_periodFileBase: typeof periodFileBase;
 declare namespace runner {
-  export { type runner_RunRequestOptions as RunRequestOptions, type runner_RunSummary as RunSummary, runner_Runner as Runner, type runner_RunnerDeps as RunnerDeps };
+  export { type runner_RunRequestOptions as RunRequestOptions, type runner_RunSummary as RunSummary, runner_Runner as Runner, type runner_RunnerDeps as RunnerDeps, runner_isoWeekName as isoWeekName, runner_periodFileBase as periodFileBase };
 }
 
 interface PluginInfo {
@@ -1296,6 +1334,8 @@ interface ScheduleConfig {
     enabled: boolean;
     time: string;
     timezone: string;
+    /** 自动产出的周期；每个周期只在「它自己的触发日」跑（日=每天、周=周日、月=月末）。 */
+    periods: Period[];
 }
 /** 目标时区的墙上时间 → UTC 时刻（按 DST 修正一次，够用且可测）。 */
 declare function zonedTimeToUtc(year: number, month: number, day: number, hour: number, minute: number, second: number, timezone: string): Date;
@@ -1310,9 +1350,14 @@ declare function zonedDateString(date: Date, timezone: string): string;
 declare function nextOccurrence(now: Date, schedule: ScheduleConfig): Date;
 /** 今天这一次是否已过点且在补跑窗口内。 */
 declare function isDue(now: Date, schedule: ScheduleConfig): boolean;
+declare function daysInMonth(year: number, month: number): number;
+/** 该时刻是否落在某个周期的结算日（按 timezone 的本地日历）。 */
+declare function isPeriodTriggerDay(period: Period, now: Date, timezone: string): boolean;
+/** 某周期下一次触发时刻（触发日的墙钟 time，严格晚于 now）。 */
+declare function nextOccurrenceFor(period: Period, now: Date, schedule: ScheduleConfig): Date;
 interface SchedulerDeps {
     store: Store;
-    run: (trigger: 'schedule') => Promise<unknown>;
+    run: (trigger: 'schedule', period: Period) => Promise<unknown>;
     isRunning: () => boolean;
     getTimer: () => {
         interval?: (fn: () => void, ms: number) => unknown;
@@ -1331,13 +1376,16 @@ declare class Scheduler {
     stop(): void;
     /** 公开给测试：判断此刻是否该跑，并按需触发一次。 */
     tick(now?: Date): Promise<'skipped' | 'ran' | 'disabled' | 'busy'>;
+    /** 该周期今天是否已经成功过（含无变更跳过）。 */
+    private succeededToday;
     private readSchedule;
-    /** 下一次运行（禁用时为 undefined）。 */
+    /** 下一次运行（取所有已启用周期里最近的一次；禁用时为 undefined）。 */
     next(): Date | undefined;
     describe(state: PluginState, now?: Date): {
         enabled: boolean;
         time: string;
         timezone: string;
+        periods: Period[];
         nextRunAt?: string;
         lastRunDate?: string;
         catchUpMinutes: number;
@@ -1349,13 +1397,16 @@ type schedule_ScheduleConfig = ScheduleConfig;
 type schedule_Scheduler = Scheduler;
 declare const schedule_Scheduler: typeof Scheduler;
 type schedule_SchedulerDeps = SchedulerDeps;
+declare const schedule_daysInMonth: typeof daysInMonth;
 declare const schedule_isDue: typeof isDue;
+declare const schedule_isPeriodTriggerDay: typeof isPeriodTriggerDay;
 declare const schedule_nextOccurrence: typeof nextOccurrence;
+declare const schedule_nextOccurrenceFor: typeof nextOccurrenceFor;
 declare const schedule_parseClock: typeof parseClock;
 declare const schedule_zonedDateString: typeof zonedDateString;
 declare const schedule_zonedTimeToUtc: typeof zonedTimeToUtc;
 declare namespace schedule {
-  export { type schedule_ScheduleConfig as ScheduleConfig, schedule_Scheduler as Scheduler, type schedule_SchedulerDeps as SchedulerDeps, schedule_isDue as isDue, schedule_nextOccurrence as nextOccurrence, schedule_parseClock as parseClock, schedule_zonedDateString as zonedDateString, schedule_zonedTimeToUtc as zonedTimeToUtc };
+  export { type schedule_ScheduleConfig as ScheduleConfig, schedule_Scheduler as Scheduler, type schedule_SchedulerDeps as SchedulerDeps, schedule_daysInMonth as daysInMonth, schedule_isDue as isDue, schedule_isPeriodTriggerDay as isPeriodTriggerDay, schedule_nextOccurrence as nextOccurrence, schedule_nextOccurrenceFor as nextOccurrenceFor, schedule_parseClock as parseClock, schedule_zonedDateString as zonedDateString, schedule_zonedTimeToUtc as zonedTimeToUtc };
 }
 
 /**
@@ -1447,13 +1498,6 @@ declare namespace importCli {
   export { type importCli_ImportCandidate as ImportCandidate, type importCli_ImportResult as ImportResult, importCli_cliConfigCandidates as cliConfigCandidates, importCli_importFirstAvailable as importFirstAvailable, importCli_importFromCli as importFromCli, importCli_parseSimpleYaml as parseSimpleYaml };
 }
 
-/**
- * 两个对外工具：`trending_run` / `trending_history`（规格 §8）。
- *
- * 工具名是**稳定对外接口**：一旦发布不再改名；需要新能力时新增工具。
- * 参数方言用宿主 `dsh-tools` 的「内联 required: true」，输出用标准 JSON Schema。
- */
-
 declare function createTrendingRunTool(runner: Runner): {
     name: string;
     description: string;
@@ -1466,6 +1510,11 @@ declare function createTrendingRunTool(runner: Runner): {
             type: string;
             description: string;
         };
+        period: {
+            type: string;
+            enum: string[];
+            description: string;
+        };
     };
     output: {
         schema: {
@@ -1533,6 +1582,7 @@ declare function createTrendingRunTool(runner: Runner): {
     execute(args?: {
         dryRun?: boolean;
         date?: string;
+        period?: string;
     }, exec?: {
         signal?: AbortSignal;
     }): Promise<{

package/lib/internal.js

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

package/package.json

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