Add released API skill and reproducible PowerX onboarding / 集成已发布 API 技能与可复现 PowerX 使用指南

[edwingao28]

Users can install and explicitly upgrade the published @semianalysisai/inferencex-skills@0.1.0 from /api and /zh/api. The seven package files match the public archive byte-for-byte.

The skill navigates the live public API, with strictV2 single-turn PowerX export as its first worked example. It distinguishes per-GPU watts from deployment GPU energy, preserves missing values and real zeros, and records request scope and provenance. Examples provide saved API lookups, CSV/JSON exports, and empty-selection diagnostics. These are historical observations; no new benchmarks ran. Public API and database behavior are unchanged.

Testing

Local checks recorded at 2ec9bcc3: 5,792 unit tests, including 29 packed-package tests; 6 API-page Cypress tests; smoke suite; typecheck, lint, format and typography passed. English/Chinese desktop and mobile onboarding was inspected. Earlier anonymous installation/export checks passed for both Codex and Claude Code against the public 0.1.0 archive; its seven source files and the saved example checksums were reverified.

Remote CI passed: typecheck/unit tests, component tests, all eight Chrome/Firefox E2E shards, lint/format and Actions audit. Claude and Bugbot found no blocking issues. Production deployment and live bilingual onboarding verification remain pending, and the examples link to master becomes available after merge. When integrating the independent #901 proposal, reconcile its overlapping package and .codex/skills destination with this released baseline, which uses .agents/skills for Codex. The separate 0.2.0 changes in #1019 remain unpublished.

中文说明

用户可以从 /api 和 /zh/api 安装已发布的 @semianalysisai/inferencex-skills@0.1.0，并按说明显式升级。七个包文件与公开产物逐字节一致。

技能帮助用户使用实时公开 API，首个完整示例是 strictV2 单轮请求的 PowerX 导出。它区分单 GPU 功率与整个部署的 GPU 能耗，保留缺失值、真实零值、请求范围和溯源信息。示例提供已保存的 API 查询、CSV/JSON 导出及空结果诊断。示例使用历史观测，本轮未运行新的基准测试，也未修改公开 API 或数据库行为。

验证

2ec9bcc3 的本地验证记录：5,792 项单元测试通过，其中包含 29 项打包测试；6 项 API 页面 Cypress 测试、smoke suite、类型检查、lint、格式和字体规范检查通过。已检查中英文页面的桌面和移动端显示。此前已通过 Codex 与 Claude Code 的公开 0.1.0 匿名安装和导出验证，本次重新核对了七个源码文件及示例校验值。

远端 CI 已通过类型检查、单元测试、组件测试、Chrome/Firefox 全部八个 E2E 分片、lint、格式及 Actions 审计；Claude 和 Bugbot 未发现阻碍合并的问题。生产部署及线上中英文使用流程验证仍待完成；指向 master 的示例链接在合并后可用。后续集成独立提案 #901 时，其重叠包和 .codex/skills 安装目录需要以本次已发布版本为基准协调；本版本的 Codex 目录是 .agents/skills。另行提交的 #1019 包含 0.2.0 改进，尚未发布。

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
inferencemax-app	Ready	Preview	Sep 5, 2026 7:44am UTC

[github-actions]

Claude finished @edwingao28's task in 2m 5s —— View job

---

Review: PR #1018 — Add released API skill and reproducible PowerX onboarding

• Read the diff and understand the changes
• Review frontend changes (API reference page, examples link component)
• Review the skills package (install script, export-powerx, tests)
• Check CI status
• Runtime-verify the /api page changes
• Post review findings

🟢 LGTM — no blocking issues found

This PR is mostly a self-contained packages/skills package plus a documentation section on the API reference page. I focused runtime verification and static review on the app-affecting changes.

Runtime verification (localhost, real read-only DB):

• /api and /zh/api both render the new "Use the API with your agent" / "通过智能体使用 API" section with 0 console errors. Install commands, upgrade note, examples link, prompt block, and the collapsible PowerX cookbook all render as intended.

CI: Tests (Unit) ✅, Lint & Format ✅, Zizmor ✅; Tests (E2E) still in progress at review time (no failures).

What I checked and found solid:

• export-powerx.mjs re-filters power_valid === 1 && power_metric_schema_version === 2 client-side, so it stays correct even if the API ignored the powerValid param — and powerValid/strictV2 is in fact supported by benchmarks/route.ts, so the docs are accurate. Non-finite handling, metric_coverage counting (on selected, pre-round-trip), and CSV blanking are all internally consistent.
• install.mjs validates target/dir/positionals, guards against non-directory and symlink overwrites, and enforces Node ≥ 24.
• Test coverage is present and thorough: skills package unit tests (install, export, diagnose, basic-lookup) plus an expanded api-documentation.cy.ts covering both locales, install copy-to-clipboard, prompt/cookbook contents, and mobile overflow. packages/skills/** was correctly added to the tests-unit.yml path filter.
• The new interactive element (ApiAgentExamplesLink) already has a named track('api_agent_examples_opened', { locale }) call. 👍

Chinese copy (advisory): The /zh/api strings are accurate, parallel to the English source, and read as natural technical Chinese; established English terms (token, strictV2, GPU, Node 24, npm, MCP server, schema v2, prefill/decode, joules) are correctly preserved. Note the pragmatic （英文） marker on the examples link, which is honest since the linked doc is English-only. No semantic issues — nothing requiring maintainer attention.

Note (non-blocking, already acknowledged in the PR body): the examples link and blob/master example URLs only resolve after merge to master. Expected.
· codex/inferencex-api-skill