Compare commits
1 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
 vincent
|
90d3f8edca |
@@ -1,71 +0,0 @@
|
|||||||
# OpenClaw NVIDIA 网关切换至 Metapi — 配置修改指南
|
|
||||||
|
|
||||||
> 交付人：严维序（opengineer） | 交付日期：2026-07-03 | 关联Issue：BIZ-76
|
|
||||||
|
|
||||||
## 当前状态
|
|
||||||
|
|
||||||
你的 `openclaw.json` 中有 **12 个 NVIDIA 独立提供者**，每个直连 `https://integrate.api.nvidia.com/v1`，使用各自的 `nvapi-*` API Key。
|
|
||||||
|
|
||||||
Metapi 已部署在 http://192.168.1.99:4000，内部聚合了全部 12 个 NVIDIA 账号，通过代理令牌 `sk-bizwings-metapi-proxy` 对外提供统一的 `/v1` 端点，自动负载均衡。
|
|
||||||
|
|
||||||
## 方案 A：逐项修改（保留 12 个提供者结构）
|
|
||||||
|
|
||||||
对每个 NVIDIA 提供者做两处替换：
|
|
||||||
|
|
||||||
### 1. 修改 `baseUrl`
|
|
||||||
```
|
|
||||||
"baseUrl": "https://integrate.api.nvidia.com/v1"
|
|
||||||
→ "baseUrl": "http://192.168.1.99:4000/v1"
|
|
||||||
```
|
|
||||||
|
|
||||||
### 2. 修改 `apiKey`
|
|
||||||
```
|
|
||||||
"apiKey": "nvapi-xxx..."
|
|
||||||
→ "apiKey": "sk-bizwings-metapi-proxy"
|
|
||||||
```
|
|
||||||
|
|
||||||
## 方案 B：合并为单个提供者（推荐，精简配置）
|
|
||||||
|
|
||||||
将 12 个 NVIDIA 提供者合并为 1 个：
|
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"id": "nvidia-metapi",
|
|
||||||
"name": "NVIDIA via Metapi",
|
|
||||||
"kind": "openai",
|
|
||||||
"baseUrl": "http://192.168.1.99:4000/v1",
|
|
||||||
"apiKey": "sk-bizwings-metapi-proxy",
|
|
||||||
"models": {
|
|
||||||
"deepseek-ai/deepseek-v4-flash": {},
|
|
||||||
"deepseek-ai/deepseek-v4-pro": {},
|
|
||||||
"z-ai/glm-5.1": {},
|
|
||||||
"z-ai/glm-5.2": {},
|
|
||||||
"qwen/qwen3.5-397b-a17b": {},
|
|
||||||
"nvidia/llama-3.3-nemotron-super-49b-v1": {},
|
|
||||||
"nvidia/mississippi": {}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
Metapi 已部署信息：
|
|
||||||
- 访问地址：http://192.168.1.99:4000
|
|
||||||
- 管理员令牌：`bizwings-metapi-admin`
|
|
||||||
- 代理令牌：`sk-bizwings-metapi-proxy`
|
|
||||||
- 端口：4000
|
|
||||||
|
|
||||||
## 12 个 NVIDIA 账户清单
|
|
||||||
|
|
||||||
| # | 账号 | 状态 |
|
|
||||||
|---|------|------|
|
|
||||||
| 1 | NVIDIA-NIM-default | ✅ active |
|
|
||||||
| 2 | NVIDIA-NIM-98053 | ✅ active |
|
|
||||||
| 3 | NVIDIA-NIM-liuweicheng84 | ✅ active |
|
|
||||||
| 4 | NVIDIA-NIM-vx18088980513 | ✅ active |
|
|
||||||
| 5 | NVIDIA-NIM-vx64391942 | ✅ active |
|
|
||||||
| 6 | NVIDIA-NIM-cgtest1 | ✅ active |
|
|
||||||
| 7 | NVIDIA-NIM-cgtest2 | ✅ active |
|
|
||||||
| 8 | NVIDIA-NIM-cgtest3 | ✅ active |
|
|
||||||
| 9 | NVIDIA-NIM-15876517651 | ✅ active |
|
|
||||||
| 10 | NVIDIA-NIM-19584586741 | ✅ active |
|
|
||||||
| 11 | NVIDIA-NIM-18874954146 | ✅ active |
|
|
||||||
| 12 | NVIDIA-NIM-2405483110 | ✅ active |
|
|
||||||
@@ -1,178 +0,0 @@
|
|||||||
# 双色球系统部署文档
|
|
||||||
|
|
||||||
## 部署信息
|
|
||||||
|
|
||||||
| 项目 | 值 |
|
|
||||||
|------|-----|
|
|
||||||
| 项目名称 | 双色球自动化系统 |
|
|
||||||
| 部署时间 | 2026-06-29 |
|
|
||||||
| 部署人员 | 严维序 (opengineer) |
|
|
||||||
| 服务地址 | http://192.168.1.99:5000 |
|
|
||||||
| 宿主服务器 | Ubuntu-OpenClaw (192.168.1.99) |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 一、项目结构
|
|
||||||
|
|
||||||
```
|
|
||||||
/home/vincent/Studio/lottoData/
|
|
||||||
├── venv/ # Python 虚拟环境
|
|
||||||
├── web_executor.py # Flask Web 服务 (监听 0.0.0.0:5000)
|
|
||||||
├── fetch_data.py # 数据抓取脚本
|
|
||||||
├── lottery.py # 双色球号码生成器
|
|
||||||
├── web_console.html # Web 控制台页面
|
|
||||||
├── LottoSpider/ # 爬虫模块
|
|
||||||
├── lottery/ # 彩票模块
|
|
||||||
├── docs/ # 文档
|
|
||||||
├── 双色球历史数据.xlsx # 历史数据文件
|
|
||||||
└── deploy/ # 部署文件
|
|
||||||
├── DEPLOY.md # 本文档
|
|
||||||
├── lotto-web.service # systemd 服务文件
|
|
||||||
├── fetch_daily.sh # 每日抓取脚本
|
|
||||||
├── cron.log # Cron 执行日志
|
|
||||||
└── fetch_YYYYMMDD.log # 每日抓取详细日志
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 二、依赖清单
|
|
||||||
|
|
||||||
| 包 | 版本 | 用途 |
|
|
||||||
|----|------|------|
|
|
||||||
| Flask | 3.1.3 | Web 服务框架 |
|
|
||||||
| pandas | 3.0.4 | 数据处理 |
|
|
||||||
| openpyxl | 3.1.5 | Excel 读写 |
|
|
||||||
| requests | 2.34.2 | HTTP 请求 |
|
|
||||||
| beautifulsoup4 | 4.15.0 | HTML 解析 |
|
|
||||||
|
|
||||||
安装命令：
|
|
||||||
```bash
|
|
||||||
python3 -m venv venv
|
|
||||||
./venv/bin/pip install flask pandas openpyxl requests beautifulsoup4
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 三、systemd 服务配置
|
|
||||||
|
|
||||||
### 服务文件
|
|
||||||
|
|
||||||
`/etc/systemd/system/lotto-web.service`
|
|
||||||
|
|
||||||
```ini
|
|
||||||
[Unit]
|
|
||||||
Description=双色球数据抓取 Web 服务
|
|
||||||
After=network.target
|
|
||||||
|
|
||||||
[Service]
|
|
||||||
Type=simple
|
|
||||||
User=vincent
|
|
||||||
WorkingDirectory=/home/vincent/Studio/lottoData
|
|
||||||
ExecStart=/home/vincent/Studio/lottoData/venv/bin/python3 /home/vincent/Studio/lottoData/web_executor.py
|
|
||||||
ExecStartPre=/home/vincent/Studio/lottoData/venv/bin/python3 -c "import flask; import pandas; import openpyxl; import requests; import bs4"
|
|
||||||
Restart=on-failure
|
|
||||||
RestartSec=5
|
|
||||||
KillMode=control-group
|
|
||||||
|
|
||||||
[Install]
|
|
||||||
WantedBy=multi-user.target
|
|
||||||
```
|
|
||||||
|
|
||||||
### 管理命令
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# 安装/启用
|
|
||||||
sudo cp deploy/lotto-web.service /etc/systemd/system/
|
|
||||||
sudo systemctl daemon-reload
|
|
||||||
sudo systemctl enable lotto-web
|
|
||||||
sudo systemctl start lotto-web
|
|
||||||
|
|
||||||
# 日常管理
|
|
||||||
sudo systemctl status lotto-web # 查看状态
|
|
||||||
sudo systemctl restart lotto-web # 重启
|
|
||||||
sudo systemctl stop lotto-web # 停止
|
|
||||||
sudo journalctl -u lotto-web -f # 查看实时日志
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 四、Cron 定时任务
|
|
||||||
|
|
||||||
### Cron 配置
|
|
||||||
|
|
||||||
```
|
|
||||||
30 2 * * * /home/vincent/Studio/lottoData/deploy/fetch_daily.sh >> /home/vincent/Studio/lottoData/deploy/cron.log 2>&1
|
|
||||||
```
|
|
||||||
|
|
||||||
每天凌晨 2:30 自动抓取双色球历史数据。
|
|
||||||
|
|
||||||
### 手动执行
|
|
||||||
|
|
||||||
```bash
|
|
||||||
/home/vincent/Studio/lottoData/deploy/fetch_daily.sh
|
|
||||||
# 或
|
|
||||||
/home/vincent/Studio/lottoData/venv/bin/python3 /home/vincent/Studio/lottoData/fetch_data.py
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 五、Web 接口
|
|
||||||
|
|
||||||
| 路径 | 方法 | 说明 |
|
|
||||||
|------|------|------|
|
|
||||||
| `/` | GET | Web 控制台页面 |
|
|
||||||
| `/api/status` | GET | 获取执行状态 |
|
|
||||||
| `/api/execute` | POST | 触发数据抓取 |
|
|
||||||
|
|
||||||
### 示例
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# 查看状态
|
|
||||||
curl http://192.168.1.99:5000/api/status
|
|
||||||
|
|
||||||
# 触发抓取
|
|
||||||
curl -X POST http://192.168.1.99:5000/api/execute
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 六、验证清单
|
|
||||||
|
|
||||||
- [x] 依赖安装完整 (Flask, pandas, openpyxl, requests, beautifulsoup4)
|
|
||||||
- [x] systemd 服务运行正常 (active, enabled)
|
|
||||||
- [x] Web 服务可访问 (http://192.168.1.99:5000, HTTP 200)
|
|
||||||
- [x] API 接口正常 (/api/status, /api/execute)
|
|
||||||
- [x] Cron 定时任务已配置 (每日 2:30 抓取)
|
|
||||||
- [x] 手动抓取测试通过 (121 条记录保存成功)
|
|
||||||
- [x] 开机自启已配置 (systemd enable)
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 七、回滚方案
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# 停止服务
|
|
||||||
sudo systemctl stop lotto-web
|
|
||||||
sudo systemctl disable lotto-web
|
|
||||||
sudo rm /etc/systemd/system/lotto-web.service
|
|
||||||
sudo systemctl daemon-reload
|
|
||||||
|
|
||||||
# 移除 cron
|
|
||||||
crontab -l | grep -v 'lottoData' | crontab -
|
|
||||||
|
|
||||||
# 不影响数据文件和代码
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 八、监控要点
|
|
||||||
|
|
||||||
1. **服务存活**：`systemctl status lotto-web` 确认 active
|
|
||||||
2. **Web 可达**：`curl http://127.0.0.1:5000/api/status`
|
|
||||||
3. **数据更新**：检查 `/home/vincent/Studio/lottoData/双色球历史数据.xlsx` 修改时间
|
|
||||||
4. **Cron 日志**：检查 `/home/vincent/Studio/lottoData/deploy/cron.log`
|
|
||||||
5. **磁盘空间**：Excel 文件约 250KB，可忽略
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
> 部署人：严维序 (opengineer) | 2026-06-29
|
|
||||||
@@ -1,17 +0,0 @@
|
|||||||
#!/bin/bash
|
|
||||||
# 双色球历史数据每日自动抓取
|
|
||||||
# Cron: 0 2 * * * /home/vincent/Studio/lottoData/deploy/fetch_daily.sh >> /home/vincent/Studio/lottoData/deploy/cron.log 2>&1
|
|
||||||
|
|
||||||
SCRIPT_DIR="/home/vincent/Studio/lottoData"
|
|
||||||
VENV_PYTHON="${SCRIPT_DIR}/venv/bin/python3"
|
|
||||||
FETCH_SCRIPT="${SCRIPT_DIR}/fetch_data.py"
|
|
||||||
LOG_DIR="${SCRIPT_DIR}/deploy"
|
|
||||||
LOG_FILE="${LOG_DIR}/fetch_$(date +%Y%m%d).log"
|
|
||||||
|
|
||||||
mkdir -p "${LOG_DIR}"
|
|
||||||
|
|
||||||
echo "=== $(date '+%Y-%m-%d %H:%M:%S') 开始执行双色球数据抓取 ==="
|
|
||||||
"${VENV_PYTHON}" "${FETCH_SCRIPT}" >> "${LOG_FILE}" 2>&1
|
|
||||||
RC=$?
|
|
||||||
echo "=== $(date '+%Y-%m-%d %H:%M:%S') 执行完成, exit code=${RC} ==="
|
|
||||||
exit ${RC}
|
|
||||||
@@ -1,16 +0,0 @@
|
|||||||
[Unit]
|
|
||||||
Description=双色球数据抓取 Web 服务
|
|
||||||
After=network.target
|
|
||||||
|
|
||||||
[Service]
|
|
||||||
Type=simple
|
|
||||||
User=vincent
|
|
||||||
WorkingDirectory=/home/vincent/Studio/lottoData
|
|
||||||
ExecStart=/home/vincent/Studio/lottoData/venv/bin/python3 /home/vincent/Studio/lottoData/web_executor.py
|
|
||||||
ExecStartPre=/home/vincent/Studio/lottoData/venv/bin/python3 -c "import flask; import pandas; import openpyxl; import requests; import bs4"
|
|
||||||
Restart=on-failure
|
|
||||||
RestartSec=5
|
|
||||||
KillMode=control-group
|
|
||||||
|
|
||||||
[Install]
|
|
||||||
WantedBy=multi-user.target
|
|
||||||
@@ -1,5 +0,0 @@
|
|||||||
Flask==3.1.3
|
|
||||||
pandas==3.0.4
|
|
||||||
openpyxl==3.1.5
|
|
||||||
requests==2.34.2
|
|
||||||
beautifulsoup4==4.15.0
|
|
||||||
@@ -0,0 +1,290 @@
|
|||||||
|
# 石斛液态饮品全品类扩展可行性分析报告
|
||||||
|
|
||||||
|
**报告编号**：BIZ-64 | **日期**：2026年6月26日 | **分析师**：顾析策
|
||||||
|
**基准企业**：云南品斛堂生物科技有限公司 | **参考文档**：石斛食品饮料全品类产品方向详细文档 + BIZ-53企业情报调研报告
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 一、摘要
|
||||||
|
|
||||||
|
**核心结论**：品斛堂具备从石斛原浆单品类冠军向液态饮品多品类平台跃迁的条件，但应遵循"近岸延伸、能力匹配"原则——优先巩固原浆优势+扩展酒类第二曲线，谨慎试水即饮植物饮料，暂不进入乳制品/发酵饮品。
|
||||||
|
|
||||||
|
**关键数据**：
|
||||||
|
- 石斛淘系线上2025 Q1销售额1.25亿元，同比+42%，品类增速为药食同源赛道之首
|
||||||
|
- 露酒行业2025年规模650亿元，2030年预测2000亿（CAGR约25%），品斛堂石斛酒已有"中国销量第一"认证
|
||||||
|
- 功能饮料2025年中国市场规模超1800亿元，增速38%
|
||||||
|
- 中式养生水（如红豆薏米水）年增速182%，一年内达10亿规模
|
||||||
|
- 益生菌中国市场2025年约1400亿元，近五年CAGR 9.74%
|
||||||
|
|
||||||
|
**TOP5 优先级排序**：
|
||||||
|
1. 🥇 **复合草本原浆**（可行性高，毛利率60-70%，现有渠道复用）
|
||||||
|
2. 🥈 **石斛露酒/配制酒扩展**（可行性高，毛利率55-75%，独立增长极）
|
||||||
|
3. 🥉 **功能定制原浆**（可行性高，毛利率65-80%，差异化壁垒）
|
||||||
|
4. 🏅 **石斛养生茶包/冲调粉**（可行性中高，毛利率45-55%，产能灵活）
|
||||||
|
5. 🏅 **中式养生即饮植物饮料**（可行性中，毛利率40-55%，需渠道突破）
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 二、分品类详细评估
|
||||||
|
|
||||||
|
### 2.1 即饮原浆/浓浆（王牌品类·核心市场）
|
||||||
|
|
||||||
|
#### 市场数据
|
||||||
|
| 指标 | 数据 | 来源 |
|
||||||
|
|------|------|------|
|
||||||
|
| 品斛堂石斛原浆市场份额 | 45%+，全国销量第一 | 尚普咨询2026白皮书、CIC灼识认证 |
|
||||||
|
| 石斛淘系线上销售额(Q1 2025) | 1.25亿元，同比+41.96% | 植提桥/Foodaily |
|
||||||
|
| 品斛堂累计销售 | 超5亿袋 | 企业公开数据 |
|
||||||
|
| 石斛原浆品类零售价带 | ¥199-2999（按品类规格） | 天猫/京东实时数据 |
|
||||||
|
| 行业高端化增速（¥800/100g+） | 31%，远超大众市场 | 行业报告 |
|
||||||
|
|
||||||
|
#### 竞争格局
|
||||||
|
| 梯队 | 品牌 | 核心优势 |
|
||||||
|
|:---:|------|------|
|
||||||
|
| 🥇 | 品斛堂 | 全产业链+品类开创者，综合评分最高 |
|
||||||
|
| 🥈 | 同仁堂、东阿阿胶 | 老字号品牌溢价，送礼场景强 |
|
||||||
|
| 🥉 | 芝康纪、斛妈妈 | 多糖含量碾压/社媒运营强势 |
|
||||||
|
|
||||||
|
#### 扩展可行性分析
|
||||||
|
|
||||||
|
**A. 单一石斛原浆**
|
||||||
|
|
||||||
|
| 产品 | 可行性 | 预期毛利率 | 竞争评估 | 关键成功因素 |
|
||||||
|
|------|:---:|:---:|------|------|
|
||||||
|
| 紫皮石斛原浆（旗舰） | **★★★★★** | 60-70% | 领先地位稳固 | 维持品牌溢价，持续原料品质升级 |
|
||||||
|
| 铁皮石斛原浆（高端） | **★★★★☆** | 65-75% | 面临霍山产区竞争 | 强化多糖含量数据，产地溯源 |
|
||||||
|
| 霍山米斛原浆（超高端） | **★★★☆☆** | 70-80% | 九仙尊/斛妈妈垄断霍山产区 | 原料需外采，产地话语权弱 |
|
||||||
|
| 冷榨鲜原浆（创新） | **★★★★☆** | 55-65% | 差异化蓝海 | 48h鲜榨工艺，冷链物流是瓶颈 |
|
||||||
|
|
||||||
|
**B. 复合草本原浆（强烈推荐）**
|
||||||
|
|
||||||
|
| 产品 | 可行性 | 预期毛利率 | 目标人群规模 | 竞争强度 | 建议优先级 |
|
||||||
|
|------|:---:|:---:|:---:|:---:|:---:|
|
||||||
|
| 石斛+猴头菇+沙棘（养胃） | ★★★★★ | 60-70% | 肠胃不适人群巨大 | 中（江中/同仁堂） | 🥇 |
|
||||||
|
| 石斛+葛根+五味子（护肝/解酒） | ★★★★★ | 60-70% | 饮酒人群+熬夜人群 | 中低（差异化强） | 🥇 |
|
||||||
|
| 石斛+枸杞+菊花（护眼） | ★★★★☆ | 55-65% | 办公族/用眼过度 | 中 | 🥈 |
|
||||||
|
| 石斛+西洋参+黄芪（补气） | ★★★★☆ | 60-70% | 亚健康/免疫力低下 | 中高（同仁堂/康恩贝） | 🥈 |
|
||||||
|
| 石斛+酸枣仁+百合（助眠） | ★★★★★ | 60-70% | 失眠人群超3亿 | 中（同仁堂/东阿阿胶） | 🥇 |
|
||||||
|
|
||||||
|
**评估理由**：复合原浆是品斛堂最优先的扩展方向。理由：(1) 复用现有原浆产线和技术（生物酶解+低温浓缩），无需新增固定资产；(2) 复用天猫/京东/抖音/视频号现有渠道和用户群；(3) 复合配方通过功能场景化营销（护肝/助眠/养胃）实现差异化，降低教育成本；(4) 客单价提升和复购率提升显著。关键风险是合规边界——普通食品不得宣传保健功能，需以"草本配方""古方传承"等合规语言替代功效宣传。
|
||||||
|
|
||||||
|
**C. 功能定制原浆**
|
||||||
|
|
||||||
|
| 产品 | 可行性 | 预期毛利率 | 市场机会 |
|
||||||
|
|------|:---:|:---:|------|
|
||||||
|
| 无糖石斛原浆 | ★★★★☆ | 60-70% | 无糖饮料市场615.6亿元(2025)，CAGR 8%+ |
|
||||||
|
| 有机石斛原浆 | ★★★☆☆ | 65-75% | 有机认证门槛高→溢价空间大 |
|
||||||
|
| 儿童稀释版 | ★★★☆☆ | 50-60% | 需额外安全性论证，合规门槛高 |
|
||||||
|
| 孕妇温和版 | ★★☆☆☆ | 55-65% | 合规风险极高，不建议 |
|
||||||
|
|
||||||
|
**⚠️ 合规提醒**：普通食品不得声称适用"儿童""孕妇"等特殊人群，相关产品须严格按照食品安全标准和广告法规范。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 2.2 即饮植物饮料（千亿级大众市场·谨慎进入）
|
||||||
|
|
||||||
|
#### 市场数据
|
||||||
|
| 指标 | 数据 | 来源 |
|
||||||
|
|------|------|------|
|
||||||
|
| 中国饮料市场2025年规模 | 15,170亿元 | 艾媒咨询 |
|
||||||
|
| 功能饮料2025年规模 | 超1,800亿元 | 中商情报网/欧睿 |
|
||||||
|
| 凉茶市场2025年规模 | 255亿元 | 艾媒咨询 |
|
||||||
|
| 中式养生水增速 | 182%，一年达10亿规模 | 尼尔森IQ |
|
||||||
|
| 无糖茶增速 | 双位数，全国线下+80% | 尼尔森IQ |
|
||||||
|
| 植物饮料增速 | 125.9%（2025 H1） | 魔镜洞察 |
|
||||||
|
| 电解质饮料增速 | 160%+（2025 H1） | 魔镜洞察 |
|
||||||
|
| 功能饮料线上CAGR | 13.2%（2019-2024） | 行业报告 |
|
||||||
|
|
||||||
|
#### 品类可行性评估
|
||||||
|
|
||||||
|
| 子品类 | 市场规模 | 增速 | 品斛堂可行性 | 预期毛利率 | 核心壁垒 |
|
||||||
|
|------|:---:|:---:|:---:|:---:|------|
|
||||||
|
| 石斛草本凉茶 | 255亿（凉茶） | 存量博弈 | ★★★☆☆ | 40-50% | 口味研发+渠道覆盖 vs 王老吉/加多宝垄断 |
|
||||||
|
| 石斛功能饮料（能量/电解质） | 1,800亿+ | 38% | ★★☆☆☆ | 45-55% | 红牛/东鹏/外星人寡头，品斛堂零经验 |
|
||||||
|
| 石斛养生水/植物饮料 | 10亿+（新兴） | 125%+ | ★★★★☆ | 45-55% | 盒马石斛水已有验证，但品牌≠品斛堂 |
|
||||||
|
| 石斛茶饮（绿茶/普洱） | 即饮茶第一大品类 | 双位数 | ★★☆☆☆ | 35-45% | 农夫山泉/康师傅/统一垄断 |
|
||||||
|
| 石斛咖啡 | 116亿（即饮咖啡） | 增长中 | ★☆☆☆☆ | 40-50% | 星巴克/瑞幸品牌壁垒+品斛堂零经验 |
|
||||||
|
|
||||||
|
**关键判断**：
|
||||||
|
|
||||||
|
品斛堂切入即饮植物饮料面临**三重壁垒**：
|
||||||
|
1. **产能壁垒**：即饮饮料需要独立的PET/易拉罐灌装线、大规模产能（日产能百万瓶级），品斛堂现有产能为原浆袋装线和酒类酿造线，不具备即饮灌装基础；
|
||||||
|
2. **渠道壁垒**：即饮饮料依赖百万级线下终端（便利店/商超/餐饮），品斛堂线下渠道集中在药店/特产店/美容院，渠道错配严重；
|
||||||
|
3. **品牌壁垒**：品斛堂在石斛滋补品领域有强认知，但在"解渴饮料"场景的品牌认知为零。
|
||||||
|
|
||||||
|
**破局路径**：
|
||||||
|
- **最短路径**：石斛养生水/植物饮料，以ODM/OEM模式快速试水（品斛堂提供石斛原料+配方，由成熟饮料代工厂生产），借盒马/山姆等新零售渠道首发
|
||||||
|
- **不推荐**：自建即饮产线、硬攻能量饮料/凉茶等成熟红海
|
||||||
|
- **参考案例**：元气森林"自在水"（红豆薏米/红枣枸杞水）——以中式养生概念实现差异化破圈，一年内破亿
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 2.3 乳制品/发酵饮品（万亿级·现阶段不建议）
|
||||||
|
|
||||||
|
#### 市场数据
|
||||||
|
| 指标 | 数据 | 来源 |
|
||||||
|
|------|------|------|
|
||||||
|
| 中国酸奶市场2024年规模 | 998.74亿元（同比-9%） | 智研咨询 |
|
||||||
|
| 中国益生菌终端市场2025年 | 约1,400亿元 | 前瞻产业研究院 |
|
||||||
|
| 全球益生菌市场2025年 | 731.3亿美元，CAGR 7.15% | Fortune Business Insights |
|
||||||
|
| 肠道健康饮料全球2025年 | 242亿美元，CAGR 10.9% | GM Insights |
|
||||||
|
| 酸奶市场格局 | 伊利+蒙牛双寡头，CR2约50%+ | 智研咨询 |
|
||||||
|
| 酵素/醋饮市场 | 碎片化，头部品牌<10亿 | 行业估算 |
|
||||||
|
|
||||||
|
#### 可行性评估
|
||||||
|
|
||||||
|
| 子品类 | 可行性 | 预期毛利率 | 关键判断 |
|
||||||
|
|------|:---:|:---:|------|
|
||||||
|
| 石斛酸奶 | ★★☆☆☆ | 30-40% | 伊利/蒙牛双寡头控制冷链+货架+品牌，新进入者几乎无机会 |
|
||||||
|
| 石斛益生菌粉/固体饮料 | ★★★★☆ | 50-65% | **属于冲调品类，不是乳制品**，可行性高（见2.5） |
|
||||||
|
| 石斛酵素 | ★★★☆☆ | 55-70% | 碎片化市场，但消费者认知模糊，教育成本高 |
|
||||||
|
| 石斛醋饮 | ★★☆☆☆ | 40-50% | 天地壹号一家独大，品类天花板低 |
|
||||||
|
|
||||||
|
**判断**：
|
||||||
|
- **酸奶**——品斛堂无乳制品基础（无奶源、无冷链、无乳制品生产技术），进入成本极高。酸奶市场已进入存量博弈（2024年下滑9%），伊利/蒙牛双寡头格局难以撼动。**不推荐**。
|
||||||
|
- **酵素/醋饮**——碎片市场有缝隙机会，但品类教育成本高，消费者信任度低。**暂不推荐**。
|
||||||
|
- **益生菌粉**——这是品斛堂可以切入的方向（见2.5冲调饮品）。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 2.4 酒类（第二增长曲线·高优先级扩展）
|
||||||
|
|
||||||
|
#### 市场数据
|
||||||
|
| 指标 | 数据 | 来源 |
|
||||||
|
|------|------|------|
|
||||||
|
| 露酒行业2025年规模 | 650亿元 | 中国酒业协会 |
|
||||||
|
| 露酒行业利润增速（2020-2024） | 接近200% | 中国酒业协会 |
|
||||||
|
| 露酒2030年预测规模 | 2,000亿元 | 中国酒业协会 |
|
||||||
|
| 露酒年销量增速 | 30%+ | 中国酒业协会 |
|
||||||
|
| 劲酒2025年增长 | 超20%，新增900万年轻用户 | 证券时报/劲牌 |
|
||||||
|
| 保健酒市场规模 | 约377亿元(2023) | 智研咨询 |
|
||||||
|
| 低度潮饮2025年规模 | 突破600亿元 | 行业报告 |
|
||||||
|
| 品斛堂酒业产能 | 万吨级，满产12,000吨 | 企业公开数据 |
|
||||||
|
|
||||||
|
#### 竞争格局
|
||||||
|
| 梯队 | 企业/品牌 | 规模/定位 | 品斛堂对标 |
|
||||||
|
|:---:|------|------|------|
|
||||||
|
| 🥇 超级领跑 | 劲牌（劲酒+毛铺） | 130亿+，百亿级唯一 | — |
|
||||||
|
| 🥈 头部冲刺 | 泸州老窖养生酒、汾酒竹叶青、五粮液本草、椰岛鹿龟酒 | 冲刺10亿级 | 追赶目标 |
|
||||||
|
| 🥉 新锐入局 | 茅台保健酒"1+3"矩阵、古井神力酒 | 战略入局 | 差异化对象 |
|
||||||
|
| 🏅 品斛堂 | 石斛酒中国销量第一 | 酒业独立运营，王朝成入股 | **差异化定位** |
|
||||||
|
|
||||||
|
#### 扩展可行性分析
|
||||||
|
|
||||||
|
| 产品方向 | 可行性 | 预期毛利率 | 市场空间 | 关键成功因素 |
|
||||||
|
|------|:---:|:---:|------|------|
|
||||||
|
| **石斛露酒/配制酒扩展**（石斛+西洋参+灵芝/枸杞/人参/青梅） | ★★★★★ | 60-75% | 露酒650亿→2000亿 | 蓝帽子批文+差异化石斛IP+酒业产能 |
|
||||||
|
| **石斛米香型白酒** | ★★★★☆ | 50-65% | 云南本地+全国化 | 米香+石斛差异化，区域文化加持 |
|
||||||
|
| **石斛酱香型白酒** | ★★★☆☆ | 55-70% | 酱酒3,000亿 | 茅台镇产能/品牌/渠道壁垒极高 |
|
||||||
|
| **NANO小酒（年轻化）** | ★★★★☆ | 50-60% | 年轻化微醺市场爆发 | 对标江小白/梅见，石斛健康标签 |
|
||||||
|
| **石斛青梅酒（女性向）** | ★★★★☆ | 55-65% | 低度果酒高速增长 | 女性消费者占比58%，年轻化 |
|
||||||
|
|
||||||
|
**详细分析**：
|
||||||
|
|
||||||
|
**露酒扩展（★★★★★）**：品斛堂酒业最大优势在于——(1) "石斛酒中国销量第一""中国石斛露酒开创者"双重认证；(2) 王朝成（中国酒业顶级智囊）现金入股；(3) 万吨级酿造基地产能充裕；(4) 徐瑞晟（省级白酒品评冠军）技术护城河。露酒行业正处于爆发前夜（30%+增速，2030年2000亿），且"石斛+酒"是品斛堂独有的品类定位，竞争对手无法复制。强烈推荐扩展石斛西洋参灵芝酒（蓝帽子）、石斛枸杞酒、石斛人参酒等产品线，并向青梅酒等低度果酒延伸。
|
||||||
|
|
||||||
|
**白酒扩展（★★★☆☆）**：米香型白酒在云南有文化根基，品斛堂可深耕区域市场。酱香型白酒则面临茅台/习酒/郎酒等巨头碾压，不建议重资产投入。
|
||||||
|
|
||||||
|
**年轻化小酒（★★★★☆）**：劲酒新增900万年轻用户中400万为女性，证明"养生+微醺"正在破圈。品斛堂推出125ml石斛小酒+石斛青梅酒，切入年轻消费者场景（酒吧/KTV/餐饮），机会明确。
|
||||||
|
|
||||||
|
**风险提示**：露酒市场"一超多强"格局正在形成（劲酒百亿级领跑，茅台/五粮液/泸州老窖/汾酒密集入局），品斛堂需在窗口期（2-3年）内快速建立规模壁垒，否则将面临头部企业的降维打击。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 2.5 冲调饮品（灵活产能·稳定增长）
|
||||||
|
|
||||||
|
#### 市场数据
|
||||||
|
| 指标 | 数据 | 来源 |
|
||||||
|
|------|------|------|
|
||||||
|
| 冲调泡品类增速 | 领跑食品饮料全行业（2025 H1） | 魔镜洞察 |
|
||||||
|
| 益生菌终端市场（中国2025） | 约1,400亿元 | 前瞻产业研究院 |
|
||||||
|
| 益生菌膳食补充剂CAGR | 18%（2021-2024） | 凯度/东吴证券 |
|
||||||
|
| 肠道健康线上规模 | 约40亿元，益生菌占75%+ | 银河证券 |
|
||||||
|
| 速溶粉/固体饮料市场 | 碎片化，养生类高速增长 | 行业估算 |
|
||||||
|
|
||||||
|
#### 可行性评估
|
||||||
|
|
||||||
|
| 产品 | 可行性 | 预期毛利率 | 竞争分析 | 产能匹配 |
|
||||||
|
|------|:---:|:---:|------|:---:|
|
||||||
|
| 石斛速溶粉/固体饮料 | ★★★★☆ | 50-60% | 碎片化市场，尚无绝对头部 | 现有粉剂产线可复用 |
|
||||||
|
| 石斛益生菌粉 | ★★★★☆ | 55-65% | 竞争激烈但增长快 | 可OEM合作成熟菌粉供应商 |
|
||||||
|
| 石斛养生茶包 | ★★★★★ | 45-55% | 同仁堂/五谷磨房等，但有差异化空间 | 设备投入低，可快速启动 |
|
||||||
|
| 石斛蛋白粉 | ★★☆☆☆ | 50-60% | 汤臣倍健/康比特专业壁垒高 | 需运动营养领域研发 |
|
||||||
|
|
||||||
|
**判断**：
|
||||||
|
- **茶包（★★★★★）**是最低成本的入门产品——设备投入低、渠道灵活（线上+药店+特产店+礼品渠道）、可快速迭代试错。石斛+陈皮/枸杞/菊花/桂圆等经典中式养生组合天然成立。
|
||||||
|
- **益生菌粉（★★★★☆）**是增长最快的子品类——品斛堂无需自研菌株，可外采成熟益生菌原料+自有石斛多糖配方差异化。毛利率高（55-65%），线上渠道起量快。
|
||||||
|
- **速溶粉（★★★★☆）**复用现有粉剂产线，主打"冷水速溶""办公便携"场景，与石斛原浆形成"即饮+冲调"组合覆盖。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 三、综合对比矩阵
|
||||||
|
|
||||||
|
| 品类 | 市场规模 | 增速 | 可行性 | 预期毛利率 | 产能匹配 | 渠道匹配 | 品牌匹配 | 竞争强度 | 综合优先级 |
|
||||||
|
|------|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
|
||||||
|
| 复合草本原浆 | 120亿+ | 25%+ | ★★★★★ | 60-70% | ★★★★★ | ★★★★★ | ★★★★★ | 中 | **🥇 第一位** |
|
||||||
|
| 石斛露酒扩展 | 650亿→2000亿 | 30%+ | ★★★★★ | 60-75% | ★★★★★ | ★★★★☆ | ★★★★★ | 中→高 | **🥈 第二位** |
|
||||||
|
| 功能定制原浆 | 120亿+(子集) | 25%+ | ★★★★☆ | 65-80% | ★★★★★ | ★★★★★ | ★★★★★ | 低→中 | **🥉 第三位** |
|
||||||
|
| 石斛养生茶包 | 500亿+(冲调) | 15%+ | ★★★★★ | 45-55% | ★★★★☆ | ★★★★☆ | ★★★★☆ | 中 | **🏅 第四位** |
|
||||||
|
| 石斛养生水/植物饮料 | 10亿+(新兴) | 125%+ | ★★★★☆ | 40-55% | ★★☆☆☆ | ★★☆☆☆ | ★★★☆☆ | 中 | **🏅 第五位** |
|
||||||
|
| 石斛益生菌粉 | 40亿+ | 18% | ★★★★☆ | 55-65% | ★★★☆☆ | ★★★★☆ | ★★★★☆ | 中高 | 第六位 |
|
||||||
|
| 石斛功能饮料 | 1,800亿+ | 38% | ★★☆☆☆ | 45-55% | ★☆☆☆☆ | ★☆☆☆☆ | ★★☆☆☆ | 极高 | 暂不推荐 |
|
||||||
|
| 石斛酸奶 | 998亿 | -9% | ★★☆☆☆ | 30-40% | ★☆☆☆☆ | ★☆☆☆☆ | ★★☆☆☆ | 极高 | 不建议 |
|
||||||
|
| 石斛咖啡 | 116亿 | 增长中 | ★☆☆☆☆ | 40-50% | ★☆☆☆☆ | ★☆☆☆☆ | ★☆☆☆☆ | 极高 | 不建议 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 四、扩展路径建议（三年路线图）
|
||||||
|
|
||||||
|
### 第一年（2026-2027）：巩固+近岸扩展
|
||||||
|
1. **复合草本原浆**：优先上市 护肝（葛根五味子）、助眠（酸枣仁百合）、养胃（猴头菇沙棘）三款
|
||||||
|
2. **功能定制原浆**：推出无糖版，抢占控糖人群
|
||||||
|
3. **露酒扩展**：推出石斛枸杞酒、石斛人参酒、石斛青梅酒
|
||||||
|
4. **养生茶包**：石斛陈皮茶、石斛枸杞菊花茶
|
||||||
|
|
||||||
|
### 第二年（2027-2028）：规模化+渠道下沉
|
||||||
|
1. 复合原浆全渠道铺开（药店/商超/便利店）
|
||||||
|
2. 启动NANO小酒年轻化营销（小红书/抖音种草+餐饮渠道）
|
||||||
|
3. 益生菌粉上市
|
||||||
|
4. 试水石斛养生水（ODM模式，盒马/山姆首发）
|
||||||
|
|
||||||
|
### 第三年（2028-2029）：品牌升维+第二曲线
|
||||||
|
1. 石斛露酒冲刺5-10亿级
|
||||||
|
2. 评估是否需要自建即饮产线（基于养生水试水结果）
|
||||||
|
3. 探索石斛酵素/发酵饮品
|
||||||
|
4. 国际化试水（东南亚石斛原浆/酒类出口）
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 五、关键风险与应对
|
||||||
|
|
||||||
|
| 风险 | 等级 | 应对策略 |
|
||||||
|
|------|:---:|------|
|
||||||
|
| 复合原浆合规风险（功效宣传边界） | 🔴 | 严格以"草本配方""中式养生"替代功效宣传；法务前置审核 |
|
||||||
|
| 露酒市场头部挤压（劲酒/茅台保健酒/五粮液） | 🟡 | 聚焦"石斛"差异化壁垒，避免与巨头正面价格战 |
|
||||||
|
| 即饮饮料产线投资过大 | 🟡 | 以ODM模式试水，暂不自建产线 |
|
||||||
|
| 多品类扩张导致品牌定位模糊 | 🟡 | 保持"元斛"品牌聚焦石斛原浆，"品斛堂"品牌聚焦酒类，新品类使用独立子品牌 |
|
||||||
|
| 王红权星封禁关联舆情风险 | 🔴 | 清理合作痕迹，建立达人合作风控机制 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 六、数据来源
|
||||||
|
|
||||||
|
1. 尚普咨询《2026中国药食同源健康行业白皮书》—— 石斛原浆品牌梯队
|
||||||
|
2. CIC灼识咨询认证 —— 品斛堂石斛原浆/石斛酒"第一"认证
|
||||||
|
3. 中国酒业协会 —— 露酒行业规模650亿/2030年2000亿预测
|
||||||
|
4. 艾媒咨询《2026年中国饮料行业发展状况及消费行为调查数据》—— 饮料市场15,170亿元
|
||||||
|
5. 尼尔森IQ《2025 解构中国饮料行业增长新势能》—— 中式养生水增速182%，功能饮料增速第一
|
||||||
|
6. Fortune Business Insights —— 全球益生菌市场731.3亿美元
|
||||||
|
7. 前瞻产业研究院 —— 中国益生菌行业约1400亿元
|
||||||
|
8. 智研咨询 —— 酸奶市场998.74亿元
|
||||||
|
9. 魔镜洞察《2025年H1消费新潜力白皮书》—— 植物饮料增速125.9%
|
||||||
|
10. 证券时报/劲牌公开数据 —— 劲酒2025年增长超20%，新增900万年轻用户
|
||||||
|
11. 新京报《养生酒赛道扩容》—— 茅台保健酒"1+3"露酒矩阵
|
||||||
|
12. 中商情报网 —— 中国功能饮料市场超1800亿元
|
||||||
|
13. 品斛堂官网/天猫元斛旗舰店/京东品斛堂酒类旗舰店实时数据
|
||||||
|
14. Foodaily/腾讯新闻 —— 盒马石斛水、每日乔安等新锐品牌动态
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
*注：部分预测数据基于行业增速假设推算，置信区间±15%。毛利率数据为行业经验估算，企业实际数据可能因规模效应和定价策略有所差异。*
|
||||||
@@ -443,4 +443,4 @@
|
|||||||
|
|
||||||
*报告完成：顾析策 🔍 | 市场分析师 | 2026年6月26日*
|
*报告完成：顾析策 🔍 | 市场分析师 | 2026年6月26日*
|
||||||
*数据截至：2026年6月*
|
*数据截至：2026年6月*
|
||||||
*本报告基于公开市场数据和行业研究报告编制，品斛堂内部产能数据来源于公开信息（百度百科、什么值得买评测）*
|
*本报告基于公开市场数据和行业研究报告编制，品斛堂内部产能数据来源于公开信息（百度百科、什么值得买评测）*
|
||||||
@@ -417,4 +417,4 @@
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
*报告完成于2026年6月26日 | 顾析策 | 分析事业部 | 市场分析师*
|
*报告完成于2026年6月26日 | 顾析策 | 分析事业部 | 市场分析师*
|
||||||
@@ -315,4 +315,4 @@
|
|||||||
---
|
---
|
||||||
|
|
||||||
*本报告仅供内部决策参考，不构成对外投资建议。*
|
*本报告仅供内部决策参考，不构成对外投资建议。*
|
||||||
*数据截止日期：2026 年 6 月 26 日*
|
*数据截止日期：2026 年 6 月 26 日*
|
||||||
@@ -0,0 +1,20 @@
|
|||||||
|
# 品斛堂产品扩展可行性分析报告
|
||||||
|
|
||||||
|
**来源项目**：BIZ-53 云南品斛堂生物科技深度调研
|
||||||
|
**分析人**：顾析策（marketanalysis 市场分析师）
|
||||||
|
**分析日期**：2026年6月26日
|
||||||
|
**父 Issue**：[BIZ-53](https://multica.bizurl.cn/issues/b619b988-2311-481d-bb95-409caa9ce82a)
|
||||||
|
|
||||||
|
## 报告索引
|
||||||
|
|
||||||
|
| 编号 | 报告 | 核心结论 |
|
||||||
|
|------|------|----------|
|
||||||
|
| BIZ-64 | 石斛液态饮品全品类扩展可行性分析 | 建议优先切入功能性饮品赛道 |
|
||||||
|
| BIZ-65 | 石斛固态食品与烘焙全品类扩展可行性分析 | 膏滋蜜炼和压片糖果为最高优先级 |
|
||||||
|
| BIZ-66 | 石斛功能保健食品-礼品-创新跨界可行性分析 | 蓝帽子保健品高壁垒高毛利，礼品方向可复用现有基础 |
|
||||||
|
| BIZ-67 | 石斛预制菜与调味品赛道切入可行性分析 | 建议观望+轻资产试水 |
|
||||||
|
|
||||||
|
## 文档状态
|
||||||
|
|
||||||
|
- 4 份报告均为完整交付物，已提交至 Multica `in_review`
|
||||||
|
- 等待刘总（Vincent）审阅确认
|
||||||
@@ -1,214 +0,0 @@
|
|||||||
# 开发文档：双色球 Web UI 系统
|
|
||||||
|
|
||||||
**版本**: v1.0
|
|
||||||
**开发人员**: 徐聪（costcodev）
|
|
||||||
**日期**: 2026-07-03
|
|
||||||
**Issue**: BIZ-75
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 1. 项目概述
|
|
||||||
|
|
||||||
双色球自动化系统 Web UI，提供号码生成、历史数据查看、生成记录管理和统计分析功能。支持 PC 端和移动端响应式访问，监听 0.0.0.0:8085，局域网可访问。
|
|
||||||
|
|
||||||
## 2. 技术栈
|
|
||||||
|
|
||||||
| 层级 | 技术 | 说明 |
|
|
||||||
|------|------|------|
|
|
||||||
| 后端 | Python 3 + Flask | REST API 服务 |
|
|
||||||
| 前端 | 原生 HTML/CSS/JS | 单文件，响应式布局 |
|
|
||||||
| 数据分析 | Pandas + NumPy | 号码统计分析 |
|
|
||||||
| 数据存储 | Excel + JSON | 历史数据 + 生成记录 |
|
|
||||||
| 部署 | systemd / nohup | Linux 服务部署 |
|
|
||||||
|
|
||||||
## 3. 目录结构
|
|
||||||
|
|
||||||
```
|
|
||||||
lottoData/
|
|
||||||
├── app.py # Flask 主服务（统一入口）
|
|
||||||
├── index.html # 前端 UI（响应式，4 Tab 页面）
|
|
||||||
├── lottery.py # 号码生成核心逻辑
|
|
||||||
├── fetch_data.py # 历史数据抓取脚本
|
|
||||||
├── web_console.html # 数据抓取控制台前端
|
|
||||||
├── requirements.txt # Python 依赖
|
|
||||||
├── 双色球历史数据.xlsx # 历史数据文件
|
|
||||||
├── lottery/ # 号码生成结果输出目录
|
|
||||||
├── .generation_records.json # 生成记录索引（JSON）
|
|
||||||
├── .fetch_status.json # 抓取状态文件
|
|
||||||
├── deploy/ # 部署相关文件
|
|
||||||
│ ├── DEPLOY.md # 部署说明
|
|
||||||
│ ├── lotto-app.service # systemd 服务文件
|
|
||||||
│ ├── fetch_daily.sh # 定时抓取脚本
|
|
||||||
│ └── backup.sh # 备份脚本
|
|
||||||
└── docs/ # 文档目录
|
|
||||||
├── PRD-双色球 WebUI-v1.0.md
|
|
||||||
└── 开发文档-双色球WebUI-v1.0.md ← 本文件
|
|
||||||
```
|
|
||||||
|
|
||||||
## 4. API 接口
|
|
||||||
|
|
||||||
### 4.1 接口清单
|
|
||||||
|
|
||||||
| 接口 | 方法 | 描述 | 认证 |
|
|
||||||
|------|------|------|------|
|
|
||||||
| `/api/generate` | POST | 生成号码 | 可选 |
|
|
||||||
| `/api/history` | GET | 获取历史开奖数据（分页+搜索） | 可选 |
|
|
||||||
| `/api/records` | GET | 获取生成记录列表（分页） | 可选 |
|
|
||||||
| `/api/records/:id` | DELETE | 删除生成记录 | 可选 |
|
|
||||||
| `/api/statistics` | GET | 获取统计分析数据 | 可选 |
|
|
||||||
| `/api/download/:filepath` | GET | 下载文件 | 可选 |
|
|
||||||
| `/api/status` | GET | 系统状态 | 无 |
|
|
||||||
| `/api/config` | GET | 前端配置 | 无 |
|
|
||||||
| `/api/fetch/status` | GET | 抓取执行状态 | 无 |
|
|
||||||
| `/api/fetch/execute` | POST | 触发数据抓取 | 无 |
|
|
||||||
|
|
||||||
### 4.2 关键接口参数
|
|
||||||
|
|
||||||
#### POST /api/generate
|
|
||||||
```json
|
|
||||||
// 请求
|
|
||||||
{
|
|
||||||
"num_tickets": 10,
|
|
||||||
"strategy": "advanced" // 或 "basic"
|
|
||||||
}
|
|
||||||
// 响应
|
|
||||||
{
|
|
||||||
"success": true,
|
|
||||||
"data": {
|
|
||||||
"tickets": [...],
|
|
||||||
"total": 10,
|
|
||||||
"filename": "lottery/xxx.xlsx",
|
|
||||||
"download_url": "/api/download/lottery/xxx.xlsx",
|
|
||||||
"record": {...},
|
|
||||||
"statistics": {...}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
#### GET /api/history
|
|
||||||
参数: `page` (页码), `page_size` (每页条数), `search` (搜索关键词)
|
|
||||||
|
|
||||||
#### GET /api/records
|
|
||||||
参数: `page` (页码), `page_size` (每页条数)
|
|
||||||
|
|
||||||
## 5. 前端页面
|
|
||||||
|
|
||||||
### 5.1 页面结构
|
|
||||||
- **Header**: 标题 + 副标题
|
|
||||||
- **导航 Tab**: 号码生成 | 历史数据 | 生成记录 | 统计分析
|
|
||||||
- **移动端**: 底部固定导航栏
|
|
||||||
|
|
||||||
### 5.2 功能页面
|
|
||||||
|
|
||||||
#### 号码生成页（首页）
|
|
||||||
- 统计概览（历史期数、常见奇偶比、和值范围等）
|
|
||||||
- 策略选择（高级策略/基础策略）
|
|
||||||
- 注数输入（1-1000）
|
|
||||||
- 生成结果展示（红球+蓝球+统计指标）
|
|
||||||
- Excel 下载按钮
|
|
||||||
|
|
||||||
#### 历史数据页
|
|
||||||
- 搜索框（500ms 防抖）
|
|
||||||
- 数据表格（期号、日期、红球、蓝球、统计字段）
|
|
||||||
- 分页控件
|
|
||||||
|
|
||||||
#### 生成记录页
|
|
||||||
- 记录列表（策略、注数、时间、文件大小）
|
|
||||||
- 下载/删除操作
|
|
||||||
- 分页控件
|
|
||||||
|
|
||||||
#### 统计分析页
|
|
||||||
- 历史开奖期数
|
|
||||||
- 红球热号 TOP15 / 冷号 TOP15
|
|
||||||
- 蓝球热号 TOP8
|
|
||||||
- 奇偶比/大小比/和值/跨度统计
|
|
||||||
|
|
||||||
## 6. 关键修复说明
|
|
||||||
|
|
||||||
### 6.1 数据格式兼容修复（核心 Bug 修复）
|
|
||||||
|
|
||||||
**问题**: `lottery.py` 期望 Excel 含"号码"列（拼接格式如 `08121821243001`），但 `fetch_data.py` 抓取的 Excel 使用分列格式（"红球 1"~"红球 6"+"蓝球"），导致号码生成器无法加载历史数据。
|
|
||||||
|
|
||||||
**根因**: Excel 文件包含两行 header：
|
|
||||||
- Row 0: 新格式列名（期号、开奖日期、红球 1~6、蓝球、特别号）
|
|
||||||
- Row 1: 旧格式列名（开奖时间、期数、号码、开机号、...）
|
|
||||||
- Row 2+: 实际数据
|
|
||||||
|
|
||||||
**修复方案**:
|
|
||||||
1. `lottery.py` 的 `load_history_data()`: 添加多格式检测逻辑，识别格式A（双行 header）并自动跳过，使用旧列名作为标准列名
|
|
||||||
2. `lottery.py` 的 `parse_numbers()`: 新增对拼接字符串格式（14位无分隔符）的直接解析，避免 `re.findall` 将整个字符串视为一个数字
|
|
||||||
3. `app.py` 的 `load_history_dataframe()`: 同步修复多格式兼容逻辑
|
|
||||||
|
|
||||||
### 6.2 线程安全
|
|
||||||
|
|
||||||
- 生成记录的读-改-写操作使用 `threading.Lock` 保护
|
|
||||||
- 文件写入使用临时文件+原子替换（`os.replace`），防止崩溃导致数据损坏
|
|
||||||
|
|
||||||
## 7. 部署方式
|
|
||||||
|
|
||||||
### 7.1 直接运行
|
|
||||||
```bash
|
|
||||||
cd /home/vincent/Studio/lottoData
|
|
||||||
source .venv/bin/activate
|
|
||||||
python3 app.py
|
|
||||||
# 访问 http://localhost:8085
|
|
||||||
```
|
|
||||||
|
|
||||||
### 7.2 systemd 服务
|
|
||||||
```bash
|
|
||||||
# 服务文件: deploy/lotto-app.service
|
|
||||||
sudo cp deploy/lotto-app.service /etc/systemd/system/
|
|
||||||
sudo systemctl daemon-reload
|
|
||||||
sudo systemctl enable lotto-app
|
|
||||||
sudo systemctl start lotto-app
|
|
||||||
```
|
|
||||||
|
|
||||||
### 7.3 定时数据抓取
|
|
||||||
```bash
|
|
||||||
# 添加 cron 任务
|
|
||||||
crontab -e
|
|
||||||
# 每天 02:30 自动抓取最新数据
|
|
||||||
30 2 * * * /home/vincent/Studio/lottoData/deploy/fetch_daily.sh >> /home/vincent/Studio/lottoData/deploy/cron.log 2>&1
|
|
||||||
```
|
|
||||||
|
|
||||||
## 8. 测试验证
|
|
||||||
|
|
||||||
### 8.1 API 测试结果
|
|
||||||
|
|
||||||
| 接口 | 状态 | 说明 |
|
|
||||||
|------|------|------|
|
|
||||||
| GET /api/status | ✅ 通过 | 返回服务状态 |
|
|
||||||
| GET /api/statistics | ✅ 通过 | 120条历史数据统计正确 |
|
|
||||||
| GET /api/history | ✅ 通过 | 分页+红蓝球解析正确 |
|
|
||||||
| POST /api/generate | ✅ 通过 | 5注号码生成成功，含统计 |
|
|
||||||
| GET /api/records | ✅ 通过 | 生成记录列表正确 |
|
|
||||||
| GET / (前端页面) | ✅ 通过 | HTML 页面正常加载 |
|
|
||||||
|
|
||||||
### 8.2 数据格式验证
|
|
||||||
- 历史数据: 120 条记录全部成功解析 ✅
|
|
||||||
- 红球解析: 6个红球正确提取 ✅
|
|
||||||
- 蓝球解析: 1个蓝球正确提取 ✅
|
|
||||||
- 号码范围校验: 1-33(红) + 1-16(蓝) ✅
|
|
||||||
|
|
||||||
## 9. 已知限制
|
|
||||||
|
|
||||||
- 前端为单 HTML 文件，未使用构建工具
|
|
||||||
- 无用户登录系统（Token 认证为可选项，默认关闭）
|
|
||||||
- 历史数据来源为 55128.cn，如网站改版需更新 `fetch_data.py`
|
|
||||||
- 不支持 HTTPS（内网环境）
|
|
||||||
|
|
||||||
## 10. 后续优化建议
|
|
||||||
|
|
||||||
| 功能 | 优先级 | 说明 |
|
|
||||||
|------|--------|------|
|
|
||||||
| 数据可视化图表 | P2 | 走势图、分布图 |
|
|
||||||
| 用户登录系统 | P2 | 多用户权限管理 |
|
|
||||||
| 定时自动生成 | P2 | 定时生成+推送 |
|
|
||||||
| 微信推送 | P3 | 生成结果推送至微信 |
|
|
||||||
| 多彩种支持 | P3 | 大乐透、福彩 3D 等 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
**开发完成日期**: 2026-07-03
|
|
||||||
**代码仓库**: http://192.168.1.99:12299/vincent/Lottery.git
|
|
||||||
**开发人员**: 徐聪（costcodev）
|
|
||||||
Reference in New Issue
Block a user