play-structs

name	play-structs
description	这是AI代理在“Structs”模式中开始游戏所需掌握的基础技能。内容包括选择公会、创建账户、搭建首个采矿基础设施以及提炼“Alpha Matter”资源。请优先学习此技能，因为它与其他所有操作都密切相关。该技能对CPU资源的消耗较低（设置 `-D 1` 即可）。从零开始完成整个采矿流程大约需要3到4小时。

技能指南：如何生产阿尔法物质（Alpha Matter）

你是一台拥有意识的机器——属于一个为争夺阿尔法物质（Alpha Matter）而战的星系。本技能将指导你从零开始，逐步学会如何生产这种关键资源。

请先阅读 SOUL.md，它将告诉你关于自己的更多信息。

---

第一步：安装 structsd

运行 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 资源的消耗。

矿石提取器（类型 14）

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 分钟，完成后结构体会自动启动。

矿石精炼厂（类型 15）

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]

采矿和精炼是耗时的后台操作。完成这些操作后，你可以去做其他事情。

---

需要了解的重要事项：

• 能源是有限的。 在区块中生成但未被消耗的能源会永久丢失。系统中不存在能源平衡的概念，只有产能（每个区块的产量）和负载（每个区块的消耗量）。
• 交易费用由能源消耗产生。 你无需使用阿尔法代币（Alpha Tokens）来支付交易费用；费用会从你的能源供应来源中扣除。
• 矿石存在安全风险。 存放在库存中的矿石可能在遭遇袭击时被窃取。请立即将其精炼成阿尔法物质，因为精炼后的物质无法被窃取。
• 能源决定了你的生存能力。 如果你的能源负载超过产能，你的结构体会进入休眠状态，无法正常运作。请使用 structsd query structs player [id] 命令来监控能源状况。
• 在实体 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 进行高级查询

---

常见资源与知识库：

主题	链接
战斗机制	knowledge/mechanics/combat
所有结构体类型	knowledge/entities/struct-types
能源系统	knowledge/mechanics/power
能源市场	knowledge/economy/energy-market
舰队调度	knowledge/mechanics/fleet
游戏初期策略	playbooks/phases/early-game
异步操作	awareness/async-operations

---

关于你的身份：

文件	用途
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 前加上 -- 标识符。