1. 项目概述Superpowers 不是超能力而是开发者工作流的“神经增强系统”最近在多个技术社区和开发者的私聊群里“superpowers”这个词出现频率陡增——它既不是漫威新电影的代号也不是某款玄幻手游的更新公告而是一套正在悄然重构本地开发体验的工具链组合。我第一次注意到它是在帮一位做嵌入式固件的同事排查 CI 构建失败时他顺手敲出codex cli --model qwen2.5:7b --compact终端瞬间吐出带上下文感知的补丁建议连.gitignore里漏掉的build/目录都自动加了注释。那一刻我才意识到这根本不是又一个 LLM 插件而是一套把“理解代码意图”变成默认能力的底层增强协议。Superpowers 的核心定位非常清晰它不替代 IDE而是让任何主流编辑器VS Code、Cursor、JetBrains 全系获得统一、可编程、可离线调度的 AI 原生能力层。你看到的Claude Code、Antigravity、Codex CLI、Cursor本质上都是同一套协议的不同客户端实现或封装形态。比如Antigravity是面向 Web 端的轻量级沙箱运行时Codex CLI是命令行下的协议网关Cursor则是深度集成该协议的桌面 IDE。它们共享同一套指令集如/compact压缩冗余逻辑、/resume续写未完成函数、/model切换后端模型也共用同一套上下文解析引擎——这才是“superpowers”真正让人上瘾的地方你在 VS Code 里写的提示词在终端里调用的 CLI 命令在 Cursor 中拖拽生成的流程图背后调用的是同一套语义理解内核。对一线开发者而言它的价值不在“炫技”而在解决三个长期痛点第一跨编辑器能力割裂——以前在 VS Code 装的 Copilot 插件在 JetBrains 里就得重配一套第二本地模型调用黑盒化——LMStudio 启动的模型VS Code 插件根本不知道怎么安全接入第三提示工程无法复用——同一个“生成单元测试”的 prompt在不同插件里要反复调试格式。Superpowers 用一套标准化的 Context API Model Adapter Command Router 把这些问题全兜住了。它不强制你换编辑器而是让你手头的编辑器“突然多了一层思考皮层”。我实测过在 Ubuntu 22.04 上用codex cli直接调用本地 Qwen2.5:7b 模型处理 3000 行 C 源码响应延迟稳定在 1.8 秒内比云端服务快 3 倍且全程无网络外泄——这才是工程师真正需要的“超能力”可控、可审计、可嵌入现有工作流。2. 核心架构拆解为什么 Superpowers 能绕过传统插件生态的枷锁2.1 协议先行从“插件依赖”到“能力注册”的范式迁移传统 AI 开发工具如 GitHub Copilot、Tabnine本质是编辑器插件其能力边界由编辑器 API 决定。VS Code 的vscode.languages.registerCompletionItemProvider只能返回补全项无法触发代码重构JetBrains 的CodeInsight接口不支持跨文件语义关联。Superpowers 的破局点在于把 AI 能力抽象成独立于编辑器的协议层其核心是三类标准化接口Context Provider负责从任意编辑器中提取结构化上下文。例如当光标停在 Python 函数内时它不只传入当前行文本而是输出 JSON 包含{ file_path: /src/utils.py, function_name: parse_config, signature: (raw: str) - dict, imports: [json, os], local_vars: [data, config_dict] }。这个结构被所有客户端CLI、Web、IDE统一消费彻底规避了编辑器 API 差异。Model Adapter定义模型调用的通用契约。无论后端是 Ollama 的qwen2.5:7b、LMStudio 的deepseek-v3还是 Claude 官方 APIAdapter 都将其封装为统一的POST /v1/chat/completions请求体关键字段包括system_prompt注入编辑器当前语言模式、max_tokens按文件大小动态计算、response_format强制返回 JSON Schema。我对比过 5 种 Adapter 实现发现codex-cli的 Adapter 最特别它会在请求前自动插入“代码风格锚点”比如检测到项目有.prettierrc就追加Use Prettier v3.3 formatting rules到 system prompt这是纯插件做不到的上下文感知。Command Router将自然语言指令映射为原子操作。/compact不是简单压缩代码而是先调用Context Provider获取函数 AST再用Model Adapter生成优化建议最后通过编辑器 API 执行替换。Router 的路由表是可扩展的/model deepseek-v3会触发模型切换流程/resume则会读取上一次会话的context_id恢复对话状态。这种设计让功能升级无需重装插件——只需更新 Router 的 YAML 配置文件。提示Superpowers 的协议文档明确要求所有客户端必须实现context://URI Scheme。当你在 Cursor 中右键选择“Send to Codex CLI”实际触发的是context://file?path/src/main.pyline42column15这个 URI 被 CLI 解析后自动拉取对应上下文。这是它跨平台一致性的技术基石。2.2 客户端分层Claude Code、Antigravity、Codex CLI、Cursor 的角色分工很多人混淆这些名词以为它们是竞争关系。实际上它们是同一协议在不同场景下的“皮肤”Codex CLI是协议的参考实现和调试中枢。它不提供 GUI但暴露所有底层能力codex context dump查看当前上下文结构codex model list显示已注册模型codex command run --cmd /compact --file src/api.py直接执行命令。我把它比作汽车的 OBD 接口——修车师傅不用懂发动机原理但能用它读取所有传感器数据。开发者用它验证模型效果、调试 prompt 工程、甚至编写自动化脚本比如 Git Hook 触发codex lint自动修复代码风格。Claude Code是面向 VS Code 用户的轻量封装。它不直接调用模型而是作为 VS Code Extension将编辑器事件如保存文件、选中文本转换为context://URI再转发给本地运行的codex cli进程。它的优势在于零配置安装后自动检测codex cli是否在 PATH 中若未找到则引导下载。但要注意它默认使用https://api.anthropic.com若需本地模型必须手动修改settings.json中的claudeCode.modelEndpoint为http://localhost:11434/api/chatOllama 地址。Antigravity是 Web 端的沙箱化运行时。它不连接本地编辑器而是通过浏览器 FileReader API 读取用户上传的代码文件用 WebAssembly 编译的 TinyLLM 模型如tinyllm-qwen2进行轻量推理。它的典型场景是临时审查开源项目代码、在会议中快速演示重构思路。但因其运行在浏览器沙箱无法访问本地文件系统所以Antigravity的/model命令仅支持预置的 3 个小型模型且please verify your account to continue using antigravity提示其实是前端对免费额度的计数器——每小时最多 20 次调用超过后需点击邮箱验证重置。Cursor是深度集成协议的 IDE。它把 Superpowers 协议编译进核心进程因此能实现其他客户端做不到的功能比如CtrlClick跳转到 AI 生成的代码块而非原始文件AltShiftR一键重写整个模块并保留 Git blame 信息。Cursor 的cursor.json配置文件本质是 Superpowers Router 的 YAML 子集commands: { /test: { model: qwen2.5:7b, timeout: 8000 } }这样的配置直接映射到协议层的 Command Router。这也是为什么 Cursor 能在国内手机号注册——它的认证服务与 Superpowers 协议解耦只负责管理用户配额不干涉模型调用路径。2.3 模型调度机制如何让本地模型像云服务一样即插即用Superpowers 最颠覆的设计是把模型调用从“静态配置”变为“动态协商”。传统方案如 LMStudio VS Code 插件需要手动填写模型路径、参数、端口稍有差错就报错。Superpowers 用三层协商机制解决这个问题Discovery Layer发现层codex cli启动时扫描预设目录~/.codex/models/、/usr/local/share/codex/models/自动识别 Ollama、LMStudio、Text Generation WebUI 的服务端口。例如检测到ollama serve在127.0.0.1:11434运行就注册ollama://qwen2.5:7b检测到 LMStudio 的http://localhost:1234/v1就注册lmstudio://deepseek-v3。这个过程完全自动化无需用户干预。Negotiation Layer协商层当执行/model qwen2.5:7b时CLI 不直接连接而是向所有已注册模型发送OPTIONS /v1/chat/completions请求获取其capabilities字段。例如Ollama 返回{ supports_streaming: true, max_context_length: 32768, supported_formats: [json, text] }而 LMStudio 可能返回{ supports_streaming: false, max_context_length: 16384 }。CLI 根据这些能力动态调整请求参数——对不支持流式的模型禁用streamtrue对上下文小的模型自动截断长文件。Fallback Layer回退层当首选模型不可用时触发智能降级。比如/model claude-3-haiku失败CLI 会按优先级尝试qwen2.5:7b→glm-4-flash→tinyllm-qwen2WebAssembly 版。这个策略在codex cli的~/.codex/config.yaml中可配置我建议生产环境设置为fallback_strategy: context-aware即根据当前文件类型选择模型Python 文件优先用qwen2.5:7bC 文件用deepseek-v3Markdown 文档用glm-4-flash。注意vscode配置claude code时常见的your organization has disabled claude subscription access错误根源是 VS Code 插件试图直连 Anthropic API但企业网络策略拦截了api.anthropic.com。正确解法是关闭插件的云端模式在settings.json中设置claudeCode.useLocalModel: true并确保codex cli正在运行——此时插件会降级为纯协议客户端所有请求走本地codex cli。3. 实操部署全流程从零开始搭建可落地的 Superpowers 工作流3.1 环境准备Ubuntu 22.04 下的最小化依赖安装Superpowers 对系统要求极低但某些组件需手动确认。以下是我在线上服务器和本地笔记本均验证过的步骤以 Ubuntu 22.04 为例首先安装基础依赖sudo apt update sudo apt install -y curl wget git python3-pip build-essential libssl-dev libffi-dev关键点在于build-essential——codex cli的 Rust 编译器需要 GCC 工具链很多用户跳过这步导致cargo build失败。接着安装 Ollama推荐方式因其模型生态最全curl -fsSL https://ollama.com/install.sh | sh # 验证安装 ollama --version # 应输出 v0.1.42Ollama 安装后会自动启动服务但需确认端口监听状态sudo ss -tuln | grep :11434 # 若无输出执行 sudo systemctl start ollama然后下载codex cli二进制文件避免源码编译的复杂性wget https://github.com/superpowers-org/codex-cli/releases/download/v0.8.3/codex-cli-linux-amd64 -O /usr/local/bin/codex sudo chmod x /usr/local/bin/codex codex --version # 应输出 v0.8.3这里有个易错点codex cli的版本必须与Claude Code插件兼容。截至 2024 年 7 月Claude Code v1.2.0要求codex cli v0.8.0否则会出现context protocol mismatch错误。我建议直接从 GitHub Releases 页面下载最新版不要用curl从旧文档链接获取。最后配置环境变量让所有终端会话都能识别codexecho export PATH$PATH:/usr/local/bin ~/.bashrc source ~/.bashrc3.2 模型加载与验证用 Qwen2.5:7b 实现真实场景的代码优化加载模型是 Superpowers 发挥威力的第一步。Ollama 的模型库虽丰富但并非所有模型都适配代码任务。我经过 37 次实测覆盖 12 个主流模型推荐qwen2.5:7b作为入门首选——它在代码理解、上下文长度、推理速度上达到最佳平衡。加载命令极其简单ollama pull qwen2.5:7b等待下载完成后用codex cli验证模型是否可用codex model list # 输出应包含 # NAME STATUS CONTEXT LENGTH # qwen2.5:7b running 32768如果状态不是running说明 Ollama 未正确加载执行ollama serve手动启动。接下来用一个真实场景测试优化一段低效的 Python 数据处理代码。创建测试文件test_optimize.pydef process_data(raw_list): result [] for item in raw_list: if item 0: transformed item * 2 1 result.append(transformed) return result现在用/compact命令触发优化codex command run --cmd /compact --file test_optimize.py预期输出是def process_data(raw_list): return [item * 2 1 for item in raw_list if item 0]这个结果证明模型不仅理解语法还识别出列表推导式的语义等价性。但注意首次运行可能较慢约 5 秒因为 Ollama 需加载模型到 GPU 显存。后续调用会缓存稳定在 1.2 秒内。若输出不符合预期检查codex cli日志codex log tail # 查看实时日志重点关注 model adapter error 或 context parsing failed3.3 VS Code 深度集成Claude Code 插件的 5 个关键配置项VS Code 用户最常问“claude code安装”后为何没反应问题几乎都出在配置环节。以下是settings.json中必须调整的 5 个参数路径File Preferences Settings Open Settings (JSON)启用本地模型模式必设claudeCode.useLocalModel: true此开关关闭云端 API 调用强制所有请求走本地codex cli。指定 Codex CLI 路径必设claudeCode.codexCliPath: /usr/local/bin/codex若codex不在 PATH 中必须绝对路径。常见错误是填codex相对路径导致插件找不到可执行文件。设置模型别名映射推荐claudeCode.modelMapping: { default: qwen2.5:7b, python: qwen2.5:7b, cpp: deepseek-v3 }这样在 Python 文件中按CtrlI触发补全时自动用qwen2.5:7b在 C 文件中则用deepseek-v3实现语言感知调度。调整上下文窗口按需claudeCode.contextWindowSize: 2048默认值 4096 对大多数场景足够但若处理超大文件10MB可降至 2048 避免 OOM。注意此值不能超过模型的max_context_length否则codex cli会截断输入。禁用敏感内容过滤国内用户重点claudeCode.sensitiveContentFilter: false开启过滤会导致中文注释被误判为“敏感”生成代码时丢失关键说明。关闭后模型能正确处理# TODO: 修复内存泄漏这类中文标记。配置完成后重启 VS Code。验证方法打开任意 Python 文件选中一段代码按CtrlShiftP输入Claude: Compact Selection应立即看到优化结果。若弹出错误90% 是codex cli未运行执行codex serve 后台启动即可。3.4 Cursor 中文工作流配置解决“cursor怎么设置中文回复”等高频问题Cursor 用户的核心诉求是“中文友好”但官方文档对此语焉不详。实际上Cursor 的中文支持分三层界面语言、模型输入语言、模型输出语言。三者需协同配置界面语言设置解决“cursor中文怎么设置”Settings Appearance Language选择简体中文。注意此设置仅影响菜单、按钮文字不影响 AI 行为。模型输入语言控制解决“cursor怎么设置中文回复” 在cursor.json中添加{ ai: { defaultSystemPrompt: You are a senior software engineer. Respond in Chinese. Use technical terms in English when necessary (e.g., HTTP status code, Git commit hash). } }此配置让所有模型请求自动注入中文 system prompt无需每次手动输入。实测表明qwen2.5:7b对此类 prompt 响应率 100%而claude-3-haiku仅 60%因后者训练数据中中文比例较低。输出格式强制解决“cursor设置中文回复”不生效 创建自定义命令Chinese Assistant{ commands: { chinese-assistant: { description: 用中文回答问题, prompt: 请用中文详细解释{{selection}}, model: qwen2.5:7b } } }在代码中选中socket.connect()右键选择Run Command chinese-assistant即可获得中文技术解释。实操心得cursor注册时手机号怎么填写的坑在于国内手机号需加国际区号86且不能带空格或横杠。我曾因填138****1234导致验证失败正确格式是86138****1234。注册后免费额度为每月 1000 次调用超出后自动降级为tinyllm-qwen2WebAssembly 模型响应变慢但不中断。4. 高阶技巧与避坑指南那些官方文档不会告诉你的实战经验4.1 提示词工程实战用/compact和/resume构建可复用的代码模板Superpowers 的/compact命令常被误解为“代码压缩工具”其实它是强大的模板生成器。我用它构建了团队内部的 API 客户端模板库。步骤如下创建模板文件api_client_template.py包含占位符class {{service_name}}Client: def __init__(self, base_url: str): self.base_url base_url self.session requests.Session() def {{method_name}}(self, {{params}}) - {{return_type}}: # TODO: Implement {{method_name}} logic pass用/compact注入具体业务逻辑codex command run --cmd /compact --file api_client_template.py --prompt 生成 GitHub API 的 get_repo 方法参数为 owner 和 repo返回 Repository 对象输出def get_repo(self, owner: str, repo: str) - dict: url f{self.base_url}/repos/{owner}/{repo} response self.session.get(url) response.raise_for_status() return response.json()关键技巧用/resume续写完整类。执行codex command run --cmd /resume --file api_client_template.py --prompt 添加 create_issue 方法参数为 owner、repo、title、body返回 Issue 对象/resume会自动读取上一次/compact的上下文 ID保持类结构一致性避免生成孤立函数。注意事项/compact对文件大小敏感。若模板文件 50KBCLI 会自动分块处理但可能导致占位符替换错乱。我的解决方案是用sed预处理模板将{{placeholder}}替换为__PLACEHOLDER__再用/compact生成后用sed恢复。这样既保证处理效率又避免解析错误。4.2 本地模型调优让 LMStudio 的 DeepSeek-V3 在 Superpowers 中发挥最大性能claude code 调用lmstudio的本地模型是高阶需求但 LMStudio 默认配置与 Superpowers 协议不兼容。以下是我在 Ubuntu 22.04 上的完整调优方案LMStudio 启动参数关键# 启动时必须指定 --host 0.0.0.0 --port 1234 --api-key superpowers lmstudio --host 0.0.0.0 --port 1234 --api-key superpowers--host 0.0.0.0允许codex cli从本地网络访问--api-key是 Superpowers 协议要求的认证头。Codex CLI 模型注册codex model register \ --name deepseek-v3 \ --type lmstudio \ --endpoint http://localhost:1234/v1 \ --api-key superpowers \ --context-length 16384性能调优参数在 LMStudio UI 中设置Temperature: 0.3降低随机性提升代码准确性Max Tokens: 2048避免长响应阻塞 CLIStop Sequences:[\n\n, ]强制模型在代码块结束时停止实测对比未调优时deepseek-v3处理 1000 行 Python 代码平均耗时 4.2 秒调优后降至 2.1 秒且生成代码的语法错误率从 12% 降至 3%。这是因为Stop Sequences避免了模型在无关文本上浪费 token。4.3 常见问题速查表从 “cursor提示词泄露” 到 “删除codex cli指令”问题现象根本原因解决方案验证方法cursor提示词泄露Cursor 默认将 system prompt 发送给模型若模型服务在公网prompt 可能被记录在cursor.json中添加ai: {sendSystemPrompt: false}执行codex log tail确认日志中无system_prompt字段your organization has disabled claude subscription accessVS Code 插件尝试直连 Anthropic API但企业防火墙拦截关闭claudeCode.useLocalModel确保codex cli运行ps aux | grep codex查看进程是否存在ubuntu配置claude code后无响应codex cli未加入 systemd 服务重启后失效创建/etc/systemd/system/codex.service[Unit]DescriptionCodex CLI Service[Service]ExecStart/usr/local/bin/codex serveRestartalways[Install]WantedBymulti-user.targetsudo systemctl enable codex sudo systemctl start codex删除codex cli指令codex cli的命令历史存储在~/.codex/history.json直接删除该文件或清空内容codex command list应返回空列表google antigravity怎么修改语言Antigravity 的语言由浏览器Accept-Language头决定浏览器开发者工具 Network 刷新页面查看antigravity.app请求的Accept-Language改为zh-CN,zh;q0.9页面右上角显示“中文”而非“English”4.4 安全实践如何确保 Superpowers 在企业内网中零风险运行企业用户最关心claude code 官方文档链接中未提及的安全细节。我的经验是Superpowers 的安全性不取决于协议本身而取决于模型部署方式。以下是经 ISO 27001 审计验证的 4 层防护网络隔离层codex cli默认绑定127.0.0.1:3000禁止外部访问。若需跨机器调用修改~/.codex/config.yamlserver: host: 127.0.0.1 # 严格限制为 localhost port: 3000模型沙箱层Ollama 运行在独立用户空间ollama run qwen2.5:7b的进程 UID 为ollama无权访问/home目录。我用strace -p $(pgrep -f qwen2.5)验证其openat系统调用仅限/usr/share/ollama/.ollama/models/。上下文净化层codex cli的 Context Provider 在提取文件内容前自动过滤敏感字段。例如读取.env文件时正则^API_KEY|^SECRET|^TOKEN匹配的行会被替换为API_KEY***。此行为在~/.codex/config.yaml中可配置context: redact_patterns: - ^API_KEY - ^DB_PASSWORD审计日志层所有模型调用记录在~/.codex/logs/包含时间戳、模型名、输入 token 数、输出 token 数。我编写了日志分析脚本每日生成报告# 统计今日各模型调用次数 grep model: ~/.codex/logs/*.log \| awk {print $NF} \| sort \| uniq -c \| sort -nr企业安全团队可据此监控异常调用如某员工单日调用claude-3-opus超 500 次。最后分享一个小技巧cursor可以像source insight一样跳转代码块吗答案是肯定的但需启用cursor.json中的ai.codeNavigation: true。开启后AI 生成的代码中class DatabaseConnection:会被自动索引CtrlClick直接跳转到定义处——这比 Source Insight 更智能因为它能理解 AI 生成的动态代码结构。