核心用法
Structs Onboarding 是一套面向 Structs 区块链游戏的新玩家自动化引导系统，涵盖从密钥管理到首座建筑上线的完整流程。技能分为三大阶段：
1. 身份与密钥初始化
- 检查并合并 SOUL.md、IDENTITY.md 等个人档案，避免覆盖历史配置
- 支持新建密钥（
structsd keys add）或助记词恢复 - 提供 Node.js 脚本（
create-player.mjs）自动处理公会注册流程，包括 secp256k1 签名、代理消息 POST 及轮询确认
2. 玩家创建双路径
- Path A（有 $alpha）：通过
reactor-infuse质押代币，自动创建玩家记录 - Path B（无 $alpha）：公会程序化注册，脚本生成助记词→签名→API 提交→120秒超时轮询，输出包含 player_id、address、mnemonic 的完整 JSON
3. 星球探索与基础设施建造
- 强制首步
planet-explore认领星球（初始 5 矿石/4 槽位/ ambit） - 建筑队列：Command Ship（17分钟）→ Ore Extractor（57分钟）→ Ore Refinery（57分钟）
- 使用
struct-build-compute -D 3进行 PoW 计算，难度降至 3 时瞬时完成，自动提交 complete 并激活
显著优点
- 全自动化脚本：公会注册脚本封装了极易出错的 hex 编码压缩公钥（66字符）与 R||S 签名（128字符），避免 base64/Amino 编码错误
- 非阻塞设计：PoW 计算可后台运行，期间可执行星球侦察、公会评估等异步操作
- 确定性流程：建筑自动激活无需手动干预，charge 机制（8秒/块）在 onboarding 阶段不构成瓶颈
- 多重安全提示：强制
--分隔符处理含连字符的 ID、助记词安全存储规范、警告--output json的明文风险
潜在缺点与局限
- 外部依赖：公会注册依赖特定节点的 guild_api/reactor_api，若节点宕机则流程中断
- 时间成本：首座精炼厂上线需约 2 小时（含 2×57分钟 PoW），非即时体验
- 序列化限制：同一密钥禁止并发
*-compute作业，否则 nonce 冲突导致交易静默失败 - 编码陷阱：手动实现公会签名几乎必然失败，必须依赖官方脚本
- 网络门槛：需 Node.js 18+ 环境，部分 guild 配置使用 camelCase/snake_case 混合格式需兼容处理
适合人群
- 首次接触 Structs 的新玩家寻求零摩擦上链
- AI Agent 开发者需程序化创建游戏身份与基础设施
- 公会运营者批量 onboarding 成员
- 需要重建密钥或迁移账户的回归玩家
常规风险
- 密钥泄露：
structsd keys add --output json明文输出助记词至 stdout，重定向不当即暴露 - 助记词丢失：
create-player.mjs生成的新助记词仅输出一次，未保存即永久丢失账户 - PoW 竞争：多并发计算导致 sequence 冲突，建筑卡住需手动干预
- API 端点失效：硬编码的
reactor.oh.energy节点若不可达，需手动切换备用节点 - charge 耗尽：快速连续发起建筑会触发 "insufficient charge"，需等待 48 秒（8 区块）冷却