核心用法
Structs Onboarding 是面向 Structs 链的完整新手引导技能，解决从"零地址"到"具备生产能力的星球基地"的全流程自动化。它分为两大路径：
路径 A（持有 $alpha）：通过 reactor-infuse 质押代币直接创建玩家；
路径 B（零资产）：通过公会程序化注册（guild signup），由 create-player.mjs 脚本自动完成助记词生成、代理消息签名、API 轮询与玩家创建。
创建玩家后，技能引导执行星球探索（planet-explore）、领取初始 Command Ship，并按标准顺序搭建首批基础设施：Command Ship（约 17 分钟）→ Ore Extractor（约 57 分钟）→ Ore Refinery（约 57 分钟）。所有建造均通过 struct-build-compute 完成 PoW 计算并自动上链激活，无需手动 struct-build-complete 或 struct-activate。
显著优点
- 双路径灵活适配：无论用户是否持有代币均可 onboarding；公会路径完全自动化，降低门槛。
- 内置安全细节：强制
--分隔符防止 CLI 将带横线的 Entity ID 解析为 flag；助记词安全提示完善（环境变量、.env、不提交 git）。 - PoW 优化策略：推荐
-D 3难度等待，实现"零 CPU 浪费"的瞬时哈希；提供明确的建造时间表与异步操作建议。 - 防并发冲突设计：明确警告"同一密钥禁止并发 compute"，避免序列号冲突导致交易静默失败。
- 详尽的命令速查表：涵盖密钥、查询、交易全生命周期，便于快速复制。
潜在缺点与局限性
- 外部依赖较重：路径 B 依赖特定公会 API 可用性（如 Orbital Hydro），若公会服务下线或配置变更（如
guildApivsguild_api字段差异）会导致失败。 - Node.js 版本限制：
create-player.mjs要求 Node 18+（依赖原生fetch），老旧环境需手动升级。 - 时间成本明确：即使优化到 D=3，首批三座建筑仍需约 2 小时等待，不适合追求"即时可玩"的场景。
- CLI 工具链依赖：全程围绕
structsd设计，无图形界面，纯命令行门槛对非技术用户较高。 - 公会注册的黑盒性：脚本虽自动处理签名与轮询，但失败时（120s 超时、HTML 返回）排查需理解 HTTP 与 secp256k1 签名编码细节。
适合人群
- 区块链游戏开发者/自动化代理（agents）需要程序化 onboarding 新账号；
- 公会运营者批量创建玩家；
- 熟悉 Cosmos SDK CLI 的技术用户，追求可复现的基础设施搭建流程；
- 愿意接受异步等待（PoW 降难度）以换取零额外能耗的环保/效率优先用户。
常规风险
- 助记词泄露：脚本生成的新助记词仅输出一次，若未立即保存至安全位置（环境变量/密钥管理器）将永久丢失账号；
--output json会明文打印助记词，存在终端历史泄露风险。 - PoW 并发冲突：违反"一密钥一 compute"规则会导致交易序列号冲突，建造进程卡住，需手动排查。
- 公会 API 单点故障：路径 B 的可用性完全依赖所选公会的代理服务，建议提前验证
services.guild_api字段存在性。 - Gas 与费用波动：使用
--gas auto --gas-adjustment 1.5虽简化操作，但在网络拥堵时可能低估费用导致交易挂起。