@morehao/dsh-github-trending 0.8.22 → 0.8.23

package/client.js

@@ -457,6 +457,14 @@ var DICT = {
     "summarize.readmeChars": "README 摘录长度",
     "summarize.readmeChars.help": "enrich 为 readme 时，每个仓库 README 摘录的最大字符数（超出截断）。",
     "summarize.enrichNote": "外部增强需要只读 token：enrich=repo/readme 建议配置 GITHUB_READ_TOKEN（独立只读）；readme 模式在网络慢时可能因预算耗尽跳过部分仓库（自动降级，不影响运行）。",
+    "card.observe.title": "本地观测库",
+    "observe.enabled": "启用观测库",
+    "observe.enabled.help": "每日记录候选仓库的 star 快照，用本地差分算出「今日新增」，不再依赖趋势页那行数字；关闭即回到「增量只来自趋势页」的旧行为。数据存在本机 $DSH_HOME，不进归档仓库。",
+    "observe.backfillDays": "回填天数",
+    "observe.backfillDays.help": "首次见到的仓库从 GitHub 历史接口回填多少天（0=不回填，从今天开始攒；上限 365）。",
+    "observe.maxCandidates": "候选上限",
+    "observe.maxCandidates.help": "单次运行最多记多少个候选仓库（越多覆盖越广、请求越多；建议 300，约 3 个批量请求/天）。",
+    "observe.disabledNote": "观测库已关闭：本次运行的「今日新增」仍来自趋势页/搜索，可能为 0。",
     "card.releases.title": "订阅",
     "card.releases.hint": "对应核心 releases.*（core 0.5.0+）",
     "releases.includePrerelease": "含预发布",
@@ -1013,6 +1021,14 @@ var DICT = {
     "summarize.readmeChars": "README excerpt chars",
     "summarize.readmeChars.help": "Max README characters excerpted per repo when enrich=readme (longer text is truncated).",
     "summarize.enrichNote": "Enrich needs a read-only token: enrich=repo/readme is best paired with GITHUB_READ_TOKEN (separate, read-only). In readme mode slow networks may skip some repos when the budget runs out (auto-degrades; the run is unaffected).",
+    "card.observe.title": "Local observation store",
+    "observe.enabled": "Enable observation store",
+    "observe.enabled.help": 'Records a daily star snapshot of candidate repos and derives "stars today" from local diffs instead of the trending-page number; turn it off to fall back to the old "increment only from the trending page" behaviour. Data lives in $DSH_HOME, never in the archive repo.',
+    "observe.backfillDays": "Backfill days",
+    "observe.backfillDays.help": "How many days to backfill a first-seen repo from GitHub history (0 = no backfill, accumulate from today; max 365).",
+    "observe.maxCandidates": "Candidate cap",
+    "observe.maxCandidates.help": "Max candidate repos recorded per run (more = broader coverage and more requests; 300 ≈ 3 batch requests/day is recommended).",
+    "observe.disabledNote": `Observation store is off: this run's "stars today" still comes from the trending page/search and may be 0.`,
     "card.releases.title": "Subscriptions",
     "card.releases.hint": "Maps to core releases.* (core 0.5.0+)",
     "releases.includePrerelease": "Include pre-releases",
@@ -2242,7 +2258,7 @@ function sectionSlice(settings, section) {
     case "auth":
       return { github: settings.github };
     case "scope":
-      return { trending: settings.trending, schedule: settings.schedule, summarize: settings.summarize };
+      return { trending: settings.trending, schedule: settings.schedule, summarize: settings.summarize, observe: settings.observe };
     case "releases":
       return { releases: settings.releases };
   }
@@ -2730,6 +2746,8 @@ function SettingsView(props) {
       )
     )
   );
+  const observeOf = (s) => s.observe ?? { enabled: true, backfillDays: 30, maxCandidates: 300 };
+  const observe = observeOf(draft);
   const scopeCard = h(
     Card,
     {
@@ -2822,7 +2840,35 @@ function SettingsView(props) {
         next.summarize.readmeChars = Math.round(Number(value) || 0);
       }) })
     ),
-    draft.summarize.enrich === "none" ? null : h(Alert, { kind: "warn" }, h("div", null, t("summarize.enrichNote")))
+    draft.summarize.enrich === "none" ? null : h(Alert, { kind: "warn" }, h("div", null, t("summarize.enrichNote"))),
+    // 本地 star 观测库（核心 observe.*）：旧设置里可能还没有该字段，先取默认再编辑。
+    // 观测库让「今日新增」来自本地每日快照的差分；关闭即回到「增量只来自趋势页」的旧行为。
+    h("h4", { className: "dshgt-subhead" }, t("card.observe.title")),
+    h(
+      Row,
+      { label: t("observe.enabled"), help: t("observe.enabled.help") },
+      h(Toggle, {
+        checked: observe.enabled,
+        onChange: (value) => update((next) => {
+          next.observe = { ...observeOf(next), enabled: value };
+        })
+      })
+    ),
+    h(
+      Row,
+      { label: t("observe.backfillDays"), help: t("observe.backfillDays.help") },
+      h(Input, { mono: true, width: 90, value: String(observe.backfillDays), onInput: (value) => update((next) => {
+        next.observe = { ...observeOf(next), backfillDays: Math.round(Number(value) || 0) };
+      }) })
+    ),
+    h(
+      Row,
+      { label: t("observe.maxCandidates"), help: t("observe.maxCandidates.help") },
+      h(Input, { mono: true, width: 90, value: String(observe.maxCandidates), onInput: (value) => update((next) => {
+        next.observe = { ...observeOf(next), maxCandidates: Math.round(Number(value) || 0) };
+      }) })
+    ),
+    observe.enabled ? null : h(Alert, { kind: "info" }, h("div", null, t("observe.disabledNote")))
   );
   const releaseSchedule = draft.releases.schedule ?? { enabled: false, weekday: 1, time: "08:00:00", timezone: "Asia/Shanghai" };
   const releaseConcurrency = draft.releases.concurrency ?? "auto";

package/lib/{chunk-SLY2RKCZ.js → chunk-DGEO5BHK.js}

@@ -69,6 +69,7 @@ var DEFAULT_SETTINGS = {
     enrichTimeoutSeconds: 5,
     enrichBudgetSeconds: 8
   },
+  observe: { enabled: true, backfillDays: 30, maxCandidates: 300 },
   releases: {
     includePrerelease: false,
     includeDrafts: false,
@@ -102,6 +103,7 @@ function sectionOfField(field) {
   if (field.startsWith("github.")) return "auth";
   if (field.startsWith("trending.")) return "scope";
   if (field.startsWith("summarize.")) return "summarize";
+  if (field.startsWith("observe.")) return "scope";
   if (field.startsWith("releases.")) return "releases";
   if (field.startsWith("schedule.")) return "schedule";
   if (field === "corePath" || field === "coreAutoDownload" || field === "network.proxy") return "source";
@@ -128,6 +130,7 @@ function mergeSettingsSection(stored, incoming, section) {
       break;
     case "scope":
       next.trending = incoming.trending;
+      next.observe = incoming.observe;
       break;
     case "summarize":
       next.summarize = incoming.summarize;
@@ -171,6 +174,7 @@ function normalizeSettings(input) {
   const github = raw.github ?? {};
   const trending = raw.trending ?? {};
   const summarize = raw.summarize ?? {};
+  const observe = raw.observe ?? {};
   const releases = raw.releases ?? {};
   const releasesSchedule = releases.schedule ?? {};
   const output = raw.output ?? {};
@@ -225,6 +229,11 @@ function normalizeSettings(input) {
       enrichTimeoutSeconds: Math.round(num(summarize.enrichTimeoutSeconds, DEFAULT_SETTINGS.summarize.enrichTimeoutSeconds)),
       enrichBudgetSeconds: Math.round(num(summarize.enrichBudgetSeconds, DEFAULT_SETTINGS.summarize.enrichBudgetSeconds))
     },
+    observe: {
+      enabled: bool(observe.enabled, DEFAULT_SETTINGS.observe.enabled),
+      backfillDays: Math.round(num(observe.backfillDays, DEFAULT_SETTINGS.observe.backfillDays)),
+      maxCandidates: Math.round(num(observe.maxCandidates, DEFAULT_SETTINGS.observe.maxCandidates))
+    },
     releases: {
       includePrerelease: bool(releases.includePrerelease, DEFAULT_SETTINGS.releases.includePrerelease),
       includeDrafts: bool(releases.includeDrafts, DEFAULT_SETTINGS.releases.includeDrafts),
@@ -332,6 +341,13 @@ 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" });
   }
+  const { observe } = settings;
+  if (!Number.isInteger(observe.backfillDays) || observe.backfillDays < 0 || observe.backfillDays > 365) {
+    problems.push({ field: "observe.backfillDays", code: "CONFIG_INVALID", message: "backfillDays \u5FC5\u987B\u662F 0\u2013365 \u7684\u6574\u6570" });
+  }
+  if (!Number.isInteger(observe.maxCandidates) || observe.maxCandidates < 1 || observe.maxCandidates > 1e3) {
+    problems.push({ field: "observe.maxCandidates", code: "CONFIG_INVALID", message: "maxCandidates \u5FC5\u987B\u662F 1\u20131000 \u7684\u6574\u6570" });
+  }
   if (releases.period !== "weekly") {
     problems.push({
       field: "releases.period",
@@ -422,6 +438,11 @@ function toCoreConfig(settings, apiKey, baseURLOverride, period, repoCount = 0)
       enrichTimeoutSeconds: settings.summarize.enrichTimeoutSeconds,
       enrichBudgetSeconds: settings.summarize.enrichBudgetSeconds
     },
+    observe: {
+      enabled: settings.observe.enabled,
+      backfillDays: settings.observe.backfillDays,
+      maxCandidates: settings.observe.maxCandidates
+    },
     releases: {
       // 发版订阅常开：插件侧不再提供开关，是否产出由订阅列表决定。
       enabled: true,

package/lib/index.js

@@ -9,7 +9,7 @@ import {
   createUpdateService,
   ensureGithubFlow,
   readPluginInfo
-} from "./chunk-SLY2RKCZ.js";
+} from "./chunk-DGEO5BHK.js";
 
 // src/index.ts
 var name = "dsh-github-trending";

package/lib/internal.d.ts

@@ -282,6 +282,21 @@ interface SummarizeSettings {
     enrichTimeoutSeconds: number;
     enrichBudgetSeconds: number;
 }
+/**
+ * 本地 star 观测库（核心 `observe.*`，core ≥ 0.8.8）。
+ * 观测库让「今日新增」来自本地每日快照的差分，而不是趋势页上的一行字；
+ * 默认开启，`enabled=false` 是回滚开关（回到「增量只来自趋势页」的旧行为）。
+ * 存储位置由核心自己解析到 `$DSH_HOME`（计划 D4），**不**在这里暴露，避免用户
+ * 把观测库指进归档仓库。
+ */
+interface ObserveSettings {
+    /** 是否启用观测库；关闭即回到旧行为（`starsInPeriod` 只来自趋势页/搜索）。 */
+    enabled: boolean;
+    /** 首次见到的仓库从历史接口回填多少天（0=不回填，从今天开始攒）。 */
+    backfillDays: number;
+    /** 单次运行最多记多少个候选仓库（上限 300，约 3 个 GraphQL 批量/天）。 */
+    maxCandidates: number;
+}
 /**
  * 每周发版运行的插件侧节奏（核心没有这个字段，**绝不**写进核心 YAML）。
  * 与榜单调度（`schedule.*`）完全独立：两者各有自己的开关与时间点。
@@ -345,6 +360,7 @@ interface Settings {
     github: GithubSettings;
     trending: TrendingSettings;
     summarize: SummarizeSettings;
+    observe: ObserveSettings;
     releases: ReleasesSettings;
     output: OutputSettings;
     schedule: ScheduleSettings;
@@ -432,6 +448,11 @@ interface CoreConfig {
         enrichTimeoutSeconds: number;
         enrichBudgetSeconds: number;
     };
+    observe: {
+        enabled: boolean;
+        backfillDays: number;
+        maxCandidates: number;
+    };
     releases: {
         enabled: boolean;
         includePrerelease: boolean;
@@ -480,6 +501,7 @@ type config_Enrich = Enrich;
 type config_GithubSettings = GithubSettings;
 type config_ModelSettings = ModelSettings;
 type config_NetworkSettings = NetworkSettings;
+type config_ObserveSettings = ObserveSettings;
 type config_OutputSettings = OutputSettings;
 declare const config_PERIODS: typeof PERIODS;
 declare const config_PROVIDER_BASE_URLS: typeof PROVIDER_BASE_URLS;
@@ -508,7 +530,7 @@ declare const config_toCoreConfig: typeof toCoreConfig;
 declare const config_toYaml: typeof toYaml;
 declare const config_validateSettings: typeof validateSettings;
 declare namespace config {
-  export { type config_AuthMode as AuthMode, config_CORE_PROVIDERS as CORE_PROVIDERS, type config_CommitMode as CommitMode, type config_CoreConfig as CoreConfig, config_DEFAULT_SETTINGS as DEFAULT_SETTINGS, type config_Enrich as Enrich, type config_GithubSettings as GithubSettings, type config_ModelSettings as ModelSettings, type config_NetworkSettings as NetworkSettings, type config_OutputSettings as OutputSettings, config_PERIODS as PERIODS, config_PROVIDER_BASE_URLS as PROVIDER_BASE_URLS, type config_PRSettings as PRSettings, type config_Period as Period, type config_Problem as Problem, type config_Provider as Provider, type config_ReleaseScheduleSettings as ReleaseScheduleSettings, type config_ReleasesSettings as ReleasesSettings, type config_RepoSettings as RepoSettings, config_SETTINGS_SECTIONS as SETTINGS_SECTIONS, type config_ScheduleSettings as ScheduleSettings, type config_Settings as Settings, type config_SettingsSection as SettingsSection, type config_Since as Since, type config_SummarizeSettings as SummarizeSettings, type config_TrendingSettings as TrendingSettings, config_effectiveBaseURL as effectiveBaseURL, config_isEnrich as isEnrich, config_isPeriod as isPeriod, config_isValidTimezone as isValidTimezone, config_mergeSettingsSection as mergeSettingsSection, config_normalizeSettings as normalizeSettings, config_sectionOfField as sectionOfField, config_toCoreConfig as toCoreConfig, config_toYaml as toYaml, config_validateSettings as validateSettings };
+  export { type config_AuthMode as AuthMode, config_CORE_PROVIDERS as CORE_PROVIDERS, type config_CommitMode as CommitMode, type config_CoreConfig as CoreConfig, config_DEFAULT_SETTINGS as DEFAULT_SETTINGS, type config_Enrich as Enrich, type config_GithubSettings as GithubSettings, type config_ModelSettings as ModelSettings, type config_NetworkSettings as NetworkSettings, type config_ObserveSettings as ObserveSettings, type config_OutputSettings as OutputSettings, config_PERIODS as PERIODS, config_PROVIDER_BASE_URLS as PROVIDER_BASE_URLS, type config_PRSettings as PRSettings, type config_Period as Period, type config_Problem as Problem, type config_Provider as Provider, type config_ReleaseScheduleSettings as ReleaseScheduleSettings, type config_ReleasesSettings as ReleasesSettings, type config_RepoSettings as RepoSettings, config_SETTINGS_SECTIONS as SETTINGS_SECTIONS, type config_ScheduleSettings as ScheduleSettings, type config_Settings as Settings, type config_SettingsSection as SettingsSection, type config_Since as Since, type config_SummarizeSettings as SummarizeSettings, type config_TrendingSettings as TrendingSettings, config_effectiveBaseURL as effectiveBaseURL, config_isEnrich as isEnrich, config_isPeriod as isPeriod, config_isValidTimezone as isValidTimezone, config_mergeSettingsSection as mergeSettingsSection, config_normalizeSettings as normalizeSettings, config_sectionOfField as sectionOfField, config_toCoreConfig as toCoreConfig, config_toYaml as toYaml, config_validateSettings as validateSettings };
 }
 
 declare const PLUGIN_DIR_NAME = "github-trending";

package/lib/internal.js

@@ -27,7 +27,7 @@ import {
   tools_exports,
   update_exports,
   version_exports
-} from "./chunk-SLY2RKCZ.js";
+} from "./chunk-DGEO5BHK.js";
 
 // src/internal.ts
 import * as exec from "@morehao/dsh-plugin-kit/exec";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@morehao/dsh-github-trending",
-  "version": "0.8.22",
+  "version": "0.8.23",
   "description": "GitHub 趋势日报的 DeepSeek Harness 插件：按日 / 周 / 月周期定时 spawn 本地 trendradar 核心，抓取 Trending、生成中文简介与周期总结，并可选把订阅仓库的新 Release 合成中文摘要，一起提交到你的仓库、自动开 PR 合并；内置概览 / 榜单 / 运行记录 / 订阅 / 设置工作台。",
   "type": "module",
   "main": "lib/index.js",
@@ -60,7 +60,7 @@
     },
     "core": {
       "repo": "morehao/trendradar",
-      "version": "0.8.7"
+      "version": "0.8.8"
     },
     "client": {
       "platform": "web",