@morehao/dsh-github-trending 0.3.2 → 0.4.1

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## [v0.4.1] - 2026-10-31
+
+### Features
+
+- **ui**: move navigation to top with identity bar (#25)
+
+**Full Changelog**: https://github.com/morehao/dsh-github-trending/compare/v0.4.0...v0.4.1
+
+## 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
 
 ### 改进

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` 并给出下载地址——不会写空文件，也不会退回旧内容。
 
@@ -40,11 +40,11 @@ dsh plugin --profile <profile> add @morehao/dsh-github-trending
 - `GET /preview?id=<runId>` 只接受历史里出现过的 id、不接路径参数；返回 `{ text, truncated }`。客户端渲染 Markdown 子集（标题 / 段落 / 列表 / 引用 / 代码块 / 表格（GFM 管道表，含列对齐）/ 粗体 / 行内代码 / 链接 / 分隔线），**只生成 React 文本节点**，链接仅放行 http(s)，不渲染图片或原始 HTML；也可以切「原文」。
 - 日报只列最近 30 天**有记录**的日期，每天一条；默认打开最近一期有预览的日报。失败 / 无变更 / 试跑 / 旧记录 / 副本被清理都有各自的空状态，不用示例内容兜底。
 - 预览是运行结束时的派生副本：你在仓库里事后编辑 canonical 文件，不会改变这次记录。
-- 关于入口在左轨底部：包名 / 版本 / GitHub 来自 `/state.plugin`（`repository` 由 `package.json` 规范化），仓库缺失时隐藏外链。
+- 工作台顶部第一行是插件身份条：名称 / 版本 / 完整包名（点击复制）/ GitHub 外链 / 检查更新（就地状态）；第二行是横向 tab（概览 / 日报 / 运行记录 / 设置），右侧常驻下次运行与就绪 N/4。点版本号可打开「关于」弹层。包名 / 版本 / GitHub 来自 `/state.plugin`（`repository` 由 `package.json` 规范化），仓库缺失时隐藏外链。
 
 ## 插件更新
 
-- 关于弹层里会显示当前版本与 npm 上的最新版：打开时静默检查一次（Host 侧缓存 5 分钟），也可以点「检查更新」强制重查。只跟随 npm 的 `latest` 稳定版。
+- 顶部身份条的「检查更新」与「关于」弹层都会显示当前版本与 npm 上的最新版：首次挂载静默检查一次（Host 侧缓存 5 分钟），也可以点「检查更新」强制重查；有新版时身份条就地显示「有新版本 vX」+「更新到 vX」。只跟随 npm 的 `latest` 稳定版。
 - 确认后由宿主 `pluginManager` 重装本插件（`installBundle`；已装同 spec 时走 `removeBundle → installBundle`，失败会尝试装回原版本），完成后需要重启 DSH 生效。
 - 本地安装（`link:` / `file:` / `workspace:`）**不提供一键更新**：那会把开发链接换成 npm 版。此时只显示 `dsh plugin --profile <name> add @morehao/dsh-github-trending@latest` 供复制。
 - 更新引擎来自共享包 [`@morehao/dsh-plugin-kit`](https://www.npmjs.com/package/@morehao/dsh-plugin-kit)（`./update` + `./update/client`），本仓只做上下文与 `execCapture` 接线；`GET /update` / `POST /update` 与其它路由一样要求自定义头、`no-store`，业务失败返回 409 + `UPDATE_FAILED` + `updateCode`。
@@ -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": "下次运行",
@@ -239,6 +241,22 @@ var DICT = {
     "shell.ready": "就绪 {ready} / {total}",
     "shell.github": "GitHub",
     "shell.package.copy": "复制完整包名",
+    "shell.update.check": "检查更新",
+    "shell.update.checking": "正在检查…",
+    "shell.update.applying": "正在更新到 v{version}…",
+    "shell.update.applyingShort": "更新中…",
+    "shell.update.done": "已更新，重启 DSH 生效",
+    "shell.update.failed": "更新失败",
+    "shell.update.checkFailed": "检查失败，可稍后重试",
+    "shell.update.available": "有新版本 v{latest}",
+    "shell.update.latest": "已是最新 v{version}",
+    "shell.update.apply": "更新到 v{version}",
+    "shell.update.confirmHint": "更新会重装插件，需重启 DSH 生效",
+    "shell.update.confirmYes": "确认更新",
+    "shell.update.cancel": "取消",
+    "shell.update.copyCmd": "复制更新命令",
+    "shell.update.copied": "已复制",
+    "shell.update.manual": "本地安装，需手动更新",
     "time.in.minutes": "{minutes} 分钟后",
     "time.in.hours": "{hours} 小时 {minutes} 分后",
     "time.in.days": "{days} 天后",
@@ -452,10 +470,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",
@@ -554,6 +574,22 @@ var DICT = {
     "shell.ready": "Ready {ready} / {total}",
     "shell.github": "GitHub",
     "shell.package.copy": "Copy full package name",
+    "shell.update.check": "Check for updates",
+    "shell.update.checking": "Checking…",
+    "shell.update.applying": "Updating to v{version}…",
+    "shell.update.applyingShort": "Updating…",
+    "shell.update.done": "Updated · restart DSH",
+    "shell.update.failed": "Update failed",
+    "shell.update.checkFailed": "Check failed, try again later",
+    "shell.update.available": "v{latest} available",
+    "shell.update.latest": "Up to date · v{version}",
+    "shell.update.apply": "Update to v{version}",
+    "shell.update.confirmHint": "Reinstalls the plugin; restart DSH to apply",
+    "shell.update.confirmYes": "Confirm",
+    "shell.update.cancel": "Cancel",
+    "shell.update.copyCmd": "Copy update command",
+    "shell.update.copied": "Copied",
+    "shell.update.manual": "Local install · update manually",
     "time.in.minutes": "in {minutes} min",
     "time.in.hours": "in {hours} h {minutes} min",
     "time.in.days": "in {days} d",
@@ -764,7 +800,7 @@ var CSS = `
 
 /* ——— 01 工作台外壳 ——— */
 .dshgt-shell{gap:0;height:100%;min-height:0;overflow:hidden;}
-.dshgt-app{flex:1;min-height:0;display:grid;grid-template-columns:216px minmax(0,1fr);background:var(--gt-bg);}
+.dshgt-app{flex:1;min-height:0;display:flex;flex-direction:column;background:var(--gt-bg);}
 .dshgt-rail{background:color-mix(in srgb,var(--gt-fg) 3%,var(--gt-bg));border-right:1px solid var(--gt-border);display:flex;flex-direction:column;padding:14px 10px 12px;min-height:0;overflow:hidden;}
 .dshgt-brand{display:flex;align-items:center;gap:9px;padding:2px 6px 16px;}
 .dshgt-brand svg{flex:none;border-radius:8px;}
@@ -793,7 +829,7 @@ var CSS = `
 .dshgt-pkg-copy{width:22px;height:22px;margin-left:auto;display:grid;place-items:center;border:0;background:none;border-radius:4px;color:var(--gt-muted);cursor:pointer;}
 .dshgt-pkg-copy:hover{background:color-mix(in srgb,var(--gt-fg) 7%,var(--gt-bg));color:var(--gt-fg);}
 .dshgt-pkg-copy:disabled{opacity:.4;cursor:not-allowed;}
-.dshgt-main{display:flex;flex-direction:column;min-width:0;min-height:0;background:var(--gt-bg);}
+.dshgt-main{flex:1;display:flex;flex-direction:column;min-width:0;min-height:0;background:var(--gt-bg);}
 .dshgt-page-head{display:flex;align-items:flex-start;gap:16px;padding:20px 30px 14px;border-bottom:1px solid color-mix(in srgb,var(--gt-border) 70%,transparent);flex:none;}
 .dshgt-page-heading{min-width:0;}
 .dshgt-page-head h1{margin:0;font-size:21px;line-height:1.25;font-weight:650;letter-spacing:-.012em;}
@@ -809,6 +845,43 @@ var CSS = `
 .dshgt-tag{display:inline-flex;align-items:center;height:20px;padding:0 7px;border:1px solid var(--gt-border);border-radius:999px;font-size:11px;color:var(--gt-muted);background:var(--gt-bg);white-space:nowrap;}
 .dshgt-inline-tag{margin-left:6px;vertical-align:1px;}
 
+/* ——— 顶部身份条（第一行）：名称 / 版本 / 完整包名 / GitHub / 检查更新 ——— */
+.dshgt-idbar{display:flex;align-items:center;gap:10px;height:48px;padding:0 18px;border-bottom:1px solid var(--gt-border);flex:none;background:var(--gt-bg);}
+.dshgt-idbar .dshgt-brand{display:flex;align-items:center;gap:9px;padding:0;flex:none;}
+.dshgt-idbar .dshgt-brand svg{width:22px;height:22px;flex:none;border-radius:6px;}
+.dshgt-brand-name{font-size:13.5px;font-weight:650;letter-spacing:-.01em;white-space:nowrap;line-height:1.3;}
+.dshgt-id-ver{appearance:none;font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:11px;color:var(--gt-fg);background:var(--gt-card);border:1px solid var(--gt-border);border-radius:999px;padding:1px 7px;line-height:16px;cursor:pointer;flex:none;}
+.dshgt-id-ver:hover{border-color:color-mix(in srgb,var(--gt-accent) 45%,var(--gt-border));}
+.dshgt-id-sep{width:1px;height:16px;background:var(--gt-border);flex:none;}
+.dshgt-id-pkg{appearance:none;border:0;background:none;padding:2px 4px;border-radius:5px;color:var(--gt-muted);cursor:pointer;font-size:12px;max-width:44vw;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;flex:none;}
+.dshgt-id-pkg:hover{color:var(--gt-fg);background:color-mix(in srgb,var(--gt-fg) 5%,var(--gt-bg));}
+.dshgt-idbar-right{margin-left:auto;display:flex;align-items:center;gap:10px;flex:none;}
+.dshgt-id-gh{display:inline-flex;align-items:center;justify-content:center;width:30px;height:30px;border-radius:7px;color:var(--gt-muted);border:1px solid transparent;}
+.dshgt-id-gh:hover{color:var(--gt-fg);background:color-mix(in srgb,var(--gt-fg) 6%,var(--gt-bg));border-color:var(--gt-border);}
+.dshgt-id-upd{display:flex;align-items:center;gap:10px;}
+.dshgt-id-status{font-size:12px;color:var(--gt-muted);white-space:nowrap;display:inline-flex;align-items:center;gap:6px;}
+.dshgt-id-status.ok{color:var(--gt-ok);}
+.dshgt-id-status.new{color:var(--gt-warn);}
+.dshgt-id-status.err{color:var(--gt-err);}
+.dshgt-id-actions{display:flex;align-items:center;gap:8px;}
+
+/* ——— 横向 tab（第二行）+ 右侧状态 ——— */
+.dshgt-tabsbar{display:flex;align-items:stretch;gap:16px;height:46px;padding:0 24px;border-bottom:1px solid var(--gt-border);flex:none;background:var(--gt-bg);}
+.dshgt-tabnav{display:flex;align-items:stretch;gap:2px;height:100%;}
+.dshgt-tab{display:flex;align-items:center;gap:7px;padding:0 12px;border:0;background:none;color:var(--gt-muted);cursor:pointer;font:inherit;font-size:13.5px;position:relative;border-bottom:2px solid transparent;margin-bottom:-1px;}
+.dshgt-tab svg{opacity:.8;}
+.dshgt-tab:hover{color:var(--gt-fg);}
+.dshgt-tab.on{color:var(--gt-fg);font-weight:600;border-bottom-color:var(--gt-accent);}
+.dshgt-tab.on svg{opacity:1;color:var(--gt-accent);}
+.dshgt-tab-tail{font-size:10.5px;color:var(--gt-muted);background:var(--gt-card);border:1px solid var(--gt-border);border-radius:999px;padding:0 5px;line-height:15px;}
+.dshgt-tabsbar-status{margin-left:auto;display:flex;align-items:center;gap:16px;flex:none;}
+.dshgt-status-item{display:inline-flex;align-items:center;gap:7px;font-size:12px;color:var(--gt-muted);white-space:nowrap;}
+.dshgt-status-key{color:var(--gt-muted);}
+.dshgt-status-val{color:var(--gt-fg);font-weight:600;}
+.dshgt-status-sub{color:var(--gt-muted);}
+@media (max-width:1100px){ .dshgt-id-pkg{max-width:26vw;} }
+@media (max-width:860px){ .dshgt-id-pkg{display:none;} .dshgt-status-item.dshgt-next{display:none;} }
+
 /* ——— 概览 ——— */
 .dshgt-delivery{border:1px solid var(--gt-border);border-radius:12px;padding:18px 20px 16px;background:var(--gt-card);display:flex;flex-direction:column;gap:6px;}
 .dshgt-delivery-top{display:flex;align-items:center;gap:10px;flex-wrap:wrap;}
@@ -1663,10 +1736,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")),
@@ -1704,6 +1778,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;
@@ -2107,11 +2198,6 @@ function usePluginUpdate() {
   }, [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();
@@ -3440,6 +3526,109 @@ function AboutDialog(props) {
   return h("div", { className: "dshgt-root" }, dialog);
 }
 
+// client/identity-bar.ts
+function logo() {
+  return h(
+    "svg",
+    { width: 22, height: 22, viewBox: "0 0 64 64", "aria-hidden": "true" },
+    h("rect", { x: 4, y: 4, width: 56, height: 56, rx: 14, fill: "#0d1117" }),
+    h("path", { d: "M18 46V22l14 12 14-12v24", fill: "none", stroke: "#58a6ff", strokeWidth: 4, strokeLinecap: "round", strokeLinejoin: "round" }),
+    h("circle", { cx: 32, cy: 45, r: 3, fill: "#3fb950" })
+  );
+}
+function githubIcon() {
+  return h("svg", { width: 16, height: 16, viewBox: "0 0 16 16", fill: "currentColor", "aria-hidden": "true" }, h("path", {
+    d: "M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.01 8.01 0 0 0 16 8c0-4.42-3.58-8-8-8Z"
+  }));
+}
+function IdentityBar(props) {
+  const { t, plugin } = props;
+  const [copied, setCopied] = import_react.default.useState(false);
+  const [confirming, setConfirming] = import_react.default.useState(false);
+  const [cmdCopied, setCmdCopied] = import_react.default.useState(false);
+  const [updateState, controller] = usePluginUpdate();
+  const view = updateState.view;
+  const status = updateState.status;
+  import_react.default.useEffect(() => {
+    if (status === "applying" || status === "restart-required" || status === "applied") setConfirming(false);
+  }, [status]);
+  const copyPkg = () => {
+    void copyText(plugin.name).then((ok) => {
+      if (!ok) return;
+      setCopied(true);
+      setTimeout(() => setCopied(false), 1400);
+    });
+  };
+  const busy = status === "checking" || status === "applying";
+  const settled = status === "restart-required" || status === "applied";
+  const latestVersion = view === null ? "" : view.latestVersion ?? "";
+  const updateAvailable = view !== null && view.updateAvailable;
+  const actionable = updateAvailable && view !== null && view.canApply && !settled && !busy;
+  const manual = view !== null && (!view.canApply || view.checkFailed) ? view.manualCommand ?? null : null;
+  const currentVersion = view === null ? plugin.version : view.currentVersion ?? plugin.version;
+  const copyCmd = () => {
+    if (manual === void 0 || manual === null) return;
+    void copyText(manual).then((ok) => {
+      if (!ok) return;
+      setCmdCopied(true);
+      setTimeout(() => setCmdCopied(false), 1400);
+    });
+  };
+  function statusLine() {
+    if (status === "checking" || view === null) return { text: t("shell.update.checking"), kind: "muted" };
+    if (status === "applying") return { text: t("shell.update.applying", { version: latestVersion }), kind: "muted" };
+    if (status === "restart-required" || status === "applied") return { text: t("shell.update.done", { version: latestVersion }), kind: "ok" };
+    if (status === "failed") return { text: updateState.error?.code === "CHECK_FAILED" ? t("shell.update.checkFailed") : t("shell.update.failed"), kind: "err" };
+    if (view.checkFailed) return { text: t("shell.update.checkFailed"), kind: "err" };
+    if (view.updateAvailable) return { text: t("shell.update.available", { latest: view.latestVersion ?? "" }), kind: "new" };
+    return { text: t("shell.update.latest", { version: currentVersion }), kind: "ok" };
+  }
+  function action() {
+    if (status === "applying") return h(Btn, { small: true, disabled: true }, t("shell.update.applyingShort"));
+    if (actionable) {
+      if (confirming) {
+        return [
+          h(Btn, { key: "yes", small: true, variant: "danger", onClick: () => {
+            setConfirming(false);
+            void controller.apply();
+          } }, t("shell.update.confirmYes")),
+          h(Btn, { key: "no", small: true, onClick: () => setConfirming(false) }, t("shell.update.cancel"))
+        ];
+      }
+      return h(Btn, { small: true, variant: "primary", onClick: () => setConfirming(true) }, t("shell.update.apply", { version: latestVersion }));
+    }
+    if (manual !== null) return h(Btn, { small: true, onClick: copyCmd }, cmdCopied ? t("shell.update.copied") : t("shell.update.copyCmd"));
+    return h(Btn, { small: true, disabled: busy, onClick: () => void controller.check({ fresh: true }) }, t("shell.update.check"));
+  }
+  const line = statusLine();
+  return h(
+    "div",
+    { className: "dshgt-idbar" },
+    h("div", { className: "dshgt-brand" }, logo(), h("span", { className: "dshgt-brand-name" }, t("section.title"))),
+    h("button", { type: "button", className: "dshgt-id-ver", title: t("about.title"), onClick: () => props.onOpenAbout() }, `v${plugin.version}`),
+    h("span", { className: "dshgt-id-sep" }),
+    h(
+      "button",
+      { type: "button", className: "dshgt-id-pkg dshgt-mono", title: updatedCopyTitle(t, copied), onClick: copyPkg },
+      copied ? t("about.copied") : plugin.name
+    ),
+    h(
+      "div",
+      { className: "dshgt-idbar-right" },
+      plugin.repository === void 0 ? null : h("a", { className: "dshgt-id-gh", href: plugin.repository, target: "_blank", rel: "noreferrer", title: t("about.repo"), "aria-label": t("about.repo") }, githubIcon()),
+      h(
+        "span",
+        { className: "dshgt-id-upd" },
+        confirming ? h("span", { className: "dshgt-id-status new" }, t("shell.update.confirmHint")) : h("span", { className: `dshgt-id-status ${line.kind}` }, line.text),
+        h("span", { className: "dshgt-id-actions" }, action())
+      )
+    )
+  );
+}
+function updatedCopyTitle(t, copied) {
+  return copied ? t("about.copied") : t("about.copy");
+}
+
 // client/panel-icon.ts
 var TREND_LINE = "3 16.5 9 10.5 13 14.5 21 6.5";
 var TREND_ARROW = "15.5 6.5 21 6.5 21 12";
@@ -3520,22 +3709,6 @@ function navIcon(name, size = 16) {
     h("circle", { cx: 10, cy: 17, r: 2.2 })
   );
 }
-function brandLogo() {
-  return h(
-    "svg",
-    { width: 28, height: 28, viewBox: "0 0 64 64", "aria-hidden": "true" },
-    h("rect", { x: 3, y: 3, width: 58, height: 58, rx: 15, fill: "#0d1117", stroke: "rgba(255,255,255,.14)", strokeWidth: 1 }),
-    h("path", {
-      d: "M18 46V22l14 12 14-12v24",
-      fill: "none",
-      stroke: "#58a6ff",
-      strokeWidth: 4,
-      strokeLinecap: "round",
-      strokeLinejoin: "round"
-    }),
-    h("circle", { cx: 32, cy: 45, r: 3, fill: "#3fb950" })
-  );
-}
 function relativeFuture(iso, t) {
   if (iso === void 0) return void 0;
   const target = new Date(iso).getTime();
@@ -3581,6 +3754,7 @@ function apply(ctx) {
     }, []);
     const openRuns = import_react.default.useCallback(() => setView("runs"), []);
     const openSettings = import_react.default.useCallback(() => setView("settings"), []);
+    const openAbout = import_react.default.useCallback(() => setAboutOpen(true), []);
     const state = value.state;
     const plugin = state?.plugin;
     const history = state?.status.history ?? [];
@@ -3591,9 +3765,10 @@ function apply(ctx) {
       state.settings.repo.path.trim() !== "",
       state.github.configured
     ].filter(Boolean).length;
-    const fullName = plugin === void 0 ? void 0 : `${plugin.name}@v${plugin.version}`;
     const digestTail = digestDate ?? state?.status.lastResult?.date ?? state?.status.history[0]?.date;
     const showActions = view === "overview" || view === "runs";
+    const nextRun = schedule === void 0 || !schedule.enabled ? t("shell.scheduleOff") : schedule.nextRunAt === void 0 ? `${schedule.time} · ${schedule.timezone}` : nextRunText(schedule.nextRunAt);
+    const relNext = schedule !== void 0 && schedule.enabled && schedule.nextRunAt !== void 0 ? relativeFuture(schedule.nextRunAt, t) : void 0;
     const viewNode = view === "overview" ? h(OverviewView, {
       t,
       lang,
@@ -3616,103 +3791,49 @@ function apply(ctx) {
       h(
         "div",
         { className: "dshgt-app" },
+        plugin === void 0 ? null : h(IdentityBar, { t, plugin, onOpenAbout: openAbout }),
         h(
-          "aside",
-          { className: "dshgt-rail" },
-          h(
-            "div",
-            { className: "dshgt-brand" },
-            brandLogo(),
-            h(
-              "div",
-              null,
-              h("div", { className: "dshgt-brand-name" }, t("section.title")),
-              h("div", { className: "dshgt-brand-ver" }, plugin === void 0 ? "" : `v${plugin.version}`)
-            )
-          ),
+          "div",
+          { className: "dshgt-tabsbar" },
           h(
             "nav",
-            { className: "dshgt-nav", "aria-label": t("shell.nav") },
+            { className: "dshgt-tabnav", "aria-label": t("shell.nav") },
             NAV.map(
               (item) => h(
                 "button",
                 {
                   key: item.id,
                   type: "button",
-                  className: `dshgt-nav-item${view === item.id ? " on" : ""}`,
+                  className: `dshgt-tab${view === item.id ? " on" : ""}`,
                   "aria-current": view === item.id ? "page" : void 0,
                   onClick: () => setView(item.id)
                 },
                 navIcon(item.icon),
                 h("span", null, t(item.label)),
-                item.id === "digest" && digestTail !== void 0 ? h("span", { className: "dshgt-nav-tail" }, h("span", { className: "dshgt-mono" }, digestTail.slice(5))) : item.id === "runs" && history.length > 0 ? h("span", { className: "dshgt-nav-tail" }, h("span", { className: "dshgt-mono" }, String(history.length))) : null
+                item.id === "digest" && digestTail !== void 0 ? h("span", { className: "dshgt-tab-tail dshgt-mono" }, digestTail.slice(5)) : item.id === "runs" && history.length > 0 ? h("span", { className: "dshgt-tab-tail dshgt-mono" }, String(history.length)) : null
               )
             )
           ),
-          h("div", { className: "dshgt-rail-spacer" }),
           h(
             "div",
-            { className: "dshgt-rail-status" },
-            h("div", { className: "dshgt-rail-cap" }, t("shell.nextRun")),
-            h(
-              "div",
-              { className: "dshgt-rail-time" },
-              schedule === void 0 || !schedule.enabled ? t("shell.scheduleOff") : schedule.nextRunAt === void 0 ? `${schedule.time} · ${schedule.timezone}` : nextRunText(schedule.nextRunAt)
-            ),
-            h(
-              "div",
-              { className: "dshgt-rail-count" },
-              schedule !== void 0 && schedule.enabled && schedule.nextRunAt !== void 0 ? relativeFuture(schedule.nextRunAt, t) ?? "" : schedule === void 0 ? "" : `${schedule.time} · ${schedule.timezone}`
-            ),
+            { className: "dshgt-tabsbar-status" },
             h(
-              "div",
-              { className: "dshgt-rail-ready" },
+              "span",
+              { className: "dshgt-status-item" },
               h("span", { className: `dshgt-lamp ${ready === 4 ? "ok" : ready > 0 ? "warn" : "err"}` }),
               t("shell.ready", { ready, total: 4 })
-            )
-          ),
-          h(
-            "div",
-            { className: "dshgt-rail-pkg" },
-            h(
-              "button",
-              {
-                type: "button",
-                className: "dshgt-pkg-name",
-                onClick: () => setAboutOpen(true),
-                title: plugin === void 0 ? "" : fullName
-              },
-              plugin?.name ?? t("section.title"),
-              h(UpdateDot, { t })
             ),
             h(
-              "div",
-              { className: "dshgt-pkg-sub" },
-              h("span", { className: "dshgt-mono" }, plugin === void 0 ? "" : `@v${plugin.version}`),
-              plugin?.repository === void 0 ? null : h(
-                "a",
-                { href: plugin.repository, target: "_blank", rel: "noreferrer" },
-                `${t("shell.github")} ↗`
-              ),
-              h(
-                "button",
-                {
-                  type: "button",
-                  className: "dshgt-pkg-copy",
-                  title: t("shell.package.copy"),
-                  "aria-label": t("shell.package.copy"),
-                  disabled: fullName === void 0,
-                  onClick: () => {
-                    if (fullName !== void 0) void copyText(fullName);
-                  }
-                },
-                navIcon("doc", 13)
-              )
+              "span",
+              { className: "dshgt-status-item dshgt-next" },
+              h("span", { className: "dshgt-status-key" }, t("shell.nextRun")),
+              h("span", { className: "dshgt-status-val dshgt-mono" }, nextRun),
+              relNext === void 0 ? null : h("span", { className: "dshgt-status-sub" }, relNext)
             )
           )
         ),
         h(
-          "main",
+          "div",
           { className: "dshgt-main" },
           h(
             "header",

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.2",
+  "version": "0.4.1",
   "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",