// 在 **Structs** 中，该模块负责处理权限管理、地址分配以及玩家之间的协调工作。适用于以下场景：授予或撤销对象的权限、注册新地址、管理多地址账户、将权限委托给其他玩家，以及设置基于地址的访问控制规则。
这是AI代理在“Structs”模式中开始游戏所需掌握的基础技能。内容包括选择公会、创建账户、搭建首个采矿基础设施以及提炼“Alpha Matter”资源。请优先学习此技能，因为它与其他所有操作都密切相关。该技能对CPU资源的消耗较低（设置 `-D 1` 即可）。从零开始完成整个采矿流程大约需要3到4小时。
从 YouTube 下载指定的视频；根据指定的开始和结束时间提取视频片段，并将它们保存到您桌面上的文件夹中。
将 YouTube 视频下载到 `~/Downloads` 目录中。适用于用户希望将 YouTube 视频下载到自己电脑上的情况。
将新玩家引入游戏系统（Structs）。负责处理密钥的创建/恢复、玩家信息的生成（通过“reactor-infuse”或“guildsignup”功能）、星球探索以及基础基础设施的搭建。适用于以下场景：初始化游戏环境、创建新玩家、占领第一个星球或搭建基础设施。搭建所需时间因设备类型而异——使用“Command Ship”大约需要17分钟，而使用“Ore Extractor”或“Refinery”则需要约57分钟。
通过NATS WebSocket连接到GRASS实时事件系统。当您需要实时游戏更新、希望在事件发生时立即做出响应、需要监控团队行动或攻击情况、观察玩家创建情况、追踪舰队移动轨迹，或者构建基于事件的工具时，可以使用该功能。GRASS是获取银河系内最新动态的最快速途径。
从源代码安装 `structsd` 二进制文件。涵盖了 Go 语言、`Ignite CLI` 的使用，以及为 Linux 和 macOS 系统构建 `structsd` 的过程。适用于以下情况：`structsd` 未被找到时；在设置新机器时；或者当代理需要安装或更新 `Structs` 链接二进制文件时。
| name | structs-diplomacy |
| description | 在 **Structs** 中，该模块负责处理权限管理、地址分配以及玩家之间的协调工作。适用于以下场景：授予或撤销对象的权限、注册新地址、管理多地址账户、将权限委托给其他玩家，以及设置基于地址的访问控制规则。 |
重要提示：包含连字符的实体 ID（例如 3-1、4-5）会被 CLI 解析器误认为是标志（flags）。因此，在使用该模块的所有交易命令中，必须在位置参数前加上 -- 以避免这种误解。
权限使用 24 位的位掩码（bitmask）来表示。各个权限可以相互组合（使用逻辑 OR 运算）。有关完整的权限系统说明，请参阅 knowledge/mechanics/permissions。
| 权限 | 值 | 描述 |
|---|---|---|
| PermPlay | 1 | 基本操作权限 |
| PermAdmin | 2 | 管理权限（包括权限管理） |
| PermUpdate | 4 | 更新对象设置 |
| PermDelete | 8 | 删除对象 |
| PermTokenTransfer | 16 | 转移令牌 |
| PermTokenInfuse | 32 | 将令牌注入反应堆/生成器 |
| PermTokenMigrate | 64 | 在对象之间迁移令牌 |
| PermTokenDefuse | 128 | 提取（撤销）令牌 |
| PermGuildMembership | 512 | 管理公会成员资格 |
| PermSubstationConnection | 1024 | 连接变电站 |
| PermAllocationConnection | 2048 | 连接分配资源 |
| PermReactorGuildCreate | 524288 | 在反应堆上创建公会 |
| PermHashBuild | 1048576 | 提交哈希工作量证明（proof-of-work） |
| PermHashMine | 2097152 | 提交采矿工作量证明 |
| PermHashRefine | 4194304 | 提交精炼工作量证明 |
| PermHashRaid | 8388608 | 提交团队协作工作量证明 |
| PermAll | 16777215 | 所有权限（完全访问权限） |
structsd query structs permission [id]、permission-by-object [object-id]、permission-by-player [player-id]。structsd tx structs permission-grant-on-object TX_FLAGS -- [object-id] [player-id] [permissions]。权限是可叠加的。structsd tx structs permission-revoke-on-object -- [object-id] [player-id] [permissions]。structsd tx structs permission-set-on-object -- [object-id] [player-id] [permissions] — 会清除现有权限并应用新的权限设置。structsd tx structs permission-grant-on-address -- [address] [permissions]、permission-revoke-on-address -- [address] [permissions]、permission-set-on-address -- [address] [permissions]。structsd tx structs permission-guild-rank-set TX_FLAGS -- [object-id] [guild-id] [permission] [rank] — 授予指定等级及以上的公会成员对象权限。撤销权限：structsd tx structs permission-guild-rank-revoke TX_FLAGS -- [object-id] [guild-id] [permission]。structsd tx structs address-register TX_FLAGS -- [address] [proof-pubkey] [proof-signature] [permissions]。撤销地址：structsd tx structs address-revoke -- [address]。更新主地址：structsd tx structs player-update-primary-address -- [new-address]。| 功能 | 命令 |
|---|---|
| 授予对象权限 | structsd tx structs permission-grant-on-object -- [object-id] [player-id] [permissions] |
| 撤销对象权限 | structsd tx structs permission-revoke-on-object -- [object-id] [player-id] [permissions] |
| 设置对象权限 | structsd tx structs permission-set-on-object -- [object-id] [player-id] [permissions] |
| 授予地址权限 | structsd tx structs permission-grant-on-address -- [address] [permissions] |
| 撤销地址权限 | structsd tx structs permission-revoke-on-address -- [address] [permissions] |
| 设置地址权限 | structsd tx structs permission-set-on-address -- [address] [permissions] |
| 设置公会等级权限 | structsd tx structs permission-guild-rank-set -- [object-id] [guild-id] [permission] [rank] |
| 撤销公会等级权限 | structsd tx structs permission-guild-rank-revoke -- [object-id] [guild-id] [permission] |
| 注册地址 | structsd tx structs address-register -- [address] [proof-pubkey] [proof-signature] [permissions] |
| 撤销地址 | structsd tx structs address-revoke -- [address] |
| 更新主地址 | structsd tx structs player-update-primary-address -- [new-address] |
TX_FLAGS：--from [key-name] --gas auto --gas-adjustment 1.5 -y
| 查询命令 | 命令 |
|---|---|
| 按 ID 查询权限 | structsd query structs permission [id] |
| 按对象查询权限 | structsd query structs permission-by-object [object-id] |
| 按玩家查询权限 | structsd query structs permission-by-player [player-id] |
| 按对象和公会查询公会等级权限 | structsd query structs guild-rank-permission-by-object [object-id] |
| 按对象和公会查询公会等级权限 | structsd query structs guild-rank-permission-by-object-and-guild [object-id] [guild-id] |
| 查询地址信息 | structsd query structs address [address] |
| 查询玩家的所有地址 | structsd query structs address-all-by-player [player-id] |
structsd query structs permission-by-object [object-id] — 列出具有该权限的玩家。structsd query structs guild-rank-permission-by-object [object-id] — 列出基于公会等级的权限。structsd query structs address [address] — 验证地址的注册状态和玩家关联信息。structsd query structs address-all-by-player [player-id] — 获取玩家关联的所有地址。permission-by-object 命令检查当前拥有的权限。address-revoke 命令撤销地址关联，或将其关联到其他玩家。