From 2fa0e04508adb60053ca909287471ba263b474dc Mon Sep 17 00:00:00 2001
From: anghunk <anghunk@gmail.com>
Date: Thu, 22 Jan 2026 10:14:17 +0800
Subject: [PATCH] =?UTF-8?q?feat(admin):=20=E6=B7=BB=E5=8A=A0=E5=9F=9F?=
 =?UTF-8?q?=E5=90=8D=E5=88=97=E8=A1=A8=E8=8E=B7=E5=8F=96=E5=8A=9F=E8=83=BD?=
 =?UTF-8?q?=E7=94=A8=E4=BA=8E=E7=AD=9B=E9=80=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

新增获取域名列表的API端点，用于统一管理评论和访问统计中的域名筛选功能。修改了前端多个视图的域名获取逻辑，从原来的分散获取改为统一调用新接口，提高代码复用性和维护性。

docs: 添加反馈页面并更新侧边栏
---
 cwd-admin/src/api/admin.ts                 |  8 +++
 cwd-admin/src/views/AnalyticsVisitView.vue | 37 +++++------
 cwd-admin/src/views/CommentsView.vue       | 10 ++-
 cwd-admin/src/views/StatsView.vue          | 32 ++++++----
 cwd-api/src/api/admin/getDomains.ts        | 74 ++++++++++++++++++++++
 cwd-api/src/index.ts                       |  2 +
 docs/.vitepress/configs/sidebar.js         |  1 +
 docs/api/admin.md                          | 47 ++++++++++++++
 docs/feedback.md                           |  8 +++
 9 files changed, 182 insertions(+), 37 deletions(-)
 create mode 100644 cwd-api/src/api/admin/getDomains.ts
 create mode 100644 docs/feedback.md

diff --git a/cwd-admin/src/api/admin.ts b/cwd-admin/src/api/admin.ts
index 708a689..72ec767 100644
--- a/cwd-admin/src/api/admin.ts
+++ b/cwd-admin/src/api/admin.ts
@@ -107,6 +107,10 @@ export type VisitPagesResponse = {
 	items: VisitPageItem[];
 };
 
+export type DomainListResponse = {
+	domains: string[];
+};
+
 export async function loginAdmin(name: string, password: string): Promise<string> {
 	const res = await post<AdminLoginResponse>('/admin/login', { name, password });
 	const key = res.data.key;
@@ -265,3 +269,7 @@ export function fetchVisitPages(domain?: string, order?: 'pv' | 'latest'): Promi
 	const url = query ? `/admin/analytics/pages?${query}` : '/admin/analytics/pages';
 	return get<VisitPagesResponse>(url);
 }
+
+export function fetchDomainList(): Promise<DomainListResponse> {
+	return get<DomainListResponse>('/admin/stats/domains');
+}
diff --git a/cwd-admin/src/views/AnalyticsVisitView.vue b/cwd-admin/src/views/AnalyticsVisitView.vue
index 7a59410..c0984a3 100644
--- a/cwd-admin/src/views/AnalyticsVisitView.vue
+++ b/cwd-admin/src/views/AnalyticsVisitView.vue
@@ -55,7 +55,7 @@
       <h3 class="card-title">最近 30 天访问趋势</h3>
       <div v-if="loading" class="page-hint">加载中...</div>
       <div v-else-if="error" class="page-error">{{ error }}</div>
-      <div v-else class="chart-wrapper">
+      <div class="chart-wrapper">
         <div ref="chartEl" class="chart"></div>
       </div>
     </div>
@@ -127,6 +127,7 @@ import * as echarts from "echarts";
 import {
   fetchVisitOverview,
   fetchVisitPages,
+  fetchDomainList,
   type VisitOverviewResponse,
   type VisitPageItem,
 } from "../api/admin";
@@ -252,20 +253,6 @@ async function loadData() {
     last30Days.value = Array.isArray(overviewRes.last30Days)
       ? overviewRes.last30Days
       : [];
-
-    const domains = new Set<string>();
-    for (const item of items.value) {
-      const domainFromUrl =
-        extractDomain(item.postUrl) || extractDomain(item.postSlug);
-      if (domainFromUrl) {
-        domains.add(domainFromUrl);
-      }
-    }
-    const options = Array.from(domains);
-    if (domainFilter.value && !options.includes(domainFilter.value)) {
-      options.unshift(domainFilter.value);
-    }
-    domainOptions.value = options;
   } catch (e: any) {
     const msg = e.message || "加载访问统计数据失败";
     error.value = msg;
@@ -274,14 +261,27 @@ async function loadData() {
     loading.value = false;
     listLoading.value = false;
     await nextTick();
-    if (!error.value && last30Days.value.length > 0) {
+    if (!error.value) {
       renderChart();
-    } else if (chartInstance) {
-      chartInstance.clear();
     }
   }
 }
 
+async function loadDomains() {
+  try {
+    const res = await fetchDomainList();
+    const domains = Array.isArray(res.domains) ? res.domains : [];
+    const set = new Set(domains);
+    if (domainFilter.value && !set.has(domainFilter.value)) {
+      set.add(domainFilter.value);
+    }
+    domainOptions.value = Array.from(set);
+  } catch (e: any) {
+    const msg = e.message || "加载域名列表失败";
+    showToast(msg, "error");
+  }
+}
+
 async function loadVisitPagesOnly() {
   listLoading.value = true;
   error.value = "";
@@ -370,6 +370,7 @@ function handleResize() {
 
 onMounted(() => {
   loadData();
+  loadDomains();
   window.addEventListener("resize", handleResize);
 });
 
diff --git a/cwd-admin/src/views/CommentsView.vue b/cwd-admin/src/views/CommentsView.vue
index 4851246..683b288 100644
--- a/cwd-admin/src/views/CommentsView.vue
+++ b/cwd-admin/src/views/CommentsView.vue
@@ -257,12 +257,12 @@ import {
   CommentItem,
   CommentListResponse,
   fetchComments,
-  fetchCommentStats,
   deleteComment,
   updateCommentStatus,
   updateComment,
   blockIp,
   blockEmail,
+  fetchDomainList,
 } from "../api/admin";
 
 const DOMAIN_STORAGE_KEY = "cwd_admin_domain_filter";
@@ -558,11 +558,9 @@ onMounted(() => {
     domainFilter.value = d.trim();
   }
 
-  fetchCommentStats()
-    .then((res: CommentListResponse | any) => {
-      const domains = Array.isArray(res.domains)
-        ? res.domains.map((item: any) => item.domain)
-        : [];
+  fetchDomainList()
+    .then((res) => {
+      const domains = Array.isArray(res.domains) ? res.domains : [];
       domainOptions.value = Array.from(new Set(domains));
     })
     .catch(() => {
diff --git a/cwd-admin/src/views/StatsView.vue b/cwd-admin/src/views/StatsView.vue
index 2b79a15..75c687f 100644
--- a/cwd-admin/src/views/StatsView.vue
+++ b/cwd-admin/src/views/StatsView.vue
@@ -55,7 +55,7 @@
       <h3 class="card-title">最近 30 天评论数趋势</h3>
       <div v-if="statsLoading" class="page-hint">加载中...</div>
       <div v-else-if="statsError" class="page-error">{{ statsError }}</div>
-      <div v-else class="chart-wrapper">
+      <div class="chart-wrapper">
         <div ref="chartEl" class="chart"></div>
       </div>
     </div>
@@ -94,7 +94,7 @@
 <script setup lang="ts">
 import { onMounted, onBeforeUnmount, ref, nextTick, watch } from "vue";
 import * as echarts from "echarts";
-import { fetchCommentStats } from "../api/admin";
+import { fetchCommentStats, fetchDomainList } from "../api/admin";
 
 type DomainStat = {
   domain: string;
@@ -152,14 +152,6 @@ async function loadStats() {
       rejected: res.summary.rejected,
     };
     domainStats.value = res.domains;
-    const domains = Array.isArray(res.domains)
-      ? res.domains.map((item) => item.domain)
-      : [];
-    const set = new Set(domains);
-    if (domainFilter.value && !set.has(domainFilter.value)) {
-      set.add(domainFilter.value);
-    }
-    domainOptions.value = Array.from(set);
     last7Days.value = Array.isArray(res.last7Days) ? res.last7Days : [];
   } catch (e: any) {
     const msg = e.message || "加载统计数据失败";
@@ -168,14 +160,27 @@ async function loadStats() {
   } finally {
     statsLoading.value = false;
     await nextTick();
-    if (!statsError.value && last7Days.value.length > 0) {
+    if (!statsError.value) {
       renderChart();
-    } else if (chartInstance) {
-      chartInstance.clear();
     }
   }
 }
 
+async function loadDomains() {
+  try {
+    const res = await fetchDomainList();
+    const domains = Array.isArray(res.domains) ? res.domains : [];
+    const set = new Set(domains);
+    if (domainFilter.value && !set.has(domainFilter.value)) {
+      set.add(domainFilter.value);
+    }
+    domainOptions.value = Array.from(set);
+  } catch (e: any) {
+    const msg = e.message || "加载域名列表失败";
+    showToast(msg, "error");
+  }
+}
+
 function renderChart() {
   const el = chartEl.value;
   if (!el) {
@@ -239,6 +244,7 @@ function handleResize() {
 
 onMounted(() => {
   loadStats();
+  loadDomains();
   window.addEventListener("resize", handleResize);
 });
 
diff --git a/cwd-api/src/api/admin/getDomains.ts b/cwd-api/src/api/admin/getDomains.ts
new file mode 100644
index 0000000..58ffa1d
--- /dev/null
+++ b/cwd-api/src/api/admin/getDomains.ts
@@ -0,0 +1,74 @@
+import type { Context } from 'hono';
+import type { Bindings } from '../../bindings';
+
+function extractDomain(source: string | null | undefined): string | null {
+	if (!source) {
+		return null;
+	}
+	const value = source.trim();
+	if (!value) {
+		return null;
+	}
+	if (!/^https?:\/\//i.test(value)) {
+		return null;
+	}
+	try {
+		const url = new URL(value);
+		return url.hostname.toLowerCase();
+	} catch {
+		return null;
+	}
+}
+
+export const getDomains = async (c: Context<{ Bindings: Bindings }>) => {
+	try {
+		const domains = new Set<string>();
+
+		const { results: commentRows } = await c.env.CWD_DB.prepare(
+			'SELECT post_slug, url FROM Comment'
+		).all<{
+			post_slug: string;
+			url: string | null;
+		}>();
+
+		for (const row of commentRows) {
+			const domain =
+				extractDomain(row.post_slug) || extractDomain(row.url);
+			if (domain) {
+				domains.add(domain);
+			}
+		}
+
+		await c.env.CWD_DB.prepare(
+			'CREATE TABLE IF NOT EXISTS page_stats (id INTEGER PRIMARY KEY AUTOINCREMENT, post_slug TEXT UNIQUE NOT NULL, post_title TEXT, post_url TEXT, pv INTEGER NOT NULL DEFAULT 0, last_visit_at INTEGER, created_at INTEGER NOT NULL, updated_at INTEGER NOT NULL)'
+		).run();
+
+		const { results: pageRows } = await c.env.CWD_DB.prepare(
+			'SELECT post_slug, post_url FROM page_stats'
+		).all<{
+			post_slug: string;
+			post_url: string | null;
+		}>();
+
+		for (const row of pageRows) {
+			const domain =
+				extractDomain(row.post_url) || extractDomain(row.post_slug);
+			if (domain) {
+				domains.add(domain);
+			}
+		}
+
+		const list = Array.from(domains);
+		list.sort();
+
+		return c.json({
+			domains: list
+		});
+	} catch (e: any) {
+		return c.json(
+			{ message: e.message || '获取域名列表失败' },
+			500
+		);
+	}
+};
+
diff --git a/cwd-api/src/index.ts b/cwd-api/src/index.ts
index adaa615..f627f4c 100644
--- a/cwd-api/src/index.ts
+++ b/cwd-api/src/index.ts
@@ -23,6 +23,7 @@ import { getAdminEmail } from './api/admin/getAdminEmail';
 import { setAdminEmail } from './api/admin/setAdminEmail';
 import { testEmail } from './api/admin/testEmail';
 import { getStats } from './api/admin/getStats';
+import { getDomains } from './api/admin/getDomains';
 import { trackVisit } from './api/public/trackVisit';
 import { getVisitOverview, getVisitPages } from './api/admin/visitAnalytics';
 
@@ -243,6 +244,7 @@ app.post('/admin/comments/import', importComments);
 app.put('/admin/comments/status', updateStatus);
 app.put('/admin/comments/update', updateComment);
 app.get('/admin/stats/comments', getStats);
+app.get('/admin/stats/domains', getDomains);
 app.get('/admin/analytics/overview', getVisitOverview);
 app.get('/admin/analytics/pages', getVisitPages);
 app.get('/admin/settings/email', getAdminEmail);
diff --git a/docs/.vitepress/configs/sidebar.js b/docs/.vitepress/configs/sidebar.js
index fdb0e1a..a214a08 100644
--- a/docs/.vitepress/configs/sidebar.js
+++ b/docs/.vitepress/configs/sidebar.js
@@ -25,4 +25,5 @@ export default [
 			{ text: '管理员 API', link: '/api/admin' },
 		],
 	},
+	{ text: '反馈', link: '/feedback' },
 ];
diff --git a/docs/api/admin.md b/docs/api/admin.md
index 68f6807..5de74d1 100644
--- a/docs/api/admin.md
+++ b/docs/api/admin.md
@@ -1161,6 +1161,53 @@ GET /admin/stats/comments
 }
 ```
 
+### 6.2 获取域名列表
+
+```
+GET /admin/stats/domains
+```
+
+用于管理后台获取所有已产生评论或访问记录的域名列表，用于域名筛选下拉框等场景。
+
+- 方法：`GET`
+- 路径：`/admin/stats/domains`
+- 鉴权：需要（Bearer Token）
+
+**成功响应**
+
+- 状态码：`200`
+
+```json
+{
+  "domains": [
+    "blog.example.com",
+    "example.com",
+    "www.example.com"
+  ]
+}
+```
+
+字段说明：
+
+| 字段名     | 类型            | 说明                   |
+| ---------- | --------------- | ---------------------- |
+| `domains`  | Array\<string\> | 域名列表，按字母排序 |
+
+说明：
+
+- 域名从评论数据和访问统计数据中提取
+- 域名自动去重并按字母顺序排序
+
+**错误响应**
+
+- 状态码：`500`
+
+```json
+{
+  "message": "获取域名列表失败"
+}
+```
+
 ## 7. 访问统计相关
 
 ### 7.1 获取访问统计概览
diff --git a/docs/feedback.md b/docs/feedback.md
new file mode 100644
index 0000000..2132fc3
--- /dev/null
+++ b/docs/feedback.md
@@ -0,0 +1,8 @@
+# 反馈
+
+在使用中遇到问题或有建议吗？请通过以下方式联系我们：
+
+- [Github Isseus](https://github.com/anghunk/cwd/issues)
+- 涉及到文档的问题，请直接在对应页面下进行评论留言！
+
+我们会尽快回复您的反馈。感谢您的参与！