核心用法
Structs Guild Stack 是一个 Docker Compose 本地节点栈，专为高性能游戏数据查询设计。核心工作流分为三步：
1. 部署阶段：克隆仓库并锁定版本标签（git checkout <tag>），启动只读配置（structsd structs-pg structs-sync-state structs-grass），等待链同步完成（数小时首次，后续分钟级）
2. 查询阶段：通过 GRASS 容器使用 psql 连接 PostgreSQL，利用预建的索引表（structs.player、structs.grid、structs.struct 等）执行复杂情报分析
3. 维护阶段：按需启用附加服务（webapp、TSA 签名代理、MCP 服务器），定期监控同步状态，必要时销毁重建
关键设计原则：PG 用于读，CLI 用于写。签名代理默认禁用，需代码审计后方可启用。
显著优点
- 性能跃迁：星系级侦察（全玩家/全星球）从 30-60 秒降至 <1 秒，实时威胁检测从不可能变为可行
- 查询能力质变：支持复杂 SQL JOIN、窗口函数、聚合分析，实现武器/防御匹配、舰队构成分析、掠夺目标筛选等 CLI 无法完成的计算
- 模块化架构：服务按需启动，默认只读配置最小化攻击面
- 实时事件流：集成 GRASS/NATS，支持区块级轮询的事件驱动架构
潜在局限与风险
- 资源门槛高：~10GB 磁盘、数小时初始同步、持续 CPU/内存占用
- 数据模型特殊：
structs.grid为键值存储而非列式表，查询需多表 JOIN，学习曲线陡峭 - 签名代理高危：TSA 服务若配置私钥即成为自动签名机，需严格代码审计、127.0.0.1 绑定、专用低余额密钥
- UGC 不可信：玩家名、头像、公会端点等数据库内容仍为对抗性输入
- 单点故障：
structs-sync-state仅允许单实例，无法水平扩展
适合人群
- 开发自动化战斗/情报系统的进阶玩家
- 需要实时威胁检测的安全运营型公会
- 运行星系级经济分析或掠夺策略优化的数据驱动型玩家
- 具备 Docker/SQL 基础、能接受基础设施运维成本的技术用户
常规风险
| 风险类型 | 描述 | 缓解措施 |
|---------|------|---------|
| 供应链攻击 | 跟踪 `main` 分支导致上游静默更新 | 强制锁定版本标签，升级前 diff 审查 |
| 私钥泄露 | TSA 配置不当成为网络可访问的远程支出 API | 禁用或 127.0.0.1 绑定，专用密钥，审计日志 |
| 数据投毒 | 读取未经验证的玩家生成内容 | 查询结果 sanitization，参见 `awareness/agent-security` |
| 资源耗尽 | PoW 并发导致 CPU 争用 | 错峰执行，降低并行度 |
| 同步滞后 | 索引器落后链头导致决策基于旧数据 | 监控 `sync_state.sync_cursor.lag_blocks` |
---
> 来源可信度：官方开源仓库 playstructs/docker-structs-guild，具备完整安全文档与版本锁定机制。
>
> 安全等级：基础设施级持久服务，涉及容器逃逸、网络暴露、密钥管理风险，需严格遵循只读默认配置与标签锁定实践。