From ff3f8fb2335e3ee6f9330a7b9a51fb3d63d84d53 Mon Sep 17 00:00:00 2001 From: Loong Loong Date: Wed, 8 Oct 2025 21:32:54 +0800 Subject: [PATCH] =?UTF-8?q?feat:=E4=B8=BA=E8=AE=A8=E8=AE=BA=E5=8A=A0?= =?UTF-8?q?=E4=B8=8Atitle?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- app/components/GiscusComments.tsx | 19 ++- app/docs/[...slug]/page.tsx | 6 +- scripts/test.mjs | 266 ++++++++++++++++++++++++++++++ 3 files changed, 286 insertions(+), 5 deletions(-) create mode 100644 scripts/test.mjs diff --git a/app/components/GiscusComments.tsx b/app/components/GiscusComments.tsx index cfde287..ef8d60a 100644 --- a/app/components/GiscusComments.tsx +++ b/app/components/GiscusComments.tsx @@ -5,10 +5,21 @@ import Giscus from "@giscus/react"; interface GiscusCommentsProps { className?: string; docId?: string | null; + title?: string | null; } -export function GiscusComments({ className, docId }: GiscusCommentsProps) { - const useDocId = typeof docId === "string" && docId.trim().length > 0; +export function GiscusComments({ + className, + docId, + title, +}: GiscusCommentsProps) { + const normalizedDocId = typeof docId === "string" ? docId.trim() : ""; + const normalizedTitle = typeof title === "string" ? title.trim() : ""; + + const useSpecificMapping = normalizedDocId.length > 0; + const termValue = useSpecificMapping + ? `${normalizedTitle || "Untitled"} | ${normalizedDocId}` + : undefined; return (
@@ -17,8 +28,8 @@ export function GiscusComments({ className, docId }: GiscusCommentsProps) { repoId="R_kgDOPuD_8A" category="Comments" categoryId="DIC_kwDOPuD_8M4Cvip8" - mapping={useDocId ? "specific" : "pathname"} - term={useDocId ? docId : undefined} + mapping={useSpecificMapping ? "specific" : "pathname"} + term={termValue} strict="0" reactionsEnabled="1" emitMetadata="0" diff --git a/app/docs/[...slug]/page.tsx b/app/docs/[...slug]/page.tsx index 0d20f06..98256d4 100644 --- a/app/docs/[...slug]/page.tsx +++ b/app/docs/[...slug]/page.tsx @@ -57,6 +57,7 @@ export default async function DocPage({ params }: Param) { const contributorsEntry = getDocContributorsByPath(page.file.path) || getDocContributorsByDocId(docIdFromPage); + const discussionTitle = page.data.title ?? docIdFromPage ?? page.path; const Mdx = page.data.body; // Prepare page content for AI assistant @@ -86,7 +87,10 @@ export default async function DocPage({ params }: Param) {
- +
diff --git a/scripts/test.mjs b/scripts/test.mjs new file mode 100644 index 0000000..b695817 --- /dev/null +++ b/scripts/test.mjs @@ -0,0 +1,266 @@ +#!/usr/bin/env node +/** + * 将 GitHub Discussions 标题补上 [docId: ]，用于从 pathname->docId 的 Giscus 迁移。 + * + * 两种输入来源： + * A) DB 模式（推荐）：读取 Postgres（docs/path_current + doc_paths）获得每个 docId 的所有历史路径 + * B) 映射文件模式：传入 JSON 文件，手动提供 docId 与候选“旧 term”（通常是旧路径） + * + * 需要： + * - GH_TOKEN（或者 GITHUB_TOKEN）：具备 Discussions: read/write（fine-grained）或 repo 权限 + * - GITHUB_OWNER, GITHUB_REPO + * - （可选）DATABASE_URL（启用 DB 模式） + * + * 用法示例： + * # 仅预览（dry run，默认） + * node scripts/migrate-giscus-add-docid.mjs --owner=InvolutionHell --repo=involutionhell.github.io + * + * # 真正执行（写入） + * node scripts/migrate-giscus-add-docid.mjs --owner=InvolutionHell --repo=involutionhell.github.io --apply=true + * + * # 用映射文件（不连 DB） + * node scripts/migrate-giscus-add-docid.mjs --map=tmp/discussion-map.json --apply=true + * + * 映射文件格式（示例）： + * { + * "i0xmpsk...xls": ["app/docs/foo/bar.mdx", "/docs/foo/bar"], + * "abcd123...": ["app/docs/baz.md"] + * } + */ + +import "dotenv/config"; +import fs from "node:fs/promises"; +import path from "node:path"; +import process from "node:process"; + +// 可选：DB（Prisma） +let prisma = null; +try { + const { PrismaClient } = await import("../generated/prisma/index.js"); + if (process.env.DATABASE_URL) { + prisma = new PrismaClient(); + } +} catch { + // 没有 prisma 也可运行（映射文件模式） +} + +// Node18+ 自带 fetch +const GH_TOKEN = process.env.GH_TOKEN || process.env.GITHUB_TOKEN || ""; +const OWNER = getArg("owner") || process.env.GITHUB_OWNER || "InvolutionHell"; +const REPO = + getArg("repo") || process.env.GITHUB_REPO || "involutionhell.github.io"; +const MAP = getArg("map") || process.env.GISCUS_DISCUSSION_MAP || ""; // JSON 文件（映射文件模式） +const APPLY = (getArg("apply") || "false").toLowerCase() === "true"; // 是否真的更新标题 + +if (!GH_TOKEN) { + console.error("[migrate-giscus] Missing GH_TOKEN/GITHUB_TOKEN."); + process.exit(1); +} + +function getArg(k) { + const arg = process.argv.slice(2).find((s) => s.startsWith(`--${k}=`)); + return arg ? arg.split("=")[1] : null; +} + +const GQL = "https://api.github.com/graphql"; +const ghHeaders = { + "Content-Type": "application/json", + Authorization: `Bearer ${GH_TOKEN}`, + "User-Agent": "giscus-docid-migrator", +}; + +// 简单日志 +const log = (...a) => console.log("[migrate-giscus]", ...a); + +// GraphQL helpers +async function ghQuery(query, variables) { + const res = await fetch(GQL, { + method: "POST", + headers: ghHeaders, + body: JSON.stringify({ query, variables }), + }); + if (!res.ok) { + const text = await res.text(); + throw new Error( + `GitHub GraphQL failed: ${res.status} ${res.statusText} -> ${text}`, + ); + } + const json = await res.json(); + if (json.errors) { + throw new Error(`GraphQL errors: ${JSON.stringify(json.errors)}`); + } + return json.data; +} + +const Q_SEARCH_DISCUSSIONS = ` + query SearchDiscussions($q: String!) { + search(query: $q, type: DISCUSSION, first: 20) { + nodes { + ... on Discussion { + id + number + title + url + category { id name } + repository { nameWithOwner } + } + } + } + } +`; + +const M_UPDATE_DISCUSSION = ` + mutation UpdateDiscussion($id: ID!, $title: String!) { + updateDiscussion(input: { discussionId: $id, title: $title }) { + discussion { id number title url } + } + } +`; + +// 读取输入来源：DB 或 映射文件 +async function loadDocIdTerms() { + // 优先 DB + if (prisma) { + log("Loading doc paths from DB…"); + const docs = await prisma.docs.findMany({ + select: { + id: true, + path_current: true, + doc_paths: { select: { path: true } }, + }, + }); + const map = new Map(); // docId -> Set + for (const d of docs) { + const set = map.get(d.id) ?? new Set(); + if (d.path_current) set.add(d.path_current); + for (const p of d.doc_paths) if (p?.path) set.add(p.path); + // 兼容站点实际的 pathname（可选添加去掉扩展名、加前缀） + for (const p of Array.from(set)) { + const noExt = p.replace(/\.(md|mdx|markdown)$/i, ""); + set.add(noExt); + set.add(`/${noExt}`); // 常见 pathname 形态 + } + map.set(d.id, set); + } + return map; + } + + // 退化：映射文件模式 + if (MAP) { + const abs = path.resolve(process.cwd(), MAP); + const raw = await fs.readFile(abs, "utf8"); + const obj = JSON.parse(raw); + const map = new Map(); + for (const [docId, arr] of Object.entries(obj)) { + const set = new Set(); + (arr || []).forEach((t) => { + if (typeof t === "string" && t.trim()) { + set.add(t.trim()); + const noExt = t.replace(/\.(md|mdx|markdown)$/i, ""); + set.add(noExt); + set.add(`/${noExt}`); + } + }); + map.set(docId, set); + } + return map; + } + + throw new Error("No DATABASE_URL (DB 模式) and no --map JSON provided."); +} + +// 搜索一个 term 对应的讨论（尽量限定到你的仓库） +async function searchDiscussionByTerm(term) { + // GitHub 搜索语法：repo:OWNER/REPO in:title + const q = `${term} repo:${OWNER}/${REPO} in:title`; + const data = await ghQuery(Q_SEARCH_DISCUSSIONS, { q }); + const nodes = data?.search?.nodes || []; + // 过滤到目标仓库的讨论（双重保险） + return nodes.filter( + (n) => + n?.repository?.nameWithOwner?.toLowerCase() === + `${OWNER}/${REPO}`.toLowerCase(), + ); +} + +// 如果标题中已经包含 [docId: xxx]，就跳过 +function alreadyHasDocIdTag(title, docId) { + const tag = `[docId:${docId}]`; + return title.includes(tag); +} + +// 生成新标题（在末尾追加，如已含则不变） +function appendDocIdTag(title, docId) { + const tag = `[docId:${docId}]`; + if (title.includes(tag)) return title; + // 避免标题太挤，加个空格 + return `${title.trim()} ${tag}`; +} + +async function main() { + log( + `Target repo: ${OWNER}/${REPO} | Mode: ${prisma ? "DB" : MAP ? "MAP" : "UNKNOWN"}`, + ); + const docIdToTerms = await loadDocIdTerms(); + + let updated = 0, + skipped = 0, + notFound = 0, + examined = 0; + + for (const [docId, termsSet] of docIdToTerms) { + const terms = Array.from(termsSet); + let matched = null; + + // 尝试每个 term，直到命中一个讨论 + for (const term of terms) { + const hits = await searchDiscussionByTerm(term); + // 多命中：优先那些标题更“像”旧路径的；简单按包含度/长度排序 + const scored = hits + .map((d) => ({ d, score: d.title.includes(term) ? term.length : 0 })) + .sort((a, b) => b.score - a.score); + + if (scored.length > 0) { + matched = scored[0].d; + break; + } + } + + if (!matched) { + notFound += 1; + log(`⚠️ docId=${docId} 未找到旧讨论（terms=${terms.join(", ")})`); + continue; + } + + examined += 1; + + const oldTitle = matched.title; + if (alreadyHasDocIdTag(oldTitle, docId)) { + skipped += 1; + log(`⏭ #${matched.number} 已包含 docId：${matched.url}`); + continue; + } + + const newTitle = appendDocIdTag(oldTitle, docId); + log( + `${APPLY ? "✏️ 更新" : "👀 预览"} #${matched.number} "${oldTitle}" → "${newTitle}"`, + ); + + if (APPLY) { + await ghQuery(M_UPDATE_DISCUSSION, { id: matched.id, title: newTitle }); + updated += 1; + } + } + + log( + `Done. examined=${examined}, updated=${updated}, skipped=${skipped}, notFound=${notFound}`, + ); + + if (prisma) await prisma.$disconnect(); +} + +main().catch(async (e) => { + console.error(e); + if (prisma) await prisma.$disconnect(); + process.exit(1); +});