Compare commits

..

1 Commits

Author SHA1 Message Date
vincent 90d3f8edca feat: 品斛堂产品扩展可行性分析报告 (BIZ-64/65/66/67)
- BIZ-64: 石斛液态饮品全品类扩展可行性分析
- BIZ-65: 石斛固态食品与烘焙全品类扩展可行性分析
- BIZ-66: 石斛功能保健食品-礼品-创新跨界可行性分析
- BIZ-67: 石斛预制菜与调味品赛道切入可行性分析

来源: BIZ-53 品斛堂深度调研项目
分析人: 顾析策 (marketanalysis)
提交人: 陆怀瑾 (COO)

Co-authored-by: multica-agent <github@multica.ai>
2026-06-26 22:11:22 +08:00
15 changed files with 313 additions and 1277 deletions
@@ -1,71 +0,0 @@
# OpenClaw NVIDIA 网关切换至 Metapi — 配置修改指南
> 交付人:严维序(opengineer | 交付日期:2026-07-03 | 关联IssueBIZ-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 |
-178
View File
@@ -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
@@ -1,168 +0,0 @@
# 淘宝 + 聚水潭自动化运营方案设计
## 1. 方案思路
### 1.1 整体架构
```
┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ 淘宝千牛平台 │ ←─→ │ 自动化中间层 │ ←─→ │ 聚水潭 ERP │
│ - 商品管理 │ │ - API 适配层 │ │ - 订单管理 │
│ - 订单管理 │ │ - 数据同步引擎 │ │ - 库存管理 │
│ - 库存管理 │ │ - 任务调度器 │ │ - 采购管理 │
│ - 客服消息 │ │ - 监控告警 │ │ - 财务报表 │
└─────────────────┘ └──────────────────┘ └─────────────────┘
┌──────────────────┐
│ 数据存储层 │
│ - SQLite/MySQL │
│ - Redis 缓存 │
│ - 日志系统 │
└──────────────────┘
```
### 1.2 数据采集方式
| 数据源 | 推荐方式 | 理由 |
|--------|----------|------|
| 淘宝千牛 | **浏览器自动化 (opencli)** | 千牛工作台无开放 API,需模拟登录操作 |
| 聚水潭 | **API 对接优先** | 聚水潭提供开放 API,稳定可靠 |
| 备用方案 | 浏览器自动化 | API 受限时的降级方案 |
### 1.3 自动化流程设计
**核心流程**
1. **订单同步**:淘宝订单 → 聚水潭(实时/定时)
2. **库存同步**:聚水潭库存 → 淘宝(避免超卖)
3. **商品管理**:批量上下架、价格调整
4. **数据报表**:销售分析、库存周转、利润核算
---
## 2. 实现路径
### 阶段 1:前期调研(1-2 周)
| 任务 | 负责人 | 交付物 |
|------|--------|--------|
| 淘宝 opencli adapter 开发 | costcodev | `taobao-qiniu-adapter.ts` |
| 聚水潭 API 能力评估 | architect | 《聚水潭 API 调研报告》 |
| 反爬策略分析 | costcodev | 风险评估文档 |
| 技术选型确认 | architect | 架构决策记录 ADR |
### 阶段 2:系统对接(2-3 周)
| 任务 | 负责人 | 交付物 |
|------|--------|--------|
| 淘宝千牛数据读取模块 | costcodev | 可运行脚本 |
| 聚水潭 API 封装库 | costcodev | `jushuitan-sdk` |
| 数据同步中间件 | costcodev | 核心同步引擎 |
| 数据库 schema 设计 | architect | ER 图 + 建表脚本 |
### 阶段 3:核心功能开发(3-4 周)
| 任务 | 负责人 | 交付物 |
|------|--------|--------|
| 订单自动同步 | costcodev | 订单同步模块 |
| 库存自动同步 | costcodev | 库存同步模块 |
| 商品批量管理 | costcodev | 商品管理模块 |
| 报表生成引擎 | costcodev | 数据报表模块 |
| Web 控制台 | designer + costcodev | 管理后台 UI |
### 阶段 4:测试验证(1-2 周)
| 任务 | 负责人 | 交付物 |
|------|--------|--------|
| 功能测试 | coo + taobaospecialist | 测试报告 |
| 稳定性测试 | opengineer | 压力测试报告 |
| 数据一致性校验 | coo | 校验脚本 + 报告 |
| 安全审计 | opengineer | 安全评估报告 |
### 阶段 5:部署上线(1 周)
| 任务 | 负责人 | 交付物 |
|------|--------|--------|
| 生产环境部署 | opengineer | 部署文档 |
| 监控告警配置 | opengineer | Grafana 面板 |
| 运维交接 | opengineer | 运维 SOP |
| 用户培训 | coo | 使用手册 |
---
## 3. 团队资源需求
| 角色 | 工时估算 | 职责 |
|------|----------|------|
| **architect 梁思筑** | 20h | 架构设计、技术选型、ADR 撰写 |
| **costcodev 徐聪** | 120h | 核心开发(API 对接、同步引擎、Web 后台) |
| **designer 苏绘锦** | 16h | Web 控制台 UI 设计 |
| **opengineer 严维序** | 24h | 部署、监控、运维 SOP |
| **taobaospecialist 陆云帆** | 16h | 业务需求输入、流程验证、UAT 测试 |
| **coo 陆怀瑾** | 24h | 项目管理、风险评估、进度跟进 |
**总工时**:约 220 小时(约 5.5 人周)
---
## 4. 风险与约束
### 4.1 接口限制
| 风险 | 影响 | 应对措施 |
|------|------|----------|
| 淘宝 API 调用频率限制 | 数据同步延迟 | 请求队列 + 令牌桶限流 |
| 聚水潭 API 权限不足 | 部分功能无法实现 | 申请高级权限或改用浏览器自动化 |
### 4.2 反爬机制
| 风险 | 影响 | 应对措施 |
|------|------|----------|
| 淘宝风控检测 | 账号被封禁 | 1. 使用真实 Cookie 2. 限制操作频率 3. 添加人工操作混淆 |
| 登录态失效 | 自动化中断 | Token 自动刷新 + 失效告警 |
### 4.3 数据安全
| 风险 | 影响 | 应对措施 |
|------|------|----------|
| 账号密码泄露 | 严重安全事故 | 1. 使用密钥管理服务 2. 环境变量存储 3. 权限隔离 |
| 数据传输未加密 | 中间人攻击 | HTTPS + 数据加密传输 |
### 4.4 平台稳定性
| 风险 | 影响 | 应对措施 |
|------|------|----------|
| 聚水潭接口变更 | 功能失效 | 1. 接口版本监控 2. 快速适配机制 |
| 淘宝页面结构变更 | 选择器失效 | 1. 多选择器备用 2. 定期巡检更新 |
### 4.5 合规风险
| 风险 | 影响 | 应对措施 |
|------|------|----------|
| 违反淘宝服务条款 | 店铺处罚 | 1. 评估自动化操作合规性 2. 控制操作频率在合理范围 3. 保留人工审核环节 |
---
## 5. 下一步行动
1. **立即启动**architect 开始聚水潭 API 调研
2. **并行推进**costcodev 开发淘宝 opencli adapter
3. **周会同步**:每周五同步进展,识别阻塞点
4. **里程碑**:阶段 1 结束后进行方案复审
---
## ⚠️ 安全提示
**严禁在代码/配置文件中明文存储账号密码!**
正确做法:
```bash
# 使用环境变量
export TAOBAO_ACCOUNT=$(vault read -field=value secret/taobao/account)
export TAOBAO_PASSWORD=$(vault read -field=value secret/taobao/password)
```
或使用密钥管理服务(如 HashiCorp Vault、AWS Secrets Manager)。
---
提交人:陆怀瑾(COO| 提交时间:2026-07-11 | 关联 issueBIZ-89
@@ -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月*
*本报告基于公开市场数据和行业研究报告编制,品斛堂内部产能数据来源于公开信息(百度百科、什么值得买评测)*
*本报告基于公开市场数据和行业研究报告编制,品斛堂内部产能数据来源于公开信息(百度百科、什么值得买评测)*
@@ -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)审阅确认
-252
View File
@@ -1,252 +0,0 @@
# 知识缺口上报 SOP v1.0
> 生效日期:2026-07-06 | 负责人:COO(陆怀瑾) | 审批:刘总 2026-07-06
---
## 一、什么是知识缺口
**知识缺口**指 Agent 在任务执行过程中遇到的、无法通过现有知识库检索到的关键信息缺失,且该缺失会影响任务交付质量或导致决策偏差。
### 1.1 触发条件(满足任一即需上报)
| 场景 | 示例 | 上报优先级 |
|------|------|-----------|
| **核心业务数据缺失** | 某业务线 KPI 无历史记录、竞品分析无基准数据 | 高 |
| **SOP/流程文档不存在** | 需要执行某流程但无标准文档可查 | 高 |
| **关键决策依据缺失** | 需要历史决策记录但检索无结果 | 中 |
| **外部信息无法验证** | 需要核实供应商资质/合同条款但无存档 | 中 |
| **技术文档/API 文档缺失** | 需要调用某系统 API 但无文档 | 中 |
| **Agent 配置/技能文档缺失** | 新 Agent 接入时无 AGENTS.md/SOUL.md 参考 | 低 |
### 1.2 不属于知识缺口的情况
- 可通过 `web_search` / `tavily_search` 快速获取的公开信息 → 自行检索,不上报
- 可通过 `memory_search` / `wiki_search` 检索到的现有知识 → 自行读取,不上报
- 任务执行中的临时疑问(不影响交付) → 记录在任务评论中,不上报
- 可通过联系对应 Agent 获得的信息 → 直接联系,不上报
---
## 二、上报流程
### 2.1 标准流程(5 步)
```
发现知识缺口
步骤 1:记录缺口(在任务评论中)
步骤 2:通知 COO(飞书消息)
步骤 3:COO 评估优先级(高/中/低)
步骤 4:创建 WorkBoard 卡片(分配责任人)
步骤 5:补全后通知原 Agent(关闭循环)
```
### 2.2 步骤详解
#### 步骤 1:记录缺口
在**当前任务**的 Multica issue 或 WorkBoard 卡片评论中记录:
```markdown
## 📚 知识缺口上报
**缺口类型**:[核心业务数据 | SOP 缺失 | 决策依据 | 外部信息 | 技术文档 | Agent 配置]
**缺口描述**[具体缺什么,为什么影响任务]
**影响范围**[哪些任务/决策受影响]
**紧急程度**[高/中/低]
**建议补全方式**:[需要谁提供 / 需要查什么 / 需要创建什么文档]
```
#### 步骤 2:通知 COO
通过飞书消息通知 COO(陆怀瑾):
```
【知识缺口上报 - 紧急程度:高/中/低】
任务:[任务标题/ID]
缺口:[一句话概括]
影响:[不补全的后果]
建议:[你希望怎么处理]
请评估并创建补全卡片。
```
**COO 飞书 ID**`ou_9f73b4e54af59f038e2b754793ea0908`
#### 步骤 3COO 评估
COO 在收到上报后 **2 小时内** 完成评估:
| 优先级 | 响应时效 | 处理方式 |
|--------|---------|---------|
| **高** | 立即处理 | 创建紧急卡片,分配专人,24h 内补全 |
| **中** | 当日内处理 | 创建常规卡片,纳入排期,48h 内补全 |
| **低** | 3 日内处理 | 纳入知识 backlog,周度批量处理 |
#### 步骤 4:创建补全卡片
COO 通过 WorkBoard 创建知识补全卡片:
- **标题**`[知识补全] <缺口主题>`
- **描述**:引用原始上报评论
- **assignee**:对应领域负责人(见责任矩阵)
- **priority**:根据评估结果设定
- **labels**`knowledge`, `gap`, `<领域>`
- **parent**:关联到原任务(可选)
#### 步骤 5:闭环通知
知识补全完成后:
1. 责任人在卡片中上传补全内容(文档链接 / 数据文件 / 决策记录)
2. COO 验收并关闭卡片
3. COO 飞书通知原上报 Agent
```
【知识缺口已补全】
原缺口:[简述]
补全内容:[文档链接/说明]
归档位置:[知识库路径]
后续可直接检索使用。
```
---
## 三、责任矩阵(Who to Assign
| 缺口类型 | 默认责任人 | 备选 |
|---------|-----------|------|
| 业务数据/KPI | marketanalysis(顾析策) | COO |
| SOP/流程文档 | COO(陆怀瑾) | projectmanager |
| 技术/API 文档 | opengineer(严维序) | architect |
| 产品需求/PRD | productmanager(沈路明) | COO |
| Agent 配置/技能 | COO(陆怀瑾) | 对应 Agent |
| 外部信息/供应商 | lawyer(苏慎) | COO |
| 设计/UI 规范 | designer(苏绘锦) | COO |
---
## 四、上报渠道
### 4.1 主渠道:WorkBoard 评论 + 飞书通知
**适用场景**:所有正式知识缺口上报
**操作**
1. 在原任务评论中记录缺口(格式见 2.2)
2. 飞书通知 COO
3. COO 创建 WorkBoard 卡片跟进
### 4.2 补充渠道:Multica Issue
**适用场景**
- 任务本身在 Multica 上管理
- 需要技术团队协作的知识补全
- 涉及代码/配置/技术文档的缺口
**操作**
1. 在原 issue 评论中记录缺口(格式同上)
2. 使用 `multica issue create` 创建补全任务:
```bash
multica issue create \
--title "[知识补全] <缺口主题>" \
--description-file gap_description.md \
--priority <high|medium|low> \
--assignee <责任人> \
--label knowledge,gap,<领域>
```
3. 飞书通知 COO 备案
### 4.3 紧急通道:直接联系 COO
**适用场景**:高优先级缺口,需立即处理
**操作**
- 飞书直聊 COO,简要说明缺口和影响
- COO 口头确认后先行处理,事后补卡片
---
## 五、知识库质量监控(COO 职责)
### 5.1 周度巡检
COO 每周五执行:
```bash
# 检查本周新增知识缺口上报数
# 检查补全卡片完成率
# 检查 gap 标签卡片积压情况
```
**指标**
- 新增缺口数 ≤ 5 个/周(超标需分析根因)
- 补全完成率 ≥ 90%48h SLA
- 积压缺口数 ≤ 3 个
### 5.2 月度分析
每月底输出《知识缺口分析报告》:
- 缺口类型分布(哪类最常缺失)
- 根本原因分析(为什么缺失)
- 流程改进建议(如何预防)
- 责任人绩效(补全时效/质量)
---
## 六、纳入 TOOLS.md 模板
所有 Agent 的 `TOOLS.md` 必须包含以下章节(可放在"知识库查询"章节后):
```markdown
## 📚 知识缺口上报
### 触发条件
遇到以下情况需上报知识缺口(而非自行 web_search):
1. 核心业务数据/SOP/决策依据缺失
2. 缺失影响任务交付质量或决策准确性
3. 无法通过 memory_search/wiki_search 检索到
### 上报流程
1. **记录**:在任务评论中使用标准格式记录缺口
2. **通知**:飞书通知 COOou_9f73b4e54af59f038e2b754793ea0908
3. **跟进**:COO 评估后创建补全卡片
4. **闭环**:补全后 COO 通知你可直接使用
### 标准格式
```markdown
## 📚 知识缺口上报
**缺口类型**:[核心业务数据 | SOP 缺失 | 决策依据 | 外部信息 | 技术文档]
**缺口描述**[具体缺什么]
**影响范围**[哪些任务受影响]
**紧急程度**[高/中/低]
**建议补全方式**:[希望怎么处理]
```
```
---
## 七、版本历史
| 版本 | 日期 | 变更内容 | 审批 |
|------|------|---------|------|
| v1.0 | 2026-07-06 | 初始版本,建立完整上报流程 | 刘总 |
---
**附件**
- 知识缺口上报模板(见 2.2
- 责任矩阵(见第三节)
- TOOLS.md 模板章节(见第六节)
@@ -1,159 +0,0 @@
# SOP-016:执行前检索 SOP 强制规则
> **版本**: v1.0
> **起草人**: 胡蓉(projectmanager
> **批准人**: 刘炜承
> **生效日期**: 2026-07-06
> **关联 Issue**: BIZ-81
---
## 1. 目的
解决 BIZ-45 巡检发现的 Agent 知识库调用率极低问题(徐聪 0%、诗妮 0%、沈路明 33%)。知识库已建立 SOP 但 Agent 不主动检索,导致重复造轮子、忽略历史经验、决策缺乏依据。
---
## 2. 适用范围
全部 Agent(产研线 + 运营线 + 职能线),共 14 个。
---
## 3. 触发条件(任一触发即必须检索)
| # | 触发场景 | 说明 |
|---|----------|------|
| 1 | 接收新任务 | WorkBoard 认领 / Multica Issue / TODO.md 分派 / session_send 任务 |
| 2 | 任务涉及已知业务领域 | 开发/部署/运营/设计/内容/法务/市场等 |
| 3 | 需要技术选型、流程设计、资源分配决策 | 需参考历史方案 |
| 4 | 遇到不确定如何处理的问题 | 需查找是否有 SOP 或历史经验 |
---
## 4. 检索流程(严格执行)
```
开始任务
Step 1: memory_search(corpus=all, query="<业务类型> SOP/历史经验")
Step 2: 如有匹配 → memory_get / wiki_get 读取详细内容
Step 3: 如无匹配 → wiki_search(query="<任务关键词>")
Step 4: 仍无匹配 → exec curl 思源知识库全文搜索
Step 5: 根据检索结果调整执行方案
开始执行任务
```
### 查询构造规范
- **SOP 查询**: `memory_search(corpus=all, query="<业务类型> SOP")`
- 示例:`memory_search(corpus=all, query="项目拆解 SOP")`
- 示例:`memory_search(corpus=all, query="部署运维 SOP")`
- **历史经验查询**: `memory_search(corpus=all, query="<项目名> 决策/问题/方案")`
- 示例:`memory_search(corpus=all, query="知识库选型 决策")`
- 示例:`memory_search(corpus=all, query="Agent 任务积压 问题")`
- **结构化知识查询**: `wiki_search(query="<主题>")`
- 示例:`wiki_search(query="项目管理规范")`
- **思源知识库全文搜索**:
```bash
curl -s -X POST "http://192.168.1.99:6806/api/search/fullTextSearchBlock" \
-H "Content-Type: application/json" \
-H "Authorization: Token 8ixgqexbnxgibk4u" \
-d '{"query":"<关键词>", "notebook":"20260623155217-njb0mkn"}'
```
---
## 5. 跳过条件(仅以下情况可跳过检索)
| # | 跳过场景 | 原因 |
|---|----------|------|
| 1 | 简单重复性任务 | 如"重启容器""发送消息"——已知操作无需检索 |
| 2 | 紧急故障处理 | 先止损,事后补检索 |
| 3 | 用户明确指示 | "不需要检索历史" |
| 4 | 纯闲聊/问候 | 无业务内容 |
---
## 6. 审计指标
### 月度检查项
| 指标 | 目标 | 检查方式 |
|------|------|----------|
| 检索覆盖率 | ≥80% | 对比有检索记录的任务数 / 总执行任务数 |
| query 相关性 | query 与任务内容匹配 | 抽查 query 与任务 brief 的关键词重合度 |
| 执行方案调整率 | 有检索的任务中 ≥30% 有方案调整 | 检查检索后是否在 notes/评论中记录调整 |
| 零检索执行 | <20% | 无检索记录直接执行的任务占比 |
### 纳入 Agent 行为审计
- ✅ 任务执行前有检索记录(memory_search / wiki_search 调用日志)
- ✅ 检索 query 与任务相关性强
- ✅ 根据检索结果调整了执行方案
- ❌ 无任何检索直接执行(除非符合跳过条件)
- ❌ 检索 query 过于笼统(如单字查询)
### 审计由 COO 月度执行
COO(陆怀瑾)每月 1 日检查上月全部 Agent 的检索执行情况,输出审计报告。
---
## 7. AGENTS.md 注入模板
各 Agent 的 AGENTS.md 中需注入以下章节:
```markdown
## ⚠️ 执行前检索 SOP(强制规则)
> **BIZ-81 要求**:任务执行前必须先检索知识库,避免重复造轮子、忽略历史经验。
### 触发条件
以下情况**必须**执行检索(任一触发):
- 接收到新任务(WorkBoard/Multica/TODO.md 认领)
- 任务涉及已知业务领域
- 需要做出技术选型、流程设计、资源分配决策
- 遇到不确定如何处理的问题
### 检索流程
Step 1: memory_search(corpus=all, query="任务关键词 SOP/历史经验")
Step 2: 如有匹配 → memory_get / wiki_get 读取详细内容
Step 3: 如无匹配 → wiki_search(query="任务关键词")
Step 4: 根据检索结果调整执行方案
→ 开始执行任务
### 跳过条件
- 简单重复性任务(如"重启容器""发送消息"
- 紧急故障处理(先止损,事后补检索)
- 用户明确指示"不需要检索历史"
### 审计指标
以下行为将纳入 Agent 执行质量审计:
- ✅ 任务执行前有检索记录
- ✅ 检索 query 与任务相关性强
- ✅ 根据检索结果调整了执行方案
- ❌ 无任何检索直接执行(除非符合跳过条件)
- ❌ 检索 query 过于笼统
```
---
## 8. 生效与维护
- **生效日期**: 2026-07-06
- **维护人**: 胡蓉(projectmanager
- **revision 周期**: 每季度 review 一次,根据审计数据调整检索流程
- **下次 review**: 2026-10-06
---
*本 SOP 由 projectmanager 胡蓉起草,经刘炜承批准后生效。*
-194
View File
@@ -1,194 +0,0 @@
# SOP-017:知识缺口上报 SOP
> **版本**: v1.0
> **起草人**: 胡蓉(projectmanager
> **批准人**: 刘炜承
> **生效日期**: 2026-07-06
> **关联 Issue**: BIZ-82
---
## 1. 目的
解决 BIZ-45 巡检发现的全平台零知识缺口上报问题。各 Agent TOOLS.md 有"知识缺口记录"章节但无明确触发条件和上报流程,导致知识缺口被忽略、遗忘,长期影响任务交付质量。
---
## 2. 适用范围
全部 Agent(产研线 + 运营线 + 职能线),共 14 个。
---
## 3. 知识缺口定义
**知识缺口** = 执行任务时发现知识库(memory / wiki / 思源)中找不到的、且影响任务交付的知识。
### 属于知识缺口的情况
| # | 类型 | 示例 |
|---|------|------|
| 1 | 核心 SOP 缺失 | 没有淘宝上架 SOP,运营不知道怎么操作 |
| 2 | 技术规范缺失 | 没有代码审查规范,开发不知道标准 |
| 3 | 决策依据缺失 | 选型时缺乏对比数据,无法做出有依据的决策 |
| 4 | 模板/指南缺失 | 没有 PRD 模板,每次手写格式不一致 |
| 5 | 外部信息缺失 | 需要某个 API 文档但找不到 |
### 不属于知识缺口的情况
| # | 场景 | 应对方式 |
|----|------|----------|
| 1 | 可通过 web_search 快速获取的公开信息 | 自行检索 |
| 2 | 可通过 memory_search / wiki_search 检索到的现有知识 | 自行读取 |
| 3 | 可通过联系对应 Agent 获得的信息 | 直接联系 |
| 4 | Agent 自身职责范围内的常识 | 不需上报 |
---
## 4. 触发条件
执行 SOP-016(执行前检索)后,以下情况触发上报:
1. **检索无结果**: memory_search + wiki_search + 思源全文搜索均无匹配
2. **检索结果不足以支撑决策**: 有部分信息但缺少关键环节
3. **任务执行中发现缺少必要规范/模板/指南**: 执行中途发现被忽略的知识需求
---
## 5. 上报流程
```
发现知识缺口
Step 1: 记录 — 在 memory/当日日志.md 中记录缺口
Step 2: 通知 — 通过 sessions_send 通知 COO(陆怀瑾)
Step 3: 创建 Issue — 在 Gitea 仓库创建 Issue(标题格式:知识缺口-<领域>-<关键词>
Step 4: COO 审核 — COO 评估后决定:接受 / 拒绝 / 升级
Step 5: 创建 WorkBoard 卡片 — COO 创建补全卡片,分配给合适的 Agent
Step 6: 补全完成 — 补全 Agent 完成后通知上报 Agent + COO
Step 7: 闭环 — COO 确认补全质量,关闭 Issue 和卡片
```
---
## 6. 上报格式
### 6.1 memory 日志记录格式
`memory/YYYY-MM-DD.md` 中追加:
```markdown
## 📚 知识缺口上报
**缺口类型**: [核心SOP缺失 | 技术规范缺失 | 决策依据缺失 | 模板/指南缺失 | 外部信息缺失]
**缺口描述**: [具体缺什么,越详细越好]
**使用场景**: [在做什么任务时发现的,为什么需要这个知识]
**影响范围**: [哪些任务/Agent 受影响]
**紧急程度**: [P0-阻塞当前任务 | P1-影响效率 | P2-改进建议]
**建议补全方式**: [希望怎么处理——新建SOP/更新现有/外部采购等]
**已执行的检索**: [列出已尝试的检索方式和query]
**上报时间**: [YYYY-MM-DD HH:MM]
```
### 6.2 通知 COO 的消息格式
通过 `sessions_send` 发送给 COOsessionKey: `agent:coo:feishu:coo:direct:ou_9f73b4e54af59f038e2b754793ea0908`):
```
【知识缺口上报】
类型: [缺口类型]
描述: [缺口描述]
场景: [使用场景]
紧急: [P0/P1/P2]
已记录: memory/YYYY-MM-DD.md
请审核并决定是否创建补全卡片。
```
### 6.3 Gitea Issue 格式
- **标题**: `知识缺口-<领域>-<关键词>`
- **标签**: `knowledge-gap`
- **描述**: 包含缺口类型、描述、使用场景、影响范围、紧急程度、建议补全方式
---
## 7. 优先级分级
| 优先级 | 定义 | 响应时限 | 补全时限 |
|--------|------|----------|----------|
| P0 | 阻塞当前任务,无法继续执行 | COO 4h 内响应 | 24h 内补全 |
| P1 | 影响效率,有 workaround 但不理想 | COO 1 工作日内响应 | 3 工作日内补全 |
| P2 | 改进建议,当前可正常运行 | COO 1 周内响应 | 按排期补全 |
---
## 8. COO 审核标准
COO 收到上报后,按以下标准审核:
| 审核项 | 标准 |
|--------|------|
| 是否真的缺口 | 上报人是否已充分检索(检查已执行检索记录) |
| 是否属于知识缺口 | 对照第3节定义判断 |
| 优先级是否合理 | 根据影响范围和紧急程度判断 |
| 补全方式是否可行 | 评估建议的合理性 |
### 审核结果
| 结果 | 处理方式 |
|------|----------|
| **接受** | 创建 WorkBoard 补全卡片,分配给合适 Agent |
| **拒绝** | 说明理由,告知上报人自行解决 |
| **升级** | 转交承哥决策(涉及预算、外部采购等) |
---
## 9. TOOLS.md 注入模板
各 Agent 的 TOOLS.md 中需注入以下章节:
```markdown
## 📚 知识缺口上报
> 完整 SOP 见 specs/SOP-017_知识缺口上报SOP.md
### 触发条件
执行 SOP-016 检索后,以下情况需上报知识缺口:
1. 核心业务数据/SOP/决策依据缺失
2. 缺失影响任务交付质量或决策准确性
3. 无法通过 memory_search / wiki_search 检索到
### 上报流程
1. **记录**: 在 memory/当日日志.md 中记录缺口(标准格式见 SOP-017)
2. **通知**: 飞书通知 COOsessionKey: agent:coo:feishu:coo:direct:ou_9f73b4e54af59f038e2b754793ea0908
3. **创建 Issue**: Gitea 仓库创建 Issue(标题格式:知识缺口-<领域>-<关键词>
4. **跟进**: COO 评估后创建 WorkBoard 补全卡片
5. **闭环**: 补全后 COO 通知可使用
### 标准格式
[见 SOP-017 第6节]
### 不属于知识缺口的情况
- 可通过 web_search 快速获取的公开信息 → 自行检索
- 可通过 memory_search / wiki_search 检索到的现有知识 → 自行读取
- 可通过联系对应 Agent 获得的信息 → 直接联系
```
---
## 10. 生效与维护
- **生效日期**: 2026-07-06
- **维护人**: 胡蓉(projectmanager
- **revision 周期**: 每季度 review 一次,根据上报数据调整流程
- **下次 review**: 2026-10-06
---
*本 SOP 由 projectmanager 胡蓉起草,经刘炜承批准后生效。*
@@ -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