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 (
     <div className={className}>
@@ -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) {
           <Mdx components={getMDXComponents()} />
           <Contributors entry={contributorsEntry} />
           <section className="mt-16">
-            <GiscusComments docId={docIdFromPage ?? null} />
+            <GiscusComments
+              docId={docIdFromPage ?? null}
+              title={discussionTitle}
+            />
           </section>
         </DocsBody>
       </DocsPage>
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: <id>]，用于从 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<term>
+    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 <term>
+  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);
+});