# @adonis-agora/telescope-ui 中文文档

规范地址：https://npmcn.com/package/%40adonis-agora/telescope-ui/

版本：2\.1\.0
npm 元数据更新时间：2026-10-30T01:12:00.313Z
中文译文更新时间：2026-11-06T14:19:08.141Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40adonis-agora/telescope-ui
原文对照：https://npmcn.com/package/%40adonis-agora/telescope-ui/?lang=original
项目主页：https://davidecarvalho.github.io/agora/docs/telescope
源码仓库：https://github.com/DavideCarvalho/adonis-agora-telescope

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：808 kB，64 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=24
- 运行依赖：4 个
- peer 依赖：@adonisjs/core ^7\.3\.0，@adonis-agora/telescope \>=0\.11\.0 \<1\.0\.0
- 首次发布：2026-07-14T22:15:59.918Z
- 最新版本发布：2026-10-30T01:11:59.897Z
- 近 30 天下载量：3008（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：27（近 12 个月 27 个）

## 中文简介

@adonis-agora/望远镜的可观察性仪表板——一个反应性SPA(概览、条目+活的尾巴、条目细节、痕迹和瀑布、例外组、脉冲健康、CPU简介、活的队列和时间表、扩展页、客户端导出)

## 安装

```sh
npm install @adonis-agora/telescope-ui
```

也可以使用：`pnpm add @adonis-agora/telescope-ui`、`yarn add @adonis-agora/telescope-ui`、`bun add @adonis-agora/telescope-ui`

## README

# @ados-agora/望远镜-ui

观察力 **仪表板** 页:1 [`@adonis-agora/telescope`](https://npmcn.com/package/%40adonis-agora/core) 依赖光反应 AdonisJS提供商提供的SPA服务 **不变** 它消耗的JSON API的护卫. 阿戈拉生态系统的一部分.

## 显示什么

-   **大赦国际** ——人工智能支出(按特征/型号/支付者分列的总和、平台和估计份额), 代理运行有队列 / 模型 / 工具计时和与跟踪相连的每步分解,以及 未定价的电话,从 `@adonis-agora/agent` 0.93.0号 `usage.recorded` 财务报告和审定财务报表 `run.*` 事件.
-   **脉搏** - 那个 `getHealth` "一览"卷起:吞吐量,出错率,p99 纬度,HTTP状态 分解出,收录得最慢,路由慢,最上等例外,N+1热点,负载逐用户,缓存命中比.
-   **条目** ——带有类型 + 自由文本过滤器和一个 **SSE 活尾键** 预支 记录时的新条目。 纵行深通入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入出出出出出出出出出出出入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入出出出出出出出出出出出出出入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入.
-   **条目细节** ——完整条目:能识别类型头(请求的方法/url/状态),元数据 列表,并打印出 `content`. 例外/`client_exception` 附加条目 **大赦国际诊断** 面板( 仅在 `@adonis-agora/telescope/ai` 已安装和配置)—— "有AI的诊断"称Anthropic支持 `DiagnosisCoordinator` 并造成可能的原因 + 建议修复,由例外家族缓存,所以重开相同的错误不会燃烧第二个模型 电话. `request` 条目获得一个 **重播** 重新对现场发布抓获的请求的行动 服务器(由于默认服务器侧而失效;面板显示为什么是).
-   **追踪** ——近代有其类型组合的痕迹,外加每道追踪 **瀑布** (手卷,无相图 库)和可追踪的条目视图.
-   **例外** ——窗外有例外组(类+消息),有计数和趋势花花纹.

这是一个 **纯消费者** 望远镜核心的真实路线 `<path>/api/*` (单位:千美元)`/entries`, (中文(简体) ), `/entries/:id`, (中文(简体) ), `/trace/:id`, (中文(简体) ), `/metrics/{pulse,stats,traces,waterfall,n-plus-one}`和SSE现场直播 流点 `<path>/api/stream`没有捆绑的 API , 没有 NestJS 模块 .

## 安装

```ts
// adonisrc.ts — after the core telescope providers
providers: [
  // …
  () => import('@adonis-agora/telescope/telescope_provider'),
  () => import('@adonis-agora/telescope/ui_provider'),          // JSON API + SSE under <path>/api/*
  () => import('@adonis-agora/telescope-ui'),                   // serves the SPA at <path>
]
```

SPA 挂载在 `config('telescope_ui').path` (默认) `/telescope`和再利用该块的 `authorize` 警卫 切换它或用可选选项覆盖挂载 `telescope_ui.dashboard` 块 :

```ts
// config/telescope_ui.ts
import { defineConfig } from '@adonis-agora/telescope/ui'

export default defineConfig({
  path: '/telescope',
  // authorize: (ctx) => ctx.auth.user?.isAdmin === true,
  // dashboard: { enabled: true, path: '/telescope' },
})
```

## 设计

尾风 + 一个销售的阴影式组件层 [基础UI](https://base-ui.com/) (单位:千美元)`button`, (中文(简体) ), `badge`, (中文(简体) ), `dialog`, (中文(简体) ), `tabs`, (中文(简体) ), `tooltip`, (中文(简体) ), `popover`, (中文(简体) ), `input`, (中文(简体) ), `select`, (中文(简体) ), `table` —— 说 `src/app/primitives/`, (中文(简体) ), 编辑 **飞行员** agora生态系统控制台共享的设计标志——相同的中性/状态 胡为: `@dudousxd/nestjs-telescope-ui` (这个仪表板的NestJS兄弟会) 同样的红色 `--accent`, (中文(简体) ), 所以无论主机框架如何,两台望远镜仪表板都匹配像素换像素. 黑暗模式第一 带有 `.light`\- 类重置( 长期为 `localStorage`),反应. 仍然依赖 - 灯光在哪里 它算数:手卷的 SVG 火花和 CSS 瀑布(一个密集的、以网格为基础的失去的时间线) 像纯净的公用设施一样细微 `useAsync` 而不是查询库,和本地 `EventSource` 对于活的尾巴——没有反应路由器,没有图表库,没有表库.

## 常见问题

### @adonis-agora/telescope-ui 是什么？

@adonis-agora/望远镜的可观察性仪表板——一个反应性SPA\(概览、条目\+活的尾巴、条目细节、痕迹和瀑布、例外组、脉冲健康、CPU简介、活的队列和时间表、扩展页、客户端导出\)

### 如何安装 @adonis-agora/telescope-ui？

在项目目录运行 npm install @adonis-agora/telescope-ui，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@adonis-agora/telescope（\>=0\.11\.0 \<1\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @adonis-agora/telescope-ui 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @adonis-agora/telescope-ui 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @adonis-agora/telescope-ui 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=24。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @adonis-agora/telescope-ui 可以商用吗？

@adonis-agora/telescope-ui 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @adonis-agora/telescope-ui 的下载量有多少？

根据 npm 官方下载统计，@adonis-agora/telescope-ui 在 2026/10/05 – 2026/11/03 这 30 天内被下载 3,008 次，日均约 100 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @adonis-agora/telescope-ui 还在维护吗？

最新版本 2\.1\.0 发布于 2026/10/30（8 天前）；至今共发布 27 个版本，其中过去 12 个月发布了 27 个；首次发布于 2026/07/15。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。