# 小主机部署说明

本包是 Windows x64 + Python 3.12 部署包，包含当前数据快照、看板、更新脚本和隔离依赖。DeepSeek 不负责生成行情数据，只负责调用确定性脚本、读取状态和报告异常。

## 首次部署

1. 将压缩包解压到固定目录，路径中可以包含中文。
2. 安装 64 位 Python 3.12。包内 `vendor/` 已附带对应的 Windows Python 3.12 依赖。
3. 在通达信中下载完整的沪深日线、专业财务数据和除权除息数据。
4. 以 PowerShell 运行：

```powershell
powershell -ExecutionPolicy Bypass -File .\scripts\configure_host.ps1 -TdxRoot "D:\Software\TDX64"
.\run_daily_update.cmd --check
```

`ready=true` 且 `missingSourcePaths` 为空后，才允许执行正式更新：

```powershell
.\run_daily_update.cmd
```

## 定时更新

先确保通达信本地数据在 18:00 前已下载，然后安装任务：

```powershell
powershell -ExecutionPolicy Bypass -File .\scripts\install_daily_task.ps1 -At "18:00"
```

若通达信未自动下载，本项目只会重新计算旧截面，DeepSeek 不能把旧数据变成新数据。建议将行情下载排在 17:30，本项目更新排在 18:00。

## 验收

- 看板：`http://127.0.0.1:8765/reports/dashboard/index.html`
- 启动服务：`python serve_dashboard.py`
- 日更状态：`reports/dashboard/update_status.json`
- 日更日志：`reports/dashboard/logs/`
- DeepSeek 提示词：`prompts/deepseek_daily_maintenance.md`

## 已知边界

- 节假日滞后采用工作日近似，长假期可能把正常休市计为滞后，需人工判读。
- 外部治理和风险数据受网络与数据源可用性影响；失败时不应伪造或手工补数。
- 当前数据源依赖通达信本地目录，迁移后必须重新配置路径。
- 看板发布是原子替换，更新失败时旧看板仍可用；中间 Parquet 产物仍应定期做磁盘快照或备份。