# 真人核对 · 生产 VedAstro 运行模式（2026-09-15）

这份清单只能由产品负责人在生产主机上执行（会话内没有 SSH 凭据，也不应该有）。目的是确认三件事：**有没有 API key、fanout 是不是开着、缓存 TTL 是多少**。

下面每条命令都刻意只输出「有 / 没有」或数字，**不会打印 key 值**。请不要改写成 `cat .env.production` 或 `grep VEDASTRO_API_KEY` 直接看值，也不要把命令输出之外的内容贴回对话。

## 准备

```bash
ssh -p <confirmed-port> deploy@118.194.235.34
cd /opt/jyotisha-production
```

## 1. key 是否配置（最关键）

```bash
grep -qE '^VEDASTRO_API_KEY=.+$' .env.production && echo "API_KEY: set" || echo "API_KEY: EMPTY"
```

回填：`API_KEY: ____`

- `EMPTY` 意味着生产正在用官方免费公共模式。一次未命中缓存的完整取证要发 24 个外部请求，而免费层是 5 个/60 秒且我们的排队实现是同步 sleep + 全局锁——见 `TASK-vedastro-runtime-ops-20260915.md` 任务 2，该任务会因此升为 P0。

## 2. fanout 与 range scan 开关

```bash
grep -E '^VEDASTRO_(FULL_SNAPSHOT_FANOUT_ENABLED|RANGE_SCAN_NETWORK_ENABLED|ENABLE_NETWORK|TIMEOUT_SECONDS|GATEWAY_MODE)=' .env.production
```

这几个不是 secret，可以直接看值。回填：

| 变量 | 实际值 | 代码默认 |
| --- | --- | --- |
| `VEDASTRO_FULL_SNAPSHOT_FANOUT_ENABLED` | ____ | `1`（开，24 个请求） |
| `VEDASTRO_RANGE_SCAN_NETWORK_ENABLED` | ____ | 跟随 `ENABLE_NETWORK` |
| `VEDASTRO_ENABLE_NETWORK` | ____ | 空（关） |
| `VEDASTRO_TIMEOUT_SECONDS` | ____ | 见适配器默认 |
| `VEDASTRO_GATEWAY_MODE` | ____ | — |

**没有这一行**就等于取代码默认值 `1`（开）。

## 3. 缓存 TTL

```bash
grep -E '^VEDASTRO_(CACHE_TTL_SECONDS|OFFICIAL_FULL_SNAPSHOT_CACHE_TTL_SECONDS)=' .env.production
grep -E '^JYOTISH_API_CHART_CACHE_TTL_SECONDS=' .env.production
```

回填：`VEDASTRO_CACHE_TTL_SECONDS: ____`、`OFFICIAL_FULL_SNAPSHOT_CACHE_TTL_SECONDS: ____`、`JYOTISH_API_CHART_CACHE_TTL_SECONDS: ____`（后者没配则是 900 秒）

## 4. 网关自报的运行状态

```bash
COMPOSE='docker compose -p jyotisha-production --env-file .env.production -f deploy/docker-compose.server.yml -f deploy/docker-compose.postgres.yml -f deploy/docker-compose.production.yml'
$COMPOSE exec -T api sh -c 'curl -s -m 20 http://127.0.0.1:5200/api/vedastro_gateway/status' | head -c 2000; echo
```

回填整段输出（它不含 key，只含布尔与状态名）。如果里面出现任何看起来像凭据的长串，**不要贴回来**，只说「有疑似凭据字段」。

## 5. 运行期 SDK 实际版本（验证 pin 是否漂移）

```bash
$COMPOSE exec -T api python -c "from importlib.metadata import version; print('vedastro runtime version:', version('vedastro'))"
```

回填：`____`

`requirements.txt` 固定的是 `1.23.25`。**如果这里显示的不是 1.23.25**，说明 SDK 在容器里自己把自己升级了（它 import 时会请求 pypi 并 `pip install --upgrade`），这就是 BUG-719 的生产实证。

## 6. 星盘页真实首屏（改动上线后再做）

`TASK-chart-vedastro-decouple-20260915` 部署到 staging 之后：

```bash
# 在你自己的电脑上，登录 staging 后用浏览器打开
https://staging.jyotisha.chat/chart
```

- 主盘应该几乎立刻出现（本机实测本地计算 5 毫秒）。
- 记录一次「冷」打开（先等 15 分钟以上让引擎缓存过期，或换一个还没算过的出生资料）的主观等待时间。
- 五个 Tab 逐个点开，内容与改动前一致即可。

回填：冷打开等待 `____` 秒；Tab 有无异常 `____`

## 回填后怎么处理

把 1–5 的回填结果交给执行方，写进 `BUG-720` 的触发条件与定级。第 6 条写进 `docs/testing/chart-page-20260915.md` 的走查记录。

**在这份清单回填之前，任何人不得声称「生产 VedAstro 行为已验证」。**