@morehao/dsh-github-trending 0.7.10 → 0.8.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [v0.7.11] - 2026-11-01
+
+### Refactors
+
+- **settings**: merge schedule into scope card and link subscription repos (#65)
+
+### Docs
+
+- 新增英文版 README.en.md，中文 README 默认并加语言切换 (#64)
+
+**Full Changelog**: https://github.com/morehao/dsh-github-trending/compare/v0.7.10...v0.7.11
+
 ## [v0.7.10] - 2026-11-01
 
 > 修复 peer / engine 版本区间漏掉 `0.2.2-*` 预发布的问题，让插件在宿主升到 `0.2.2` 线后仍能正常安装。

package/README.en.md

@@ -0,0 +1,92 @@
+<p align="center">
+  <img src="icon.svg" alt="dsh-github-trending logo" width="88" height="88">
+</p>
+
+<h1 align="center">dsh-github-trending</h1>
+
+<p align="center">
+  A DeepSeek Harness plugin for the GitHub Trending board
+</p>
+
+<p align="center">
+  <a href="README.md">简体中文</a> | English
+</p>
+
+<p align="center">
+  <a href="https://github.com/morehao/dsh-github-trending/actions/workflows/check.yml"><img alt="check" src="https://github.com/morehao/dsh-github-trending/actions/workflows/check.yml/badge.svg"></a>
+  <a href="https://www.npmjs.com/package/@morehao/dsh-github-trending"><img alt="npm version" src="https://img.shields.io/npm/v/@morehao/dsh-github-trending.svg"></a>
+</p>
+
+A **DeepSeek Harness plugin** for the GitHub Trending board: it schedules daily / weekly / monthly digests, hands them to the local [`trendradar`](https://github.com/morehao/trendradar) core to scrape Trending, write Chinese intros and period summaries, and commits the result to your own repository with a PR merged automatically. You follow status, read digests and manage subscriptions from the workbench — no command line needed.
+
+## Positioning
+
+- **An entry point, not an engine**. Scraping, parsing, model summarization, rendering, git and PR all live in one place — the local `trendradar` core. The plugin only handles **configuration, scheduling, spawning the core and displaying results**, so there is no second implementation to drift.
+- **Deliver the artifact as-is**. Content is written byte-for-byte exactly as the core produces it; the plugin does not rewrite, reorder or re-invoke a model on it.
+- **Local execution, no telemetry**. The core runs on your machine; the plugin has no cloud account, and secrets are handed to the core only over a runtime channel — never written to config files or logs.
+
+> For deeper material — requirements, config fields, error codes, subscription stages and implementation details — see **[docs/reference.md](docs/reference.md)**.
+
+## Features
+
+Open the workbench from the sidebar **GitHub Trending** or `Settings → GitHub Trending`. It has five views:
+
+### Overview
+
+Answers "when will it run next, are the four readiness checks all green, what was delivered last time" at a glance. The top shows the plugin identity bar (version / package name / check for updates); the right side keeps the next run and readiness N/4 always visible.
+
+![Overview](docs/images/overview.png)
+
+### Digest
+
+Browse past digests by period (daily / weekly / monthly). Markdown is rendered directly (headings, lists, tables, links), and you can switch to **Raw**. Only issues whose preview copy was kept can be read; failed / unchanged / dry-run / old records each have their own empty state.
+
+![Digest](docs/images/digest.png)
+
+### Runs
+
+The last 30 runs, filterable by success / failure / dry-run. Expand a run to see its deliverables (commit, content hash, branch, PR link) and a read-only log; the footer shows cumulative tokens.
+
+![Runs](docs/images/runs.png)
+
+### Settings
+
+Six sections — Content source / Model / Repository / Auth / Digest / Schedule — each saved and validated independently; an unsaved section shows a yellow dot next to its item on the left.
+
+![Settings](docs/images/settings.png)
+
+### Subscriptions
+
+(Optional) Subscribe to a set of repositories; each week the new Releases from each of them are merged into one Chinese summary and committed alongside the digest on the same branch and PR. The subscription list is versioned with the data repo, auditable and reproducible.
+
+![Subscriptions](docs/images/subscriptions.png)
+
+## Installation
+
+```bash
+dsh plugin --profile <profile> add @morehao/dsh-github-trending
+```
+
+Restart the host after installing, then open **GitHub Trending** from the sidebar or `Settings → GitHub Trending`.
+
+### Quick start in three steps
+
+1. **Pick a repository**: enter the absolute path of a local git repository (the plugin does not run `git init` for you; a non-repo path returns `REPO_NOT_GIT`).
+2. **Pick a model**: click "Use DSH config" to choose a provider and model from the host's provider directory; providers that can export a key pass it straight to the core, while OAuth-type credentials go through a local loopback proxy.
+3. **Dry-run once**: "Dry run (no commit)" only scrapes and renders — it writes no files and makes no commit.
+
+Requirements: DSH `0.2.1-rc.3` or later, Node.js `^22.20.0 || >=24.0.0`, a local git ≥ 2.30 with a writable remote, and git / GitHub credentials (needed only for push and opening PRs). On first run the core binary is downloaded from GitHub Releases and verified by sha256, then reused offline.
+
+## Development and release
+
+```bash
+npm install
+npm run check            # typecheck + contract check + build + all tests
+node scripts/ac/run.mjs  # AC-P mechanical checks
+```
+
+Releases go through **tag-triggered CI** (Trusted Publishing / OIDC): merge the PR → push an annotated tag `vX.Y.Z` on `main` → CI publishes to npm and creates the Release from the annotation body. See [docs/publishing.md](docs/publishing.md) for details.
+
+## License
+
+MIT

package/README.md

@@ -8,6 +8,10 @@
   GitHub 趋势榜的 DeepSeek Harness 插件
 </p>
 
+<p align="center">
+  简体中文 | <a href="README.en.md">English</a>
+</p>
+
 <p align="center">
   <a href="https://github.com/morehao/dsh-github-trending/actions/workflows/check.yml"><img alt="check" src="https://github.com/morehao/dsh-github-trending/actions/workflows/check.yml/badge.svg"></a>
   <a href="https://www.npmjs.com/package/@morehao/dsh-github-trending"><img alt="npm version" src="https://img.shields.io/npm/v/@morehao/dsh-github-trending.svg"></a>

package/client.js

@@ -54,7 +54,7 @@ var DICT = {
     "st.model": "模型",
     "st.repo": "仓库",
     "st.auth": "认证",
-    "st.scope": "榜单",
+    "st.scope": "榜单与调度",
     "st.summarize": "摘要与用量",
     "st.releases": "订阅",
     "st.schedule": "调度",
@@ -123,7 +123,19 @@ var DICT = {
     "auth.mode": "方式",
     "auth.pat": "PAT",
     "auth.gh": "本机 gh",
+    "auth.browser": "浏览器登录",
     "auth.gh.hint": "使用本机 gh 登录态：终端执行 `gh auth login` 完成登录，再点「测试认证」。",
+    "auth.browser.hint": "在浏览器里完成 GitHub 授权，token 由 DSH 安全保存，无需手工粘贴。",
+    "auth.browser.signin": "用 GitHub 登录",
+    "auth.browser.waiting": "等待浏览器授权…",
+    "auth.browser.code": "在打开的页面输入验证码：",
+    "auth.browser.cancel": "取消",
+    "auth.browser.done": "已登录",
+    "auth.browser.device": "用设备码登录",
+    "auth.browser.unavailable": "当前环境未配置 GitHub OAuth client_id，浏览器登录不可用：请改用「本机 gh」或 PAT。",
+    "auth.browser.openHint": "若浏览器未自动打开，请手动打开发起授权，或复制链接：",
+    "auth.browser.copy": "复制链接",
+    "auth.browser.copied": "授权链接已复制",
     "auth.pat.hint": "在 GitHub → Settings → Developer settings 生成 Personal Access Token（勾选 public_repo），填到下方引用或环境变量。",
     "auth.tokenRef": "凭据引用",
     "auth.tokenRef.hint": "凭据引用名 / 环境变量名",
@@ -583,7 +595,7 @@ var DICT = {
     "st.model": "Model",
     "st.repo": "Repository",
     "st.auth": "Auth",
-    "st.scope": "Scope",
+    "st.scope": "Scope & Schedule",
     "st.summarize": "Summary & usage",
     "st.releases": "Subscriptions",
     "st.schedule": "Schedule",
@@ -652,7 +664,19 @@ var DICT = {
     "auth.mode": "Mode",
     "auth.pat": "PAT",
     "auth.gh": "Local gh",
+    "auth.browser": "Browser login",
     "auth.gh.hint": "Uses your local gh login: run `gh auth login` in a terminal, then click Test authentication.",
+    "auth.browser.hint": "Authorize GitHub in your browser; DSH stores the token securely, no manual paste.",
+    "auth.browser.signin": "Sign in with GitHub",
+    "auth.browser.waiting": "Waiting for browser authorization…",
+    "auth.browser.code": "Enter this code on the opened page:",
+    "auth.browser.cancel": "Cancel",
+    "auth.browser.done": "Signed in",
+    "auth.browser.device": "Use a device code",
+    "auth.browser.unavailable": "No GitHub OAuth client_id configured in this environment, so browser sign-in is unavailable: use Local gh or PAT instead.",
+    "auth.browser.openHint": "If the browser did not open, open the authorization page manually, or copy the link:",
+    "auth.browser.copy": "Copy link",
+    "auth.browser.copied": "Authorization link copied",
     "auth.pat.hint": "Create a Personal Access Token under GitHub → Settings → Developer settings (scope public_repo) and put it in the ref below or an env var.",
     "auth.tokenRef": "Credential ref",
     "auth.tokenRef.hint": "credential ref / env var name",
@@ -1147,6 +1171,7 @@ var CSS = `
 .dshgt-card-h h3{margin:0;font-size:13px;font-weight:600;white-space:nowrap;}
 .dshgt-hint{color:var(--gt-muted);font-size:12px;}
 .dshgt-desc{margin:0;color:var(--gt-muted);font-size:12px;}
+.dshgt-subhead{margin:4px 0 0;padding-top:8px;border-top:1px solid var(--gt-border);font-size:12px;font-weight:600;color:var(--gt-muted);}
 .dshgt-row{display:flex;gap:10px;align-items:center;min-height:28px;flex-wrap:wrap;}
 .dshgt-row>label.dshgt-label{width:96px;color:var(--gt-muted);flex:none;font-size:12px;display:flex;align-items:flex-start;gap:5px;}
 .dshgt-label-text{flex:1;min-width:0;}
@@ -1521,6 +1546,8 @@ var CSS = `
 .dshgt-subs-cb{width:14px;height:14px;margin:0;accent-color:var(--gt-accent);justify-self:center;}
 .dshgt-subs-ident{font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:12.5px;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;}
 .dshgt-subs-ident mark{background:color-mix(in srgb,var(--gt-accent) 18%,transparent);color:inherit;border-radius:3px;padding:0 1px;}
+.dshgt-subs-ident-link{color:inherit;text-decoration:none;min-width:0;overflow:hidden;text-overflow:ellipsis;}
+.dshgt-subs-ident-link:hover{color:var(--gt-accent);text-decoration:underline;text-underline-offset:2px;}
 .dshgt-subs-ver{font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:12px;color:var(--gt-fg);text-align:right;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;min-width:0;}
 .dshgt-subs-sum{font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:11.5px;color:var(--gt-muted);text-align:right;white-space:nowrap;}
 .dshgt-subs-stat{display:flex;align-items:center;gap:6px;padding-left:4px;font-size:12px;color:var(--gt-muted);white-space:nowrap;}
@@ -1848,6 +1875,23 @@ async function apiCall(method, path, body, options = {}) {
   }
   return json;
 }
+async function beginGithubSignIn(method = "browser") {
+  const payload = await apiCall("POST", "/github/browser/begin", { method });
+  return payload.attempt;
+}
+async function getGithubSignInStatus(signal) {
+  const payload = await apiCall(
+    "GET",
+    "/github/browser/status",
+    void 0,
+    signal === void 0 ? {} : { signal }
+  );
+  return payload.attempt;
+}
+async function cancelGithubSignIn() {
+  const payload = await apiCall("POST", "/github/browser/cancel", {});
+  return payload.attempt;
+}
 function releaseRunsOf(state) {
   if (state === null || state === void 0) return [];
   const root = Array.isArray(state.releaseRuns) ? state.releaseRuns : void 0;
@@ -2024,8 +2068,8 @@ function credentialView(model, t) {
 
 // client/settings.ts
 var LANGUAGES = ["all", "typescript", "python", "go", "rust", "java", "c", "cpp", "javascript", "csharp"];
-var SECTIONS = ["source", "model", "repo", "auth", "scope", "summarize", "releases", "schedule"];
-var EMPTY_DIRTY = { source: false, model: false, repo: false, auth: false, scope: false, summarize: false, releases: false, schedule: false };
+var SECTIONS = ["source", "model", "repo", "auth", "scope", "summarize", "releases"];
+var EMPTY_DIRTY = { source: false, model: false, repo: false, auth: false, scope: false, summarize: false, releases: false };
 function cloneSettings(settings) {
   return JSON.parse(JSON.stringify(settings));
 }
@@ -2040,13 +2084,11 @@ function sectionSlice(settings, section) {
     case "auth":
       return { github: settings.github };
     case "scope":
-      return { trending: settings.trending };
+      return { trending: settings.trending, schedule: settings.schedule };
     case "summarize":
       return { summarize: settings.summarize };
     case "releases":
       return { releases: settings.releases };
-    case "schedule":
-      return { schedule: settings.schedule };
   }
 }
 var NOTICE_TTL_MS = 5e3;
@@ -2077,6 +2119,7 @@ function SettingsView(props) {
   const [branchLoading, setBranchLoading] = import_react.default.useState(false);
   const [testing, setTesting] = import_react.default.useState(false);
   const [githubTest, setGithubTest] = import_react.default.useState(null);
+  const [signIn, setSignIn] = import_react.default.useState({ phase: "idle" });
   const anyDirty = SECTIONS.some((id) => dirtySections[id]);
   const sectionEditable = section !== "source";
   import_react.default.useEffect(() => {
@@ -2204,6 +2247,52 @@ function SettingsView(props) {
       setTesting(false);
     }
   };
+  const startSignIn = async (method) => {
+    try {
+      const view = await beginGithubSignIn(method);
+      setSignIn(view);
+      if (view.phase === "waiting-browser" && view.authorizeUrl !== void 0) {
+        try {
+          window.open(view.authorizeUrl, "_blank", "noopener,noreferrer");
+        } catch {
+        }
+      }
+    } catch (error) {
+      notify("err", error instanceof Error ? error.message : String(error));
+    }
+  };
+  const cancelSignIn = async () => {
+    try {
+      setSignIn(await cancelGithubSignIn());
+    } catch (error) {
+      notify("err", error instanceof Error ? error.message : String(error));
+    }
+  };
+  const copyAuthorizeLink = () => {
+    if (signIn.authorizeUrl === void 0) return;
+    void navigator.clipboard?.writeText(signIn.authorizeUrl).then(() => notify("ok", t("auth.browser.copied")));
+  };
+  const signInActive = signIn.phase === "waiting-browser" || signIn.phase === "waiting-device" || signIn.phase === "exchanging";
+  import_react.default.useEffect(() => {
+    if (!signInActive) return void 0;
+    let alive = true;
+    const timer = setInterval(() => {
+      void getGithubSignInStatus().then((view) => {
+        if (!alive) return;
+        setSignIn(view);
+        if (view.phase === "done") {
+          setGithubTest(view.login === void 0 ? { ok: true } : { ok: true, login: view.login });
+          notify("ok", t("auth.browser.done"));
+          void store.refresh({ quiet: true });
+        }
+      }).catch(() => {
+      });
+    }, 1500);
+    return () => {
+      alive = false;
+      clearInterval(timer);
+    };
+  }, [signInActive]);
   const importCli = async () => {
     try {
       const result = await apiCall(
@@ -2242,6 +2331,8 @@ function SettingsView(props) {
   const branchText = branchLoading ? t("branch.loading") : branchInfo?.branch !== void 0 ? branchInfo.branch : draft.repo.baseBranch !== "" ? draft.repo.baseBranch : "—";
   const branchHint = branchInfo?.source === "origin-head" ? t("branch.fromOrigin") : branchInfo?.source === "head" ? t("branch.fromHead") : branchInfo?.message !== void 0 ? branchInfo.message : t("branch.readonlyHint");
   const isGh = draft.github.authMode === "gh";
+  const isBrowser = draft.github.authMode === "browser";
+  const browserAvailable = state.github.browserAvailable === true;
   const sections = [
     { id: "source", label: t("st.source") },
     { id: "model", label: t("st.model") },
@@ -2249,8 +2340,7 @@ function SettingsView(props) {
     { id: "auth", label: t("st.auth") },
     { id: "scope", label: t("st.scope") },
     { id: "summarize", label: t("st.summarize") },
-    { id: "releases", label: t("st.releases") },
-    { id: "schedule", label: t("st.schedule") }
+    { id: "releases", label: t("st.releases") }
   ];
   const sourceCard = h(
     Card,
@@ -2419,16 +2509,32 @@ function SettingsView(props) {
         value: draft.github.authMode,
         options: [
           { value: "gh", label: t("auth.gh") },
-          { value: "pat", label: t("auth.pat") }
+          { value: "pat", label: t("auth.pat") },
+          { value: "browser", label: t("auth.browser") }
         ],
         onChange: (value) => update((next) => {
-          next.github.authMode = value === "pat" ? "pat" : "gh";
+          next.github.authMode = value === "pat" ? "pat" : value === "browser" ? "browser" : "gh";
         })
       }),
       h(Pill, { kind: state.github.configured ? "ok" : "warn" }, state.github.configured ? `${t("auth.configured")} · ${state.github.source}` : t("auth.missing"))
     ),
-    h("p", { className: "dshgt-hint" }, isGh ? t("auth.gh.hint") : t("auth.pat.hint")),
-    isGh ? null : h(
+    h("p", { className: "dshgt-hint" }, isGh ? t("auth.gh.hint") : isBrowser ? t("auth.browser.hint") : t("auth.pat.hint")),
+    isGh ? null : isBrowser ? h(
+      Row,
+      { label: t("auth.status") },
+      browserAvailable ? h(
+        Btn,
+        {
+          small: true,
+          variant: "primary",
+          onClick: () => void startSignIn("browser"),
+          disabled: signInActive
+        },
+        signIn.phase === "done" && signIn.login !== void 0 ? `${t("auth.browser.done")} · @${signIn.login}` : signInActive ? t("auth.browser.waiting") : t("auth.browser.signin")
+      ) : h("span", { className: "dshgt-hint" }, t("auth.browser.unavailable")),
+      browserAvailable ? h(Btn, { small: true, variant: "ghost", onClick: () => void startSignIn("device"), disabled: signInActive }, t("auth.browser.device")) : null,
+      signInActive ? h(Btn, { small: true, variant: "ghost", onClick: () => void cancelSignIn() }, t("auth.browser.cancel")) : null
+    ) : h(
       Row,
       { label: t("auth.tokenRef") },
       h(Input, { mono: true, width: 220, value: draft.github.tokenRef, placeholder: "GITHUB_TOKEN", onInput: (value) => update((next) => {
@@ -2436,6 +2542,19 @@ function SettingsView(props) {
       }) }),
       h("span", { className: "dshgt-hint" }, t("auth.tokenRef.hint"))
     ),
+    // 浏览器登录进行中的状态行：授权页链接（可复制）+ 设备码。
+    isBrowser && signIn.phase !== "idle" && signIn.phase !== "done" ? h(
+      "div",
+      { className: "dshgt-hint" },
+      signIn.authorizeUrl !== void 0 ? h(
+        "div",
+        { className: "dshgt-desc" },
+        h("span", null, t("auth.browser.openHint")),
+        " ",
+        h(Btn, { small: true, variant: "ghost", onClick: () => copyAuthorizeLink() }, t("auth.browser.copy"))
+      ) : null,
+      signIn.userCode !== void 0 ? h("div", { className: "dshgt-mono" }, `${t("auth.browser.code")} ${signIn.userCode}`) : null
+    ) : null,
     h(
       Row,
       { label: t("auth.test") },
@@ -2449,7 +2568,10 @@ function SettingsView(props) {
   );
   const scopeCard = h(
     Card,
-    { title: t("card.scope.title") },
+    {
+      title: t("card.scope.title"),
+      hint: state.schedule.nextRunAt === void 0 ? void 0 : `${t("schedule.next")} ${localTime(state.schedule.nextRunAt)}`
+    },
     h(
       Row,
       { label: t("scope.period") },
@@ -2483,11 +2605,8 @@ function SettingsView(props) {
           draftNext.trending.languages = next;
         })
       })
-    )
-  );
-  const scheduleCard = h(
-    Card,
-    { title: t("card.schedule.title"), hint: state.schedule.nextRunAt === void 0 ? void 0 : `${t("schedule.next")} ${localTime(state.schedule.nextRunAt)}` },
+    ),
+    h("h4", { className: "dshgt-subhead" }, t("card.schedule.title")),
     h(
       Row,
       { label: t("schedule.enabled") },
@@ -2657,7 +2776,7 @@ function SettingsView(props) {
       })
     )
   );
-  const currentCard = section === "source" ? sourceCard : section === "model" ? modelCard : section === "repo" ? repoCard : section === "auth" ? authCard : section === "scope" ? scopeCard : section === "summarize" ? summarizeCard : section === "releases" ? releasesCard : scheduleCard;
+  const currentCard = section === "source" ? sourceCard : section === "model" ? modelCard : section === "repo" ? repoCard : section === "auth" ? authCard : section === "scope" ? scopeCard : section === "summarize" ? summarizeCard : releasesCard;
   return h(
     "div",
     { className: "dshgt-settings" },
@@ -4574,6 +4693,9 @@ function highlight(text, needle) {
   if (index < text.length) parts.push(text.slice(index));
   return parts;
 }
+function repoUrl(name) {
+  return /^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/.test(name) ? `https://github.com/${name}` : void 0;
+}
 function isMissingDoc(code, message) {
   if (code !== void 0 && /NOT_?FOUND|MISSING|NO_?DOC/i.test(code)) return true;
   return /not\s*found|no such file|enoent|404|不存在|no release document|has no release|无发版记录/i.test(message);
@@ -4885,7 +5007,21 @@ function SubscriptionsView(props) {
         }
       },
       checkbox,
-      h("span", { key: "name", role: "cell", className: "dshgt-subs-ident", title: row.name }, highlight(row.name, needle)),
+      h(
+        "span",
+        { key: "name", role: "cell", className: "dshgt-subs-ident", title: row.name },
+        repoUrl(row.name) === void 0 ? highlight(row.name, needle) : h(
+          "a",
+          {
+            className: "dshgt-subs-ident-link",
+            href: repoUrl(row.name),
+            target: "_blank",
+            rel: "noreferrer",
+            onClick: (event) => event.stopPropagation()
+          },
+          highlight(row.name, needle)
+        )
+      ),
       h("span", { key: "tag", role: "cell", className: "dshgt-subs-ver", title: item?.latestTag ?? "" }, item?.latestTag ?? "—"),
       h(
         "span",