@morehao/dsh-github-trending 0.5.1 → 0.6.0

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

@@ -74,9 +74,14 @@ var DEFAULT_SETTINGS = {
     includeDrafts: false,
     fallbackToTags: true,
     baselineOnFirstRun: true,
-    perRepoLimit: 5,
+    perRepoLimit: 10,
     maxNotesChars: 4e3,
-    period: "daily"
+    summaryMaxChars: 1200,
+    docMaxLines: 600,
+    concurrency: "auto",
+    budgetSeconds: "auto",
+    period: "weekly",
+    schedule: { enabled: true, weekday: 1, time: "08:00:00", timezone: "Asia/Shanghai" }
   },
   output: { dir: "trending" },
   schedule: { enabled: true, time: "08:30:00", timezone: "Asia/Shanghai", periods: ["daily", "weekly", "monthly"] },
@@ -148,6 +153,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 autoNumber(value, fallback) {
+  if (value === "auto") return "auto";
+  if (typeof value === "number" && Number.isFinite(value)) return Math.round(value);
+  return fallback;
+}
 function periodList(_value, _fallback) {
   return [...PERIODS];
 }
@@ -160,6 +170,7 @@ function normalizeSettings(input) {
   const trending = raw.trending ?? {};
   const summarize = raw.summarize ?? {};
   const releases = raw.releases ?? {};
+  const releasesSchedule = releases.schedule ?? {};
   const output = raw.output ?? {};
   const schedule = raw.schedule ?? {};
   const commitMode = str(repo.commitMode, DEFAULT_SETTINGS.repo.commitMode);
@@ -220,7 +231,17 @@ function normalizeSettings(input) {
       baselineOnFirstRun: bool(releases.baselineOnFirstRun, DEFAULT_SETTINGS.releases.baselineOnFirstRun),
       perRepoLimit: Math.round(num(releases.perRepoLimit, DEFAULT_SETTINGS.releases.perRepoLimit)),
       maxNotesChars: Math.round(num(releases.maxNotesChars, DEFAULT_SETTINGS.releases.maxNotesChars)),
-      period: isPeriod(releasesPeriod) ? releasesPeriod : DEFAULT_SETTINGS.releases.period
+      summaryMaxChars: Math.round(num(releases.summaryMaxChars, DEFAULT_SETTINGS.releases.summaryMaxChars)),
+      docMaxLines: Math.round(num(releases.docMaxLines, DEFAULT_SETTINGS.releases.docMaxLines)),
+      concurrency: autoNumber(releases.concurrency, DEFAULT_SETTINGS.releases.concurrency),
+      budgetSeconds: autoNumber(releases.budgetSeconds, DEFAULT_SETTINGS.releases.budgetSeconds),
+      period: isPeriod(releasesPeriod) ? releasesPeriod : DEFAULT_SETTINGS.releases.period,
+      schedule: {
+        enabled: bool(releasesSchedule.enabled, DEFAULT_SETTINGS.releases.schedule.enabled),
+        weekday: Math.round(num(releasesSchedule.weekday, DEFAULT_SETTINGS.releases.schedule.weekday)),
+        time: str(releasesSchedule.time, DEFAULT_SETTINGS.releases.schedule.time),
+        timezone: str(releasesSchedule.timezone, DEFAULT_SETTINGS.releases.schedule.timezone)
+      }
     },
     output: {
       dir: str(output.dir, DEFAULT_SETTINGS.output.dir).trim() || DEFAULT_SETTINGS.output.dir
@@ -245,6 +266,10 @@ function isValidTimezone(timezone) {
     return false;
   }
 }
+function autoInRange(value, min, max) {
+  if (value === "auto") return true;
+  return Number.isInteger(value) && value >= min && value <= max;
+}
 function validateSettings(settings, providers = CORE_PROVIDERS) {
   const problems = [];
   const { model, repo, trending, summarize, releases, output, schedule } = settings;
@@ -298,8 +323,12 @@ function validateSettings(settings, providers = CORE_PROVIDERS) {
   if (!Number.isInteger(summarize.readmeChars) || summarize.readmeChars <= 0) {
     problems.push({ field: "summarize.readmeChars", code: "CONFIG_INVALID", message: "readmeChars \u5FC5\u987B\u662F\u6B63\u6574\u6570" });
   }
-  if (!isPeriod(releases.period)) {
-    problems.push({ field: "releases.period", code: "CONFIG_INVALID", message: "releases.period \u5FC5\u987B\u662F daily / weekly / monthly" });
+  if (releases.period !== "weekly") {
+    problems.push({
+      field: "releases.period",
+      code: "CONFIG_INVALID",
+      message: "\u672C\u7248\u672C\u53EA\u652F\u6301\u6BCF\u5468\uFF08weekly\uFF09\u53D1\u7248\u6458\u8981\uFF0C\u8BF7\u628A releases.period \u6539\u4E3A weekly"
+    });
   }
   if (!Number.isInteger(releases.perRepoLimit) || releases.perRepoLimit < 1 || releases.perRepoLimit > 20) {
     problems.push({ field: "releases.perRepoLimit", code: "CONFIG_INVALID", message: "perRepoLimit \u5FC5\u987B\u662F 1\u201320 \u7684\u6574\u6570" });
@@ -307,6 +336,27 @@ function validateSettings(settings, providers = CORE_PROVIDERS) {
   if (!Number.isInteger(releases.maxNotesChars) || releases.maxNotesChars < 500 || releases.maxNotesChars > 2e4) {
     problems.push({ field: "releases.maxNotesChars", code: "CONFIG_INVALID", message: "maxNotesChars \u5FC5\u987B\u662F 500\u201320000 \u7684\u6574\u6570" });
   }
+  if (!Number.isInteger(releases.summaryMaxChars) || releases.summaryMaxChars < 500 || releases.summaryMaxChars > 2e3) {
+    problems.push({ field: "releases.summaryMaxChars", code: "CONFIG_INVALID", message: "summaryMaxChars \u5FC5\u987B\u662F 500\u20132000 \u7684\u6574\u6570" });
+  }
+  if (!Number.isInteger(releases.docMaxLines) || releases.docMaxLines < 100 || releases.docMaxLines > 2e3) {
+    problems.push({ field: "releases.docMaxLines", code: "CONFIG_INVALID", message: "docMaxLines \u5FC5\u987B\u662F 100\u20132000 \u7684\u6574\u6570" });
+  }
+  if (!autoInRange(releases.concurrency, 1, 8)) {
+    problems.push({ field: "releases.concurrency", code: "CONFIG_INVALID", message: "concurrency \u5FC5\u987B\u662F auto \u6216 1\u20138 \u7684\u6574\u6570" });
+  }
+  if (!autoInRange(releases.budgetSeconds, 1, 300)) {
+    problems.push({ field: "releases.budgetSeconds", code: "CONFIG_INVALID", message: "budgetSeconds \u5FC5\u987B\u662F auto \u6216 1\u2013300 \u7684\u6574\u6570" });
+  }
+  if (!Number.isInteger(releases.schedule.weekday) || releases.schedule.weekday < 1 || releases.schedule.weekday > 7) {
+    problems.push({ field: "releases.schedule.weekday", code: "CONFIG_INVALID", message: "\u53D1\u7248\u65E5\u5FC5\u987B\u662F ISO \u661F\u671F 1\u20137\uFF081=\u5468\u4E00\uFF09" });
+  }
+  if (!TIME_RE.test(releases.schedule.time)) {
+    problems.push({ field: "releases.schedule.time", code: "CONFIG_INVALID", message: "\u65F6\u95F4\u683C\u5F0F\u5FC5\u987B\u662F HH:MM \u6216 HH:MM:SS" });
+  }
+  if (!isValidTimezone(releases.schedule.timezone)) {
+    problems.push({ field: "releases.schedule.timezone", code: "CONFIG_INVALID", message: "\u65F6\u533A\u5FC5\u987B\u662F IANA \u540D\u79F0\uFF08\u5982 Asia/Shanghai\uFF09" });
+  }
   if (output.dir.trim() === "" || path.isAbsolute(output.dir) || output.dir.split(/[\\/]/).includes("..")) {
     problems.push({ field: "output.dir", code: "CONFIG_INVALID", message: "\u8F93\u51FA\u76EE\u5F55\u5FC5\u987B\u662F\u4ED3\u5E93\u5185\u7684\u76F8\u5BF9\u8DEF\u5F84\uFF0C\u4E14\u4E0D\u542B .." });
   }
@@ -321,7 +371,11 @@ function validateSettings(settings, providers = CORE_PROVIDERS) {
 function effectiveBaseURL(model) {
   return model.baseURL !== "" ? model.baseURL : PROVIDER_BASE_URLS[model.provider] ?? "";
 }
-function toCoreConfig(settings, apiKey, baseURLOverride, period) {
+function toCoreConfig(settings, apiKey, baseURLOverride, period, repoCount = 0) {
+  const releases = settings.releases;
+  const repoTotal = Number.isFinite(repoCount) && repoCount > 0 ? Math.floor(repoCount) : 0;
+  const concurrency = releases.concurrency === "auto" ? Math.min(8, Math.max(4, Math.ceil(repoTotal / 10))) : releases.concurrency;
+  const budgetSeconds = releases.budgetSeconds === "auto" ? Math.min(300, 30 + 3 * repoTotal) : releases.budgetSeconds;
   const config = {
     model: {
       provider: settings.model.provider,
@@ -363,13 +417,21 @@ function toCoreConfig(settings, apiKey, baseURLOverride, period) {
     releases: {
       // 发版订阅常开：插件侧不再提供开关，是否产出由订阅列表决定。
       enabled: true,
-      includePrerelease: settings.releases.includePrerelease,
-      includeDrafts: settings.releases.includeDrafts,
-      fallbackToTags: settings.releases.fallbackToTags,
-      baselineOnFirstRun: settings.releases.baselineOnFirstRun,
-      perRepoLimit: settings.releases.perRepoLimit,
-      maxNotesChars: settings.releases.maxNotesChars,
-      period: settings.releases.period
+      includePrerelease: releases.includePrerelease,
+      includeDrafts: releases.includeDrafts,
+      fallbackToTags: releases.fallbackToTags,
+      baselineOnFirstRun: releases.baselineOnFirstRun,
+      perRepoLimit: releases.perRepoLimit,
+      maxNotesChars: releases.maxNotesChars,
+      summaryMaxChars: releases.summaryMaxChars,
+      docMaxLines: releases.docMaxLines,
+      // 核心按这个时区切 ISO 周；必须与插件侧 lastReleaseWeek 的去重口径一致。
+      timezone: releases.schedule.timezone,
+      weekStart: "monday",
+      concurrency,
+      budgetSeconds,
+      // 核心只实现每周一次；非法值在校验阶段已拦下，这里不再透传枚举。
+      period: "weekly"
     },
     output: {
       dir: settings.output.dir,
@@ -448,6 +510,7 @@ __export(state_exports, {
   HISTORY_LIMIT: () => HISTORY_LIMIT,
   PREVIEW_LIMIT: () => PREVIEW_LIMIT,
   PREVIEW_MAX_BYTES: () => PREVIEW_MAX_BYTES,
+  RELEASE_RUN_LIMIT: () => RELEASE_RUN_LIMIT,
   Store: () => Store,
   newRunId: () => newRunId,
   sumTokens: () => sumTokens,
@@ -460,6 +523,7 @@ var PREVIEW_LIMIT = 90;
 var PREVIEW_MAX_BYTES = 512 * 1024;
 var CONTENT_HASH_ALGO_V2 = "jcs-sha256-v1";
 var V2_CORE_MIN = [0, 3, 0];
+var RELEASE_RUN_LIMIT = 30;
 function readJson(file, fallback) {
   try {
     const text = readFileSync(file, "utf8");
@@ -488,6 +552,11 @@ function coreVersionIsV2(coreVersion) {
 function digestIsV2(digest) {
   return digest !== void 0 && digest.contentHashAlgo === CONTENT_HASH_ALGO_V2 && coreVersionIsV2(digest.coreVersion);
 }
+function isReleaseRunRecord(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const record = value;
+  return typeof record.id === "string" && typeof record.startedAt === "string" && typeof record.finishedAt === "string" && (record.status === "ok" || record.status === "failed" || record.status === "skipped" || record.status === "cancelled");
+}
 function normalizeState(state) {
   const next = { ...state };
   if (next.lastDigest !== void 0 && !digestIsV2(next.lastDigest)) {
@@ -582,6 +651,21 @@ var Store = class {
     const state = this.readState();
     this.writeState({ ...state, ...next, lastResult: record });
   }
+  /**
+   * 记录一次发版运行：只写 `state.json`（不发版记录进 `history.json`，两者节奏不同）。
+   * 记录裁剪到 RELEASE_RUN_LIMIT 条，`next` 用来顺带更新 lastReleaseAt/lastReleaseWeek。
+   */
+  appendReleaseRun(record, next = {}) {
+    const state = this.readState();
+    const runs = [record, ...Array.isArray(state.releaseRuns) ? state.releaseRuns : []].slice(0, RELEASE_RUN_LIMIT);
+    this.writeState({ ...state, ...next, releaseRuns: runs });
+  }
+  /** 读发版运行记录；缺失/损坏（不是数组或行不是对象）一律按空数组处理，不让界面崩。 */
+  readReleaseRuns() {
+    const state = this.readState();
+    if (!Array.isArray(state.releaseRuns)) return [];
+    return state.releaseRuns.filter(isReleaseRunRecord);
+  }
   newLogPath(id) {
     ensureDir(this.logsPath);
     return path3.join(this.logsPath, `${id}.log`);
@@ -911,6 +995,8 @@ __export(ipc_exports, {
   IpcError: () => IpcError,
   SUPPORTED_CONTRACT_MAJOR: () => SUPPORTED_CONTRACT_MAJOR,
   SUPPORTED_DIGEST_SCHEMA: () => SUPPORTED_DIGEST_SCHEMA,
+  isSubscriptionDoc: () => isSubscriptionDoc,
+  isSubscriptionStatus: () => isSubscriptionStatus,
   isVersionInfo: () => isVersionInfo,
   parseJsonObject: () => parseJsonObject,
   parseRunResult: () => parseRunResult,
@@ -921,6 +1007,17 @@ import { validators } from "@morehao/trendradar-contract";
 var IPC_SCHEMA_VERSION = 2;
 var SUPPORTED_DIGEST_SCHEMA = 2;
 var SUPPORTED_CONTRACT_MAJOR = 0;
+var SUBSCRIPTION_STATUSES = ["baseline", "ok", "no_change", "rate_limited", "failed"];
+function isSubscriptionStatus(value) {
+  return typeof value === "string" && SUBSCRIPTION_STATUSES.includes(value);
+}
+function isSubscriptionDoc(value) {
+  if (!isRecord(value)) return false;
+  return typeof value.fullName === "string" && value.fullName !== "" && typeof value.volume === "number" && Number.isInteger(value.volume) && value.volume >= 1 && typeof value.markdown === "string";
+}
+function isSubscriptionItem(value) {
+  return isRecord(value) && typeof value.fullName === "string" && value.fullName !== "" && isSubscriptionStatus(value.status);
+}
 var IpcError = class extends Error {
   code;
   constructor(code, message) {
@@ -996,6 +1093,16 @@ function timing(options) {
   return { startedAt: options.startedAt, finishedAt: options.finishedAt, durationMs: options.durationMs };
 }
 var REPO_PATTERN = /^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/;
+function parseSubscriptionList(value) {
+  if (!isRecord(value)) throw new IpcError("IPC_INVALID", "\u6838\u5FC3 subscribe \u8FD4\u56DE\u7684 subscriptions \u4E0D\u662F\u5BF9\u8C61");
+  const rawRepos = value.repos;
+  if (!Array.isArray(rawRepos) || rawRepos.some((item) => typeof item !== "string")) {
+    throw new IpcError("IPC_INVALID", "\u6838\u5FC3 subscribe \u8FD4\u56DE\u7684 subscriptions.repos \u4E0D\u662F\u5B57\u7B26\u4E32\u6570\u7EC4");
+  }
+  const repos = rawRepos.filter((item) => typeof item === "string");
+  const items = Array.isArray(value.items) ? value.items.filter(isSubscriptionItem) : void 0;
+  return { repos, ...items === void 0 ? {} : { items } };
+}
 function parseSubscribeResult(text) {
   const trimmed = text.trim();
   if (trimmed === "") throw new IpcError("IPC_INVALID", "\u6838\u5FC3 subscribe \u8F93\u51FA\u4E3A\u7A7A");
@@ -1012,15 +1119,24 @@ function parseSubscribeResult(text) {
     throw new IpcError("IPC_INVALID", "\u6838\u5FC3 subscribe --json \u4E0D\u662F\u5951\u7EA6\u4FE1\u5C01\uFF08ipcSchema=2 / ok\uFF09");
   }
   const error = normalizeError(envelope.error);
-  const repos = [];
-  for (const line of lines.slice(0, -1)) {
-    const value = line.trim();
-    if (value === "") continue;
-    if (REPO_PATTERN.test(value)) repos.push(value);
+  const list = envelope.subscriptions === void 0 ? void 0 : parseSubscriptionList(envelope.subscriptions);
+  const doc = envelope.subscriptionDoc;
+  if (doc !== void 0 && !isSubscriptionDoc(doc)) {
+    throw new IpcError("IPC_INVALID", "\u6838\u5FC3 subscribe \u8FD4\u56DE\u7684 subscriptionDoc \u4E0D\u662F\u5951\u7EA6 SubscriptionDoc\uFF08fullName/volume/markdown\uFF09");
+  }
+  const repos = list?.repos ?? [];
+  if (list === void 0) {
+    for (const line of lines.slice(0, -1)) {
+      const value = line.trim();
+      if (value === "") continue;
+      if (REPO_PATTERN.test(value)) repos.push(value);
+    }
   }
   return {
     ok: envelope.ok === true,
     repos,
+    ...list?.items === void 0 ? {} : { items: list.items },
+    ...doc === void 0 ? {} : { doc },
     ...error === void 0 ? {} : { error }
   };
 }
@@ -1494,6 +1610,7 @@ function buildCoreArgs(channelPath, options) {
   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);
+  if (options.stages !== void 0 && options.stages.length > 0) args.push("--stages", options.stages.join(","));
   return args;
 }
 async function runCore(options) {
@@ -1501,10 +1618,16 @@ 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, options.period))}
+  const yaml = `${toYaml(toCoreConfig(options.settings, options.apiKey, options.baseURLOverride, options.period, options.repoCount))}
 `;
   const secrets = [options.apiKey, options.token, ...options.secrets ?? []];
-  const child = spawn2(options.core.path, buildCoreArgs(channel.path, { dryRun: options.dryRun, date: options.date, period: options.period }), {
+  const args = buildCoreArgs(channel.path, {
+    dryRun: options.dryRun,
+    date: options.date,
+    period: options.period,
+    stages: options.stages
+  });
+  const child = spawn2(options.core.path, args, {
     env: sanitizedEnv(process.env, {
       GITHUB_TOKEN: options.token,
       GH_TOKEN: options.token,
@@ -2154,18 +2277,23 @@ function authorized(request, token) {
 // src/host/schedule.ts
 var schedule_exports = {};
 __export(schedule_exports, {
+  RELEASE_CATCH_UP_MINUTES: () => RELEASE_CATCH_UP_MINUTES,
   Scheduler: () => Scheduler,
   daysInMonth: () => daysInMonth,
   isDue: () => isDue,
   isPeriodTriggerDay: () => isPeriodTriggerDay,
+  isReleaseDue: () => isReleaseDue,
+  isoWeekKey: () => isoWeekKey,
   nextOccurrence: () => nextOccurrence,
   nextOccurrenceFor: () => nextOccurrenceFor,
+  nextReleaseOccurrence: () => nextReleaseOccurrence,
   parseClock: () => parseClock,
   zonedDateString: () => zonedDateString,
   zonedTimeToUtc: () => zonedTimeToUtc
 });
 var MINUTE = 6e4;
 var CATCH_UP_MINUTES = 6 * 60;
+var RELEASE_CATCH_UP_MINUTES = 6 * 60;
 var MAX_ATTEMPTS_PER_DAY = 2;
 var RETRY_GAP_MS = 5 * MINUTE;
 function partsOf(date, timezone) {
@@ -2239,6 +2367,50 @@ function isDue(now, schedule) {
   const late = nowMinutes - targetMinutes;
   return late >= 0 && late <= CATCH_UP_MINUTES;
 }
+function isoWeekOf(year, month, day) {
+  const d = new Date(Date.UTC(year, month - 1, day));
+  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 isoWeekKey(date, timezone) {
+  const parts = partsOf(date, timezone);
+  return isoWeekOf(parts.year, parts.month, parts.day);
+}
+function isoWeekdayOf(date, timezone) {
+  const parts = partsOf(date, timezone);
+  const day = new Date(Date.UTC(parts.year, parts.month - 1, parts.day)).getUTCDay();
+  return day === 0 ? 7 : day;
+}
+function nextReleaseOccurrence(now, cfg) {
+  const { hour, minute, second } = parseClock(cfg.time);
+  const today = partsOf(now, cfg.timezone);
+  const start = Date.UTC(today.year, today.month - 1, today.day);
+  for (let index = 0; index <= 15; index += 1) {
+    const d = new Date(start + index * 864e5);
+    const year = d.getUTCFullYear();
+    const month = d.getUTCMonth() + 1;
+    const day = d.getUTCDate();
+    const dayOfWeek = d.getUTCDay();
+    const weekday = dayOfWeek === 0 ? 7 : dayOfWeek;
+    if (weekday !== cfg.weekday) continue;
+    const candidate = zonedTimeToUtc(year, month, day, hour, minute, second, cfg.timezone);
+    if (candidate.getTime() > now.getTime()) return candidate;
+  }
+  throw new Error(`\u65E0\u6CD5\u8BA1\u7B97\u4E0B\u4E00\u6B21\u53D1\u7248\u8FD0\u884C\u65F6\u523B\uFF08weekday=${String(cfg.weekday)}\uFF09`);
+}
+function isReleaseDue(now, cfg) {
+  if (isoWeekdayOf(now, cfg.timezone) !== cfg.weekday) return false;
+  const { hour, minute } = parseClock(cfg.time);
+  const parts = partsOf(now, cfg.timezone);
+  const late = parts.hour * 60 + parts.minute - (hour * 60 + minute);
+  return late >= 0 && late <= RELEASE_CATCH_UP_MINUTES;
+}
 function daysInMonth(year, month) {
   return new Date(Date.UTC(year, month, 0)).getUTCDate();
 }
@@ -2274,6 +2446,8 @@ var Scheduler = class {
   stopped = false;
   /** 当天已尝试次数与时间；只在内存里，进程重启后重新计数。 */
   attempts = /* @__PURE__ */ new Map();
+  /** 发版行程的尝试计数（键 = ISO 周 + 本地日期）；理由同榜单：失败不能每分钟重试。 */
+  releaseAttempts = /* @__PURE__ */ new Map();
   constructor(deps) {
     this.deps = deps;
   }
@@ -2299,9 +2473,24 @@ var Scheduler = class {
     else if (typeof handle === "number" || handle !== void 0) clearInterval(handle);
     this.timerHandle = void 0;
   }
-  /** 公开给测试：判断此刻是否该跑，并按需触发一次。 */
+  /**
+   * 公开给测试：判断此刻是否该跑，并按需触发。
+   *
+   * 每个 tick 都**同时**评估榜单与发版两条行程（interval 已经是 60 s）。返回值合并规则
+   * 保证老调用方不受影响：真的跑了 → `ran`；否则有人占着锁 → `busy`；再否则只要有
+   * 一条行程是禁用状态就沿用旧的 `disabled`；都没有 → `skipped`。
+   */
   async tick(now = /* @__PURE__ */ new Date()) {
     if (this.stopped) return "skipped";
+    const digest = await this.tickDigest(now);
+    const releases = await this.tickReleases(now);
+    if (digest === "ran" || releases === "ran") return "ran";
+    if (digest === "busy" || releases === "busy") return "busy";
+    if (digest === "disabled" || releases === "disabled") return "disabled";
+    return "skipped";
+  }
+  /** 榜单行程（原 tick 的逻辑，不改）。 */
+  async tickDigest(now) {
     const schedule = this.readSchedule();
     if (!schedule.enabled) return "disabled";
     if (!isDue(now, schedule)) return "skipped";
@@ -2332,6 +2521,47 @@ var Scheduler = class {
     }
     return ran ? "ran" : "skipped";
   }
+  /**
+   * 发版行程：每周一次、只跑 `--stages releases`。
+   *
+   * 跳过条件（全部满足才跑）：开启、星期/时间命中且迟到 ≤ 6 h、本周尚未成功过
+   * （`state.lastReleaseWeek`）、当前没有别的运行占锁。
+   * 失败**不锁本周**，但也只有 2 次机会（间隔 5 min）——否则一个坏 token 会在 6 h 的
+   * 补跑窗口里每分钟 spawn 一次核心、白白打 GitHub API。
+   */
+  async tickReleases(now) {
+    const cfg = this.readReleaseSchedule();
+    if (!cfg.enabled) return "disabled";
+    if (!isReleaseDue(now, cfg)) return "skipped";
+    const week = (() => {
+      try {
+        return isoWeekKey(now, cfg.timezone);
+      } catch {
+        return void 0;
+      }
+    })();
+    if (week === void 0) return "skipped";
+    const state = this.deps.store.readState();
+    if (state.lastReleaseWeek === week) return "skipped";
+    const key = `${week}:${zonedDateString(now, cfg.timezone)}`;
+    for (const existing of this.releaseAttempts.keys()) {
+      if (!existing.startsWith(`${week}:`)) this.releaseAttempts.delete(existing);
+    }
+    const attempt = this.releaseAttempts.get(key);
+    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";
+    this.releaseAttempts.set(key, { count: (attempt?.count ?? 0) + 1, lastAt: now.getTime() });
+    try {
+      await this.deps.runReleases("schedule");
+      return "ran";
+    } catch (error) {
+      this.deps.onError?.(error);
+      return "skipped";
+    }
+  }
   /** 该周期今天是否已经成功过（含无变更跳过）。 */
   succeededToday(state, period, today, timezone) {
     const stamp = state.periodSuccess?.[period];
@@ -2350,6 +2580,16 @@ var Scheduler = class {
       periods: settings.schedule.periods
     };
   }
+  /** 发版行程的节奏来自 `settings.releases.schedule`（与榜单 `schedule.*` 相互独立）。 */
+  readReleaseSchedule() {
+    const { schedule } = this.deps.store.readSettings().releases;
+    return {
+      enabled: schedule.enabled,
+      weekday: schedule.weekday,
+      time: schedule.time,
+      timezone: schedule.timezone
+    };
+  }
   /** 下一次运行（取所有已启用周期里最近的一次；禁用时为 undefined）。 */
   next() {
     const schedule = this.readSchedule();
@@ -2367,9 +2607,21 @@ var Scheduler = class {
       return void 0;
     }
   }
+  /** 下一次发版运行（禁用/非法时为 undefined）。 */
+  nextRelease(now = /* @__PURE__ */ new Date()) {
+    const cfg = this.readReleaseSchedule();
+    if (!cfg.enabled) return void 0;
+    try {
+      return nextReleaseOccurrence(now, cfg);
+    } catch {
+      return void 0;
+    }
+  }
   describe(state, now = /* @__PURE__ */ new Date()) {
     const schedule = this.readSchedule();
+    const release = this.readReleaseSchedule();
     const next = schedule.enabled ? this.next() : void 0;
+    const nextRelease = release.enabled ? this.nextRelease(now) : void 0;
     return {
       enabled: schedule.enabled,
       time: schedule.time,
@@ -2378,11 +2630,98 @@ var Scheduler = class {
       ...next === void 0 ? {} : { nextRunAt: next.toISOString() },
       ...state.lastRunAt === void 0 ? {} : { lastRunDate: zonedDateString(new Date(state.lastRunAt), schedule.timezone) },
       catchUpMinutes: CATCH_UP_MINUTES,
-      source: "timer"
+      source: "timer",
+      // 发版行程的信息并列给出，界面/工具不必再去读设置才知道下一次何时跑。
+      releaseEnabled: release.enabled,
+      releaseWeekday: release.weekday,
+      releaseTime: release.time,
+      releaseTimezone: release.timezone,
+      ...nextRelease === void 0 ? {} : { nextReleaseAt: nextRelease.toISOString() },
+      ...state.lastReleaseAt === void 0 ? {} : { lastReleaseAt: state.lastReleaseAt },
+      ...state.lastReleaseWeek === void 0 ? {} : { lastReleaseWeek: state.lastReleaseWeek },
+      releaseCatchUpMinutes: RELEASE_CATCH_UP_MINUTES
     };
   }
 };
 
+// src/host/subscribe.ts
+var subscribe_exports = {};
+__export(subscribe_exports, {
+  RELEASES_TIMEOUT_MS: () => RELEASES_TIMEOUT_MS,
+  SUBSCRIBE_TIMEOUT_MS: () => SUBSCRIBE_TIMEOUT_MS,
+  isValidRepo: () => isValidRepo,
+  runSubscribe: () => runSubscribe
+});
+import { mkdtempSync as mkdtempSync2, writeFileSync as writeFileSync2, rmSync as rmSync2 } from "fs";
+import os3 from "os";
+import path8 from "path";
+var SUBSCRIBE_TIMEOUT_MS = 8e3;
+var RELEASES_TIMEOUT_MS = 3e4;
+var REPO_PATTERN2 = /^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/;
+function isValidRepo(repo) {
+  return REPO_PATTERN2.test(repo.trim());
+}
+var SUBSCRIBE_PLACEHOLDER_BASE_URL = "http://127.0.0.1:9/v1";
+function writeTempConfig(settings) {
+  const dir = mkdtempSync2(path8.join(os3.tmpdir(), "dsh-subscribe-"));
+  const file = path8.join(dir, "config.yml");
+  const placeholder = effectiveBaseURL(settings.model) === "" ? SUBSCRIBE_PLACEHOLDER_BASE_URL : void 0;
+  const yaml = `${toYaml(toCoreConfig(settings, "", placeholder))}
+`;
+  writeFileSync2(file, yaml, { mode: 384 });
+  return { file, dir };
+}
+function requireUsableConfig(settings) {
+  const problems = validateSettings(settings);
+  if (problems.length > 0) {
+    const first = problems[0];
+    throw new IpcError("CONFIG_INVALID", `\u914D\u7F6E\u4E0D\u5B8C\u6574\uFF0C\u65E0\u6CD5\u7BA1\u7406\u8BA2\u9605\uFF1A${first?.message ?? "\u672A\u77E5\u95EE\u9898"}`);
+  }
+}
+async function runSubscribe(input, deps) {
+  const env = deps.env ?? process.env;
+  const settings = deps.store.readSettings();
+  requireUsableConfig(settings);
+  if (input.action !== "list") {
+    const repo = (input.repo ?? "").trim();
+    if (!isValidRepo(repo)) {
+      throw new IpcError("CONFIG_INVALID", `\u4ED3\u5E93\u5FC5\u987B\u662F owner/repo \u5F62\u6001\uFF1A${repo || "(\u7A7A)"}`);
+    }
+  }
+  if (input.volume !== void 0 && (!Number.isInteger(input.volume) || input.volume < 1)) {
+    throw new IpcError("CONFIG_INVALID", `\u5377\u53F7\u5FC5\u987B\u662F\u6B63\u6574\u6570\uFF1A${String(input.volume)}`);
+  }
+  const corePath = deps.corePath !== void 0 ? deps.corePath : (await locateCore({ settings, env, allowDownload: settings.coreAutoDownload })).path;
+  const { file, dir } = writeTempConfig(settings);
+  try {
+    const request = {
+      ipcSchema: 2,
+      command: "subscribe",
+      action: input.action,
+      ...input.action === "list" ? {} : { repo: (input.repo ?? "").trim() },
+      // 仅 `releases` 认卷号；核心对其它 action 传 volume 会直接判 CONFIG_INVALID。
+      ...input.action === "releases" && input.volume !== void 0 ? { volume: input.volume } : {},
+      configPath: file
+    };
+    const timeoutMs = input.action === "releases" ? RELEASES_TIMEOUT_MS : SUBSCRIBE_TIMEOUT_MS;
+    const result = await execCapture(corePath, ["subscribe", "--json"], {
+      env: sanitizedEnv(env),
+      input: JSON.stringify(request),
+      timeoutMs
+    });
+    if (result.timedOut) {
+      throw new IpcError("SUBSCRIBE_FAILED", `\u8BA2\u9605\u547D\u4EE4\u8D85\u65F6\uFF08${Math.round(timeoutMs / 1e3)} s\uFF09`);
+    }
+    if (result.stdout.trim() === "") {
+      const detail = result.stderr.trim();
+      throw new IpcError("SUBSCRIBE_FAILED", `\u8BA2\u9605\u547D\u4EE4\u65E0\u8F93\u51FA${detail === "" ? "" : `\uFF1A${detail}`}`);
+    }
+    return parseSubscribeResult(result.stdout);
+  } finally {
+    rmSync2(dir, { recursive: true, force: true });
+  }
+}
+
 // src/host/runner.ts
 var runner_exports = {};
 __export(runner_exports, {
@@ -2393,7 +2732,7 @@ __export(runner_exports, {
 });
 import { createHash as createHash2 } from "crypto";
 import { existsSync as existsSync4, readFileSync as readFileSync3, realpathSync, statSync as statSync5 } from "fs";
-import path8 from "path";
+import path9 from "path";
 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}` };
@@ -2402,7 +2741,7 @@ function repoProblem(repoPath) {
   } catch {
     return { code: "REPO_NOT_GIT", message: `\u65E0\u6CD5\u8BBF\u95EE\uFF1A${repoPath}` };
   }
-  if (!existsSync4(path8.join(repoPath, ".git"))) {
+  if (!existsSync4(path9.join(repoPath, ".git"))) {
     return { code: "REPO_NOT_GIT", message: `\u4E0D\u662F git \u4ED3\u5E93\uFF1A${repoPath}\uFF08\u63D2\u4EF6\u4E0D\u4F1A\u66FF\u4F60 git init\uFF09` };
   }
   return void 0;
@@ -2415,27 +2754,23 @@ function runDate(settings, now = /* @__PURE__ */ new Date()) {
   }
 }
 function isInside(root, target) {
-  const rel = path8.relative(root, target);
-  return rel !== "" && !rel.startsWith("..") && !path8.isAbsolute(rel);
+  const rel = path9.relative(root, target);
+  return rel !== "" && !rel.startsWith("..") && !path9.isAbsolute(rel);
 }
 function normalizeSha256(value) {
   if (typeof value !== "string") return void 0;
   const hex = value.trim().replace(/^sha256:/i, "").toLowerCase();
   return /^[0-9a-f]{64}$/.test(hex) ? hex : void 0;
 }
+function counterOf(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : 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")}`;
+  return isoWeekKey(d, "UTC");
 }
 function periodFileBase(period, date) {
   if (period === "monthly") return date.slice(0, 7);
@@ -2516,32 +2851,9 @@ var Runner = class {
           `\u6838\u5FC3\u4E0D\u652F\u6301 provider\u300C${settings.model.provider}\u300D\uFF1B\u53EF\u7528\uFF1A${handshakeResult.supportedProviders.join(" / ")}`
         );
       }
-      const modelKey = await resolveModelKey(settings, credentials, env);
-      if (modelKey.mode === "direct" && (modelKey.apiKey === void 0 || modelKey.apiKey === "")) {
-        throw new IpcError("MODEL_KEY_MISSING", `\u6CA1\u6709\u89E3\u6790\u5230\u6A21\u578B\u5BC6\u94A5\uFF08\u5F15\u7528 ${settings.model.apiKeyRef}\uFF09`);
-      }
-      let apiKey = modelKey.apiKey ?? "";
-      let baseURLOverride;
-      if (modelKey.mode === "proxy") {
-        const llm = this.deps.get("llm");
-        if (llm === void 0 || typeof llm.stream !== "function") {
-          throw new IpcError("MODEL_KEY_MISSING", "\u8BE5\u6A21\u578B\u9700\u8981\u56DE\u73AF\u4EE3\u7406\uFF0C\u4F46\u5BBF\u4E3B\u6CA1\u6709\u53EF\u7528\u7684 ctx.llm \u670D\u52A1");
-        }
-        proxy = await startProxy({
-          llm,
-          provider: settings.model.hostProvider !== "" ? settings.model.hostProvider : settings.model.provider,
-          model: settings.model.model,
-          temperature: settings.model.temperature,
-          maxTokens: settings.model.maxTokens,
-          timeoutMs: 12e4
-        });
-        baseURLOverride = proxy.url;
-        apiKey = proxy.token;
-        store.appendLog(
-          logFile,
-          `[proxy] \u56DE\u73AF\u4EE3\u7406\u5DF2\u542F\u52A8\uFF1A127.0.0.1:${proxy.port}\uFF08\u4E00\u6B21\u6027 token\uFF0C\u8FD0\u884C\u7ED3\u675F\u5373\u5173\u95ED\uFF09`
-        );
-      }
+      const model = await this.openModelChannel({ settings, credentials, env, logFile });
+      const apiKey = model.apiKey;
+      proxy = model.proxy;
       const github = await resolveGithubToken(credentials, settings.github.authMode, settings.github.tokenRef, { env });
       if (github.token === void 0) {
         store.appendLog(logFile, "[github] \u672A\u627E\u5230 token\uFF1Apush/PR \u4F1A\u5931\u8D25\u5E76\u8FD4\u56DE GITHUB_AUTH\uFF08dryRun \u4E0D\u53D7\u5F71\u54CD\uFF09");
@@ -2556,7 +2868,7 @@ var Runner = class {
         period,
         dryRun,
         trigger: options.trigger === "schedule" ? "schedule" : "manual",
-        ...baseURLOverride === void 0 ? {} : { baseURLOverride },
+        ...model.baseURLOverride === void 0 ? {} : { baseURLOverride: model.baseURLOverride },
         signal: controller.signal,
         secrets: [apiKey, github.token],
         onStderr: (line) => store.appendLog(logFile, line)
@@ -2629,6 +2941,220 @@ var Runner = class {
     }
     return summaries;
   }
+  /**
+   * 只跑发版订阅阶段（`run --stages releases`）。
+   *
+   * 与榜单运行共用同一把 `active` 锁：两条路径都会写同一份产物、读同一份订阅，
+   * 并发跑会互相踩分支。和 `run()` 的区别只有三点：不带 dryRun、写完只落
+   * `state.releaseRuns`（不碰 history.json）、自己**不**合并订阅 pending 队列
+   * （`--stages releases` 让核心跳过那一步，合并只在完整 run 里发生）。
+   */
+  async runReleases(options) {
+    const env = this.deps.env ?? process.env;
+    const store = this.deps.store;
+    const settings = store.readSettings();
+    const credentials = credentialServices(this.deps.get);
+    if (this.active !== void 0 || this.batching) {
+      throw new IpcError("CONFIG_INVALID", "\u5DF2\u6709\u4E00\u6B21\u8FD0\u884C\u5728\u8FDB\u884C\u4E2D");
+    }
+    const problems = validateSettings(settings);
+    if (problems.length > 0) {
+      const first = problems[0];
+      throw new IpcError(first?.code ?? "CONFIG_INVALID", `\u914D\u7F6E\u4E0D\u5B8C\u6574\uFF1A${first?.message ?? "\u672A\u77E5\u95EE\u9898"}`);
+    }
+    const repoIssue = repoProblem(settings.repo.path);
+    if (repoIssue !== void 0) throw new IpcError(repoIssue.code, repoIssue.message);
+    const id = newRunId();
+    const controller = new AbortController();
+    const startedAt = (/* @__PURE__ */ new Date()).toISOString();
+    const startedMs = Date.now();
+    this.active = { id, controller, startedAt };
+    const logFile = store.newLogPath(id);
+    let proxy;
+    try {
+      const core = await locateCore({ settings, env, allowDownload: settings.coreAutoDownload });
+      if (core.downloaded === true) {
+        store.appendLog(logFile, `[core] \u5DF2\u4E0B\u8F7D\u6838\u5FC3 ${core.tag ?? ""} \u2192 ${core.path}`);
+      }
+      const handshakeResult = await handshake(core, { signal: controller.signal });
+      if (!handshakeResult.supportedProviders.includes(settings.model.provider)) {
+        throw new IpcError(
+          "MODEL_PROVIDER_UNSUPPORTED",
+          `\u6838\u5FC3\u4E0D\u652F\u6301 provider\u300C${settings.model.provider}\u300D\uFF1B\u53EF\u7528\uFF1A${handshakeResult.supportedProviders.join(" / ")}`
+        );
+      }
+      const model = await this.openModelChannel({ settings, credentials, env, logFile });
+      proxy = model.proxy;
+      const github = await resolveGithubToken(credentials, settings.github.authMode, settings.github.tokenRef, { env });
+      if (github.token === void 0) {
+        store.appendLog(logFile, "[github] \u672A\u627E\u5230 token\uFF1A\u62C9\u53D6 Release \u4F1A\u5931\u8D25\u5E76\u8FD4\u56DE GITHUB_AUTH");
+      }
+      const repoCount = await this.subscriptionCount(core.path, env);
+      const result = await runCore({
+        core,
+        version: handshakeResult.version,
+        settings,
+        apiKey: model.apiKey,
+        ...github.token === void 0 ? {} : { token: github.token },
+        // 按发版调度时区算「今天」：与 lastReleaseWeek 的去重口径必须是同一天历。
+        date: this.releaseDate(settings),
+        period: settings.trending.since,
+        dryRun: false,
+        trigger: options.trigger === "schedule" ? "schedule" : "manual",
+        stages: ["releases"],
+        repoCount,
+        ...model.baseURLOverride === void 0 ? {} : { baseURLOverride: model.baseURLOverride },
+        signal: controller.signal,
+        secrets: [model.apiKey, github.token],
+        onStderr: (line) => store.appendLog(logFile, line)
+      });
+      return this.recordReleaseRun({
+        id,
+        outcome: result.outcome,
+        settings,
+        startedAt,
+        logFile,
+        cancelled: controller.signal.aborted
+      });
+    } catch (error) {
+      const aborted = controller.signal.aborted || error instanceof IpcError && error.code === "CORE_CANCELLED";
+      return this.recordReleaseFailure({ id, error, aborted, settings, startedAt, startedMs, logFile });
+    } finally {
+      if (proxy !== void 0) {
+        const port = proxy.port;
+        await proxy.close().catch(() => void 0);
+        this.deps.store.appendLog(logFile, `[proxy] \u5DF2\u5173\u95ED 127.0.0.1:${port}`);
+      }
+      this.active = void 0;
+    }
+  }
+  /** 发版运行用哪一天：发版调度时区下的「今天」（不是榜单调度时区，两者可独立配置）。 */
+  releaseDate(settings, now = /* @__PURE__ */ new Date()) {
+    try {
+      return zonedDateString(now, settings.releases.schedule.timezone);
+    } catch {
+      return now.toISOString().slice(0, 10);
+    }
+  }
+  /** 订阅仓库数（best-effort，只影响 auto 解析）：任何失败都当 0，不阻塞发版运行。 */
+  async subscriptionCount(corePath, env) {
+    try {
+      const result = await runSubscribe({ action: "list" }, { store: this.deps.store, env, corePath });
+      return result.ok ? result.repos.length : 0;
+    } catch {
+      return 0;
+    }
+  }
+  /**
+   * 解析模型钥匙并（代理模式下）起回环代理。
+   *
+   * 榜单运行与发版运行共用这一段：代理的一次性 token 语义（空 key 会让核心静默降级成
+   * 英文/离线假模型）只写一次，避免两份实现漂移。
+   */
+  async openModelChannel(input) {
+    const { settings, env, logFile } = input;
+    const modelKey = await resolveModelKey(settings, input.credentials, env);
+    if (modelKey.mode === "direct" && (modelKey.apiKey === void 0 || modelKey.apiKey === "")) {
+      throw new IpcError("MODEL_KEY_MISSING", `\u6CA1\u6709\u89E3\u6790\u5230\u6A21\u578B\u5BC6\u94A5\uFF08\u5F15\u7528 ${settings.model.apiKeyRef}\uFF09`);
+    }
+    if (modelKey.mode !== "proxy") return { apiKey: modelKey.apiKey ?? "" };
+    const llm = this.deps.get("llm");
+    if (llm === void 0 || typeof llm.stream !== "function") {
+      throw new IpcError("MODEL_KEY_MISSING", "\u8BE5\u6A21\u578B\u9700\u8981\u56DE\u73AF\u4EE3\u7406\uFF0C\u4F46\u5BBF\u4E3B\u6CA1\u6709\u53EF\u7528\u7684 ctx.llm \u670D\u52A1");
+    }
+    const proxy = await startProxy({
+      llm,
+      provider: settings.model.hostProvider !== "" ? settings.model.hostProvider : settings.model.provider,
+      model: settings.model.model,
+      temperature: settings.model.temperature,
+      maxTokens: settings.model.maxTokens,
+      timeoutMs: 12e4
+    });
+    this.deps.store.appendLog(logFile, `[proxy] \u56DE\u73AF\u4EE3\u7406\u5DF2\u542F\u52A8\uFF1A127.0.0.1:${proxy.port}\uFF08\u4E00\u6B21\u6027 token\uFF0C\u8FD0\u884C\u7ED3\u675F\u5373\u5173\u95ED\uFF09`);
+    return { apiKey: proxy.token, baseURLOverride: proxy.url, proxy };
+  }
+  /** 把 `run --json` 的发版阶段结果投影成一条发版运行记录并落盘。 */
+  recordReleaseRun(input) {
+    const { outcome, settings } = input;
+    const status = input.cancelled ? "cancelled" : outcome.skipped ? "skipped" : outcome.ok ? "ok" : "failed";
+    const releases = outcome.releases;
+    const record = {
+      id: input.id,
+      startedAt: input.startedAt,
+      finishedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      status,
+      checked: counterOf(releases?.checked),
+      changed: counterOf(releases?.changed),
+      newTags: counterOf(releases?.newReleases),
+      summarized: counterOf(releases?.summarized),
+      degraded: counterOf(releases?.degraded),
+      failed: counterOf(releases?.failed),
+      rateLimited: counterOf(releases?.rateLimited),
+      durationMs: counterOf(releases?.durationMs),
+      ...releases?.usage === void 0 ? {} : { tokens: releases.usage.totalTokens },
+      ...outcome.commit === void 0 ? {} : { commit: outcome.commit },
+      ...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 }
+    };
+    this.persistReleaseRun(record, settings, input.logFile);
+    return record;
+  }
+  /** 运行在拿到信封之前就失败（定位/握手/模型/代理/超时/取消）：也要留一条可复盘记录。 */
+  recordReleaseFailure(input) {
+    const code = input.aborted ? "CORE_CANCELLED" : input.error instanceof IpcError ? input.error.code : "INTERNAL";
+    const message = redact(input.error instanceof Error ? input.error.message : String(input.error));
+    const record = {
+      id: input.id,
+      startedAt: input.startedAt,
+      finishedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      status: input.aborted ? "cancelled" : "failed",
+      checked: 0,
+      changed: 0,
+      newTags: 0,
+      summarized: 0,
+      degraded: 0,
+      failed: 0,
+      rateLimited: 0,
+      durationMs: Date.now() - input.startedMs,
+      errorCode: code,
+      errorMessage: message
+    };
+    this.persistReleaseRun(record, input.settings, input.logFile);
+    return record;
+  }
+  /**
+   * 落盘发版运行：只写 state（history.json 是榜单的），顺带推进 lastReleaseAt；
+   * 只有 ok/skipped 才锁 `lastReleaseWeek`——失败不锁，调度下一 tick 才有机会重试。
+   */
+  persistReleaseRun(record, settings, logFile) {
+    const store = this.deps.store;
+    const succeeded = record.status === "ok" || record.status === "skipped";
+    let week;
+    if (succeeded) {
+      try {
+        week = isoWeekKey(new Date(record.finishedAt), settings.releases.schedule.timezone);
+      } catch {
+        week = void 0;
+      }
+    }
+    store.appendReleaseRun(record, {
+      lastReleaseAt: record.finishedAt,
+      ...week === void 0 ? {} : { lastReleaseWeek: week }
+    });
+    store.appendLog(
+      logFile,
+      `[release] ${record.status} checked=${record.checked} changed=${record.changed} newTags=${record.newTags} summarized=${record.summarized} degraded=${record.degraded} failed=${record.failed} rateLimited=${record.rateLimited} durationMs=${record.durationMs}`
+    );
+    this.deps.logger?.("release.finished", {
+      id: record.id,
+      status: record.status,
+      checked: record.checked,
+      changed: record.changed,
+      coreVersion: record.coreVersion ?? null
+    });
+  }
   summarize(input) {
     const { outcome } = input;
     const error = outcome.error === void 0 ? void 0 : (() => {
@@ -2703,19 +3229,19 @@ var Runner = class {
       return void 0;
     };
     const markdown = outcome.files.filter((file) => {
-      const ext = path8.extname(file.path).toLowerCase();
-      const base = path8.basename(file.path).toLowerCase();
+      const ext = path9.extname(file.path).toLowerCase();
+      const base = path9.basename(file.path).toLowerCase();
       const normalized = file.path.replace(/\\/g, "/");
       const inReleases = normalized === "releases" || normalized.startsWith("releases/");
       return ext === ".md" && base !== "readme.md" && base !== "index.md" && !inReleases;
     });
     if (markdown.length === 0) return skip("no-markdown");
     const expected = period === void 0 ? `${date}.md` : `${periodFileBase(period, date)}.md`;
-    const named = markdown.filter((file) => path8.basename(file.path) === expected);
+    const named = markdown.filter((file) => path9.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);
+    const resolved = path9.resolve(repoPath, chosen.path);
     if (!isInside(repoPath, resolved)) return skip("outside-repo", { path: chosen.path });
     let fileReal;
     try {
@@ -2748,7 +3274,7 @@ var Runner = class {
       return skip("write-failed", { path: chosen.path });
     }
     return {
-      file: path8.relative(repoPath, resolved).split(path8.sep).join("/"),
+      file: path9.relative(repoPath, resolved).split(path9.sep).join("/"),
       bytes: stored.length,
       sha256: createHash2("sha256").update(stored).digest("hex")
     };
@@ -2923,15 +3449,15 @@ __export(import_cli_exports, {
   parseSimpleYaml: () => parseSimpleYaml
 });
 import { readFileSync as readFileSync4 } from "fs";
-import os3 from "os";
-import path9 from "path";
-function cliConfigCandidates(env = process.env, home = os3.homedir()) {
+import os4 from "os";
+import path10 from "path";
+function cliConfigCandidates(env = process.env, home = os4.homedir()) {
   const xdg = env.XDG_CONFIG_HOME?.trim();
-  const base = xdg !== void 0 && xdg !== "" ? path9.resolve(xdg) : path9.join(home, ".config");
+  const base = xdg !== void 0 && xdg !== "" ? path10.resolve(xdg) : path10.join(home, ".config");
   return [
     env.TRENDradar_CONFIG?.trim() ?? "",
-    path9.join(base, "trendradar", "config.yaml"),
-    path9.join(home, ".trendradar", "config.yaml")
+    path10.join(base, "trendradar", "config.yaml"),
+    path10.join(home, ".trendradar", "config.yaml")
   ].filter((item) => item !== "");
 }
 function unquote(raw) {
@@ -3365,7 +3891,7 @@ __export(repo_exports, {
   readDefaultBranch: () => readDefaultBranch
 });
 import { statSync as statSync6 } from "fs";
-import path10 from "path";
+import path11 from "path";
 function isDirectory(dir) {
   try {
     return statSync6(dir).isDirectory();
@@ -3384,7 +3910,7 @@ async function git(dir, args, env) {
 async function readDefaultBranch(repoPath, options = {}) {
   const dir = repoPath.trim();
   if (dir === "") return { source: "none", message: "\u4ED3\u5E93\u8DEF\u5F84\u4E3A\u7A7A" };
-  if (!path10.isAbsolute(dir)) return { source: "none", message: "\u4ED3\u5E93\u8DEF\u5F84\u5FC5\u987B\u662F\u7EDD\u5BF9\u8DEF\u5F84" };
+  if (!path11.isAbsolute(dir)) return { source: "none", message: "\u4ED3\u5E93\u8DEF\u5F84\u5FC5\u987B\u662F\u7EDD\u5BF9\u8DEF\u5F84" };
   if (!isDirectory(dir)) return { source: "none", message: "\u76EE\u5F55\u4E0D\u5B58\u5728\u6216\u4E0D\u53EF\u8BBF\u95EE" };
   const env = options.env ?? process.env;
   const origin = await git(dir, ["symbolic-ref", "--short", "refs/remotes/origin/HEAD"], env);
@@ -3399,74 +3925,6 @@ async function readDefaultBranch(repoPath, options = {}) {
   return { source: "none", message: "\u672A\u8BFB\u53D6\u5230\u9ED8\u8BA4\u5206\u652F\uFF08\u53EF\u80FD\u662F\u7A7A\u4ED3\u5E93\u6216\u6CA1\u6709 origin\uFF09" };
 }
 
-// src/host/subscribe.ts
-var subscribe_exports = {};
-__export(subscribe_exports, {
-  SUBSCRIBE_TIMEOUT_MS: () => SUBSCRIBE_TIMEOUT_MS,
-  isValidRepo: () => isValidRepo,
-  runSubscribe: () => runSubscribe
-});
-import { mkdtempSync as mkdtempSync2, writeFileSync as writeFileSync2, rmSync as rmSync2 } from "fs";
-import os4 from "os";
-import path11 from "path";
-var SUBSCRIBE_TIMEOUT_MS = 8e3;
-var REPO_PATTERN2 = /^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/;
-function isValidRepo(repo) {
-  return REPO_PATTERN2.test(repo.trim());
-}
-function writeTempConfig(settings) {
-  const dir = mkdtempSync2(path11.join(os4.tmpdir(), "dsh-subscribe-"));
-  const file = path11.join(dir, "config.yml");
-  const yaml = `${toYaml(toCoreConfig(settings, ""))}
-`;
-  writeFileSync2(file, yaml, { mode: 384 });
-  return { file, dir };
-}
-function requireUsableConfig(settings) {
-  const problems = validateSettings(settings);
-  if (problems.length > 0) {
-    const first = problems[0];
-    throw new IpcError("CONFIG_INVALID", `\u914D\u7F6E\u4E0D\u5B8C\u6574\uFF0C\u65E0\u6CD5\u7BA1\u7406\u8BA2\u9605\uFF1A${first?.message ?? "\u672A\u77E5\u95EE\u9898"}`);
-  }
-}
-async function runSubscribe(input, deps) {
-  const env = deps.env ?? process.env;
-  const settings = deps.store.readSettings();
-  requireUsableConfig(settings);
-  if (input.action !== "list") {
-    const repo = (input.repo ?? "").trim();
-    if (!isValidRepo(repo)) {
-      throw new IpcError("CONFIG_INVALID", `\u4ED3\u5E93\u5FC5\u987B\u662F owner/repo \u5F62\u6001\uFF1A${repo || "(\u7A7A)"}`);
-    }
-  }
-  const corePath = deps.corePath !== void 0 ? deps.corePath : (await locateCore({ settings, env, allowDownload: settings.coreAutoDownload })).path;
-  const { file, dir } = writeTempConfig(settings);
-  try {
-    const request = {
-      ipcSchema: 2,
-      command: "subscribe",
-      action: input.action,
-      ...input.action === "list" ? {} : { repo: (input.repo ?? "").trim() },
-      configPath: file
-    };
-    const result = await execCapture(corePath, ["subscribe", "--json"], {
-      env: sanitizedEnv(env),
-      input: JSON.stringify(request),
-      timeoutMs: SUBSCRIBE_TIMEOUT_MS
-    });
-    if (result.timedOut) {
-      throw new IpcError("SUBSCRIBE_FAILED", `\u8BA2\u9605\u547D\u4EE4\u8D85\u65F6\uFF08${Math.round(SUBSCRIBE_TIMEOUT_MS / 1e3)} s\uFF09`);
-    }
-    if (result.stdout.trim() === "") {
-      const detail = result.stderr.trim();
-      throw new IpcError("SUBSCRIBE_FAILED", `\u8BA2\u9605\u547D\u4EE4\u65E0\u8F93\u51FA${detail === "" ? "" : `\uFF1A${detail}`}`);
-    }
-    return parseSubscribeResult(result.stdout);
-  } finally {
-    rmSync2(dir, { recursive: true, force: true });
-  }
-}
-
 // src/host/routes.ts
 var routes_exports = {};
 __export(routes_exports, {
@@ -3623,7 +4081,32 @@ async function dispatch(method, pathname, url, request, deps) {
     if (!result.ok) {
       throw new IpcError("SUBSCRIBE_FAILED", result.error?.message ?? "\u8BFB\u53D6\u8BA2\u9605\u5217\u8868\u5931\u8D25");
     }
-    return { repos: result.repos };
+    return { repos: result.repos, items: result.items ?? [] };
+  }
+  if (method === "GET" && pathname === "/subscriptions/releases") {
+    const repo = (url.searchParams.get("repo") ?? "").trim();
+    if (!isValidRepo(repo)) {
+      throw new IpcError("CONFIG_INVALID", `\u4ED3\u5E93\u5FC5\u987B\u662F owner/repo \u5F62\u6001\uFF1A${repo || "(\u7A7A)"}`);
+    }
+    const volumeRaw = url.searchParams.get("volume");
+    let volume;
+    if (volumeRaw !== null && volumeRaw !== "") {
+      if (!/^\d+$/.test(volumeRaw.trim()) || Number(volumeRaw) < 1) {
+        throw new IpcError("CONFIG_INVALID", `\u5377\u53F7\u5FC5\u987B\u662F\u6B63\u6574\u6570\uFF1A${volumeRaw}`);
+      }
+      volume = Number(volumeRaw);
+    }
+    const result = await runSubscribe(
+      { action: "releases", repo, ...volume === void 0 ? {} : { volume } },
+      { store: deps.store, env }
+    );
+    if (!result.ok) {
+      throw new IpcError("SUBSCRIBE_FAILED", result.error?.message ?? `\u8BFB\u53D6 ${repo} \u7684\u53D1\u7248\u6587\u6863\u5931\u8D25`);
+    }
+    if (result.doc === void 0) {
+      throw new IpcError("SUBSCRIBE_FAILED", `\u6838\u5FC3\u6CA1\u6709\u8FD4\u56DE ${repo} \u7684\u53D1\u7248\u6587\u6863`);
+    }
+    return { ...result.doc };
   }
   if (method === "POST" && pathname === "/subscriptions") {
     const body = await readBody2(request);
@@ -3638,7 +4121,7 @@ async function dispatch(method, pathname, url, request, deps) {
       }
     }
     const latest = await runSubscribe({ action: "list" }, { store: deps.store, env });
-    return { repos: latest.ok ? latest.repos : [] };
+    return { repos: latest.ok ? latest.repos : [], items: latest.ok ? latest.items ?? [] : [] };
   }
   if (method === "POST" && pathname === "/github/test") {
     const body = await readBody2(request);
@@ -3757,6 +4240,10 @@ async function statePayload(deps, settings) {
       pendingPr,
       ...pendingPrState === void 0 ? {} : { pendingPrState },
       history,
+      /** 最近 30 次发版运行（HTTP 镜像：`Store.readReleaseRuns`，IPC 侧无对应命令，纯展示）。 */
+      releaseRuns: deps.store.readReleaseRuns(),
+      /** 最近一次发版运行结束时间（失败也算）；界面「上次发版」读它。 */
+      lastReleaseAt: state.lastReleaseAt ?? null,
       /** 历史里全部运行的 token 累计（读时求和，不落盘）；全无数据则省略。 */
       ...(() => {
         const totalTokens = sumTokens(history);
@@ -4042,6 +4529,7 @@ export {
   proxy_exports,
   Scheduler,
   schedule_exports,
+  subscribe_exports,
   Runner,
   runner_exports,
   readPluginInfo,
@@ -4051,7 +4539,6 @@ export {
   pending_pr_exports,
   preflight_exports,
   repo_exports,
-  subscribe_exports,
   ROUTE_PREFIX,
   createRoutes,
   routes_exports,