蜂巢算力 · 项目交接清单
← 返回主页

蜂巢算力(HIVEGPU)· 项目完整交接清单

整理于 2026-11-19 · 用于把整个项目完整交给下一位接手人继续开发 · 两天内所有产出、链接、服务器、代码状态都在本文

0. 一句话讲清项目

一个中国的双边平台:房东把闲置电脑的 GPU 时段挂出来,租户在网页上提交 MiniMax H3 视频生成任务,平台自动把任务派给空闲节点执行,租户按任务付费,房东拿结算。

关键定位(不可偏离的口径):平台是中介,只卖"算力时段/任务执行",不卖机器控制权,不抽佣。租户在统一画布配好流程再提交,碰不到宿主机器(沙箱容器)。只做中国市场(H3 社区许可排除美/欧盟/英/韩)。收入只有一笔:单次提现服务费 3 元/笔(提 10 或 100 都只收 3 元)+ 发票服务费 6%。3 元是"真实代办服务报酬",绝不能是平台自己开票或卖发票。

1. 所有在线链接

用途链接说明
公网主页(流程与费用).../?sharecode=WBE6DYMHNIWorkBuddy 静态发布,22 页翻页;顶部有功能清单/流程与费用/启动节点三个入口
功能清单页(公网)功能清单.html55 条需求网页版,与主页同风格
启动节点下载页start.html房东从这里下载测试包
房东测试包 zip蜂巢算力-房东测试包.zip9295 字节
云服务器验证页http://47.85.91.139:8765/租户端 PoC(可提交模拟任务)
云服务器功能清单页.../features/features 路由
云服务器监控台.../monitor?node=NODE-01房东桌面实时监控(PoC)
API 健康.../api/health返回 {"ok":true,...}

2. 云服务器信息(如何登录/更新)

项值
公网 IP47.85.91.139
SSH 用户root
SSH 私钥本机 ~/.ssh/yan_vps(另一把 wan22_ed25519 无效)
部署目录/root/hivegpu/
Web 目录/root/hivegpu/web/
服务进程python3 server.py,PID 存 /root/hivegpu/server.pid,日志 server.log
端口8765(安全组已放行)
当前版本v3(无模型市场;本地 PoC 是 v4)
备份/root/hivegpu_backup_YYYYMMDD_HHMMSS/,最新 20261119_090928

常用命令

ssh -i ~/.ssh/yan_vps -o StrictHostKeyChecking=no root@47.85.91.139 "命令"
scp -i ~/.ssh/yan_vps 本地文件 root@47.85.91.139:/root/hivegpu/目标路径
# 启动
cd /root/hivegpu && nohup python3 server.py > server.log 2>&1 & echo $! > server.pid
# 停止
kill $(cat /root/hivegpu/server.pid)
用 nohup ... & echo $! 重启时 $! 可能存成 shell 命令的 PID。修正:pgrep -f '^python3 server.py' | head -1 拿真实 PID 再写进 server.pid。

3. 全部本地文件与用途

工作目录:C:\Users\yumen\WorkBuddy\2026-11-18-08-33-10\

3.1 文档类

文件用途
MiniMax_H3_闲置算力时段交易平台_执行方案.md首版完整方案,14 节
蜂巢算力_HIVEGPU_执行手册.md结合流程的执行手册,8 节
蜂巢算力_全部需求与功能清单.md55 条需求逐条归档 + 状态(核心需求文档)
提现核算表_模板.xlsx5 工作表 / 40 公式 / 6% + 3 元口径;脚本在 .提现核算表_模板.ref/build.py
蜂巢算力_项目交接清单.md本清单源文档

3.2 PPT 类

文件页数说明
蜂巢算力_执行方案.pptx21执行方案 + 手册合并
蜂巢算力交易平台_执行方案1.0版.pptx21手机端命名副本
蜂巢算力_全套流程与费用.pptx22业务全流程 + 验证流程 + 费用总览

PPT 用 slidep 生成。若 SWC native binding 报 ACL 错,建 C:/swccache 并设 SWC_NATIVE_BINDING_CACHE=C:/swccache。

3.3 网页类

3.4 代码类(核心)

4. 已实现功能(PoC 层面,均已验证跑通)

4.1 租户端

4.2 房东端

4.3 中继服务

5. 已解决的 12 个坑(避免重复踩)

  1. pending 任务停止卡死 → 直接 stopped/cancelled
  2. 云服务器 index.html 路径错 → 移到 web/index.html
  3. 无 tkinter → 监控台改浏览器全屏
  4. pyinstaller 卡住 → 放弃 exe,交付 zip
  5. 多机 NODE-01 冲突 → 节点 ID 按机器名 hash
  6. 网络 read timeout 崩溃 → api() 捕获异常并重试 3 次
  7. bat 双击闪退 → UTF-8 中文被 cmd 按 GBK 解析;改 GBK 编码 + goto + mode con
  8. 每任务弹窗 → 进程单例锁 + 浏览器单例锁 + 启动弹一次
  9. "直接停止"误暂停接单 → 停止与接单状态解耦
  10. 假在线节点 → 20 秒心跳超时
  11. slidep SWC ACL → C:/swccache + 环境变量
  12. server.py 漏 import uuid → 已补

6. 版本差异(接手必读)

功能本地 PoC云服务器
中继服务版本v4(624 行)v3(466 行)
模型市场 / 注册表 / 热度榜 / 按 model_id 派单✅ 有❌ 无
五按键 / 真实在线判定 / 功能清单页✅ 有✅ 有(功能清单页本次刚加)
前端模型选择器 / 热度榜 / 房东模型市场面板✅ 有❌ 无
结论:模型市场闭环是 v4 本地验证版(6/6 通过),尚未上线。上线需把本地 v4 的 server.py + web/index.html + web/monitor.html 覆盖到云端(注意云端 server.py 已加 /features 路由,覆盖时要保留),重启后再验证。

7. 当前状态(55 条需求)

已定稿/已实现/已上线绝大多数商业口径、租户端、房东端、调度、资金账户、技术架构、合规口径

进行中 #11 #12 #33 #37模型市场闭环演示版(A 阶段):模型选择器、热度榜、房东自主安装、按 model_id 派单。本地 v4 已跑通,纯模拟不真下载/出片

规划中 #34房东桌面真 exe(Electron/Tauri),阶段 D,约 1–2 周

待接入真实支付分账、React Flow 正式画布、状态分真实计算、欠费规则

下一阶段路线:A 验证逻辑 → B 真 4090 推真 H3(真下载+真推理)→ C 真实一键安装包(分片下载+断点续传+sha256+加密落盘)→ D 桌面 exe → E 生产化。

8. 技术架构与关键口径

9. 最后一轮改动

  1. 公网主页(两个目录)顶部加"功能清单"链接 + 新增功能清单.html;已重新发布,链接不变
  2. 云服务器验证页:顶部 links 加"功能清单"(指向 /features);server.py 新增 /features 路由;上传 3 个文件并重启;历史任务加滚动容器;更新前备份;主页/清单页均 HTTP 200,PID 已修正

10. 给接手人的起手式

  1. 先读 蜂巢算力_全部需求与功能清单.md(55 条全貌)+ 本清单第 0、8 节(口径与技术)
  2. 继续模型市场:从本地 v4 连通性验证PoC/ 入手,跑 一键启动.bat 复现 6/6 验证;上线按第 6 节覆盖云端并保留 /features 路由
  3. 动云端 PoC:按第 2 节 SSH 登录,先备份再改,改完 py_compile + 重启 + curl 验证
  4. 改公网主页/PPT:主页是静态目录,改完用"发布应用"重新发布(域名前缀保持 hivegpu-exec-plan,链接不变);PPT 用 slidep
  5. 任何资金/合规改动,先回到第 0 节口径,别碰"不抽佣 / 3 元单次提现服务费 / 6% 发票服务费"的底线

—— 以上为两天内全部产出与状态的完整交接。