安装¶

本章说明如何安装依赖、配置可选 API 密钥，以及在开发或生产环境运行 CVE Intelligence Panel。成功安装后，开发环境 Web UI 在 5173 端口，生产静态站点在 3001 端口。

前置条件¶

需要 Node.js 18+ 与 npm。若单独构建文档站点，extended-docs/ 下需 Python 3.10+。应用本身无需数据库；状态保存在浏览器与服务端内存缓存中。

在仓库根目录：

make setup    # npm install + 从 .env.example 生成 .env
make dev      # Vite :5173 + Express :3001

打开 http://localhost:5173。Vite 将 /api 代理到 API 服务器。

新安装会先显示 法律免责声明，然后是 设置向导（栈、告警/监控设置、数据源）。完成后应用打开仪表盘。可在向导最后一步可选运行首次完整扫描。

已有栈保存在 localStorage 的用户会自动迁移（setupComplete 已设置，无需重跑向导）。栈匹配时，会从上一会话加载缓存的扫描结果。

make build
make start    # NODE_ENV=production — 在 PORT（默认 3001）提供 dist/ + API

若 3001 被占用，在 .env 中设置 PORT。真实部署应置于 HTTPS 反向代理之后；勿在无认证情况下将翻译或扫描端点暴露到公网。

扩展文档（本站）：

cd extended-docs && make install && make serve

简短 legacy 文档：在仓库根目录执行 make docs-serve（docs/mkdocs.yml）。

curl -s http://localhost:3001/api/health | jq .

应返回 "ok": true 及列出已配置源 id 的 sources 数组。