docs: 更新文档以反映从域名到站点的术语变更

- 将“域名筛选”统一更新为“站点筛选”或“多站点管理”
- 更新管理后台API文档,明确支持通过siteId参数筛选数据
- 在站点隔离配置文档中新增管理后台API使用说明
- 更新数据统计文档,将按域名分类改为按站点分类
- 修正相关API参数说明,从domain参数改为siteId参数
This commit is contained in:
anghunk
2026-02-09 16:40:42 +08:00
parent 489d30e084
commit a698734df5
6 changed files with 71 additions and 15 deletions

View File

@@ -30,7 +30,7 @@ GET /admin/comments/list
说明:
- 当前实现中每页固定大小为 `10`,暂不支持 `pageSize` 或状态过滤;
- 当提供 `domain` 参数时,会匹配该域名下的评论,例如 `https://example.com/...``http://example.com/...`
- 当提供 `siteId` 参数且不为 `default` 时,仅返回该站点下的评论
**成功响应**

View File

@@ -14,12 +14,23 @@ Authorization: Bearer <token>
GET /admin/comments/export
```
导出所有评论数据,返回格式为 JSON字段与数据库结构一致。
导出评论数据,返回格式为 JSON字段与数据库结构一致。
- 方法:`GET`
- 路径:`/admin/comments/export`
- 鉴权需要Bearer Token
**查询参数**
| 名称 | 位置 | 类型 | 必填 | 说明 |
| -------- | ----- | ------ | ---- | ------------------------------- |
| `siteId` | query | string | 否 | 按站点 ID 筛选导出的评论数据,如 `blog``docs` |
说明:
- 当提供 `siteId` 参数且不为 `default` 时,仅导出该站点下的评论数据
- 不提供 `siteId` 参数时,导出所有评论数据
**成功响应**
- 状态码:`200`
@@ -249,6 +260,17 @@ GET /admin/export/stats
- 路径:`/admin/export/stats`
- 鉴权需要Bearer Token
**查询参数**
| 名称 | 位置 | 类型 | 必填 | 说明 |
| -------- | ----- | ------ | ---- | ------------------------------- |
| `siteId` | query | string | 否 | 按站点 ID 筛选导出的统计数据,如 `blog`、`docs` |
说明:
- 当提供 `siteId` 参数且不为 `default` 时,仅导出该站点下的统计数据(包括页面访问汇总、按日访问明细以及点赞明细)
- 不提供 `siteId` 参数时,导出所有站点的统计数据
**成功响应**
- 状态码:`200`

View File

@@ -1,6 +1,6 @@
# 统计数据
统计数据接口用于获取评论统计、域名列表等数据看板相关信息。
统计数据接口用于获取评论统计、站点列表等数据看板相关信息。
所有接口都需要在请求头中携带 Bearer Token。
@@ -80,12 +80,12 @@ GET /admin/stats/comments
| `summary.approved` | number | 已通过评论数 |
| `summary.pending` | number | 待审核评论数 |
| `summary.rejected` | number | 已拒绝评论数 |
| `domains` | Array\<DomainStat\> | 按域名聚合的评论统计列表 |
| `domains[].domain` | string | 解析后的域名(如 `example.com` |
| `domains[].total` | number | 该域名下评论总数 |
| `domains[].approved` | number | 该域名下已通过评论数 |
| `domains[].pending` | number | 该域名下待审核评论数 |
| `domains[].rejected` | number | 该域名下已拒绝评论数 |
| `domains` | Array\<DomainStat\> | 按站点聚合的评论统计列表 |
| `domains[].domain` | string | 站点 ID`blog``docs``default` |
| `domains[].total` | number | 该站点下评论总数 |
| `domains[].approved` | number | 该站点下已通过评论数 |
| `domains[].pending` | number | 该站点下待审核评论数 |
| `domains[].rejected` | number | 该站点下已拒绝评论数 |
| `last7Days` | Array\<DailyStat\> | 最近 30 天的每日评论数(按自然日聚合) |
| `last7Days[].date` | string (YYYY-MM-DD) | 日期UTC 时间格式化后的自然日 |
| `last7Days[].total` | number | 当日评论总数 |

View File

@@ -39,6 +39,8 @@ CWD 评论系统支持通过 `siteId` 参数实现多站点数据隔离。当你
## API 调用
### 公开 API
当使用站点隔离功能时,所有公开 API 请求都需要在查询参数中携带 `siteId`
```javascript
@@ -59,6 +61,38 @@ POST /api/comments
GET /api/config/comments?siteId=blog
```
### 管理后台 API
管理后台同样支持通过 `siteId` 参数进行数据筛选:
```javascript
// 获取评论列表
GET /admin/comments/list?siteId=blog
// 导出评论数据
GET /admin/comments/export?siteId=blog
// 获取评论统计数据
GET /admin/stats/comments?siteId=blog
// 获取访问统计概览
GET /admin/analytics/overview?siteId=blog
// 获取页面访问统计
GET /admin/analytics/pages?siteId=blog
// 获取点赞统计数据
GET /admin/likes/stats?siteId=blog
// 导出统计数据
GET /admin/export/stats?siteId=blog
```
说明:
- 当提供 `siteId` 参数且不为 `default` 时,接口仅返回该站点下的数据
- 不提供 `siteId` 参数时,返回所有站点的数据
## 多站点示例
如果你有多个站点,可以为每个站点配置不同的 `siteId`

View File

@@ -2,9 +2,9 @@
管理后台用于审核评论、删除评论和管理评论设置。
## 域名筛选(多站点管理
## 多站点管理
管理后台顶部导航栏提供了全局域名下拉选择器,用于在多域名站点之间切换数据视图。
管理后台顶部导航栏提供了站点下拉选择器,用于在多站点之间切换数据视图。
## 设置

View File

@@ -8,7 +8,7 @@ CWD 内置提供评论数据分析和访客数据分析功能。
- 总评论数统计
- 最近 30 天评论数据可视化图表
-域名分类查看评论数据
-站点分类查看评论数据
## 访客数据分析
@@ -36,8 +36,8 @@ CWD 内置提供评论数据分析和访客数据分析功能。
- 同比趋势:对比本周与上周、本月与上月的访问量变化
- 趋势图表:通过可视化图表直观展示访问数据的变化趋势
## 域名筛选
## 站点筛选
管理后台顶部导航栏提供了全局域名下拉选择器,用于在多域名站点之间切换数据视图。
管理后台顶部导航栏提供了全局站点下拉选择器,用于在多站点之间切换数据视图。
在数据看板页面,所有数据统计都会根据选中的域名进行筛选,确保您能准确查看每个站点的数据情况。
在数据看板页面,所有数据统计都会根据选中的站点进行筛选,确保您能准确查看每个站点的数据情况。