@morehao/dsh-github-trending 0.6.0 → 0.7.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## [v0.6.1] - 2026-11-01
+
+### 变更
+
+- 契约依赖 `@morehao/trendradar-contract` 0.3.0 → 0.4.0：`SubscriptionStatus` / `SubscriptionItem` /
+  `SubscriptionVolume` / `SubscriptionDoc` 改为从契约包 `import type`，删除 `src/ipc.ts` 与
+  `client/api.ts` 里的本地兜底声明（0.6.0 的临时载体）。
+- **无行为变化**：wire 仍 `ipcSchema=2` / `digestSchema=2`，`dsh.core.version` 仍为 `0.7.0`；
+  运行时守卫与错误文案保持原样（契约包的 `subscriptionDoc` 校验比本地守卫更严，换用会改变对旧核心
+  的接受范围，故不动）。
+
 ## [v0.6.0] - 2026-11-01
 
 > **发版顺序**：先发布核心 `0.7.0`（含契约 0.4.0 的字段），再发布本插件——本版

package/README.md

@@ -31,6 +31,8 @@ dsh plugin --profile <profile> add @morehao/dsh-github-trending
 2. **填模型**：点「沿用 DSH 配置」从宿主 provider 目录里挑 provider 与模型；可导出密钥的直接传给核心，OAuth 类凭据走本机回环代理。
 3. **试跑一次**：「试跑（不提交）」只抓取与渲染，不写文件、不提交。
 
+> **重新生成（忽略缓存）**：手动「重新生成」会忽略核心持久化的摘要缓存，强制重新抓取与总结，并让榜单页以本次结果为准。若重新生成后内容与分支上已有产物逐字节相同，核心仍按 append-only 语义**不新增提交**（面板提示「内容无变化，未新增提交」）；内容有变化才追加一个提交。定时运行永不强制重跑。
+
 > 设置页分「内容来源 / 模型 / 仓库 / 认证 / 榜单 / 调度」六个 tab；**除「内容来源」（只有状态与核心操作，没有可保存字段）外，每个 tab 独立保存与校验**；某个 tab 有未保存改动时，左侧对应 tab 会显示黄点。
 
 ## 榜单预览与按周期回看
@@ -133,7 +135,7 @@ dsh plugin --profile <profile> add @morehao/dsh-github-trending
 
 | 工具 | 参数 | 返回 |
 |---|---|---|
-| `trending_run` | `{ dryRun?: boolean, date?: string, period?: 'daily'\|'weekly'\|'monthly' }` | 结构化摘要：文件数、commit/分支、PR、内容哈希、错误码与下一步 |
+| `trending_run` | `{ dryRun?: boolean, date?: string, period?: 'daily'\|'weekly'\|'monthly', force?: boolean }` | 结构化摘要：文件数、commit/分支、PR、内容哈希、错误码与下一步 |
 | `trending_history` | `{ limit?: number }` | 上次/下次运行、最近 N 条记录、核心版本、模型、未合并 PR |
 
 工具名是稳定对外接口：**只新增不改名**。

package/client.js

@@ -294,6 +294,10 @@ var DICT = {
     "overview.live.note": "核心一次完成抓取、总结、渲染与提交，结束前没有分段进度；这里只显示已用时间和粗阶段。",
     "overview.live.started": "开始于",
     "run.dryRunShort": "试跑",
+    "run.force": "重新生成",
+    "run.force.hint": "忽略摘要缓存，强制重新抓取与总结",
+    "run.force.noChange": "内容无变化，未新增提交",
+    "run.forced.tag": "强制重跑",
     "run.usage.commit": "提交",
     "runs.count": "最近 {count} 次，超出即裁剪",
     "runs.files": "{count} 个文件",
@@ -352,6 +356,7 @@ var DICT = {
     "digest.select": "选择日报日期",
     "digest.render": "渲染",
     "digest.raw": "原文",
+    "digest.regenerate": "重新生成这一期",
     "digest.mode": "预览方式",
     "digest.copyPath": "复制路径",
     "digest.copied": "已复制",
@@ -801,6 +806,10 @@ var DICT = {
     "overview.live.note": "The core fetches, summarizes, renders and commits in one run; there is no per-step progress before it finishes. Only elapsed time and a coarse phase are shown here.",
     "overview.live.started": "Started",
     "run.dryRunShort": "Dry run",
+    "run.force": "Regenerate",
+    "run.force.hint": "Ignore the summary cache and re-fetch and re-summarize",
+    "run.force.noChange": "No content change; no new commit",
+    "run.forced.tag": "Forced",
     "run.usage.commit": "Commit",
     "runs.count": "Last {count} runs; older ones are trimmed",
     "runs.files": "{count} files",
@@ -859,6 +868,7 @@ var DICT = {
     "digest.select": "Choose a digest date",
     "digest.render": "Rendered",
     "digest.raw": "Raw",
+    "digest.regenerate": "Regenerate this period",
     "digest.mode": "Preview mode",
     "digest.copyPath": "Copy path",
     "digest.copied": "Copied",
@@ -2740,14 +2750,18 @@ function useRunController(store) {
   const [dryRun, setDryRun] = import_react.default.useState(false);
   const [localStartedAt, setLocalStartedAt] = import_react.default.useState(null);
   const run = import_react.default.useCallback(
-    async (overrideDry) => {
+    async (overrideDry, options) => {
       const dry = overrideDry ?? dryRun;
       setBusy(true);
       setError(null);
       setSummary(null);
       setLocalStartedAt((/* @__PURE__ */ new Date()).toISOString());
       try {
-        const result = await apiCall("POST", "/run", { dryRun: dry });
+        const body = { dryRun: dry };
+        if (options?.force === true) body.force = true;
+        if (options?.date !== void 0 && options.date !== "") body.date = options.date;
+        if (options?.period !== void 0) body.period = options.period;
+        const result = await apiCall("POST", "/run", body);
         setSummary(result.summary);
         await refresh({ quiet: true });
       } catch (failure) {
@@ -2936,6 +2950,9 @@ function digestTarget(record, timeZone) {
   const period = recordPeriod(record);
   return { period, bucket: periodBucket(period, info.date) };
 }
+function regenTarget(day) {
+  return { period: day.period, date: day.date };
+}
 function buildPeriodGroups(records, options) {
   const now = options.now ?? /* @__PURE__ */ new Date();
   const today = zonedDateString(now, options.timeZone);
@@ -3325,7 +3342,10 @@ function recordSummary(t, record) {
   if (!record.ok) {
     return [record.errorCode, record.errorMessage].filter((item) => item !== void 0 && item !== "").join(" · ") || t("state.failed");
   }
-  if (record.skipped) return skipHint(t, record.skipReason, t("runs.noChange"));
+  if (record.skipped) {
+    if (record.forced === true && record.skipReason === "unchanged") return t("run.force.noChange");
+    return skipHint(t, record.skipReason, t("runs.noChange"));
+  }
   if (record.kind === "dry-run") return t("runs.dryHint");
   if (record.branch !== void 0) return record.branch;
   if (record.commit !== void 0) return record.commit;
@@ -3459,7 +3479,8 @@ function RunsView(props) {
           { className: "dshgt-run-what" },
           record.kind === "dry-run" ? t("state.dry") : record.skipped ? t("state.skipped") : record.ok ? t("state.ok") : t("state.failed"),
           h("span", { className: "dshgt-run-muted" }, recordSummary(t, record)),
-          record.legacy === true ? h("span", { className: "dshgt-tag dshgt-inline-tag" }, t("runs.legacy")) : null
+          record.legacy === true ? h("span", { className: "dshgt-tag dshgt-inline-tag" }, t("runs.legacy")) : null,
+          record.forced === true ? h("span", { className: "dshgt-tag dshgt-inline-tag" }, t("run.forced.tag")) : null
         ),
         h("span", { className: "dshgt-run-files" }, t("runs.files", { count: record.files })),
         record.tokens === void 0 ? null : h("span", { className: "dshgt-run-tokens dshgt-mono", title: t("run.usage.tokens") }, `${formatTokens(record.tokens)} tok`),
@@ -4074,6 +4095,7 @@ function EmptyDigest(props) {
       "div",
       { className: "dshgt-actions" },
       h(Btn, { small: true, onClick: props.onOpenRuns }, t("digest.empty.viewRuns")),
+      props.onRegenerate === void 0 ? null : h(Btn, { small: true, onClick: props.onRegenerate, disabled: props.regenDisabled === true }, t("digest.regenerate")),
       nearest === void 0 ? null : h(
         Btn,
         { small: true, onClick: () => props.onSelect({ period: nearest.period, bucket: nearest.bucket }) },
@@ -4083,7 +4105,7 @@ function EmptyDigest(props) {
   );
 }
 function DigestView(props) {
-  const { t, lang, store, selected } = props;
+  const { t, lang, store, selected, controller } = props;
   const [mode, setMode] = import_react.default.useState("render");
   const [payload, setPayload] = import_react.default.useState(null);
   const [loading, setLoading] = import_react.default.useState(false);
@@ -4119,20 +4141,20 @@ function DigestView(props) {
       setLoading(false);
       return () => void 0;
     }
-    const controller = new AbortController();
+    const controller2 = new AbortController();
     setLoading(true);
     setError(null);
     setPayload(null);
-    getPreview(previewRunId, controller.signal).then((result) => {
-      if (controller.signal.aborted) return;
+    getPreview(previewRunId, controller2.signal).then((result) => {
+      if (controller2.signal.aborted) return;
       setPayload(result);
       setLoading(false);
     }).catch((failure) => {
-      if (controller.signal.aborted) return;
+      if (controller2.signal.aborted) return;
       setError(failure instanceof Error ? failure.message : String(failure));
       setLoading(false);
     });
-    return () => controller.abort();
+    return () => controller2.abort();
   }, [previewRunId]);
   if (state === null) {
     return h("div", { className: "dshgt-empty" }, store.error ?? t("quickfill.loading"));
@@ -4253,6 +4275,12 @@ function DigestView(props) {
   }
   const showEmpty = day.status !== "preview" || error !== null;
   const record = day.record;
+  const regenerate = () => {
+    const target = regenTarget(day);
+    props.onSelect({ period: target.period, bucket: day.bucket });
+    void controller.run(false, { force: true, date: target.date, period: target.period });
+  };
+  const regenerateDisabled = controller.running || controller.busy;
   return h(
     "div",
     { className: "dshgt-view dshgt-digest" },
@@ -4268,7 +4296,9 @@ function DigestView(props) {
         ...nearest === void 0 ? {} : { nearest },
         ...error === null ? {} : { error },
         onOpenRuns: props.onOpenRuns,
-        onSelect: props.onSelect
+        onSelect: props.onSelect,
+        onRegenerate: regenerate,
+        regenDisabled: regenerateDisabled
       }) : h(
         "div",
         { className: "dshgt-digest-body" },
@@ -4284,6 +4314,7 @@ function DigestView(props) {
           h("span", { className: "dshgt-dim" }, record.preview === void 0 ? "—" : formatBytes(record.preview.bytes)),
           payload?.preview.truncated === true ? h("span", { className: "dshgt-tag" }, t("digest.truncated")) : null,
           h("span", { className: "dshgt-grow" }),
+          h(Btn, { small: true, onClick: regenerate, disabled: regenerateDisabled }, t("digest.regenerate")),
           h(
             "div",
             { className: "dshgt-seg", role: "group", "aria-label": t("digest.mode") },
@@ -4391,9 +4422,10 @@ function statusLabel(t, status) {
 function mergeRows(list) {
   if (list === null) return [];
   const byName = /* @__PURE__ */ new Map();
-  for (const item of list.items) byName.set(item.fullName, item);
+  const items = list.items ?? [];
+  for (const item of items) byName.set(item.fullName, item);
   const names = [...list.repos];
-  for (const item of list.items) {
+  for (const item of items) {
     if (!names.includes(item.fullName)) names.push(item.fullName);
   }
   return names.map((name) => {
@@ -5549,7 +5581,7 @@ function apply(ctx) {
       state.github.configured
     ].filter(Boolean).length;
     const digestTail = state?.status.lastResult?.date ?? state?.status.history[0]?.date;
-    const showActions = view === "overview" || view === "runs";
+    const showActions = view === "overview" || view === "runs" || view === "digest";
     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, {
@@ -5564,6 +5596,7 @@ function apply(ctx) {
       t,
       lang,
       store: value,
+      controller,
       ...digestTarget2 === void 0 ? {} : { selected: digestTarget2 },
       onSelect: setDigestTarget,
       onOpenRuns: openRuns
@@ -5640,6 +5673,15 @@ function apply(ctx) {
                   },
                   t("run.dryRunShort")
                 ),
+                h(
+                  Btn,
+                  {
+                    key: "force",
+                    onClick: () => void controller.run(false, { force: true }),
+                    disabled: controller.running || controller.busy
+                  },
+                  t("run.force")
+                ),
                 h(
                   Btn,
                   {

package/lib/{chunk-WDBZAMWN.js → chunk-VF6DOIQQ.js}

@@ -1611,6 +1611,7 @@ function buildCoreArgs(channelPath, options) {
   if (options.date !== void 0 && options.date !== "") args.push("--date", options.date);
   if (options.period !== void 0) args.push("--period", options.period);
   if (options.stages !== void 0 && options.stages.length > 0) args.push("--stages", options.stages.join(","));
+  if (options.force === true) args.push("--force");
   return args;
 }
 async function runCore(options) {
@@ -1625,7 +1626,8 @@ async function runCore(options) {
     dryRun: options.dryRun,
     date: options.date,
     period: options.period,
-    stages: options.stages
+    stages: options.stages,
+    force: options.force
   });
   const child = spawn2(options.core.path, args, {
     env: sanitizedEnv(process.env, {
@@ -2722,9 +2724,33 @@ async function runSubscribe(input, deps) {
   }
 }
 
+// src/host/version.ts
+var version_exports = {};
+__export(version_exports, {
+  versionAtLeast: () => versionAtLeast
+});
+function parseTriplet(value) {
+  const match = /^v?(\d+)\.(\d+)\.(\d+)/.exec(value.trim());
+  if (match === null) return void 0;
+  return [Number(match[1]), Number(match[2]), Number(match[3])];
+}
+function versionAtLeast(a, b) {
+  const left = parseTriplet(a);
+  const right = parseTriplet(b);
+  if (left === void 0 || right === void 0) return false;
+  for (let i = 0; i < 3; i += 1) {
+    const l = left[i];
+    const r = right[i];
+    if (l > r) return true;
+    if (l < r) return false;
+  }
+  return true;
+}
+
 // src/host/runner.ts
 var runner_exports = {};
 __export(runner_exports, {
+  FORCE_MIN_CORE_VERSION: () => FORCE_MIN_CORE_VERSION,
   Runner: () => Runner,
   isoWeekName: () => isoWeekName,
   periodFileBase: () => periodFileBase,
@@ -2733,6 +2759,7 @@ __export(runner_exports, {
 import { createHash as createHash2 } from "crypto";
 import { existsSync as existsSync4, readFileSync as readFileSync3, realpathSync, statSync as statSync5 } from "fs";
 import path9 from "path";
+var FORCE_MIN_CORE_VERSION = "0.7.1";
 function repoProblem(repoPath) {
   if (repoPath.trim() === "") return { code: "CONFIG_INVALID", message: "\u8FD8\u6CA1\u6709\u9009\u62E9\u5F52\u6863\u4ED3\u5E93" };
   if (!existsSync4(repoPath)) return { code: "REPO_NOT_GIT", message: `\u76EE\u5F55\u4E0D\u5B58\u5728\uFF1A${repoPath}` };
@@ -2851,6 +2878,15 @@ var Runner = class {
           `\u6838\u5FC3\u4E0D\u652F\u6301 provider\u300C${settings.model.provider}\u300D\uFF1B\u53EF\u7528\uFF1A${handshakeResult.supportedProviders.join(" / ")}`
         );
       }
+      const forceRequested = options.force === true;
+      const forceSupported = versionAtLeast(handshakeResult.version.version, FORCE_MIN_CORE_VERSION);
+      const effectiveForce = forceRequested && forceSupported;
+      if (forceRequested && !forceSupported) {
+        store.appendLog(
+          logFile,
+          `[force] \u6838\u5FC3 ${handshakeResult.version.version} \u4F4E\u4E8E ${FORCE_MIN_CORE_VERSION}\uFF0C\u4E0D\u652F\u6301 --force\uFF0C\u5DF2\u964D\u7EA7\u4E3A\u666E\u901A\u91CD\u8DD1`
+        );
+      }
       const model = await this.openModelChannel({ settings, credentials, env, logFile });
       const apiKey = model.apiKey;
       proxy = model.proxy;
@@ -2868,6 +2904,7 @@ var Runner = class {
         period,
         dryRun,
         trigger: options.trigger === "schedule" ? "schedule" : "manual",
+        ...effectiveForce ? { force: true } : {},
         ...model.baseURLOverride === void 0 ? {} : { baseURLOverride: model.baseURLOverride },
         signal: controller.signal,
         secrets: [apiKey, github.token],
@@ -2884,7 +2921,8 @@ var Runner = class {
         channel: result.channelKind,
         proxy: proxy !== void 0,
         coreSource: core.source,
-        ...core.tag === void 0 ? {} : { coreTag: core.tag }
+        ...core.tag === void 0 ? {} : { coreTag: core.tag },
+        ...effectiveForce ? { forced: true } : {}
       });
       const preview = this.capturePreview({
         id,
@@ -2892,7 +2930,8 @@ var Runner = class {
         period,
         settings,
         outcome,
-        secrets: [apiKey, github.token]
+        secrets: [apiKey, github.token],
+        ...effectiveForce ? { force: true } : {}
       });
       if (preview !== void 0) summary.preview = preview;
       this.record(summary, settings);
@@ -3192,7 +3231,8 @@ var Runner = class {
       ...input.channel === void 0 ? {} : { channel: input.channel },
       proxy: input.proxy,
       ...input.coreSource === void 0 ? {} : { coreSource: input.coreSource },
-      ...input.coreTag === void 0 ? {} : { coreTag: input.coreTag }
+      ...input.coreTag === void 0 ? {} : { coreTag: input.coreTag },
+      ...input.forced === true ? { forced: true } : {}
     };
   }
   failureSummary(input) {
@@ -3223,7 +3263,8 @@ var Runner = class {
    */
   capturePreview(input) {
     const { outcome, settings, date, period, id } = input;
-    if (!outcome.ok || outcome.dryRun || outcome.skipped || date === void 0) return void 0;
+    if (!outcome.ok || outcome.dryRun || date === void 0) return void 0;
+    if (outcome.skipped && input.force !== true) return void 0;
     const skip = (reason, extra = {}) => {
       this.deps.logger?.("preview.skip", { id, reason, ...extra });
       return void 0;
@@ -3294,6 +3335,7 @@ var Runner = class {
         ...summary.error.reason === void 0 ? {} : { errorReason: summary.error.reason }
       },
       ...summary.skipReason === void 0 ? {} : { skipReason: summary.skipReason },
+      ...summary.forced === true ? { forced: true } : {},
       durationMs: summary.durationMs,
       files: summary.files,
       ...summary.date === void 0 ? {} : { date: summary.date },
@@ -3319,7 +3361,9 @@ var Runner = class {
       ...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 ? {
+      // 幂等：内容未变（skipped）通常不刷新 lastDigest；但显式 force 时即便 core 判定
+      // unchanged，也要把本次作为最新展示（contentHash 仍是真实 hash，不伪造）。
+      ...summary.ok && summary.contentHash !== void 0 && (!summary.skipped || summary.forced === true) ? {
         lastDigest: {
           date: summary.date ?? (/* @__PURE__ */ new Date()).toISOString().slice(0, 10),
           contentHash: summary.contentHash,
@@ -4060,6 +4104,7 @@ async function dispatch(method, pathname, url, request, deps) {
     const base = {
       dryRun: body.dryRun === true,
       ...typeof body.date === "string" && body.date !== "" ? { date: body.date } : {},
+      ...body.force === true ? { force: true } : {},
       trigger: "manual"
     };
     if (isPeriod(body.period)) {
@@ -4333,6 +4378,7 @@ var RUN_OUTPUT_SCHEMA = {
     ok: { type: "boolean" },
     skipped: { type: "boolean" },
     dryRun: { type: "boolean" },
+    forced: { type: "boolean" },
     durationMs: { type: "number" },
     coreVersion: { type: "string" },
     files: { type: "number" },
@@ -4393,11 +4439,12 @@ function describeRecord(record) {
 function createTrendingRunTool(runner) {
   return {
     name: "trending_run",
-    description: "\u6267\u884C GitHub \u8D8B\u52BF\u699C\u5355\uFF1A\u5B9A\u4F4D\u5E76\u63E1\u624B\u672C\u5730\u6838\u5FC3\uFF0Cspawn \u6838\u5FC3 run\uFF0C\u8FD4\u56DE\u7ED3\u6784\u5316\u6458\u8981\uFF08\u6587\u4EF6\u6570\u3001commit\u3001PR\u3001\u9519\u8BEF\u7801\uFF09\u3002\u7701\u7565 period \u65F6\u9ED8\u8BA4\u4EA7\u51FA\u65E5/\u5468/\u6708\u4E09\u699C\uFF08\u4F9D\u6B21\u8FD0\u884C\u4E09\u6B21\uFF0C\u8FD4\u56DE summaries\uFF09\u3002dryRun=true \u53EA\u6293\u53D6\u4E0E\u6E32\u67D3\u3001\u4E0D\u5199\u6587\u4EF6\u4E5F\u4E0D\u63D0\u4EA4\u3002\u540C\u65E5\u540C\u5185\u5BB9\u91CD\u8DD1\u4F1A\u8FD4\u56DE skipped=true\uFF08\u96F6\u65B0\u589E commit\uFF09\u3002",
+    description: "\u6267\u884C GitHub \u8D8B\u52BF\u699C\u5355\uFF1A\u5B9A\u4F4D\u5E76\u63E1\u624B\u672C\u5730\u6838\u5FC3\uFF0Cspawn \u6838\u5FC3 run\uFF0C\u8FD4\u56DE\u7ED3\u6784\u5316\u6458\u8981\uFF08\u6587\u4EF6\u6570\u3001commit\u3001PR\u3001\u9519\u8BEF\u7801\uFF09\u3002\u7701\u7565 period \u65F6\u9ED8\u8BA4\u4EA7\u51FA\u65E5/\u5468/\u6708\u4E09\u699C\uFF08\u4F9D\u6B21\u8FD0\u884C\u4E09\u6B21\uFF0C\u8FD4\u56DE summaries\uFF09\u3002dryRun=true \u53EA\u6293\u53D6\u4E0E\u6E32\u67D3\u3001\u4E0D\u5199\u6587\u4EF6\u4E5F\u4E0D\u63D0\u4EA4\u3002force=true \u5FFD\u7565\u6458\u8981\u7F13\u5B58\u3001\u5F3A\u5236\u91CD\u65B0\u751F\u6210\uFF08\u5185\u5BB9\u65E0\u53D8\u5316\u65F6\u4E0D\u65B0\u589E\u63D0\u4EA4\uFF0C\u4F46\u4F1A\u5237\u65B0\u9884\u89C8\uFF09\u3002\u540C\u65E5\u540C\u5185\u5BB9\u91CD\u8DD1\u4F1A\u8FD4\u56DE skipped=true\uFF08\u96F6\u65B0\u589E commit\uFF09\u3002",
     parameters: {
       dryRun: { type: "boolean", description: "\u53EA\u8BD5\u8DD1\uFF1A\u4E0D\u5199\u6587\u4EF6\u3001\u4E0D\u63D0\u4EA4\u3001\u4E0D\u5F00 PR" },
       date: { type: "string", description: "\u6307\u5B9A\u65E5\u671F\uFF08YYYY-MM-DD\uFF09\uFF1B\u7701\u7565\u5219\u7528\u8C03\u5EA6\u65F6\u533A\u7684\u4ECA\u5929" },
-      period: { type: "string", enum: ["daily", "weekly", "monthly"], description: "\u53EA\u8DD1\u6307\u5B9A\u5468\u671F\uFF1B\u7701\u7565\u5219\u9ED8\u8BA4\u4EA7\u51FA\u65E5/\u5468/\u6708\u4E09\u699C" }
+      period: { type: "string", enum: ["daily", "weekly", "monthly"], description: "\u53EA\u8DD1\u6307\u5B9A\u5468\u671F\uFF1B\u7701\u7565\u5219\u9ED8\u8BA4\u4EA7\u51FA\u65E5/\u5468/\u6708\u4E09\u699C" },
+      force: { type: "boolean", description: "\u5FFD\u7565\u6458\u8981\u7F13\u5B58\u3001\u5F3A\u5236\u91CD\u65B0\u751F\u6210\uFF08\u5185\u5BB9\u65E0\u53D8\u5316\u65F6\u4E0D\u65B0\u589E\u63D0\u4EA4\uFF0C\u4F46\u4F1A\u5237\u65B0\u9884\u89C8\uFF09" }
     },
     output: {
       schema: RUN_OUTPUT_SCHEMA,
@@ -4408,13 +4455,14 @@ function createTrendingRunTool(runner) {
       const base = {
         dryRun: args.dryRun === true,
         ...typeof args.date === "string" && args.date !== "" ? { date: args.date } : {},
+        ...args.force === true ? { force: true } : {},
         trigger: "tool"
       };
       const summaries = isPeriod(args.period) ? [await runner.run({ ...base, period: args.period })] : await runner.runMany(base);
       const lines = [];
       for (const summary of summaries) {
         const periodLabel = summary.period ?? "\u2014";
-        const head = summary.ok ? summary.skipped ? "\u65E0\u53D8\u66F4\uFF08skipped\uFF09" : summary.dryRun ? "\u8BD5\u8DD1\u5B8C\u6210" : "\u8FD0\u884C\u6210\u529F" : `\u8FD0\u884C\u5931\u8D25\uFF1A${summary.error?.code ?? "INTERNAL"}`;
+        const head = summary.ok ? summary.skipped ? summary.forced ? "\u65E0\u53D8\u5316\uFF08\u5F3A\u5236\u91CD\u8DD1\uFF0C\u672A\u65B0\u589E\u63D0\u4EA4\uFF09" : "\u65E0\u53D8\u66F4\uFF08skipped\uFF09" : summary.dryRun ? "\u8BD5\u8DD1\u5B8C\u6210" : "\u8FD0\u884C\u6210\u529F" : `\u8FD0\u884C\u5931\u8D25\uFF1A${summary.error?.code ?? "INTERNAL"}`;
         lines.push(`${summary.ok ? "\u2713" : "\u2717"} [${periodLabel}] ${head}`);
         lines.push(`\xB7 \u6838\u5FC3 ${summary.coreVersion || "(\u672A\u77E5)"} \xB7 ${formatDuration(summary.durationMs)} \xB7 ${summary.files} \u4E2A\u6587\u4EF6`);
         if (summary.tokens !== void 0) {
@@ -4444,6 +4492,7 @@ function createTrendingRunTool(runner) {
           ok: summary.ok,
           skipped: summary.skipped,
           dryRun: summary.dryRun,
+          ...summary.forced === true ? { forced: true } : {},
           durationMs: summary.durationMs,
           files: summary.files,
           ...summary.tokens === void 0 ? {} : { tokens: summary.tokens },
@@ -4455,6 +4504,7 @@ function createTrendingRunTool(runner) {
         id: primary?.id,
         skipped: summaries.every((summary) => summary.skipped),
         dryRun: base.dryRun,
+        ...base.force === true ? { forced: true } : {},
         durationMs: summaries.reduce((sum, summary) => sum + summary.durationMs, 0),
         files: summaries.reduce((sum, summary) => sum + summary.files, 0),
         ...(() => {
@@ -4530,6 +4580,7 @@ export {
   Scheduler,
   schedule_exports,
   subscribe_exports,
+  version_exports,
   Runner,
   runner_exports,
   readPluginInfo,

package/lib/index.js

@@ -8,7 +8,7 @@ import {
   createTrendingRunTool,
   createUpdateService,
   readPluginInfo
-} from "./chunk-WDBZAMWN.js";
+} from "./chunk-VF6DOIQQ.js";
 import "./chunk-R7BK7SJK.js";
 
 // src/index.ts

package/lib/internal.d.ts

@@ -1,4 +1,4 @@
-import { ErrorCode, FileArtifact, Usage, ReleasesReport, ErrorInfo, RunRequest, RunResult, State, StateRun, SubscriptionList } from '@morehao/trendradar-contract';
+import { ErrorCode, FileArtifact, Usage, ReleasesReport, SubscriptionItem, SubscriptionDoc, SubscriptionStatus, ErrorInfo, RunRequest, RunResult, State, StateRun, SubscriptionList, SubscriptionVolume } from '@morehao/trendradar-contract';
 import http from 'node:http';
 import { Updater, PluginMeta, Logger } from '@morehao/dsh-plugin-kit/update';
 
@@ -112,40 +112,6 @@ interface RunOutcome {
     durationMs: number;
     coreVersion: string;
 }
-/**
- * 契约 0.4.0（核心 0.7.0）新增的 wire 类型。
- *
- * 契约包尚未发布：npm 上的 `@morehao/trendradar-contract` 还停在 0.3.0，
- * 因此这三块按 `contract/schema/releases.v2.json` 原样在本地声明，等 0.4.0 发布后
- * 改回 `@morehao/trendradar-contract` 的 `import type`。除这里列出的字段外，
- * 不补任何契约里没有的东西——本地声明只是「包还没发」的临时载体，不是第二份契约。
- */
-type SubscriptionStatus = 'baseline' | 'ok' | 'no_change' | 'rate_limited' | 'failed';
-/** 订阅表的一行：只放列表展示需要的字段，正文在 `SubscriptionDoc` 里（首屏体积预算）。 */
-interface SubscriptionItem {
-    fullName: string;
-    url?: string;
-    latestTag?: string;
-    latestSummaryAt?: string;
-    lastCheckedAt?: string;
-    status: SubscriptionStatus;
-}
-/** 发版文档的一卷：每册都带两位序号，index N 是 `<repo>-0N.md`（第 1 册是 `-01`）。 */
-interface SubscriptionVolume {
-    index: number;
-    file: string;
-    from?: string;
-    to?: string;
-    lines?: number;
-}
-/** 一个仓库某卷的发版文档；`markdown` 是文件原文，面板逐字渲染、不再二次摘要。 */
-interface SubscriptionDoc {
-    fullName: string;
-    volume: number;
-    volumes?: SubscriptionVolume[];
-    updatedAt?: string;
-    markdown: string;
-}
 declare function isSubscriptionStatus(value: unknown): value is SubscriptionStatus;
 /**
  * `SubscriptionDoc` 的运行时守卫：缺 fullName/volume/markdown 的负载宁可抛
@@ -221,11 +187,11 @@ declare const ipc_State: typeof State;
 declare const ipc_StateRun: typeof StateRun;
 type ipc_SubscribeAction = SubscribeAction;
 type ipc_SubscribeOutcome = SubscribeOutcome;
-type ipc_SubscriptionDoc = SubscriptionDoc;
-type ipc_SubscriptionItem = SubscriptionItem;
+declare const ipc_SubscriptionDoc: typeof SubscriptionDoc;
+declare const ipc_SubscriptionItem: typeof SubscriptionItem;
 declare const ipc_SubscriptionList: typeof SubscriptionList;
-type ipc_SubscriptionStatus = SubscriptionStatus;
-type ipc_SubscriptionVolume = SubscriptionVolume;
+declare const ipc_SubscriptionStatus: typeof SubscriptionStatus;
+declare const ipc_SubscriptionVolume: typeof SubscriptionVolume;
 declare const ipc_Usage: typeof Usage;
 type ipc_VersionInfo = VersionInfo;
 declare const ipc_isSubscriptionDoc: typeof isSubscriptionDoc;
@@ -236,7 +202,7 @@ declare const ipc_parseRunResult: typeof parseRunResult;
 declare const ipc_parseSubscribeResult: typeof parseSubscribeResult;
 declare const ipc_parseVersionInfo: typeof parseVersionInfo;
 declare namespace ipc {
-  export { ipc_ErrorCode as ErrorCode, ipc_ErrorInfo as ErrorInfo, ipc_FileArtifact as FileArtifact, ipc_IPC_SCHEMA_VERSION as IPC_SCHEMA_VERSION, ipc_IpcError as IpcError, type ipc_ParseRunOptions as ParseRunOptions, ipc_ReleasesReport as ReleasesReport, type ipc_RunError as RunError, type ipc_RunOutcome as RunOutcome, ipc_RunRequest as RunRequest, ipc_RunResult as RunResult, ipc_SUPPORTED_CONTRACT_MAJOR as SUPPORTED_CONTRACT_MAJOR, ipc_SUPPORTED_DIGEST_SCHEMA as SUPPORTED_DIGEST_SCHEMA, ipc_State as State, ipc_StateRun as StateRun, type ipc_SubscribeAction as SubscribeAction, type ipc_SubscribeOutcome as SubscribeOutcome, type ipc_SubscriptionDoc as SubscriptionDoc, type ipc_SubscriptionItem as SubscriptionItem, ipc_SubscriptionList as SubscriptionList, type ipc_SubscriptionStatus as SubscriptionStatus, type ipc_SubscriptionVolume as SubscriptionVolume, ipc_Usage as Usage, type ipc_VersionInfo as VersionInfo, ipc_isSubscriptionDoc as isSubscriptionDoc, ipc_isSubscriptionStatus as isSubscriptionStatus, ipc_isVersionInfo as isVersionInfo, ipc_parseJsonObject as parseJsonObject, ipc_parseRunResult as parseRunResult, ipc_parseSubscribeResult as parseSubscribeResult, ipc_parseVersionInfo as parseVersionInfo };
+  export { ipc_ErrorCode as ErrorCode, ipc_ErrorInfo as ErrorInfo, ipc_FileArtifact as FileArtifact, ipc_IPC_SCHEMA_VERSION as IPC_SCHEMA_VERSION, ipc_IpcError as IpcError, type ipc_ParseRunOptions as ParseRunOptions, ipc_ReleasesReport as ReleasesReport, type ipc_RunError as RunError, type ipc_RunOutcome as RunOutcome, ipc_RunRequest as RunRequest, ipc_RunResult as RunResult, ipc_SUPPORTED_CONTRACT_MAJOR as SUPPORTED_CONTRACT_MAJOR, ipc_SUPPORTED_DIGEST_SCHEMA as SUPPORTED_DIGEST_SCHEMA, ipc_State as State, ipc_StateRun as StateRun, type ipc_SubscribeAction as SubscribeAction, type ipc_SubscribeOutcome as SubscribeOutcome, ipc_SubscriptionDoc as SubscriptionDoc, ipc_SubscriptionItem as SubscriptionItem, ipc_SubscriptionList as SubscriptionList, ipc_SubscriptionStatus as SubscriptionStatus, ipc_SubscriptionVolume as SubscriptionVolume, ipc_Usage as Usage, type ipc_VersionInfo as VersionInfo, ipc_isSubscriptionDoc as isSubscriptionDoc, ipc_isSubscriptionStatus as isSubscriptionStatus, ipc_isVersionInfo as isVersionInfo, ipc_parseJsonObject as parseJsonObject, ipc_parseRunResult as parseRunResult, ipc_parseSubscribeResult as parseSubscribeResult, ipc_parseVersionInfo as parseVersionInfo };
 }
 
 type Provider = string;
@@ -589,6 +555,8 @@ interface RunRecord {
     errorReason?: string;
     /** 跳过原因：merged / pr-closed / unchanged。 */
     skipReason?: string;
+    /** 本次是显式「强制重跑（忽略缓存）」；调度永不置位。仅用于展示与区分幂等。 */
+    forced?: boolean;
     durationMs: number;
     files: number;
     /** 运行所属的调度时区日期（YYYY-MM-DD）；旧记录可能没有。 */
@@ -1007,6 +975,8 @@ interface RunCoreOptions {
     dryRun: boolean;
     /** 谁触发的运行：核心用它在定时运行时尊重「人工关闭的 PR」。 */
     trigger?: 'manual' | 'schedule';
+    /** 忽略摘要缓存、强制重新生成（核心 `run --force`）；不影响 append-only 提交判断。 */
+    force?: boolean;
     /** 回环代理地址：覆盖配置里的 model.baseURL（代理模式专用）。 */
     baseURLOverride?: string;
     /**
@@ -1033,6 +1003,7 @@ declare function buildCoreArgs(channelPath: string, options: {
     date?: string;
     period?: Period;
     stages?: string[];
+    force?: boolean;
 }): string[];
 declare function runCore(options: RunCoreOptions): Promise<RunCoreResult>;
 
@@ -1470,6 +1441,11 @@ declare namespace pendingPr {
   export { type pendingPr_CheckPendingPrOptions as CheckPendingPrOptions, type pendingPr_ParsedPullUrl as ParsedPullUrl, type pendingPr_PendingPrStatus as PendingPrStatus, type pendingPr_PullState as PullState, pendingPr_checkPendingPr as checkPendingPr, pendingPr_clearPendingPrCache as clearPendingPrCache, pendingPr_parsePullUrl as parsePullUrl };
 }
 
+/**
+ * 支持 `run --force`（忽略摘要缓存重新生成）的最低核心版本。
+ * 与 core patch 发版 `0.7.1` 对齐；`dsh.core.version` 应 >= 它，dev override 指向更旧核心时靠闸门降级。
+ */
+declare const FORCE_MIN_CORE_VERSION = "0.7.1";
 interface RunSummary {
     id: string;
     ok: boolean;
@@ -1488,6 +1464,8 @@ interface RunSummary {
     preview?: PreviewMeta;
     /** 核心给出的跳过原因（merged / pr-closed / unchanged）。 */
     skipReason?: string;
+    /** 本次是显式「强制重跑（忽略缓存）」；调度永不置位。 */
+    forced?: boolean;
     error?: {
         code: string;
         message: string;
@@ -1515,6 +1493,8 @@ interface RunRequestOptions {
     date?: string;
     /** 标的周期；缺省取 settings.trending.since（手动/工具运行）。 */
     period?: Period;
+    /** 强制重跑：忽略摘要缓存、重新生成（核心 `run --force`）；仅手动/工具触发，调度永不设置。 */
+    force?: boolean;
     trigger: 'manual' | 'schedule' | 'tool';
 }
 interface RunnerDeps {
@@ -1611,6 +1591,7 @@ declare class Runner {
     coreStatus(fresh?: boolean): Promise<CoreStatus>;
 }
 
+declare const runner_FORCE_MIN_CORE_VERSION: typeof FORCE_MIN_CORE_VERSION;
 type runner_RunRequestOptions = RunRequestOptions;
 type runner_RunSummary = RunSummary;
 type runner_Runner = Runner;
@@ -1620,7 +1601,7 @@ declare const runner_isoWeekName: typeof isoWeekName;
 declare const runner_periodFileBase: typeof periodFileBase;
 declare const runner_projectUsage: typeof projectUsage;
 declare namespace runner {
-  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, runner_projectUsage as projectUsage };
+  export { runner_FORCE_MIN_CORE_VERSION as FORCE_MIN_CORE_VERSION, 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, runner_projectUsage as projectUsage };
 }
 
 /** 订阅命令超时：核心只做一次 GitHub 请求/本地文件读写，8 s 足够。 */
@@ -1803,6 +1784,23 @@ declare namespace schedule {
   export { schedule_RELEASE_CATCH_UP_MINUTES as RELEASE_CATCH_UP_MINUTES, type schedule_ReleaseScheduleConfig as ReleaseScheduleConfig, 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_isReleaseDue as isReleaseDue, schedule_isoWeekKey as isoWeekKey, schedule_nextOccurrence as nextOccurrence, schedule_nextOccurrenceFor as nextOccurrenceFor, schedule_nextReleaseOccurrence as nextReleaseOccurrence, schedule_parseClock as parseClock, schedule_zonedDateString as zonedDateString, schedule_zonedTimeToUtc as zonedTimeToUtc };
 }
 
+/**
+ * 版本比较：只用于「核心是否足够新到支持某个 CLI flag」这类能力闸门。
+ *
+ * 核心的 `version --json` 只给 `x.y.z`（偶带预发布后缀），这里按三段数字比较，
+ * 后缀忽略。不做完整 semver 区间——项目只需要「>= 阈值」这一种判断，够用且不易错。
+ */
+/**
+ * `a >= b` 时返回 true。任一方不可解析时返回 false（保守：当作「不满足」，
+ * 让调用方降级为不带新 flag 的行为，避免向旧核心传未知参数）。
+ */
+declare function versionAtLeast(a: string, b: string): boolean;
+
+declare const version_versionAtLeast: typeof versionAtLeast;
+declare namespace version {
+  export { version_versionAtLeast as versionAtLeast };
+}
+
 /**
  * Host HTTP 面：`/api/morehao/github-trending/*`。
  *
@@ -1909,6 +1907,10 @@ declare function createTrendingRunTool(runner: Runner): {
             enum: string[];
             description: string;
         };
+        force: {
+            type: string;
+            description: string;
+        };
     };
     output: {
         schema: {
@@ -1927,6 +1929,9 @@ declare function createTrendingRunTool(runner: Runner): {
                 readonly dryRun: {
                     readonly type: "boolean";
                 };
+                readonly forced: {
+                    readonly type: "boolean";
+                };
                 readonly durationMs: {
                     readonly type: "number";
                 };
@@ -1977,6 +1982,7 @@ declare function createTrendingRunTool(runner: Runner): {
         dryRun?: boolean;
         date?: string;
         period?: string;
+        force?: boolean;
     }, exec?: {
         signal?: AbortSignal;
     }): Promise<{
@@ -1986,6 +1992,9 @@ declare function createTrendingRunTool(runner: Runner): {
         errorHint?: string | undefined;
         warnings: string[];
         tokens: number;
+        durationMs: number;
+        files: number;
+        forced?: boolean | undefined;
         ok: boolean;
         summaries: {
             errorCode?: string | undefined;
@@ -1994,19 +2003,18 @@ declare function createTrendingRunTool(runner: Runner): {
             branch?: string | undefined;
             releases?: ReleasesSummary | undefined;
             tokens?: number | undefined;
+            durationMs: number;
+            files: number;
+            forced?: boolean | undefined;
             id: string;
             period: Period | undefined;
             ok: boolean;
             skipped: boolean;
             dryRun: boolean;
-            durationMs: number;
-            files: number;
         }[];
         id: string | undefined;
         skipped: boolean;
         dryRun: boolean;
-        durationMs: number;
-        files: number;
     } | {
         markdown: string;
         errorCode?: string | undefined;
@@ -2014,6 +2022,9 @@ declare function createTrendingRunTool(runner: Runner): {
         errorHint?: string | undefined;
         warnings: string[];
         tokens?: undefined;
+        durationMs: number;
+        files: number;
+        forced?: boolean | undefined;
         ok: boolean;
         summaries: {
             errorCode?: string | undefined;
@@ -2022,19 +2033,18 @@ declare function createTrendingRunTool(runner: Runner): {
             branch?: string | undefined;
             releases?: ReleasesSummary | undefined;
             tokens?: number | undefined;
+            durationMs: number;
+            files: number;
+            forced?: boolean | undefined;
             id: string;
             period: Period | undefined;
             ok: boolean;
             skipped: boolean;
             dryRun: boolean;
-            durationMs: number;
-            files: number;
         }[];
         id: string | undefined;
         skipped: boolean;
         dryRun: boolean;
-        durationMs: number;
-        files: number;
     }>;
 };
 declare function createTrendingHistoryTool(store: Store, scheduler: Scheduler): {
@@ -2138,4 +2148,4 @@ declare namespace tools {
   export { tools_createTrendingHistoryTool as createTrendingHistoryTool, tools_createTrendingRunTool as createTrendingRunTool };
 }
 
-export { channel, config, core, credentials, errors, exec, github, handshake$1 as handshake, importCli, ipc, locate, paths, pendingPr, pluginInfo, preflight, proxy, quickfill, release, repo, routes, run, runner, schedule, state, subscribe, tools, update as updateService };
+export { channel, config, core, credentials, errors, exec, github, handshake$1 as handshake, importCli, ipc, locate, paths, pendingPr, pluginInfo, preflight, proxy, quickfill, release, repo, routes, run, runner, schedule, state, subscribe, tools, update as updateService, version };

package/lib/internal.js

@@ -24,8 +24,9 @@ import {
   state_exports,
   subscribe_exports,
   tools_exports,
-  update_exports
-} from "./chunk-WDBZAMWN.js";
+  update_exports,
+  version_exports
+} from "./chunk-VF6DOIQQ.js";
 import {
   exec_exports
 } from "./chunk-R7BK7SJK.js";
@@ -56,5 +57,6 @@ export {
   state_exports as state,
   subscribe_exports as subscribe,
   tools_exports as tools,
-  update_exports as updateService
+  update_exports as updateService,
+  version_exports as version
 };

package/package.json

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