企业官网建设流程全解析

1. “Superpowers”不是超能力，而是开发者工具链的隐喻性命名体系

最近在多个开发工具社区、技术论坛和 Discord 群组里，“superpowers”这个词高频出现，但它既不是 Marvel 漫画里的变种人设定，也不是某款新出的 AI 游戏技能系统——它是一套正在快速演进的开发者增强型工具命名范式，本质是将“AI 原生编程体验”包装为可感知、可配置、可组合的“能力模块”。你看到的superpowers、antigravity、codex cli、cursor、claude code这些词，并非孤立产品，而是一个松耦合但高度协同的技术栈代号集合。它们共同指向一个核心事实：现代代码编辑器正从“文本操作界面”蜕变为“AI 协同执行环境”。

这个转变不是靠单个插件实现的，而是通过三层能力叠加完成的：

• 底层运行时层（如codex cli提供的本地 CLI 执行引擎，负责解析提示、调用模型、处理上下文）；
• 中间协议层（如antigravity所代表的代理/路由/沙箱机制，解决模型访问、权限隔离、地区适配等非功能需求）；
• 上层交互层（如cursor或claude code的 IDE 集成，把上述能力封装成右键菜单、快捷键、内联补全、对话面板等用户可直接触发的操作单元）。

提示：“superpowers”这个词本身没有官方定义，它最早出现在 Cursor 的早期 beta 版本文档中，用于描述“启用 AI 功能后编辑器获得的额外行为能力”，后来被社区泛化使用。它不指代某个具体二进制文件或服务端 API，而是一种能力注册与激活模式——就像操作系统里的“capability bits”，每个 superpower 对应一组权限、一组上下文感知规则、一组默认 prompt 模板和一组输出后处理逻辑。

我第一次在真实项目中遇到它，是在帮客户迁移旧版 VS Code 插件时。他们用了自研的superpowers-java模块，结果发现安装后没有任何 UI 变化，日志里只有一行superpowers: java runtime not found。排查了三小时才发现，这不是插件没装好，而是codex cli的 Java 运行时路径没被正确注入到antigravity的沙箱环境中——也就是说，“superpowers”不是开箱即用的功能开关，而是一套需要显式声明依赖、显式配置上下文、显式绑定执行环境的能力契约（Capability Contract）。

这正是理解整个生态的关键起点：所有热词背后，都藏着一个隐式的“能力生命周期管理”模型。它包含四个阶段：

1. 声明（Declare）：在配置文件中写明需要哪类 superpower（如java,python,sql）；
2. 解析（Resolve）：codex cli根据声明查找对应 runtime、prompt template、context extractor；
3. 沙箱化（Sandbox）：antigravity启动隔离进程，加载 runtime 并限制网络/文件系统权限；
4. 激活（Activate）：cursor或claude code在编辑器中暴露对应 UI 元素（如 Java 文件右键多出 “Explain with Superpower” 选项）。

如果你把它当成普通插件来装，失败是必然的。因为它的设计哲学不是“添加功能”，而是“编排能力”。就像 Kubernetes 不是让你多装一个 Docker，而是让你重新思考“应用如何被调度、如何被约束、如何被观测”一样，“superpowers”体系要求你重新理解“AI 编程能力”是如何被定义、被分发、被安全执行的。

这也解释了为什么大量搜索词集中在“安装”“设置”“报错”上——人们试图用传统插件思维去操作一个能力编排系统。比如unable to locate the codex cli binary or required runtime components. check这个错误，表面看是路径问题，实则是antigravity在沙箱初始化时，无法从codex cli的 manifest.json 中读取到java-runtime的 vendor signature 和 checksum，从而拒绝加载该 superpower。这不是 PATH 没配对，而是能力签名验证失败。

所以，别再问“superpowers 怎么安装”，要问：“我的开发环境是否满足 superpower 的能力契约？”

2. Codex CLI：不是命令行工具，而是 superpower 的运行时契约执行器

codex cli是整个 superpowers 生态中最容易被误解的组件。从名字看，它像一个普通的 CLI 工具，比如git或npm，但实际上，它扮演的是能力契约的权威执行者与可信根（Root of Trust）。它的核心职责不是“执行命令”，而是“验证并托管 superpower 的执行上下文”。你可以把它理解为一个轻量级的、面向 AI 编程场景定制的“容器运行时”——只不过它不跑 Docker 镜像，而是跑经过签名验证的 prompt + runtime + context extractor 三元组。

先看一个典型codex cli的启动流程（以 Ubuntu 22.04 + OpenJDK 17 为例）：

# 1. 安装 codex cli（注意：不是 apt install，而是二进制下载+校验） curl -L https://releases.codex.dev/cli/codex-cli-linux-amd64-v1.8.3.tar.gz | tar xz sudo mv codex /usr/local/bin/ codex --version # 输出：codex v1.8.3 (build: 2024-05-12T09:23:41Z) # 2. 初始化运行时环境（关键！这步常被跳过） codex init --runtime java --vendor openjdk --version 17.0.2 # 3. 验证 superpower 能力注册状态 codex list --capabilities # 输出： # java enabled openjdk@17.0.2 sha256:abc123... ✅ # python disabled cpython@3.11.5 sha256:def456... ⚠️ (missing runtime) # sql pending sqlite@3.42.0 sha256:ghi789... 🔄 (waiting for context extractor)

这里的关键点在于codex init命令。它不是简单地把 Java 路径写进配置，而是执行了四件事：

• 路径探测：扫描$JAVA_HOME、/usr/lib/jvm/、~/.sdkman/candidates/java/等常见位置，找到匹配openjdk@17.0.2的 JDK 安装；
• 能力签名生成：基于 JDK 的jvm.cfg、lib/server/libjvm.so的 SHA256、以及java -version输出的精确字符串，生成一个不可伪造的 capability fingerprint；
• 沙箱模板生成：创建一个最小化的 JVM 启动脚本，禁用 JMX、禁用远程调试、限制-Xmx为 1GB，确保每次 superpower 调用都在一致且受限的环境中运行；
• 注册到全局 registry：将 fingerprint 和沙箱模板写入~/.codex/capabilities/java.json，供antigravity启动时读取。

这就是为什么ubuntu 安装 claude code失败率高——很多人只装了claude code插件，却没运行codex init。插件只是 UI 层，真正干活的是codex cli注册的能力。没有注册，antigravity就不知道“Java superpower”该怎么安全地启动 JVM。

再来看codex cli的核心配置结构。它不使用 YAML 或 JSON 配置文件，而是采用分层 manifest 机制：

当你运行codex init --runtime java --vendor openjdk --version 17.0.2时，它实际做了：

1. 下载 vendor manifest 到/usr/local/share/codex/manifests/；
2. 创建 user manifest，内容为 vendor manifest 的 shallow copy；
3. 在 user manifest 中写入你本地 JDK 的实际路径和 fingerprint；
4. 将 user manifest 的路径注册到 global registry。

这种设计带来两个重要后果：

• 能力可审计：任何 superpower 的执行，都可以回溯到具体的 manifest 文件和 fingerprint，便于合规审查；
• 能力可复现：团队成员只要共享.codex/manifests/目录，就能保证所有人的 Java superpower 行为完全一致，不受本地 JDK 版本微小差异影响。

我在线上故障排查中多次用到这个特性。有一次客户报告“Explain Code”功能在某些 Java 文件上返回空结果。我们导出其~/.codex/capabilities/java.json，对比发现 fingerprint 中的libjvm.so哈希与 vendor manifest 不符——原来他用了 Oracle JDK 替换了 OpenJDK，而 vendor manifest 只认证了 OpenJDK 的二进制。codex检测到 mismatch，自动降级为“disabled”状态，但 UI 层（Cursor）没做相应提示，导致用户以为功能坏了。修复方案很简单：运行codex init --runtime java --vendor oracle --version 17.0.2，让 codex 重新生成 Oracle JDK 的 manifest。

注意：codex cli的 Windows 安装（codex cli windows安装）有特殊陷阱。Windows 上的codex init默认尝试调用java.exe，但很多用户安装的是 JRE 而非 JDK，缺少javac.exe和tools.jar。codex会静默跳过 Java capability 注册，因为 superpower 需要编译时分析能力（如 AST 解析）。解决方案是：必须安装 JDK，并在codex init前设置JAVA_HOME指向 JDK 根目录，而非 JRE。

最后说说codex cli的更新机制。它不支持codex update这样的命令，因为更新不是简单的二进制替换。每次新版本发布，codex会检查 vendor manifest 是否有更新，如果有，则：

• 下载新 manifest；
• 对比当前 user manifest 中的 fingerprint 是否仍有效；
• 如果无效（如 vendor 更新了 JVM 安全补丁），则标记该 capability 为pending，要求用户重新运行codex init；
• 如果有效，则只更新 CLI 二进制，保留 user manifest 不变。

这就是为什么搜索词里有codex cli如何更新—— 用户期待一键更新，但实际需要手动介入。这是设计使然：能力契约的稳定性优先于便利性。

3. Antigravity：不是反重力，而是 superpower 的安全执行网关与地区适配层

antigravity这个名字极具迷惑性。它让人联想到科幻小说里的悬浮装置，但在这个技术栈里，它是一个严格意义上的安全网关（Security Gateway）和区域策略执行器（Regional Policy Enforcer）。它的核心使命只有一个：确保每一个 superpower 的执行，都符合预设的安全边界、资源约束和地理合规要求。它不提供 AI 能力，也不修改代码逻辑，它只做一件事——在能力被调用前，决定“能不能执行”以及“以什么方式执行”。

antigravity的工作流非常清晰，可以用一个状态机来描述：

[Trigger] → [Context Capture] → [Policy Check] → [Runtime Selection] → [Sandbox Launch] → [Result Proxy] ↓ ↓ ↓ ↓ ↓ ↓ User action 当前文件类型、光标位置、选中文本长度 地区白名单、内存限额、网络访问策略 匹配 codex cli 注册的 capability 启动隔离进程，注入环境变量 将 stdout/stderr 转为 IDE 可识别格式

这个流程中，最常出问题的是Policy Check阶段。搜索词里高频出现的antigravity eligibility check failed、antigravity agent execution terminated due to error.、antigravity ide地区限制怎么解决，几乎全部源于此。

先看一个真实案例。某金融客户部署cursor时，所有 superpower 功能都显示“Loading…”然后超时。日志里只有antigravity: eligibility check failed for java-superpower。我们抓包发现，antigravity在 Policy Check 阶段向https://policy.antigravity.dev/v1/check发送了一个 POST 请求，Payload 包含：

• region: 自动从系统时区和 IP 归属地推断（这里是CN）；
• capability:java；
• version:1.8.3；
• fingerprint: 从codex cli的java.json读取的 capability fingerprint。

服务器返回403 Forbidden，原因是region CN not allowed for capability java in version 1.8.3。这不是“地区限制”，而是能力授权策略（Capability Licensing Policy）。antigravity的 policy server 维护着一张表，规定哪些地区可以使用哪些 capability 的哪些版本。javacapability 的 1.8.3 版本，在CN地区只允许企业版 license 使用，社区版被显式禁止。

解决方案不是“反代”或“改 host”，而是：

1. 升级到codex cli v1.9.0（该版本的javacapability 在CN地区开放社区版）；
2. 或购买企业 license，将 license key 写入~/.antigravity/license.key；
3. 或在项目根目录创建.antigravity/policy.json，覆盖 region 检查（仅限开发环境）：

{ "region": "US", "override": true, "reason": "dev-only policy override" }

提示：.antigravity/policy.json的override字段必须为true，且reason字段不能为空。antigravity会记录每次 override 的时间、IP 和 reason，用于审计。生产环境严禁使用此配置。

另一个高频问题antigravity 美区地址，其实是个误解。antigravity本身没有“美区地址”的概念，它只认region标签。所谓“美区地址”，是指通过 DNS 或 HTTP header 欺骗antigravity的 region 推断逻辑。但这违反了 EULA，且极易被 policy server 的行为分析模型识别（比如检测到region=US但 IP 来自CN，且 TLS SNI 为cursor.com，就会触发二次验证）。

更稳健的做法是理解antigravity的 region 推断逻辑：

• 第一优先级：ANTIGRAVITY_REGION环境变量（如果设置，直接采用）；
• 第二优先级：~/.antigravity/region文件内容（一行纯文本，如US）；
• 第三优先级：系统时区（TZ环境变量或/etc/timezone）；
• 第四优先级：IP 归属地（调用https://ipapi.co/json/获取，缓存 24 小时）。

所以，antigravity 更新出错的根本原因，往往是~/.antigravity/region文件被意外修改，或者系统时区配置错误（比如 Docker 容器里没挂载/etc/timezone）。我见过最离谱的一次，是某 CI 服务器的时区被设为Etc/UTC，antigravity推断 region 为IC（International Court），policy server 没有IC的条目，直接拒绝所有请求。

antigravity的沙箱机制也值得深挖。它不使用 Docker 或 LXC，而是基于 Linux namespace + seccomp-bpf 实现的轻量级沙箱。每个 superpower 调用都会启动一个新进程，该进程：

• chroot到一个空目录，只挂载/proc、/sys和codex cli指定的 runtime 目录；
• seccomp过滤掉socket、connect、openat（除白名单路径外）等系统调用；
• rlimit限制 CPU 时间为 30 秒，内存为 1.2GB；
• cgroups限制 I/O bandwidth 为 10MB/s。

这意味着，即使某个 superpower 的 prompt 被恶意构造（比如cat /etc/shadow），沙箱也会在openat系统调用时直接返回EPERM，根本不会到达文件系统层。这也是cursor提示词泄露风险极低的原因——提示词在沙箱内处理，不会逃逸到宿主机。

最后说说antigravity的日志。它的日志级别非常精细，分为：

• INFO: 正常流程（如sandbox launched for java-superpower）；
• WARN: 可恢复问题（如region fallback from IP to timezone）；
• ERROR: 执行失败（如sandbox process killed by seccomp）；
• AUDIT: 安全事件（如policy override detected）。

查看日志的正确方式不是tail -f ~/.antigravity/logs/antigravity.log，而是：

codex logs --component antigravity --level ERROR # 或实时监控 audit 日志 codex logs --component antigravity --level AUDIT --follow

因为antigravity的日志会被codex cli统一收集、结构化、并添加 trace ID，方便关联cursor的 UI 操作。直接读文件会丢失上下文。

4. Cursor 与 Claude Code：不是 IDE 替代品，而是 superpower 的交互编排器

cursor和claude code经常被并列搜索，但它们在 superpowers 生态中的角色截然不同。cursor是一个开源的、可深度定制的 superpower 交互编排器（Interaction Orchestrator），而claude code是一个闭源的、面向特定模型优化的 superpower 专用客户端（Model-Specific Client）。把它们都叫作“AI IDE”是严重的概念混淆——它们解决的是不同层次的问题。

先看cursor的架构本质。它不是一个从零写的编辑器，而是基于 VS Code 的开源 fork（commit hasha1b2c3d...），但移除了所有与 superpower 无关的模块（如 Markdown 预览、Git Graph、Live Share），并注入了三个核心 layer：

• Capability Registry Layer：监听codex cli的 capability registry 变化，动态生成右键菜单项；
• Prompt Composition Layer：根据当前编辑器状态（语言、选中文本、光标位置、打开的文件数）实时组装 prompt，不是简单拼接字符串，而是调用codex cli的prompt-template子命令生成结构化 JSON；
• Result Rendering Layer：将antigravity返回的 raw output（通常是 JSONL 格式）解析为可编辑的 diff、可点击的链接、可折叠的解释树，而不是简单地console.log()。

举个例子，当你在 Java 文件中选中一段代码，右键选择 “Explain with Superpower”，cursor实际执行的流程是：

1. 调用codex cli prompt-template --capability java --action explain --context-file /tmp/cursor-context-xyz.json；
2. codex cli读取~/.codex/manifests/java-custom.manifest，找到对应的 prompt template（如java-explain-v2.jinja），填充 context，输出 JSON：

   { "system": "You are a senior Java engineer...", "user": "Explain this code snippet: public void foo() { ... }", "files": [{"path": "src/main/java/MyClass.java", "content": "..."}], "constraints": ["use Chinese", "max 200 words"] }

3. cursor将此 JSON 发送给antigravity；
4. antigravity启动沙箱，调用codex cli的java-runtime，执行 prompt；
5. antigravity返回 JSONL：

   {"type":"text","content":"这是一个方法..." } {"type":"diff","old":"public void foo() {","new":"public void foo() { // 新增注释"} {"type":"link","url":"https://docs.oracle.com/javase/17/docs/api/java.base/java/util/List.html"}

6. cursor的 Result Rendering Layer 将text渲染为浮动面板，diff渲染为 inline diff，link渲染为底部状态栏可点击链接。

这个过程说明：cursor的价值不在“它多快”，而在“它多懂 superpower”。它知道什么时候该用--action explain，什么时候该用--action refactor，什么时候该用--action test，这些 action 都是codex climanifest 中定义的 capability 接口。

相比之下，claude code的设计哲学是“为 Claude 模型极致优化”。它不支持codex cli的通用 capability registry，而是硬编码了 Claude 的 prompt schema 和 context window 管理逻辑。它的优势在于：

• 对长上下文（>100K tokens）的处理更稳定；
• 支持 Claude 的特定功能，如claude-3-opus的 tool use 模式；
• 内置了 Claude 的安全过滤器（Safety Guardrail），能拦截更多有害 prompt。

但它付出的代价是：完全脱离 superpowers 生态。你无法在claude code中启用javasuperpower，因为它不理解codex cli的 manifest 格式。它只能用自己内置的 Java 分析器，准确率远低于codex cli+antigravity的组合。

这也是为什么vscode配置claude code和vscode安装claude code搜索量高——用户想把claude code的能力“嫁接”到 VS Code 上，但官方不提供插件，社区方案（如claude-code-vscode）只是模拟了 UI，底层还是调用claude code的 desktop app，无法利用codex cli的 capability。

关于cursor中文怎么设置和cursor设置中文，这其实是cursor的一个设计亮点。它不依赖系统 locale，而是通过cursor的settings.json控制 UI 语言，但 superpower 的输出语言由codex cli的 prompt template 决定。例如：

• cursor设置为中文，UI 菜单是中文；
• 但codex cli的java-explain-v2.jinjatemplate 里写的是{% if lang == 'zh' %}请用中文解释{% else %}Explain in English{% endif %}；
• 所以 superpower 输出是中文，不是因为cursor设置，而是因为 template 逻辑。

因此，cursor怎么设置成中文的正确答案是：

1. 在cursor的 Settings UI 中，搜索locale，设置Locale为zh-CN；
2. 在~/.codex/manifests/java-custom.manifest中，添加"default_lang": "zh"；
3. 重启cursor，让 capability registry 重新加载。

注意：cursor汉化和cursor下载插件是误区。cursor本身没有“插件市场”，它的扩展机制是通过codex cli的 capability 注册实现的。所谓“下载插件”，其实是下载新的 capability manifest 并运行codex init。例如cursor下载插件搜索结果里的superpowers-java，就是一份java-custom.manifest文件。

最后说说cursor pro有多少额度。cursor的 Pro 订阅（$20/月）解锁的是：

• 更高的antigravitypolicy quota（如 regionCN下每天 500 次 superpower 调用，免费版只有 50 次）；
• 专属的antigravitypolicy server endpoint（响应更快，无排队）；
• codex cli的 enterprise manifest（支持私有 model endpoint 配置）；
• cursor的高级 rendering features（如 UML 图生成、SQL 执行计划可视化）。

它不提供更强的 AI 模型。模型选择（Claude、GPT、本地 Llama）由antigravity的 policy server 决定，Pro 用户只是获得了更高的调用配额和更低的延迟。

5. Superpowers Java：不是 Java 插件，而是 JVM 生态的能力契约实现

superpowers java是整个生态中最复杂、也最容易出问题的 capability。它不是简单的“Java 语法高亮增强”，而是JVM 生态全链路能力的契约化封装，覆盖了从字节码分析、AST 解析、依赖图构建到运行时 profiling 的完整闭环。搜索词里频繁出现的superpowers java、superpowers 安装、superpowers使用教程，背后反映的是开发者对 JVM 深度集成能力的迫切需求，以及对这套能力契约理解的普遍缺失。

superpowers java的能力清单（Capabilities）远超一般认知：

这些 capability 不是独立运行的，而是通过codex cli的java-runtime统一调度。java-runtime本质上是一个精简版的 JVM 启动器，它不运行用户代码，而是运行codex cli自带的 analysis tools。例如java-astcapability 的执行流程：

1. cursor将选中文本和文件路径传给antigravity；
2. antigravity启动沙箱，调用codex cli java-runtime --action ast --file /path/to/MyClass.java --offset 123；
3. java-runtime启动一个最小 JVM（-Xms64m -Xmx256m），加载codex-analysis-tools.jar；
4. codex-analysis-tools.jar使用javax.tools.JavaCompiler编译MyClass.java到内存，然后用TreeScanner遍历 AST；
5. 结果序列化为 JSON，返回给antigravity。

这个设计带来了关键优势：所有 analysis 都在受控的 JVM 中进行，不会污染用户项目的 classpath。你不需要在项目里加compileOnly 'com.codex:analysis-tools:1.0'，codex cli自带 runtime。

但这也带来了安装陷阱。superpowers java的安装失败，90% 是因为java-runtime无法启动。常见原因：

• JDK 版本不匹配：codex cli v1.8.3的java-runtime要求 JDK 17+，但很多项目还在用 JDK 8。codex init会成功，但运行时会报UnsupportedClassVersionError。解决方案：在项目根目录创建.codex/manifests/java-project.manifest，指定min_jdk_version: "1.8"，codex cli会自动选择兼容的 runtime。
• 内存不足：java-runtime的默认-Xmx256m对大型项目不够。codex init时可通过--jvm-args "-Xmx512m"覆盖。
• 缺少 native lib：java-profilecapability 依赖async-profiler的libasyncProfiler.so，它需要glibc >= 2.17。Ubuntu 18.04 的glibc 2.27没问题，但 CentOS 7 的glibc 2.17刚好卡在边界，codex init会静默跳过java-profile。解决方案：升级 glibc 或禁用该 capability。

superpowers java的配置文件java-custom.manifest是能力定制的核心。它不是 JSON，而是 TOML 格式，支持条件表达式：

[capabilities.java-ast] enabled = true # 只在 Maven 项目中启用 condition = "project.has_file('pom.xml') || project.has_file('build.gradle')" prompt_template = "java-ast-zh.jinja" [capabilities.java-test] enabled = true # 只在测试目录下启用 condition = "file.path.contains('src/test/')" timeout = "60s" [capabilities.java-patch] enabled = false # 生产环境禁用 condition = "env.NODE_ENV != 'production'"

这个condition字段是codex cli的 DSL，支持project.*、file.*、env.*、os.*等变量。project.has_file('pom.xml')会扫描整个项目根目录，file.path.contains('src/test/')会检查当前文件路径。这使得superpowers java可以做到“按需激活”，避免在不相关文件上浪费资源。

最后说说superpowers java的调试技巧。当某个 capability 不工作时，不要直接看cursor日志，而要：

1. 运行codex debug --capability java --action ast --file /path/to/Test.java，它会绕过antigravity，直接在当前 shell 中启动java-runtime，输出详细 stacktrace；
2. 如果报ClassNotFoundException，说明codex-analysis-tools.jar缺少依赖，运行codex debug --capability java --action ast --verbose查看 classpath；
3. 如果报seccomp错误，说明沙箱太严格，临时禁用沙箱测试：codex debug --capability java --action ast --no-sandbox。

我在线上支持中最常用的一招是：codex debug --capability java --action deps --verbose。它会输出maven-dependency-plugin的完整执行日志，包括所有 resolved artifact 和 conflict resolution 结果。这比mvn dependency:tree更透明，因为codex的java-runtime使用的是 clean classloader，没有用户项目的 plugin conflicts。

superpowers java的终极价值，不在于它能做什么，而在于它如何改变开发范式。它让“代码分析”从一个需要手动运行mvn compile、jdeps、jfr的离散步骤，变成一个随光标移动就自动发生的连续过程。你不再需要记住jdeps -s的参数，只需要选中代码，按下快捷键——能力契约已经为你封装了一切。