Structs 侦察

流程

1. 1. 查询实体 — 全部通过 structsd query structs [子命令] [参数] 执行：

- 自身：address [你的地址] — 将你的地址解析为玩家ID。结果为 1-0 表示该地址没有对应玩家。 - 玩家：player [ID]，player-all - 星球：planet [ID]，planet-all，planet-all-by-player [玩家ID]，planet-attribute [星球ID] [类型]，planet-attribute-all - 结构：struct [ID]，struct-all，struct-attribute [ID] [类型]，struct-type [ID]，struct-type-all - 舰队：fleet [ID]，fleet-all，fleet-by-index [索引] - 公会：guild [ID]，guild-all，guild-membership-application [ID]，guild-membership-application-all - 能量：reactor [ID]，reactor-all，infusion [ID]，infusion-all，infusion-all-by-destination [目标ID]，provider [ID]，provider-all，agreement [ID]，agreement-all，agreement-all-by-provider [提供者ID] - 电力：allocation [ID]，allocation-all，allocation-all-by-source [来源ID]，allocation-all-by-destination [目标ID]，substation [ID]，substation-all - 网格：grid [ID]，grid-all - 区块：block-height

1. 2. 评估目标 — 针对玩家：结构、电力容量、舰队状态（onStation = 可建造；away = 正在掠夺）。针对星球：剩余矿石、防御结构、护盾。针对公会：成员、中央银行状态。
2. 识别弱点 — 未精炼矿石库存、电力接近容量上限、无防御星球、舰队外出（掠夺中）。
3. 持久化情报 — 收集后，更新：

- memory/intel/players/{玩家ID}.md — 玩家档案（个人资料、行为、弱点、关系） - memory/intel/guilds/{公会ID}.md — 公会档案（成员、银行状态、优势、劣势） - memory/intel/territory.md — 星球所有权、矿石、防御等级 - memory/intel/threats.md — 按严重程度排序的威胁面板

命令参考

实体	查询命令
地址 → 玩家	structsd query structs address [地址]（返回玩家ID；1-0 = 不存在）
玩家

structsd query structs player [ID]，player-all | | 星球 | structsd query structs planet [ID]，planet-all，planet-all-by-player [玩家ID] | | 星球属性 | structsd query structs planet-attribute [星球ID] [类型]，planet-attribute-all | | 结构 | structsd query structs struct [ID]，struct-all，struct-attribute [ID] [类型] | | 结构类型 | structsd query structs struct-type [ID]，struct-type-all | | 舰队 | structsd query structs fleet [ID]，fleet-all，fleet-by-index [索引] | | 公会 | structsd query structs guild [ID]，guild-all | | 入会申请 | structsd query structs guild-membership-application [ID]，guild-membership-application-all | | 反应堆 | structsd query structs reactor [ID]，reactor-all | | 注入 | structsd query structs infusion [ID]，infusion-all，infusion-all-by-destination [目标ID] | | 提供者 | structsd query structs provider [ID]，provider-all | | 协议 | structsd query structs agreement [ID]，agreement-all，agreement-all-by-provider [提供者ID] | | 分配 | structsd query structs allocation [ID]，allocation-all，allocation-all-by-source，allocation-all-by-destination | | 变电站 | structsd query structs substation [ID]，substation-all | | 网格 | structsd query structs grid [ID]，grid-all | | 区块高度 | structsd query structs block-height |

验证

• - 操作后重新查询实体以确认状态变更。
• 交叉引用：玩家 → 星球 → 结构 → 舰队以获取完整图景。
• 区块高度确认链同步状态。

错误处理

• - 实体未找到：ID可能无效或实体已被销毁。尝试使用 -all 变体来发现当前ID。
• 数据过时：查询 block-height；如果链已推进，重新运行查询。
• 缺少情报文件：如果不存在，创建 memory/intel/players/、memory/intel/guilds/。遵循 memory/intel/README 中的格式。

情报持久化循环

1. 1. 对目标执行侦察查询。
2. 解析结果：所有者、结构、电力、护盾、舰队状态、公会。
3. 根据 README 格式写入/更新 memory/intel/players/、memory/intel/guilds/。
4. 使用星球所有权表更新 memory/intel/territory.md。
5. 使用排序后的威胁和响应备注更新 memory/intel/threats.md。
6. 在每个文件中包含最后更新日期。

PostgreSQL 查询（高级）

如果公会栈（Guild Stack）在本地运行，所有侦察查询可以通过 PostgreSQL 在 < 1 秒 内完成，无需使用 CLI。这对于战斗自动化、实时威胁监控和全星系侦察至关重要。

示例 — 查找所有拥有可窃取矿石的玩家，按数量排序：

sql
SELECT p.id, p.guildid, COALESCE(gore.val, 0) as ore
FROM structs.player p
JOIN structs.grid gore ON gore.objectid = p.id AND gore.attribute_type = ore
WHERE g_ore.val > 0
ORDER BY g_ore.val DESC;

示例 — 星球上的敌方舰队组成：

sql
SELECT s.id, st.classabbreviation, s.operatingambit, st.unit_defenses
FROM structs.struct s
JOIN structs.struct_type st ON st.id = s.type
JOIN structs.fleet f ON f.id = s.location_id
WHERE f.locationid = 2-105 AND s.isdestroyed = false AND s.location_type = fleet;

重要提示：structs.grid 表是键值结构，而非列式结构。有关网格模式及更多查询示例，请参见 knowledge/infrastructure/database-schema。

设置方法：structs-guild-stack 技能

参见

• - memory/intel/README — 档案格式、领土地图、威胁面板
• awareness/threat-detection — 使用情报识别威胁
• awareness/opportunity-identification — 发现机会
• knowledge/mechanics/combat — 掠夺机制、舰队状态
• playbooks/meta/reading-opponents — 灵魂类型识别
• structs-guild-stack skill — 用于