EdgeOS Applications 是一个专为快闪城市（Popup City）申请与票务购买流程设计的自动化工具，其核心目标是简化用户在参与 EdgeOS 系列快闪活动时的交互体验。该工具通过标准化的 API 调用和脚本化操作，确保整个申请、状态查询及支付流程的可靠性和一致性。用户只需完成一次邮箱 OTP 验证即可启动会话，系统将自动管理 JWT 令牌，并在后续所有请求中复用，极大提升了操作效率。整个流程严格遵循预设的工作流顺序，从身份认证到最终购票，每一步都有明确的指引和规范。 该工具的设计理念强调‘脚本优先’，即尽可能使用预置的 Shell 脚本来执行各类操作，而非临时构造 curl 命令。这些脚本涵盖了从获取验证码、登录认证、提交申请、检查申请状态，到创建和查询支付信息，乃至处理基于 x402 协议的加密货币支付等关键环节。这种结构化的脚本体系不仅提高了代码的可维护性，也确保了不同操作之间的一致性。此外，工具在数据收集阶段奉行‘最小必要问题’原则，优先利用 `USER.md` 文件中的用户信息作为默认值，仅在必要时才向用户提问，避免重复询问已知信息。 在处理敏感信息和内部逻辑时，EdgeOS Applications 设置了多重防护机制。例如，它绝不会主动暴露完整的 OTP 码或 JWT 令牌，也不会强制进行服务器端状态转换。只有在用户明确表示要修改某项信息时，才会重新询问相关字段。对于支付环节，特别是涉及加密货币的部分，工具会清晰地展示人类可读的金额（如 “$10.00 USDC”），并明确指出自身不负责钱包签名，而是由集成的代理（Agent）来完成这一步骤。所有这些设计都旨在为用户提供一个安全、高效且透明的快闪城市参与体验。
核心功能特点
- 标准化流程：严格按照固定序列执行，包括 OTP 验证、JWT 持久化、目标快闪城市解析、申请表单填写、申请提交、状态查询以及后续的产品选择与支付引导。
- 脚本驱动：优先使用 `{baseDir}/scripts` 目录下的专用脚本（如 `auth_request_otp.sh`, `submit_application.sh` 等）进行操作，确保行为一致性和可维护性，仅在脚本无法处理时才回退到原始 curl 调用。
- 智能数据收集：采用严格的‘最小必要问题’策略，优先从 `USER.md` 文件和已认证的 API 配置中获取信息作为默认值，仅在缺失时向用户提问，并避免重复询问。
- 多支付方式支持：原生支持基于 x402 协议的加密货币支付，能正确处理支付要求并提供给代理进行签名，同时自动为 AgentKit 验证的代理提供 10% 的折扣。
- 安全防护机制：内置多重防护，包括不暴露敏感信息（OTP/JWT）、不强制状态转换、仅在申请被接受后才创建支付、不向已结束的快闪活动提交申请等。
适用场景
EdgeOS Applications 主要面向希望便捷地申请并参与 EdgeOS 系列快闪城市的用户群体。无论是个人爱好者还是专业建造者，只要对快闪城市感兴趣，都可以通过此工具快速完成复杂的线上流程。典型场景之一是用户在浏览 EdgeOS 官网或相关社群后，决定申请参加某个即将举办的快闪活动。此时，他/她可以使用该工具，首先通过邮箱完成一次性的 OTP 验证，随后系统将自动填充尽可能多的个人信息（如姓名、联系方式等），仅需补充少量必要信息即可完成申请表的填写。在提交后，用户还能随时通过工具查询自己申请的审核状态，无需反复刷新网页或联系客服。 另一个常见且重要的应用场景是票务购买环节。当用户的快闪城市申请获得官方通过后，该工具便会进入产品选择阶段。它会以用户友好的方式展示可选的产品包（例如基础票、VIP 套餐等），包含其具体内容和对应价格。一旦用户做出选择，工具便会引导其进入支付流程。对于支持加密货币的用户，工具会利用 x402 协议生成清晰的支付指令，明确显示应付金额（如 “$50.00 USDC”），并交由集成的数字资产代理（Agent）完成最终的钱包签名和转账操作。整个过程对用户而言是透明且无需额外技术知识的，极大地降低了参与门槛。此外，该工具也适用于需要频繁查询自己或他人申请状态的管理员或团队成员，他们可以通过简单的命令行参数快速检索特定申请的状态详情。