核心用法
本技能为 Structs 区块链游戏的公会（Guild）管理提供完整 CLI 操作指南，涵盖四大核心场景：
1. 公会创建与发现
- 使用
structsd query structs guild-all浏览现有公会，或guild [id]查询特定公会详情 - 创建公会需具备 PermReactorGuildCreate (524288) 权限和 PermSubstationConnection (1024) 权限，命令格式为
structsd tx structs guild-create TX_FLAGS -- [reactor-id] [endpoint] [entry-substation-id]
2. 成员管理流程
- 主动加入：
guild-membership-join需抵押指定 infusion，新成员默认获得 rank 101 - 邀请制：会长发出
guild-membership-invite→ 受邀者执行invite-approve/deny - 申请制：玩家
guild-membership-request→ 会长审批request-approve/deny - 代理加入：
guild-membership-join-proxy允许代为他人执行加入操作 - 踢出成员：
guild-membership-kick需满足等级权限要求
3. 等级与权限系统
- 数值越小权限越高：1 为创建者，2-100 为自定义管理层，101 为默认成员，0 为未设置
- 核心规则：只能操作等级严格低于自己的成员（数值更大）
- 关键操作：
player-update-guild-rank调整成员等级；guild-update-entry-rank设置新成员默认等级（新值必须 ≥ 自身等级）
4. 中央银行代币操作
- 铸造：
guild-bank-mint将 Alpha Matter 抵押兑换为公会代币（无需指定 guild-id，自动使用签名者所属公会） - 赎回：
guild-bank-redeem销毁代币换回 Alpha Matter - 没收销毁：
guild-bank-confiscate-and-burn对指定地址执行代币没收
5. 基于公会等级的提供商访问控制
- 替代直接玩家授权，可通过
permission-guild-rank-set将 PermProviderAgreementCreate (262144) 权限授予指定公会达到特定等级的所有成员
显著优点
- 权限体系清晰：数值化等级系统 + 严格的严格比较规则，避免权限模糊
- 灵活的入会机制：支持直接加入、邀请制、申请制、代理加入四种模式，适应不同治理风格
- 经济系统集成：原生对接中央银行抵押机制，公会可自主发行代币
- 细粒度访问控制：公会等级权限可批量授权给符合条件的成员，简化大规模权限管理
潜在缺点与局限性
- CLI 解析陷阱：含连字符的 ID（如
3-1）会被误判为 flags，所有交易命令必须使用--分隔符，增加操作复杂度 - 等级数字反直觉：数值越小权限越高，新手易混淆
- 隐性权限依赖：多数操作需提前确认 reactor/substation/infusion 等前置权限，失败排查链条长
- 铸造无显式 guild 指定：依赖签名者当前所属公会，若公会变更可能导致误操作
- 无批量操作：成员管理、权限设置均为单条交易，大规模公会管理 Gas 成本较高
适合人群
- Structs 游戏玩家，尤其是公会创建者和管理层
- 需要代管公会操作的托管服务或工具开发者
- 研究游戏公会经济模型的分析师
常规风险
- 权限升级风险：
guild-update-entry-rank若设置不当，可能导致新成员等级过高，威胁现有治理结构 - 中央银行抵押不足：mint 操作前务必查询
guild-bank-collateral-address确认储备，否则交易失败 - 邀请/申请状态滞留：需主动查询
guild-membership-application-all清理过期申请，避免状态混乱 - 等级操作不可逆误伤：高等级成员误操作踢出或降级其他成员可能造成治理危机，建议多签或时间锁机制配合