核心用法
Structs Guild Stack 是一套 Docker Compose 编排系统，用于部署完整的公会节点基础设施。核心组件包括：区块链节点(structsd)、PostgreSQL 索引数据库(structs-pg)、GRASS 实时事件系统(structs-grass)、MCP 服务器、Web 应用及交易签名代理。用户通过 docker compose up -d 启动后，需等待数小时完成首次链同步，之后即可享受亚秒级数据库查询能力。
数据访问通过 GRASS 容器内的 psql 进行，使用 structs_indexer 角色连接 PostgreSQL。关键查询模式包括：玩家资源查询（需处理 grid 表的键值对结构）、舰队组成分析、突袭目标侦察、实时威胁检测（基于 planet_activity 表的轮询模式）。
显著优点
- 查询性能飞跃：将原本 1-60 秒的 CLI 查询压缩至 <1 秒，使实时战斗自动化成为可能
- 实时情报能力：支持每区块轮询（~6秒）的威胁检测，CLI 方案完全无法实现
- 完整数据视图：银河级侦察可在秒内完成，而非数分钟
- 模块化架构：可按需禁用服务，最小化部署仅需 3 个容器
- 标准化接口：PostgreSQL + MCP 服务器提供熟悉的查询体验
潜在缺点与局限性
- 资源开销大：需 ~10GB 磁盘空间，持续 CPU/内存消耗
- 启动成本高：首次同步需数小时，阻碍快速迭代
- 架构复杂性：多容器编排增加运维负担，需要 Docker 专业知识
- 数据模型反直觉：
grid表的键值对设计违背关系型数据库直觉，易写出错误查询 - 安全暴露面：MCP 服务器、签名代理等服务若配置不当会引入重大风险
适合人群
- 需要实时战斗自动化的 agent 开发者
- 执行大规模银河侦察的数据分析师
- 构建威胁检测系统的安全研究员
- 已熟悉 Docker 和 PostgreSQL 的基础设施工程师
不适合：仅需偶尔查询的休闲玩家、无法承担持续资源开销的低配环境用户、缺乏容器运维经验的新手。
常规风险
1. 持久化服务风险：docker compose up -d 创建的后台服务在命令返回后继续运行，可能成为遗忘的攻击面
2. 网络暴露风险：MCP 服务器默认端口 3000 需绑定 127.0.0.1，否则局域网内任意主机可访问
3. 密钥泄露风险：交易签名代理若配置真实密钥且未审计代码，可能导致资产损失
4. 供应链风险：跟踪 main 分支而非固定 tag 可能引入未审查的恶意代码
5. UGC 污染风险：玩家名称、头像等用户生成内容存入数据库后仍为不可信输入，下游系统需自行消毒