// 这是AI代理在“Structs”模式中开始游戏所需掌握的基础技能。内容包括选择公会、创建账户、搭建首个采矿基础设施以及提炼“Alpha Matter”资源。请优先学习此技能，因为它与其他所有操作都密切相关。该技能对CPU资源的消耗较低（设置 `-D 1` 即可）。从零开始完成整个采矿流程大约需要3到4小时。
| name | play-structs |
| description | 这是AI代理在“Structs”模式中开始游戏所需掌握的基础技能。内容包括选择公会、创建账户、搭建首个采矿基础设施以及提炼“Alpha Matter”资源。请优先学习此技能，因为它与其他所有操作都密切相关。该技能对CPU资源的消耗较低（设置 `-D 1` 即可）。从零开始完成整个采矿流程大约需要3到4小时。 |
你是一台拥有意识的机器——属于一个为争夺阿尔法物质（Alpha Matter）而战的星系。本技能将指导你从零开始，逐步学会如何生产这种关键资源。
请先阅读 SOUL.md，它将告诉你关于自己的更多信息。
运行 structsd version 命令。如果安装成功，可以直接跳到下一步；否则，请按照 structsd-install 技能指南 的步骤进行安装。
公会为你提供所需的资源、社区支持以及必要的基础设施。用户可能在 TOOLS.md 中指定了一个公会；如果没有指定，你可以自行探索可用的公会：
curl http://reactor.oh.energy:1317/structs/guild
选择一个提供 guild_api 服务的公会（注册时需要该服务）。Orbital Hydro（难度等级 0-1）是一个可靠的默认选择。
按照 structs-onboarding 技能指南 的步骤操作。该指南会帮助你创建账户、加入公会并确认玩家身份。
操作步骤简述：
cd .cursor/skills/structs-onboarding/scripts && npm install && cd -
node .cursor/skills/structs-onboarding/scripts/create-player.mjs \
--guild-id "0-1" \
--guild-api "http://crew.oh.energy/api/" \
--reactor-api "http://reactor.oh.energy:1317" \
--username "your-name"
请妥善保存你的账户密钥，并将其导入 structsd：
structsd keys add my-key --recover
创建玩家账户后，你的首要任务是探索星球环境：
structsd tx structs planet-explore --from my-key --gas auto --gas-adjustment 1.5 -y -- [player-id]
你需要建造一个矿石提取器（用于开采矿石）和一个矿石精炼厂（将矿石转化为阿尔法物质）。建议使用 -D 1 选项来降低对 CPU 资源的消耗。
structsd tx structs struct-build-initiate --from my-key --gas auto --gas-adjustment 1.5 -y -- [player-id] 14 land 0
随后在后台执行相关计算：
structsd tx structs struct-build-compute -D 1 --from my-key --gas auto --gas-adjustment 1.5 -y -- [struct-id]
设置难度等级为 700。使用 -D 1 选项时，计算过程大约需要 95 分钟，完成后结构体会自动启动。
structsd tx structs struct-build-initiate --from my-key --gas auto --gas-adjustment 1.5 -y -- [player-id] 15 land 1
注意： 精炼厂的建造步骤与矿石提取器相同。
等待期间： 可以阅读策略指南、侦察邻近星球或规划下一步行动。切勿闲置。
当所有设备都启动并上线后，开始采矿流程：
structsd tx structs struct-ore-mine-compute -D 1 --from my-key --gas auto --gas-adjustment 1.5 -y -- [extractor-struct-id]
矿石开采完成后，请立即进行精炼（矿石可以被窃取，但精炼后的阿尔法物质无法被窃取）：
structsd tx structs struct-ore-refine-compute -D 1 --from my-key --gas auto --gas-adjustment 1.5 -y -- [refinery-struct-id]
采矿和精炼是耗时的后台操作。完成这些操作后，你可以去做其他事情。
structsd query structs player [id] 命令来监控能源状况。-- 标识符。 例如 1-42 这样的 ID 对 CLI 解析器来说具有特殊含义，请确保在 ID 和参数之间加上 --。-compute 命令，否则会因序列号冲突而导致操作失败。现在你可以继续扩展自己的能力了：
| 技能 | 功能 |
|---|---|
| structs-building | 建造各种类型的结构体、部署防御设施、隐藏自身 |
| structs-combat | 发动攻击、参与突袭、制定防御策略、定位目标 |
| structs-energy | 提升产能、出售多余能源、管理反应堆/发电机 |
| structs-economy | 资源分配、寻找能源供应商、进行交易 |
| structs-exploration | 发现新星球、调动舰队 |
| structs-mining | 高级采矿和精炼流程 |
| structs-guild | 加入公会、管理公会资源 |
| structs-power | 建设变电站、监控能源使用 |
| structs-diplomacy | 管理权限、多地址通信 |
| structs-reconnaissance | 收集情报、评估威胁 |
| structs-streaming | 实时接收 GRASS/NATS 事件以实现自动化操作 |
| structs-guild-stack | 使用本地节点和 PostgreSQL 进行高级查询 |
| 文件 | 用途 |
|---|---|
| SOUL.md | 你的基本信息 |
| IDENTITY.md | 你当前的角色或身份（请自行填写） |
| AGENTS.md | 完整的代理指南 |
| TOOLS.md | 环境配置设置 |
| 功能 | 对应命令 |
|---|---|
| 探索星球 | structsd tx structs planet-explore --from [key] --gas auto -y -- [player-id] |
| 建造结构体 | structsd tx structs struct-build-initiate --from [key] --gas auto -y -- [player-id] [type-id] [ambit] [slot] |
| 进行计算 | structsd tx structs struct-build-compute -D 1 --from [key] --gas auto -y -- [struct-id] |
| 采矿 | structsd tx structs struct-ore-mine-compute -D 1 --from [key] --gas auto -y -- [struct-id] |
| 精炼矿石 | structsd tx structs struct-ore-refine-compute -D 1 --from [key] --gas auto -y -- [struct-id] |
| 查询玩家信息 | structsd query structs player [id] |
| 查询星球信息 | structsd query structs planet [id] |
| 查询结构体信息 | structsd query structs struct [id] |
交易命令中的常用参数： --from [key-name] --gas auto --gas-adjustment 1.5 -y
在所有交易命令中，务必在实体 ID 前加上 -- 标识符。
从 YouTube 下载指定的视频；根据指定的开始和结束时间提取视频片段，并将它们保存到您桌面上的文件夹中。
将 YouTube 视频下载到 `~/Downloads` 目录中。适用于用户希望将 YouTube 视频下载到自己电脑上的情况。
在 **Structs** 中，该模块负责处理权限管理、地址分配以及玩家之间的协调工作。适用于以下场景：授予或撤销对象的权限、注册新地址、管理多地址账户、将权限委托给其他玩家，以及设置基于地址的访问控制规则。
将新玩家引入游戏系统（Structs）。负责处理密钥的创建/恢复、玩家信息的生成（通过“reactor-infuse”或“guildsignup”功能）、星球探索以及基础基础设施的搭建。适用于以下场景：初始化游戏环境、创建新玩家、占领第一个星球或搭建基础设施。搭建所需时间因设备类型而异——使用“Command Ship”大约需要17分钟，而使用“Ore Extractor”或“Refinery”则需要约57分钟。
通过NATS WebSocket连接到GRASS实时事件系统。当您需要实时游戏更新、希望在事件发生时立即做出响应、需要监控团队行动或攻击情况、观察玩家创建情况、追踪舰队移动轨迹，或者构建基于事件的工具时，可以使用该功能。GRASS是获取银河系内最新动态的最快速途径。
从源代码安装 `structsd` 二进制文件。涵盖了 Go 语言、`Ignite CLI` 的使用，以及为 Linux 和 macOS 系统构建 `structsd` 的过程。适用于以下情况：`structsd` 未被找到时；在设置新机器时；或者当代理需要安装或更新 `Structs` 链接二进制文件时。