feat(report): improve daily intelligence UX and price tracking
This commit is contained in:
@@ -18,13 +18,18 @@
|
||||
| 变量名 | 必填 | 使用方 | 默认值 | 说明 |
|
||||
|--------|------|--------|--------|------|
|
||||
| `DATABASE_URL` | 是 | API Server、迁移、采集、日报、备份恢复、验收脚本 | 无 | PostgreSQL 连接串,缺失时多数核心脚本会直接失败 |
|
||||
| `OPENROUTER_API_KEY` | 条件必填 | `fetch_openrouter.go`、`run_real_pipeline.sh`、`run_daily.sh` | 无 | 真实采集所需;只查看历史数据或仅跑前端时可不配 |
|
||||
| `OPENROUTER_API_KEY` | 条件必填 | `fetch_openrouter.go`、`run_real_pipeline.sh`、`run_daily.sh`、`run_intraday_price_watch.sh` | 无 | 真实采集所需;只查看历史数据或仅跑前端时可不配 |
|
||||
| `PORT` | 否 | `cmd/server/main.go` | `8080` | API Server 监听端口 |
|
||||
| `API_AUTH_TOKEN` | 条件必填 | `cmd/server/main.go`、API smoke / 外部调用 | 空 | 对外访问 `/api/*` 时推荐使用的 Bearer token;外部请求未携带合法 token 或 Basic Auth 时返回 `401` |
|
||||
| `API_BASIC_AUTH_USER` | 条件必填 | `cmd/server/main.go` | 空 | 对外访问 `/api/*` 的 Basic Auth 用户名;与 `API_BASIC_AUTH_PASS` 配套使用 |
|
||||
| `API_BASIC_AUTH_PASS` | 条件必填 | `cmd/server/main.go` | 空 | 对外访问 `/api/*` 的 Basic Auth 密码 |
|
||||
| `API_RATE_LIMIT_PER_WINDOW` | 否 | `cmd/server/main.go` | `60` | `/api/*` 按来源 IP 的窗口限流阈值;设为 `0` 表示关闭内建限流 |
|
||||
| `API_RATE_LIMIT_WINDOW_SEC` | 否 | `cmd/server/main.go` | `60` | `/api/*` 限流窗口长度(秒) |
|
||||
| `FEISHU_WEBHOOK` | 否 | `run_daily.sh`、`feishu_alert.sh` | 空 | 正式日报失败时发送飞书告警 |
|
||||
| `REPORT_OUTPUT_DIR` | 否 | `generate_daily_report.go` | `reports/daily` | 日报主产物输出目录 |
|
||||
| `REPORT_DATE` | 否 | `generate_daily_report.go`、`rebuild_historical_report.sh` | 当天日期 | 指定日报生成日期,格式 `YYYY-MM-DD` |
|
||||
| `REPORT_DATE` | 否 | `generate_daily_report.go`、`rebuild_historical_report.sh`、`run_intraday_price_watch.sh` | 当天日期 | 指定日报或日内价格追踪的日期,格式 `YYYY-MM-DD` |
|
||||
| `REPORT_RUN_KIND` | 否 | `generate_daily_report.go` | `manual` | 运行语义,如 `scheduled` / `manual` / `historical_rebuild` |
|
||||
| `REPORT_TRIGGER_SOURCE` | 否 | `generate_daily_report.go` | `cli` | 触发来源,如 `cron` / `pipeline` / `rebuild_script` |
|
||||
| `REPORT_TRIGGER_SOURCE` | 否 | `generate_daily_report.go`、`materialize_daily_signals.go` | `cli` | 触发来源,如 `cron` / `pipeline` / `intraday` / `rebuild_script` |
|
||||
| `REPORT_IS_OFFICIAL_DAILY` | 否 | `generate_daily_report.go` | `false` | 是否属于正式日报产出 |
|
||||
| `REPORT_RUNTIME_AUDIT` | 否 | `generate_daily_report.go` | 空 | 来源级运行审计摘要,通常由流水线脚本注入 |
|
||||
| `PHASE6_PORT` | 否 | `verify_phase6.sh` | 自动挑选 `18080-18120` | Phase 6 验收时临时启动 API Server 的端口 |
|
||||
@@ -33,6 +38,8 @@
|
||||
| `LIGHTHOUSE_FCP_THRESHOLD_MS` | 否 | `verify_lighthouse.sh` | `2000` | 首次内容绘制门槛 |
|
||||
| `VERIFY_DB_NAME` | 否 | `verify_common.sh` | `llm_intelligence` | SQL 型验收脚本默认连接的数据库名 |
|
||||
|
||||
|
||||
|
||||
## 推荐的生产注入方式
|
||||
|
||||
### API Server
|
||||
@@ -40,9 +47,12 @@
|
||||
```bash
|
||||
export DATABASE_URL="postgres://app_user:***@db:5432/llm_intelligence?sslmode=disable"
|
||||
export PORT="8080"
|
||||
export API_AUTH_TOKEN="replace-with-long-random-token"
|
||||
# 或者:export API_BASIC_AUTH_USER="review" && export API_BASIC_AUTH_PASS="replace-with-password"
|
||||
./server
|
||||
```
|
||||
|
||||
|
||||
### 正式日报调度
|
||||
|
||||
```bash
|
||||
@@ -60,6 +70,19 @@ export OPENROUTER_API_KEY="***"
|
||||
bash scripts/run_real_pipeline.sh
|
||||
```
|
||||
|
||||
### 日内价格追踪
|
||||
|
||||
```bash
|
||||
export DATABASE_URL="postgres://app_user:***@db:5432/llm_intelligence?sslmode=disable"
|
||||
export OPENROUTER_API_KEY="***"
|
||||
bash scripts/run_intraday_price_watch.sh
|
||||
```
|
||||
|
||||
说明:
|
||||
- 该入口只刷新价格 importer 与 `daily_signal_snapshot`
|
||||
- 不生成正式 HTML / Markdown 日报
|
||||
- 推荐先按每 4 小时一次调度,再根据外部源稳定性决定是否收紧到每 2 小时
|
||||
|
||||
## 日报运行语义
|
||||
|
||||
项目用以下字段区分正式日报、手工复跑和历史补跑:
|
||||
@@ -104,6 +127,11 @@ PORT="8080" \
|
||||
go run ./cmd/server
|
||||
```
|
||||
|
||||
说明:
|
||||
- `/health` 仅允许本机或私网来源访问
|
||||
- `/api/*` 对外访问默认要求 Bearer token 或 Basic Auth
|
||||
- 本机与私网来源可直接访问,便于同机前端、验收脚本和内网反代联调
|
||||
|
||||
### 仅生成指定日期日报
|
||||
|
||||
```bash
|
||||
|
||||
Reference in New Issue
Block a user