@morehao/dsh-github-trending 0.6.1 → 0.7.1

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

@@ -1611,6 +1611,8 @@ 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");
+  if (options.repo !== void 0 && options.repo !== "") args.push("--repo", options.repo);
   return args;
 }
 async function runCore(options) {
@@ -1625,7 +1627,9 @@ async function runCore(options) {
     dryRun: options.dryRun,
     date: options.date,
     period: options.period,
-    stages: options.stages
+    stages: options.stages,
+    force: options.force,
+    ...options.repo === void 0 ? {} : { repo: options.repo }
   });
   const child = spawn2(options.core.path, args, {
     env: sanitizedEnv(process.env, {
@@ -2722,9 +2726,34 @@ 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,
+  REPO_MIN_CORE_VERSION: () => REPO_MIN_CORE_VERSION,
   Runner: () => Runner,
   isoWeekName: () => isoWeekName,
   periodFileBase: () => periodFileBase,
@@ -2733,6 +2762,8 @@ __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";
+var REPO_MIN_CORE_VERSION = "0.8.0";
 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 +2882,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 +2908,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 +2925,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 +2934,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);
@@ -2971,6 +3014,7 @@ var Runner = class {
     this.active = { id, controller, startedAt };
     const logFile = store.newLogPath(id);
     let proxy;
+    const requestedRepo = options.repo !== void 0 && options.repo !== "" ? options.repo : void 0;
     try {
       const core = await locateCore({ settings, env, allowDownload: settings.coreAutoDownload });
       if (core.downloaded === true) {
@@ -2983,6 +3027,14 @@ var Runner = class {
           `\u6838\u5FC3\u4E0D\u652F\u6301 provider\u300C${settings.model.provider}\u300D\uFF1B\u53EF\u7528\uFF1A${handshakeResult.supportedProviders.join(" / ")}`
         );
       }
+      let effectiveRepo = requestedRepo;
+      if (requestedRepo !== void 0 && !versionAtLeast(handshakeResult.version.version, REPO_MIN_CORE_VERSION)) {
+        store.appendLog(
+          logFile,
+          `[release] \u6838\u5FC3 ${handshakeResult.version.version} \u4F4E\u4E8E ${REPO_MIN_CORE_VERSION}\uFF0C\u5355\u4ED3\u5206\u6790\u964D\u7EA7\u4E3A\u5168\u91CF`
+        );
+        effectiveRepo = void 0;
+      }
       const model = await this.openModelChannel({ settings, credentials, env, logFile });
       proxy = model.proxy;
       const github = await resolveGithubToken(credentials, settings.github.authMode, settings.github.tokenRef, { env });
@@ -3002,6 +3054,7 @@ var Runner = class {
         dryRun: false,
         trigger: options.trigger === "schedule" ? "schedule" : "manual",
         stages: ["releases"],
+        ...effectiveRepo === void 0 ? {} : { repo: effectiveRepo },
         repoCount,
         ...model.baseURLOverride === void 0 ? {} : { baseURLOverride: model.baseURLOverride },
         signal: controller.signal,
@@ -3014,11 +3067,12 @@ var Runner = class {
         settings,
         startedAt,
         logFile,
-        cancelled: controller.signal.aborted
+        cancelled: controller.signal.aborted,
+        ...requestedRepo === void 0 ? {} : { scopeRepo: requestedRepo }
       });
     } catch (error) {
       const aborted = controller.signal.aborted || error instanceof IpcError && error.code === "CORE_CANCELLED";
-      return this.recordReleaseFailure({ id, error, aborted, settings, startedAt, startedMs, logFile });
+      return this.recordReleaseFailure({ id, error, aborted, settings, startedAt, startedMs, logFile, ...requestedRepo === void 0 ? {} : { scopeRepo: requestedRepo } });
     } finally {
       if (proxy !== void 0) {
         const port = proxy.port;
@@ -3096,9 +3150,10 @@ var Runner = class {
       ...outcome.prUrl === void 0 ? {} : { prUrl: outcome.prUrl },
       ...outcome.branch === void 0 ? {} : { branch: outcome.branch },
       ...outcome.error === void 0 ? input.cancelled ? { errorCode: "CORE_CANCELLED", errorMessage: "\u8FD0\u884C\u5DF2\u53D6\u6D88\uFF1A\u6838\u5FC3\u8FDB\u7A0B\u5DF2\u7EC8\u6B62\uFF0C\u672A\u63D0\u4EA4\u4EFB\u4F55\u72B6\u6001" } : {} : { errorCode: outcome.error.code, errorMessage: redact(outcome.error.message) },
-      ...outcome.coreVersion === "" ? {} : { coreVersion: outcome.coreVersion }
+      ...outcome.coreVersion === "" ? {} : { coreVersion: outcome.coreVersion },
+      ...input.scopeRepo === void 0 ? {} : { scopeRepo: input.scopeRepo }
     };
-    this.persistReleaseRun(record, settings, input.logFile);
+    this.persistReleaseRun(record, settings, input.logFile, { advanceWeek: input.scopeRepo === void 0 });
     return record;
   }
   /** 运行在拿到信封之前就失败（定位/握手/模型/代理/超时/取消）：也要留一条可复盘记录。 */
@@ -3119,20 +3174,24 @@ var Runner = class {
       rateLimited: 0,
       durationMs: Date.now() - input.startedMs,
       errorCode: code,
-      errorMessage: message
+      errorMessage: message,
+      ...input.scopeRepo === void 0 ? {} : { scopeRepo: input.scopeRepo }
     };
-    this.persistReleaseRun(record, input.settings, input.logFile);
+    this.persistReleaseRun(record, input.settings, input.logFile, { advanceWeek: input.scopeRepo === void 0 });
     return record;
   }
   /**
    * 落盘发版运行：只写 state（history.json 是榜单的），顺带推进 lastReleaseAt；
    * 只有 ok/skipped 才锁 `lastReleaseWeek`——失败不锁，调度下一 tick 才有机会重试。
+   * `advanceWeek=false`（单仓手动触发）时：仍写 releaseRuns 与 lastReleaseAt，但**不**锁
+   * lastReleaseWeek——否则会把本周标记为已检查，导致周调度跳过本周真正的检查。
    */
-  persistReleaseRun(record, settings, logFile) {
+  persistReleaseRun(record, settings, logFile, opts = {}) {
     const store = this.deps.store;
+    const advanceWeek = opts.advanceWeek !== false;
     const succeeded = record.status === "ok" || record.status === "skipped";
     let week;
-    if (succeeded) {
+    if (succeeded && advanceWeek) {
       try {
         week = isoWeekKey(new Date(record.finishedAt), settings.releases.schedule.timezone);
       } catch {
@@ -3192,7 +3251,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 +3283,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 +3355,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 +3381,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,
@@ -3994,7 +4058,10 @@ function createRoutes(deps) {
       const code = error instanceof IpcError ? error.code : "INTERNAL";
       const message = redact(error instanceof Error ? error.message : String(error));
       deps.logger?.("route.error", { pathname, method, code, message });
-      const status = code === "CONFIG_INVALID" ? 400 : code === "NOT_FOUND" ? 404 : 500;
+      const status = code === "CONFIG_INVALID" ? (
+        // 「已有一次运行在进行中」是并发冲突而非参数错误：用 409，前端据此禁用按钮并提示。
+        message.includes("\u8FD0\u884C\u5728\u8FDB\u884C\u4E2D") ? 409 : 400
+      ) : code === "NOT_FOUND" ? 404 : 500;
       sendJson2(response, status, { ok: false, code, message });
     }
   };
@@ -4060,6 +4127,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)) {
@@ -4072,6 +4140,18 @@ async function dispatch(method, pathname, url, request, deps) {
   if (method === "POST" && pathname === "/run/cancel") {
     return { cancelled: deps.runner.cancel() };
   }
+  if (method === "POST" && pathname === "/releases/run") {
+    const body = await readBody2(request);
+    let repo;
+    if (body.repo !== void 0) {
+      if (typeof body.repo !== "string" || !isValidRepo(body.repo.trim())) {
+        throw new IpcError("CONFIG_INVALID", `repo \u5FC5\u987B\u662F owner/repo \u5F62\u6001\uFF1A${String(body.repo)}`);
+      }
+      repo = body.repo.trim();
+    }
+    const release = await deps.runner.runReleases({ trigger: "manual", ...repo === void 0 ? {} : { repo } });
+    return { release };
+  }
   if (method === "GET" && pathname === "/repo/branch") {
     const repoPath = url.searchParams.get("path") ?? settings.repo.path;
     return { repo: await readDefaultBranch(repoPath, { env }) };
@@ -4333,6 +4413,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 +4474,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 +4490,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 +4527,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 +4539,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 +4615,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-R3EDPRRO.js";
 import "./chunk-R7BK7SJK.js";
 
 // src/index.ts

package/lib/internal.d.ts

@@ -555,6 +555,8 @@ interface RunRecord {
     errorReason?: string;
     /** 跳过原因：merged / pr-closed / unchanged。 */
     skipReason?: string;
+    /** 本次是显式「强制重跑（忽略缓存）」；调度永不置位。仅用于展示与区分幂等。 */
+    forced?: boolean;
     durationMs: number;
     files: number;
     /** 运行所属的调度时区日期（YYYY-MM-DD）；旧记录可能没有。 */
@@ -629,6 +631,8 @@ interface ReleaseRunRecord {
     errorCode?: string;
     errorMessage?: string;
     coreVersion?: string;
+    /** 单仓手动触发时记录该仓库（owner/repo）；全量运行缺省。仅展示用。 */
+    scopeRepo?: string;
 }
 /** 发版运行记录上限：一周一次的话正好留半年，够复盘又不会让 state.json 膨胀。 */
 declare const RELEASE_RUN_LIMIT = 30;
@@ -973,6 +977,8 @@ interface RunCoreOptions {
     dryRun: boolean;
     /** 谁触发的运行：核心用它在定时运行时尊重「人工关闭的 PR」。 */
     trigger?: 'manual' | 'schedule';
+    /** 忽略摘要缓存、强制重新生成（核心 `run --force`）；不影响 append-only 提交判断。 */
+    force?: boolean;
     /** 回环代理地址：覆盖配置里的 model.baseURL（代理模式专用）。 */
     baseURLOverride?: string;
     /**
@@ -980,6 +986,8 @@ interface RunCoreOptions {
      * `['releases']` 就是「只跑发版订阅」——不抓榜单、不渲染 digest、也不合并订阅 pending。
      */
     stages?: string[];
+    /** 单仓发版分析（核心 `run --stages releases --repo owner/repo`）：只处理该仓库；须与 stages=['releases'] 搭配。 */
+    repo?: string;
     /** 订阅仓库数：用于把配置里的 `auto` 并发/预算解析成数字（发版运行传入）。 */
     repoCount?: number;
     signal?: AbortSignal;
@@ -999,6 +1007,8 @@ declare function buildCoreArgs(channelPath: string, options: {
     date?: string;
     period?: Period;
     stages?: string[];
+    force?: boolean;
+    repo?: string;
 }): string[];
 declare function runCore(options: RunCoreOptions): Promise<RunCoreResult>;
 
@@ -1436,6 +1446,16 @@ 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";
+/**
+ * 支持 `run --stages releases --repo`（单仓发版分析）的最低核心版本。
+ * 与 core v0.8.0 对齐；核心更旧时单仓触发降级为全量（不传 --repo）。
+ */
+declare const REPO_MIN_CORE_VERSION = "0.8.0";
 interface RunSummary {
     id: string;
     ok: boolean;
@@ -1454,6 +1474,8 @@ interface RunSummary {
     preview?: PreviewMeta;
     /** 核心给出的跳过原因（merged / pr-closed / unchanged）。 */
     skipReason?: string;
+    /** 本次是显式「强制重跑（忽略缓存）」；调度永不置位。 */
+    forced?: boolean;
     error?: {
         code: string;
         message: string;
@@ -1481,6 +1503,8 @@ interface RunRequestOptions {
     date?: string;
     /** 标的周期；缺省取 settings.trending.since（手动/工具运行）。 */
     period?: Period;
+    /** 强制重跑：忽略摘要缓存、重新生成（核心 `run --force`）；仅手动/工具触发，调度永不设置。 */
+    force?: boolean;
     trigger: 'manual' | 'schedule' | 'tool';
 }
 interface RunnerDeps {
@@ -1539,6 +1563,7 @@ declare class Runner {
      */
     runReleases(options: {
         trigger: 'manual' | 'schedule';
+        repo?: string;
     }): Promise<ReleaseRunRecord>;
     /** 发版运行用哪一天：发版调度时区下的「今天」（不是榜单调度时区，两者可独立配置）。 */
     private releaseDate;
@@ -1558,6 +1583,8 @@ declare class Runner {
     /**
      * 落盘发版运行：只写 state（history.json 是榜单的），顺带推进 lastReleaseAt；
      * 只有 ok/skipped 才锁 `lastReleaseWeek`——失败不锁，调度下一 tick 才有机会重试。
+     * `advanceWeek=false`（单仓手动触发）时：仍写 releaseRuns 与 lastReleaseAt，但**不**锁
+     * lastReleaseWeek——否则会把本周标记为已检查，导致周调度跳过本周真正的检查。
      */
     private persistReleaseRun;
     private summarize;
@@ -1577,6 +1604,8 @@ declare class Runner {
     coreStatus(fresh?: boolean): Promise<CoreStatus>;
 }
 
+declare const runner_FORCE_MIN_CORE_VERSION: typeof FORCE_MIN_CORE_VERSION;
+declare const runner_REPO_MIN_CORE_VERSION: typeof REPO_MIN_CORE_VERSION;
 type runner_RunRequestOptions = RunRequestOptions;
 type runner_RunSummary = RunSummary;
 type runner_Runner = Runner;
@@ -1586,7 +1615,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, runner_REPO_MIN_CORE_VERSION as REPO_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 足够。 */
@@ -1769,6 +1798,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/*`。
  *
@@ -1875,6 +1921,10 @@ declare function createTrendingRunTool(runner: Runner): {
             enum: string[];
             description: string;
         };
+        force: {
+            type: string;
+            description: string;
+        };
     };
     output: {
         schema: {
@@ -1893,6 +1943,9 @@ declare function createTrendingRunTool(runner: Runner): {
                 readonly dryRun: {
                     readonly type: "boolean";
                 };
+                readonly forced: {
+                    readonly type: "boolean";
+                };
                 readonly durationMs: {
                     readonly type: "number";
                 };
@@ -1943,6 +1996,7 @@ declare function createTrendingRunTool(runner: Runner): {
         dryRun?: boolean;
         date?: string;
         period?: string;
+        force?: boolean;
     }, exec?: {
         signal?: AbortSignal;
     }): Promise<{
@@ -1952,6 +2006,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;
@@ -1960,19 +2017,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;
@@ -1980,6 +2036,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;
@@ -1988,19 +2047,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): {
@@ -2104,4 +2162,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-R3EDPRRO.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.1",
+  "version": "0.7.1",
   "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.4.0"
+    "@morehao/trendradar-contract": "0.5.0"
   },
   "dsh": {
     "bundle": {
@@ -59,7 +59,7 @@
     },
     "core": {
       "repo": "morehao/trendradar",
-      "version": "0.7.0"
+      "version": "0.8.0"
     },
     "client": {
       "platform": "web",