npm - @mcptoolshop/registry-stats - Versions diffs - 2.3.0 → 3.1.0 - Mend

@mcptoolshop/registry-stats 2.3.0 → 3.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (14) hide show

package/README.zh.md CHANGED Viewed

@@ -1,15 +1,15 @@
-<p align="center">
-  <a href="README.ja.md">日本語</a> | <a href="README.md">English</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.it.md">Italiano</a> | <a href="README.pt-BR.md">Português (BR)</a>
-</p>
+<p align="center">
+  <a href="README.ja.md">日本語</a> | <a href="README.md">English</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.it.md">Italiano</a> | <a href="README.pt-BR.md">Português (BR)</a>
+</p>
 <p align="center">
   <img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/registry-stats/readme.png" alt="registry-stats logo" width="400" />
 </p>
 <p align="center">
   Five registries. One engine. Dashboard included.
 </p>
 <p align="center">
   <a href="https://github.com/mcp-tool-shop-org/registry-stats/actions/workflows/pages.yml"><img src="https://github.com/mcp-tool-shop-org/registry-stats/actions/workflows/pages.yml/badge.svg" alt="CI"></a>
   <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="MIT License"></a>
@@ -17,7 +17,7 @@
   <a href="https://mcp-tool-shop-org.github.io/registry-stats/dashboard/"><img src="https://img.shields.io/badge/Dashboard-live-green" alt="Dashboard"></a>
   <a href="https://mcp-tool-shop-org.github.io/registry-stats/"><img src="https://img.shields.io/badge/Landing_Page-live-blue" alt="Landing Page"></a>
 </p>
 <p align="center">
   <a href="#dashboard">Dashboard</a> &middot;
   <a href="#desktop-app">Desktop App</a> &middot;
@@ -28,57 +28,60 @@
   <a href="#config-file">Config</a> &middot;
   <a href="#license">License</a>
 </p>
 ---
-您可以在 npm、PyPI、NuGet、VS Code Marketplace 以及 Docker Hub 上发布。目前，要了解“我的软件包表现如何？”，您需要查看五个不同的网站。**registry-stats** 是一个完整的平台：一个 TypeScript 引擎（命令行工具 + API + REST 服务器），一个实时 Web 控制面板，以及一个原生 Windows 桌面应用程序——所有这些都来自一个代码仓库。
-没有运行时依赖。使用原生的 `fetch()` 方法。Node 18 或更高版本。
-## 包含内容
-| 层级 | 功能 |
-|-------|-------------|
-| **Engine** | TypeScript 库 + 命令行工具 + REST 服务器。使用一个界面查询五个注册中心。已在 npm 上发布为 `@mcptoolshop/registry-stats`。 |
-| **Dashboard** | 基于 Astro 的 Web 应用程序。提供 AI 聊天助手、6 个交互式图表、智能增长引擎和带选项卡的帮助指南。每周通过 CI 自动重建。 |
-| **Desktop** | 基于 WinUI 3 + WebView2 的原生 Windows 应用程序。将控制面板打包到本地，按需获取实时统计数据。 |
-## 控制面板
-一个自动更新的统计信息控制面板位于 [`/dashboard/`](https://mcp-tool-shop-org.github.io/registry-stats/dashboard/)。
-- **选项卡界面** — Home、Analytics、Leaderboard 和 Help 选项卡
-- **AI 聊天助手** — 基于 Ollama 的 Registry Assistant，支持 RAG 上下文注入、流式响应、模型选择器和对话记忆
-- **执行摘要** — 健康分数（0–100）、多样性指数、周变化、所有注册中心的总下载量
-- **6 个交互式图表** — 30 天趋势（汇总 / 按注册中心 / Top 5 切换）、注册中心份额（极坐标图）、组合风险（分布直方图 + Gini & P90）、Top 10 动量、带迷你图的速度追踪器、以及 30 天热力图（尖峰检测 >2σ）
-- **智能增长引擎** — 处理小分母失真，提供基线阈值、百分比上限和阻尼速度公式
-- **可操作洞察** — 自动生成的建议和下降软件包的注意警报
-- **排行榜** — 所有软件包按周下载量排序，带有 30 天迷你图和智能趋势标记
-- **设置页面** — 组合编辑器、验证功能、registry-sync 配套部分和管道概览
-- **帮助选项卡** — 涵盖每个选项卡、关键概念、AI 助手使用技巧、数据管道和有用链接的友好指南
-- **深色/浅色主题** — 根据系统偏好设置自动切换
-数据在构建时获取，并每周通过 CI 自动重建（每周一 06:00 UTC）。在 `site/src/data/packages.json` 文件中配置要跟踪的软件包。
-## 桌面应用程序
-一个原生 Windows 应用程序，它将控制面板封装在一个本地 WebView2 容器中：
-- **离线可用**：包含打包的 HTML/CSS/JS 文件；无需互联网连接即可使用。
-- **实时刷新**：从 GitHub Pages 上的 `stats.json` 文件获取实时统计数据。
-- **CSV 导出**：一键导出排行榜数据。
-- **MSIX 软件包**：通过 `desktop-ci.yml` 在 CI 环境中构建和签名。
-桌面应用程序的源代码位于 `desktop/` 目录中。使用 .NET 10 MAUI 构建，目标是 WinUI 3。
-## 安装
+您可以在 npm、PyPI、NuGet、VS Code Marketplace 以及 Docker Hub 上发布软件包。目前，要了解“我的软件包表现如何？”，您需要查看五个不同的网站。**registry-stats** 是一个完整的平台：一个 TypeScript 引擎（包含命令行工具、API 和 REST 服务器），一个实时 Web 控制面板，以及一个原生 Windows 桌面应用程序——所有这些都来自一个代码仓库。
+没有运行时依赖。使用原生的 `fetch()` 方法。Node 18+。
+## 内容
+| 层 | 功能 |
+|-------|-------------|
+| **Engine** | TypeScript 库 + 命令行工具 + REST 服务器。使用一个界面查询五个注册中心。已发布到 npm，名为 `@mcptoolshop/registry-stats`。 |
+| **Dashboard** | 一个由Astro驱动的Web应用程序，配备Pulse AI智能助手（支持语音流、网页搜索、全屏模式、GitHub数据连接器），包含六个交互式图表，支持实时刷新，并可导出报告（PDF/JSONL/Markdown），以及分Tab的帮助文档。该应用程序每周由CI自动构建，并可按需刷新。 |
+| **Desktop** | 一个原生 Windows 应用程序，使用 WinUI 3 + WebView2。将控制面板打包在本地，按需获取实时统计数据。 |
+## 控制面板
+一个自动更新的统计信息控制面板位于 [`/dashboard/`](https://mcp-tool-shop-org.github.io/registry-stats/dashboard/)。
+- **分Tab界面** — 包含“首页”、“分析”、“排行榜”和“帮助”等Tab。
+- **Pulse AI智能助手** — 基于Ollama的对话式助手，支持语音合成（LLM模型输出时同步语音，提供4种声音，通过[mcp-voice-soundboard](https://github.com/mcp-tool-shop-org/mcp-voice-soundboard)实现），网页搜索（Wikipedia + 可选的SearXNG），自动语音播报，全屏模式，GitHub组织数据连接器，模型选择器，以及对话记忆功能。
+- **关键指标概览** — 健康评分（0–100），多样性指数，每周变化，所有注册表的总下载量。
+- **六个交互式图表** — 30天趋势图（聚合/按注册表/前5名切换），注册表份额（极坐标图），投资组合风险（直方图 + Gini系数和P90），前10名增长情况，速度跟踪图（带sparklines），以及30天热力图（带异常值检测，>2σ）。
+- **智能增长引擎** — 通过基线阈值、百分比上限和阻尼速度公式，处理小基数偏差问题。
+- **可执行的洞察** — 自动生成推荐和关注提醒，用于识别下降的软件包。
+- **Pulse面板** — 分屏显示已建立的流行软件包（≥ 50次/周下载）和新兴/新软件包，并带有内联7天sparklines，绝对值和百分比变化，基线信息，以及简要的执行摘要。
+- **实时刷新** — 客户端按需从npm和PyPI API获取数据，并显示进度指示器；结果缓存在sessionStorage中（5分钟TTL），因此Tab切换速度非常快。
+- **导出报告** — 在“刷新”按钮旁边，提供下拉菜单，可以选择三种格式：**Exec PDF**（通过jsPDF实现），**LLM JSONL**（用于AI模型输入的结构化记录），以及**Dev Markdown**（GFM表格）。
+- **排行榜** — 按照每周下载量对132个软件包进行排名，并带有内联30天sparklines和智能趋势标识。
+- **配置页面** — 包含投资组合编辑器（带验证功能），注册表同步辅助部分，以及流水线概览。
+- **帮助Tab** — 提供用户友好的指南，涵盖每个Tab，关键概念，AI助手使用技巧，数据流水线，以及有用的链接。
+- **深色/浅色主题** — 自动跟随系统偏好设置。
+数据在构建时获取，并每周由 CI 自动重建（每周一 06:00 UTC）。实时刷新直接从注册中心 API 获取最新数据。在 `site/src/data/packages.json` 中配置要跟踪的软件包（5 个注册中心，共 132 个软件包）。
+## 桌面应用程序
+一个原生 Windows 应用程序，它将控制面板封装在一个本地 WebView2 容器中：
+- **支持离线使用** — 包含打包的 HTML/CSS/JS；无需互联网连接即可使用
+- **实时刷新** — 按需从 GitHub Pages 获取 `stats.json` 文件
+- **CSV 导出** — 一键导出排行榜数据
+- **MSIX 软件包** — 通过 `desktop-ci.yml` 在 CI 中构建和签名
+桌面应用程序的源代码位于 `desktop/` 目录中。使用 .NET 10 MAUI 构建，目标是 WinUI 3。
+## 安装
 ```bash
 npm install @mcptoolshop/registry-stats
 ```
-## 命令行界面 (CLI)
+## 命令行界面 (CLI)
 ```bash
 # Query a single registry
 registry-stats express -r npm
@@ -116,11 +119,11 @@ registry-stats express -r npm --range 2025-01-01:2025-06-30 --format chart
 # Start a REST API server
 registry-stats serve --port 3000
 ```
-## 配置文件
-在您的项目根目录下创建一个 `registry-stats.config.json` 文件（或者运行 `registry-stats --init` 命令）：
+## 配置文件
+在您的项目根目录下创建一个 `registry-stats.config.json` 文件（或者运行 `registry-stats --init` 命令）：
 ```json
 {
   "registries": ["npm", "pypi", "nuget", "vscode", "docker"],
@@ -139,11 +142,11 @@ registry-stats serve --port 3000
   "concurrency": 5
 }
 ```
-运行 `registry-stats` 命令，不带任何参数，即可获取所有配置软件包的统计数据。命令行界面会从当前工作目录向上查找最近的配置文件。
-配置文件也可以通过编程方式访问：
+运行 `registry-stats` 命令，不带任何参数，即可获取所有配置软件包的统计数据。命令行界面会从当前工作目录向上查找最近的配置文件。
+配置文件也可以通过编程方式访问：
 ```typescript
 import { loadConfig, defaultConfig, starterConfig } from '@mcptoolshop/registry-stats';
@@ -151,9 +154,9 @@ const config = loadConfig();          // finds nearest config file, or null
 const defaults = defaultConfig();     // returns default Config object
 const template = starterConfig();     // returns starter JSON string
 ```
-## 编程 API
+## 编程 API
 ```typescript
 import { stats, calc, createCache } from '@mcptoolshop/registry-stats';
@@ -194,41 +197,41 @@ const cache = createCache();
 await stats('npm', 'express', { cache });  // fetches
 await stats('npm', 'express', { cache });  // cache hit
 ```
-## 仓库支持
-| 仓库 | 软件包格式 | 时间序列 | 可用数据 |
-|----------|---------------|-------------|----------------|
-| `npm` | `express`, `@scope/pkg` | 是 (549 天) | 最近一天、最近一周、最近一个月 |
-| `pypi` | `requests` | 是 (180 天) | 最近一天、最近一周、最近一个月、总数 |
-| `nuget` | `Newtonsoft.Json` | No | 总数 |
-| `vscode` | `publisher.extension` | No | 总数（安装量）、评分、趋势 |
-| `docker` | `namespace/repo` | No | 总数（拉取次数）、星级 |
-## 内置可靠性
-- 自动重试，并在遇到 429/5xx 错误时采用指数退避策略
-- 尊重 `Retry-After` 头部信息
-- 批量请求的并发限制
-- 可选的 TTL 缓存（可插拔，通过 `StatsCache` 接口，您可以自定义 Redis 或文件后端）
-## REST API 服务器
-可以作为微服务运行，也可以嵌入到您自己的服务器中：
+## 仓库支持
+| 仓库 | 软件包格式 | 时间序列 | 可用数据 |
+|----------|---------------|-------------|----------------|
+| `npm` | `express`, `@scope/pkg` | 是 (549 天) | 最近一天、最近一周、最近一个月 |
+| `pypi` | `requests` | 是 (180 天) | 最近一天、最近一周、最近一个月、总数 |
+| `nuget` | `Newtonsoft.Json` | No | 总数 |
+| `vscode` | `publisher.extension` | No | 总数（安装量）、评分、趋势 |
+| `docker` | `namespace/repo` | No | 总数（拉取次数）、星级 |
+## 内置可靠性
+- 自动重试，并在遇到 429/5xx 错误时采用指数退避策略
+- 尊重 `Retry-After` 头部信息
+- 批量请求的并发限制
+- 可选的 TTL 缓存（可插拔，通过 `StatsCache` 接口，您可以自定义 Redis 或文件后端）
+## REST API 服务器
+可以作为微服务运行，也可以嵌入到您自己的服务器中：
 ```bash
 registry-stats serve --port 3000
 ```
 ```
 GET /stats/:package              # all registries
 GET /stats/:registry/:package    # single registry
 GET /compare/:package?registries=npm,pypi
 GET /range/:registry/:package?start=YYYY-MM-DD&end=YYYY-MM-DD&format=json|csv|chart
 ```
-用于自定义服务器或无服务器环境的编程用法：
+用于自定义服务器或无服务器环境的编程用法：
 ```typescript
 import { createHandler, serve } from '@mcptoolshop/registry-stats';
@@ -240,9 +243,9 @@ import { createServer } from 'node:http';
 const handler = createHandler();
 createServer(handler).listen(3000);
 ```
-## 自定义仓库
+## 自定义仓库
 ```typescript
 import { registerProvider, type RegistryProvider } from '@mcptoolshop/registry-stats';
@@ -263,9 +266,9 @@ const cargo: RegistryProvider = {
 registerProvider(cargo);
 await stats('cargo', 'serde');
 ```
-## 代码仓库结构
+## 代码仓库结构
 ```
 registry-stats/
 ├── src/        # TypeScript engine (published to npm)
@@ -273,9 +276,9 @@ registry-stats/
 ├── desktop/    # WinUI 3 desktop app (.NET 10 MAUI)
 └── test/       # Library tests (vitest)
 ```
-## 开发
+## 开发
 ```bash
 # Engine
 npm install && npm run build && npm test
@@ -286,36 +289,36 @@ npm run site:dev
 # Dashboard (production build)
 npm run site:build
 ```
-## 安全性和数据范围
-| 方面 | 详细信息 |
-|--------|--------|
-| **Data touched** | 从 npm、PyPI、NuGet、VS Code Marketplace 和 Docker Hub 获取公开的下载统计数据。可选的内存缓存。 |
-| **Data NOT touched** | 没有遥测。没有分析。没有凭证存储。没有用户数据。没有文件写入。 |
-| **Permissions** | 读取：通过 HTTPS 的公开注册中心 API。写入：仅 stdout/stderr。 |
-| **Network** | 向公开注册中心 API 的 HTTPS 出站连接。可选的本地 REST 服务器。 |
-| **Telemetry** | 未收集或发送任何数据。 |
-请参阅 [SECURITY.md](SECURITY.md) 以获取漏洞报告。
-## 评分卡
-| 类别 | 评分 |
-|----------|-------|
-| A. 安全性 | 10 |
-| B. 错误处理 | 10 |
-| C. 运维文档 | 10 |
-| D. 发布规范 | 10 |
-| E. 身份验证（软性） | 10 |
-| **Overall** | **50/50** |
-> 完整审计：[SHIP_GATE.md](SHIP_GATE.md) · [SCORECARD.md](SCORECARD.md)
-## 许可证
-MIT
+## 安全与数据范围
+| 方面 | 详细信息 |
+|--------|--------|
+| **Data touched** | 从 npm、PyPI、NuGet、VS Code Marketplace、Docker Hub 获取的公开下载统计数据。可选的内存缓存。 |
+| **Data NOT touched** | 无遥测。无分析。无凭证存储。无用户数据。无文件写入。 |
+| **Permissions** | 读取：通过 HTTPS 访问公共注册表 API。写入：仅限于标准输出/标准错误输出。 |
+| **Network** | 通过 HTTPS 访问公共注册表 API。可选的本地 REST 服务器。 |
+| **Telemetry** | 未收集或发送任何数据。 |
+请参阅 [SECURITY.md](SECURITY.md) 以报告漏洞。
+## 评分卡
+| 类别 | 评分 |
+|----------|-------|
+| A. 安全性 | 10 |
+| B. 错误处理 | 10 |
+| C. 操作文档 | 10 |
+| D. 发布规范 | 10 |
+| E. 身份验证（软性） | 10 |
+| **Overall** | **50/50** |
+> 完整审计：[SHIP_GATE.md](SHIP_GATE.md) · [SCORECARD.md](SCORECARD.md)
+## 许可证
+MIT
 ---
-由 <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a> 构建。
+由 <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a> 构建。

package/dist/cli.js CHANGED Viewed

@@ -40,7 +40,7 @@ async function fetchWithRetry(url, registry, init) {
   let lastError;
   for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
     await acquireSlot(registry);
-    const res = await fetch(url, init);
+    const res = await fetch(url, { signal: AbortSignal.timeout(3e4), ...init });
     if (res.status === 404) return null;
     if (res.ok) return res.json();
     const retryAfter = res.headers.get("retry-after");
@@ -62,7 +62,7 @@ async function fetchWithRetry(url, registry, init) {
 async function fetchDirect(url, registry, init) {
   let lastError;
   for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
-    const res = await fetch(url, init);
+    const res = await fetch(url, { signal: AbortSignal.timeout(3e4), ...init });
     if (res.status === 404) return null;
     if (res.ok) return res.json();
     const retryAfter = res.headers.get("retry-after");
@@ -284,7 +284,8 @@ var docker = {
     if (options?.dockerToken) {
       headers["Authorization"] = `Bearer ${options.dockerToken}`;
     }
-    const json2 = await fetchWithRetry(`${API4}/${pkg}`, "docker", { headers });
+    const safePkg = pkg.split("/").map((s) => encodeURIComponent(s)).join("/");
+    const json2 = await fetchWithRetry(`${API4}/${safePkg}`, "docker", { headers });
     if (!json2 || !json2.name || !json2.namespace) return null;
     return {
       registry: "docker",