FlintHub · 燧石币 FlintCoin 插件需求方案

定位：论坛内部模拟币、纯社区游戏资产，不是真实加密货币，底层复用FlintHub现有用户、积分、SQLite、插件体系、签名校验；遵循目录即插件，独立数据表、开关可控、可随时关闭/冻结生态。
目标：完整落地白皮书v1.0全部规则，同时增加后台管控、风控、日志、配置项，方便你运维。

一、基础配置 & 全局开关（后台插件设置页）

全局总开关

  • 总启停：一键开启/关闭挖矿、交易、兑换、K线。关闭后矿机页面隐藏、所有兑换入口隐藏，仅保留资产记录查看。
  • 测试模式开关（对应Phase1封闭测试）：测试模式下挖矿正常产出、资产记账，但禁止兑换、禁止销毁、不参与储备池变动；提示【封闭测试期，币仅展示，暂不可交易】。
  • 创世区块手动触发按钮：插件安装后，管理员手动点击生成Block #0，初始化储备池、难度、初始区块高度；避免自动创世乱掉。

参数配置项（全部后台可改，改后即时生效，日志留痕）

  1. 总量硬顶：21000000 FC（可锁定，不建议开放修改）
  2. 初始区块奖励：50 FC
  3. 减半高度间隔：210000区块
  4. 目标出块间隔：10分钟/块
  5. 难度调整周期：每N个区块重新计算全网难度（推荐每20块调整一次）
  6. 燃烧费率：5%（兑换积分时扣流通量销毁）
  7. 最低兑换门槛：100 FC
  8. 新号收益冻结时长：7天（注册不足7天账号挖到的FC标记冻结，冻结资产只可看、不可兑换、不可消耗）
  9. 51%算力告警阈值：50%，支持设置告警方式（后台消息通知/管理员站内信）
  10. 储备池积分：独立池子，和用户个人积分隔离，管理员单独往储备池注入/扣减积分，操作留审计录
  11. 算力倍率上限：防止盲盒、buff无限叠加（例如最高3倍封顶）

数据表规划（插件独立表，不和主论坛业务表强耦合）

  • fc_blocks：区块表，高度、出块时间、难度、奖励、打包矿工、区块hash、nonce
  • fc_transactions：交易流水（转账、兑换、销毁、挖矿产出、藏品消费、盲盒消耗），每条带hash指纹、类型、状态
  • fc_user_account：用户账户，总挖到、已流通、冻结数量、当前算力、矿工等级、钻石手标记、最后兑换时间、累计兑换记录
  • fc_pool：储备池表，记录储备池积分总额、历史注入/扣减记录
  • fc_difficulty_log：难度变更日志
  • fc_kline：K线快照表，定时快照汇率、流通量、储备池、全网总算力（用于绘图）
  • fc_buff：算力buff表（盲盒产出的限时/永久算力加成）

二、PoW挖矿模块（前端矿机 + 后端校验，重点防脚本）

注意：是模拟SHA256 PoW，前端做nonce遍历，后端二次校验，算力权重由后端管控，不把真实算力完全放前端。

前端矿机页面

  1. 矿机控制面板：启停按钮、当前本地算力、全网总算力、当前难度、距离下一块预估时间、自己待确认收益、冻结/可用资产分开展示
  2. 矿工等级标签自动展示：碳基矿工 / 硅基矿工 / 钻石手
  3. 实时状态：正在挖矿、等待区块、爆块成功弹窗通知（站内通知+页面toast）
  4. 限制：不允许多标签页叠加算力；同一个账号多开页面，算力只计一份，防刷

算力规则

  • 碳基矿工（默认）：基础算力=1
  • 硅基矿工：累计挖出≥500FC，基础算力+10%（永久基础加成，和buff叠加）
  • 算力Buff来源：盲盒产出，分限时（如24h算力×2）、SSR永久算力×2，设置倍率封顶
  • 算力只参与区块出块概率分配，不是前端随便上报多少算多少，后端做概率分配

难度&出块逻辑

  • 目标：全网平均10分钟一块；每一轮难度周期，统计上一周期实际出块耗时，自动上调/下调难度
  • 爆块分配：全网算力加权随机，算力越高，抢到区块的概率越高；一个区块只有一个矿工获得区块奖励
  • 区块奖励自动减半：区块高度每到210000整数倍，下一个区块奖励自动折半，后台显示减半倒计时
  • 收益标记：注册7天内账号挖到的FC标记【冻结】，冻结期内不可兑换、不能买藏品、不能抽盲盒；到期系统自动批量解冻

风控：51%算力攻击检测

  • 定时统计单账号算力占全网总算力比例
  • 超过阈值：后台触发告警、站内信发给管理员；自动限流：该账号算力临时打折扣（比如折半），管理员可选择直接封禁挖矿权限
  • 女巫防护：小号冻结机制、管理员可黑名单UID直接禁用挖矿

反脚本机制

  • 后端校验nonce+hash合法性，前端提交的结果后端重算校验；高频提交、短时间大量爆块直接标记异常、冻结收益
  • 日志记录挖矿请求IP、UA、请求频率，后台异常行为清单

三、储备池 + 动态汇率、K线模块（核心经济引擎）

汇率公式严格执行：实时汇率 = 储备池积分总额 ÷ FC全网可用流通量（冻结币不计入流通）

  • 全网流通量 = 所有用户【可用FC之和】，销毁的币永久剔除流通量
  • 储备池独立：只有管理员操作注入积分、或者用户兑换积分时扣减储备池；普通用户不能直接往储备池充积分，只能通过兑换消耗FC
  • 兑换流程：用户提交FC兑换积分
  1. 校验：≥最低门槛、资产是可用未冻结
  2. 计算燃烧费：5% FC直接销毁，从流通总量扣除，打入黑洞地址（黑洞是系统虚拟账户，只进不出）
  3. 剩余FC按实时汇率换算储备池积分，储备池扣减对应积分，转给用户个人论坛积分
  4. 写入交易记录、更新流通量、更新K线快照

白皮书写法：大量兑换 → 两重影响：流通量减少推高单价、储备池减少压低单价，形成回调，逻辑落地

K线&行情面板

  • 折线图指标：实时汇率、今日涨跌幅、历史最高价ATH、全网流通量、储备池余额、全网总算力、区块高度、距离下次减半剩余区块
  • 快照策略：定时（5分钟/15分钟）写入K线快照，不实时高频入库，减轻数据库压力
  • 行情页面公开，不需要开启矿机也能看行情，吸引围观用户

四、FC消耗生态（赋能场景，吸收流通盘）

全部消耗：消耗的FC直接销毁，从流通量移除，不回流市场

  1. 限量数字藏品/特权商店（后台上架商品）
  • 商品类型：绝版头衔、动态发光签名、靓号UID、专属头像框
  • 管理员上架，设置FC售价、库存上限、是否限购每人1次
  • 购买校验：资产可用、非冻结；购买成功发放对应论坛权限，消耗FC销毁
  1. 哈系盲盒
  • 固定消耗：100 FC/抽，后台可改
  • 奖池配置（后台可视化配置概率）：
  • 普通：少量积分、临时算力buff（1h/12h）
  • 稀有：24h算力×2
  • SSR：永久算力翻倍（倍率参与全局上限管控）
  • 抽卡弹窗动画、抽卡记录，可看自己盲盒历史
  1. 钻石手判定（自动任务）
  • 判定条件：连续7天没有发起任何FC兑换，并且账户可用FC≥1000
  • 系统每日定时跑任务批量判定，达标自动授予全站金色【钻石手】徽章；一旦兑换一次FC，钻石手身份立刻取消，徽章收回，需要重新累计7天
  • 钻石手只是身份徽章、信仰标识，不自带算力加成（按白皮书设定）

五、治理特权：巨鲸投票

  • 每日定时快照FC持有排名（只统计可用FC，冻结不计）
  • 持仓前10名用户自动获得本期投票资格
  • 投票载体复用论坛投票插件：管理员新建治理投票（版块开放、活动规则等议题），勾选【仅燧石币前10巨鲸可参与】
  • 投票结束公示结果；快照每日更新，巨鲸名单每日轮换

六、Phase3新增：积分反向买FC通道（拉盘通道）

后台开关，可单独启用/关闭

  • 用户使用个人论坛积分，从储备池挂单购买FC
  • 规则：用户支付积分，积分进入储备池（储备池变大→汇率上涨），系统铸造对应FC给用户（⚠️这里要注意和白皮书总量硬顶对齐：总量硬顶2100万，挖到上限后，不能再铸造）
  • 上限保护：当总产出达到21000000，买币通道自动关闭，提示FC已全部产出

七、Phase4：矿池功能（二期迭代需求，先预留字段）

  • 用户可以创建矿池、加入矿池
  • 矿池算力 = 所有成员算力之和
  • 爆块奖励不归属单一矿工，按每个成员在矿池内算力占比瓜分奖励
  • 矿池管理：创建者可设置分成比例、是否允许新人自由加入/审核加入
  • 矿池排行榜、矿池算力榜单

一期先不开发，数据表预留矿池id字段，方便后面迭代，不改动核心表结构

八、通知、日志、后台审计面板（运维刚需）

用户侧通知

  • 爆块成功通知、盲盒开奖通知、钻石手身份获得/丢失通知、资产解冻通知、兑换成功通知、51%算力告警（管理员）
  • 资产变动流水：独立资产账单，区分：挖矿产出、兑换消耗、盲盒消耗、藏品消费、销毁、冻结解冻

管理员审计后台

  1. 区块浏览器：浏览全部区块、查看每块出块人、奖励、时间、哈希
  2. 交易浏览器：所有交易可检索，支持按UID、交易类型筛选，查看黑洞销毁记录
  3. 异常监控面板：高算力账号清单、51%告警记录、高频挖矿异常账号、脚本嫌疑列表
  4. 储备池操作日志：谁、何时注入/扣减多少积分，不可删除
  5. 批量工具：管理员可冻结指定用户FC资产、清零资产、重置算力（风控兜底）

九、权限、提示与免责（页面固定展示）

  1. 矿机页面、行情页、兑换页顶部常驻提示：燧石币为论坛内部模拟娱乐资产，无现实价值，不可提现
  2. 兑换、盲盒购买二次确认弹窗，再次提示风险
  3. 外挂提示：使用脚本刷算力、批量小号刷币，查实没收全部FC、封禁挖矿权限
  4. 插件页面底部引用白皮书链接，直接跳转到你准备发布的白皮书帖子

十、版本迭代排期（对应白皮书Roadmap）

  • V1.0（Phase1 创世封闭测试）：插件主体、矿机PoW、难度自动调节、区块浏览器、K线行情、冻结机制、后台配置、风控告警；关闭兑换、关闭买币通道、盲盒/藏品商店隐藏
  • V1.1（Phase2 开放交易）：开启FC兑积分通道、燃烧销毁、上线早期矿工徽章藏品商店
  • V1.2（Phase3 生态繁荣）：哈系盲盒、积分反向购买FC通道、巨鲸投票治理
  • V1.3（Phase4）：矿池联盟算力分摊系统

十一、边界约束（非常重要，适配你的FlintHub架构）

  1. 完全作为独立插件，可随时禁用、卸载；卸载时可选保留交易区块数据或者清空
  2. 复用FlintHub签名校验体系，插件配置、资产操作日志防篡改
  3. OPcache友好，K线快照异步任务、区块难度计算走计划任务，避免前端请求阻塞页面（你现在页面42ms响应，不能因为挖矿拖慢主站）
  4. 不引入外部服务、不需要第三方API，全部SQLite本地完成
  5. 所有数值用高精度小数，避免汇率、燃烧费浮点计算误差

希望你们做出来，能给我个免费下载的权限，哈哈😁

主楼