# 蜂巢算力 CombGPU · 投资人演示版(真机闭环已跑通)
> 云端只做「下单 / 调度 / 结算 / 页面」,GPU 在你自己的电脑上。
> 客户在公网下单 → 你在监控台点「开始接单」→ 任务派到你显卡 → 出图回传云端 → 客户下载。
> 已用本机 **GTX 1060 6GB** 实测跑通 3 单(2 成功 / 1 中途终止)。
---
## 一、现在能直接演示的地址
| 角色 | 地址 | 说明 |
|---|---|---|
| 客户(租户) | https://combgpu.com/ | 模型热度榜 → 选模型 → 写提示词 → 下单 → 看进度 → 下载原图 |
| 房东(你) | https://combgpu.com/monitor | 五按键接单控制、六格实时遥测、接单成绩、队列、历史、模型市场上架 |
| 功能清单 | https://combgpu.com/features | 原 55 条需求清单 |
| 项目文档 | https://combgpu.com/docs | 就是这份 README,网页里直接看 |
| 安装说明 | https://combgpu.com/guide | 房东装之前要知道的条件与排错 |
| 下载房东端 | https://combgpu.com/download/host-installer.zip | 房东一键安装包(zip) |
> **网关口令**:仅 `/admin`、`/features`、`/docs` 三个后台类页面套 Basic Auth,用户名 `hive`,密码 `1234567890`。客户页 `/`、监控台 `/monitor`、安装说明 `/guide`、下载 `/download/*` 全部免口令;`/api/*` 也不设口令,房东端与下单流程不受影响。
三个页面(客户页 / 监控台 / 功能清单)顶部都有一条**固定导航**:客户下单 · 房东监控台 · 功能清单 · 项目文档 · 安装说明 · 交接清单 · ⬇下载房东端安装包。文档与安装包都放在服务器 `/root/hivegpu/docs/`,改完文件重新上传即生效,不用重启中继。
**本机启动房东端**:双击 `启动房东节点.bat`(自动打开监控台并连接云端)
---
## 二、实测数据(本机 GTX 1060 6GB / i7-7700 / 16GB)
| 项目 | 实测值 |
|---|---|
| 模型 | Realistic Vision V5.1 (SD1.5, fp16) |
| 出图 | 512×680,24 步 |
| 耗时 | **25.4s / 24.9s / 25.0s**(三次基本一致) |
| 峰值显存 | ~3.2GB(占 6GB 的 53%,仍可同时开浏览器/办公软件) |
| 单张结算 | **¥0.0018**(按 ¥0.25/卡时) |
| 回传体积 | 489–523KB PNG |
| 中继延迟 | 下单→开跑 ≈1s;出图→云端可下载 ≈1s |
对照:同参数 8 步约 11.8s(用于「极速试稿」档位)。
---
## 三、三分钟演示脚本(建议照这个顺序讲)
### 首页布局(2026-11-19 改版)
客户页是「左看右下单」两栏:
- **左栏(看)**:① 实时工作 —— 当前正在跑哪一单、百分比、预估/已用时长、GPU 利用率/显存/温度/功率四格 + 滚动日志;② 排队中 —— 等待接单的订单(每行 任务号+提示词+预估耗时+取消);③ 历史订单 —— 已完成/已取消/失败,带缩略图与下载。
- **右栏(下单)**:④ 下单表单;⑤ 模型市场(放下单下方,按热度排序、独立滚动)。
- 队列、历史、模型市场三个列表各自带滚动条,滚轮直接生效;整页也可滚。
1. **打开客户页** → 指着右侧「模型市场」:FLUX #1、SDXL #2… 未装的显示"暂无房东安装 N 单在等"。
> 话术:客户要什么模型一眼可见,房东看到热度就会去装好卖的模型。
2. **下单**:选 Realistic Vision(带 ✓ 1 台房东已装),提示词写「金色蝴蝶结耳环,柔和棚拍光,纯白背景,产品特写」→ 点下单。
> 左栏「实时工作」立刻亮起来:百分比推进、GPU 利用率跳到 100%、显存 4.8GB、温度 65°C、功率 104W,日志逐条刷。
3. **再连下两三单** → 左栏「排队中」出现 2 单,可滚轮翻看,可单条取消。
4. **打开房东监控台** → 指 NODE-D3CE42 / 正在接单 / 六格遥测。
5. **讲五按键**:开始接单 / 停止接单 / 跑完当前任务再停 / 跑完所有任务再停 / 直接停止当前任务(+全屏)。
> 点「直接停止当前任务」演示中途终止:进度停在 29%,客户侧变"已取消",接单状态不变、排队不动,状态分 100→90。
6. **回客户页** → 左栏「历史订单」里成片缩略图 + 下载原图。
---
## 四、系统结构(为什么云端没有显卡也能出图)
```
客户浏览器 ──HTTP──► 云端 relay.py(combgpu.com:443 → Nginx → 127.0.0.1:8765)
│ ①下单入队 ②按「已装模型+接单状态」派单
│ ③存成片 ④页面/热度榜/结算
▼ 长轮询 + 心跳(20s 超时判离线)
房东电脑 node_agent.py
│ ⑤领单 ⑥拉起常驻 worker.py(模型驻显存只加载一次)
│ ⑦逐步骤上报进度 ⑧base64 回传成片
▼
本地 GPU (CUDA / diffusers)
```
- **租户拿不到宿主控制权**:租户只拿到提示词进、图片出的接口,没有任何远程桌面入口。
- **房东随时能停**:停止指令走「progress 回包里的 stop 标志 → worker 的 cancel_flag」,GPU 立即释放。
- **可水平扩展**:relay 支持多节点注册(`/api/nodes`),当前池内 1 台;再来 10 台房东机器,同一套代码不需要改,调度器自动挑「空闲 + 该模型已装」的节点。
---
## 五、新房东入驻 · 一键安装包
文件:`蜂巢算力-房东一键安装包.zip`(含 `install.bat` / `install.ps1` / `node_agent.py` / `worker.py` / `安装说明.txt`)
房东拿到 zip 后解压、双击 `install.bat`,脚本按七步自动完成:
1. 找 Python(`py` / `python` 都试;没有就用 winget 装 3.12,再没有就提示去官网)
2. 查 NVIDIA 显卡(`nvidia-smi` 取型号、显存、驱动版本)
3. 在 `%USERPROFILE%\hivegpu` 建**独立 venv**,不动房东已有的 Python / ComfyUI
4. 装 `torch 2.6.0+cu118`(阿里云 wheel 镜像,约 2.6GB;失败自动回落官方源)
5. 装 diffusers / transformers / accelerate / safetensors / pillow / psutil,并打印 `CUDA: True arch: ...` 自检
6. 找模型:本机 ComfyUI 里已有 `Realistic_Vision_V5.1_fp16.safetensors` 就**直接复用不复制**(省 2GB 和时间);没有才从 hf-mirror 下 2GB
7. 问节点名字 + 中继地址 → 生成 `node.json`(随机节点号)、`启动房东节点.bat`、桌面快捷方式,问是否立即启动
自检模式:`install.bat /check` 只输出 Python / GPU / Torch+CUDA / 模型 / 中继,不安装任何东西。
装完房东打开 `中继地址/monitor`,点「开始接单」才真正接单。
> 已在本机实测:`/check` 正确识别 GTX 1060 6GB / 驱动 581.57 / 复用 ComfyUI 权重;配置步骤能生成节点号、启动脚本(`HIVE_CKPT_DIR` 正确指向权重目录)与桌面快捷方式。
> 首次安装的 PyTorch 下载(2.6GB)在真实新机上约 5~15 分钟,这段没法在你现有环境里"预装",需要新房东自己跑一次。
## 六、多机在线 · 派单策略
监控台新增「多机派单 · 调度策略」卡片:
- **⚡ 自动(状态分高的优先)**:每次派单在「在线 + 空闲 + 已装该模型 + 接单中」的机器里,按状态分(完成率 / 终止率 / 温度)排序取最高,分数相同比完成单数。
- **📌 只派给指定机器**:订单只投给选定节点,其他机器在线也不接单(适合给某台 4090 留专用单)。
- 节点列表按分数排序,显示 `#1/#2`、接单状态、完成数、分数;点任一行即切到该节点的监控视图(`/monitor` 顶部「查看节点」下拉同步)。
- 同一台机器重复启动会被 PID 锁拦住退出,避免两份模型抢显存。
接口:`POST /api/dispatch {mode:"auto"|"pin", node_id}`;`POST /api/node/remove {node_id}` 清掉下线的机器。
## 六·五、模型市场上架机制(房东选、房东写、客户按它下单)
这一版把「模型」变成了**房东自己发布到市场的商品**,客户主页看到的就是房东上架的内容:
- 平台给出 5 个模型条目,每个都写明 **优势**(一句话卖点)、**功能**(4 个能力标签)、**配置要求**(显存 / 权重 / 单张耗时),不是空白让房东瞎填。
- 房东在监控台第 8 块「模型市场 · 选模型上架发布」里逐条看到这些信息,装好的模型**默认自动上架**;可以单独「下架」,也可以写一段 **给客户看的说明**(如"24 小时在线,急单优先")后保存。
- 没装的模型「上架接单」按钮是灰的,点不动——后端也拦:`POST /api/node/publish` 对未装模型直接返回「这台机器还没装该模型,装好后再上架」。
- 客户主页第 5 块「模型市场·按热度排序」每条卡片显示 **优势 / 功能标签 / 配置 / 房东说 / 「✓ N 台房东已上架·可下单」**;没有房东上架的显示「⚠ 暂无房东上架 · 下单后排队」,下单页顶部也会弹提示。
- **调度只认已上架**:下架后即使机器在线、模型装着,也不会被派单;重新上架立刻恢复接单。
- 上架记录持久化在 `relay_state.json` 的 `pub` 字段(`{model_id: {node_id: {on, blurb}}}`),重启中继不丢。
实测(`T134530-010`):下架状态下单 → 9 秒后订单仍 `pending`、上架台数 0 → 点「上架接单」→ 自动派单 → 21.3 秒出图完成、¥0.0015。
接口:`POST /api/node/publish {node_id, model_id, published?, blurb?}`;`GET /api/state` 的 `models[]` 带 `advantage/features/needs/publishers/publish_count`,`nodes[]. pubs` 带本机各模型的上架状态与说明。
### 文件清单
| 文件 | 作用 |
|---|---|
| `relay.py` | 云端中继:下单/调度/节点注册/成片落盘/页面,零第三方依赖(只用标准库) |
| `node_agent.py` | 房东节点代理:心跳、领单、管理 worker、回传、单实例锁 |
| `worker.py` | 生图常驻进程:diffusers SD1.5、fp16、逐步进度、可中断 |
| `web/tenant.html` | 客户下单页(左看右下单) |
| `web/monitor.html` | 房东监控台(大状态条 + 立体按键 + 多机调度) |
| `蜂巢算力-房东一键安装包.zip` | 新房东入驻包(install.bat/ps1 + agent + worker + 说明) |
| `host_installer/` | 上面那个包的源目录 |
| `启动房东节点.bat` | 本机连云端接单 |
| `一键演示.bat` | 起节点 + 开两个页面 |
| `deploy_relay.sh` | 云端部署/重启脚本(含端口占用清理) |
| `server.py` | 早期单机版(下单+出图同进程,8766),保留作对照 |
---
## 七、先说清楚「还没做」的(别被投资方问住)
按原 55 条需求清单,本轮**已实现**:#24–#27 五按键口径、#13 队列精简行、#14 预估 vs 实际耗时、#22 状态分 90–100、#31 20 秒心跳判在线、#35 停止后可改派、模型热度榜/货架、卡时计费、真 GPU 出图与回传。
**未实现(下一阶段)**:
1. 账号 / 充值 / 提现 / 分账(#39–#45)——现在是匿名下单、演示价。
2. 模型「一键安装包」只做了 SD1.5 那一个:装环境、复用/下载 Realistic Vision 都自动化了,但 SDXL / FLUX / SD3.5 的权重与适配还没进包(#47 的"多模型可选安装"仍是货架展示)。
3. 沙箱容器隔离(#49)——现在靠"只给提示词接口"的逻辑隔离,不是容器隔离。
4. 房东端还不是打包好的独立 exe(#34)——是一键安装包(bat+ps1+python),装完有桌面快捷方式。
5. 中文提示词靠内置词典(约 70 条),词典外词汇会丢;商用应接翻译模型或直接用支持中文的模型(SD3.5/FLUX)。
6. 多机只做了注册/心跳/按分派单/指定派单/移除节点;跨机房排障、断点续跑、故障自动改派演练还没做。
## 八、机器能力边界(要如实讲)
GTX 1060 是 Pascal 架构、无 Tensor Core、fp16 吞吐极差,**只适合 SD1.5 级验证**:
- SDXL(需 10GB)/ FLUX(需 12GB)/ SD3.5 在这张卡上跑不动(6GB 显存,且没有 fp8 加速)。
- 真正对外接商用单,建议准入 12GB 起(RTX 3060 12G / 4070 / 4080 / 4090)。
- 这张 1060 的定位:**证明平台链路成立**——下单、调度、真出图、回传、停止、结算全是真的,换成 4090 只是数字变大。
## 九、几个已经踩过的坑(换机器部署时会再遇到)
1. 现有 ComfyUI 的 venv 是 `torch cu130`,arch 不含 `sm_61` → 必须另建 torch cu118 环境。
2. `download.pytorch.org` 国内拉不动 → 用 `mirrors.aliyun.com/pytorch-wheels/cu118/`。
3. wheel 改名字会报 `not a supported wheel`,必须保留 `+cu118-cp313-cp313-win_amd64` 全名。
4. `from_single_file` 会去 HuggingFace 拉配置 → 需要 `HF_ENDPOINT=https://hf-mirror.com`。
5. SD1.5 的 CLIP 只认英文 → 服务端内置中译英,否则中文提示词出乱图。
6. 私钥权限过宽会被 OpenSSH 拒绝 → `icacls 私钥 /inheritance:r /grant:r "用户:(R)"`。
7. `kill server.pid` 不会杀掉旧 relay → 部署脚本要同时 `pkill -f "python3 relay.py"` 并等端口释放。
8. **同一台机器千万别起两个 node_agent**:每个 agent 都会拉起一个 worker 并各加载一份模型,6GB 显存必爆(实测表现为跑到 75% 报"未知错误")。现已在 `node_agent.py` 加了 PID 单实例锁,第二个实例会自己退出。
9. `D:\hive\venv\Scripts\python.exe` 是 venv 启动器,会再拉起一个真实 python,所以进程数看起来是 2 —— 这是正常的,不是重复实例。
10. 中继重启不要把 running 任务判死:节点还在跑,重启后继续等回传即可(现在只对"90 秒无进展 / 节点失联"判失败)。
11. **PowerShell 5.1 读无 BOM 的 UTF-8 脚本会按 GBK 解码**,中文会把引号吃掉导致 `Missing expression after ','` 之类的诡异报错 → `install.ps1` 必须存成 **UTF-8 with BOM**。
12. CMD 里 `for /f ... in ('命令')` 的单引号是定界符,命令内部再出现单引号(如 `ToString('N')`、`'|'`)必崩(`'w' was unexpected`)→ 改用双引号或 `chr(124)`,或干脆整段换成 PowerShell 脚本。