docs: 修复第四轮 spec review 问题,定稿设计文档

- 删除 LogQueryParams 重复定义
- JSON 高亮改为无依赖正则方案(highlight.js 未安装)

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
2026-05-24 11:38:20 +08:00
parent 03dfdd13fa
commit 72faa34954
@@ -103,7 +103,7 @@ purpose: AI 调用日志详情查看功能设计文档
### JSON 高亮方案 ### JSON 高亮方案
JSON 格式化使用 `highlight.js` 轻量库(项目已可通过 npm 安装),对 JSON 语言进行语法高亮,无需手写解析逻辑。配合深色主题 CSS 覆盖默认配色 JSON 格式化使用原生 `JSON.stringify(obj, null, 2)` 生成,再通过简单正则替换为带 class 的 HTML 实现语法高亮。不引入新依赖,实现轻量。高亮规则:key、字符串、数字/布尔/null、标点符号分别用正则匹配并包裹 `<span class="...">` 后输出
**`JsonViewer.vue` Props 接口:** **`JsonViewer.vue` Props 接口:**
```typescript ```typescript
@@ -127,19 +127,7 @@ interface JsonViewerProps {
### 筛选栏参数 ### 筛选栏参数
```typescript 使用 `web-admin/src/types/common.ts` 中定义的 `LogQueryParams` 接口(见「类型定义」章节)。
interface LogQueryParams {
status?: string // running / success / failed
sceneCode?: string
providerCode?: string
endpointCode?: string
startTime?: string // ISO 8601 格式,如 "2026-05-17T00:00:00"
endTime?: string // ISO 8601 格式,如 "2026-05-24T23:59:59"
keyword?: string // 搜索入参/出参内容
pageNum?: number
pageSize?: number
}
```
**时间筛选交互:** 前端筛选栏提供快捷选项(近7天、近30天、自定义范围),由前端组件将快捷选项转换为 `startTime`/`endTime` 后传给后端。自定义范围时使用 Element Plus `el-date-picker` 选择起止时间。 **时间筛选交互:** 前端筛选栏提供快捷选项(近7天、近30天、自定义范围),由前端组件将快捷选项转换为 `startTime`/`endTime` 后传给后端。自定义范围时使用 Element Plus `el-date-picker` 选择起止时间。
- "近7天":今天 00:00:00 往前推 6 天(含今天) - "近7天":今天 00:00:00 往前推 6 天(含今天)