omp packages

pi-zcode-headers0.1.0

让 pi 伪装成官方 ZCode 客户端 | Make pi pretend to be the official ZCode client — injects ZCode identity headers so the Zhipu backend treats pi traffic as ZCode traffic.

cyzlmh Published 1 month ago MIT ~237 downloads/mo

Untested on omp

This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.

Did it work for you?

Result

One report per person. A new report replaces your old one.

Reports 0

No reports yet.

Readme

pi-zcode-headers

🎭 让 pi 伪装成官方 ZCode 客户端，让智谱后端把 pi 流量当作 ZCode 流量。 Make pi pretend to be the official ZCode client — the Zhipu backend treats pi traffic as ZCode traffic.

当 pi 使用智谱 / Z.AI provider（zai-coding、zai-coding-cn、api.z.ai、open.bigmodel.cn 等）时，自动注入与官方 ZCode 客户端完全一致的身份 headers，让智谱后端将 pi 的流量识别为 ZCode 流量。

When pi uses a Zhipu / Z.AI provider, this extension injects the exact identity headers the official ZCode client sends, so Zhipu's backend treats pi traffic as ZCode traffic.

安装 / Install

pi install npm:pi-zcode-headers

工作原理 / How It Works

每次 pi 发出 LLM 请求前，扩展检查当前 provider：

  • 智谱官方端点（provider 名 zai / zai-coding / zai-coding-cn / zhipu / bigmodel，或 baseUrl 为 api.z.ai / open.bigmodel.cn）→ 注入完整 ZCode 身份 headers
  • 其他 provider (DeepSeek, OpenAI, etc.) → 不注入，零影响

注入的 headers 与官方 ZCode（桌面版 3.10.2 内置 agent runtime）实测抓包逐字节一致，覆盖 Anthropic 风格（/api/anthropic）与 OpenAI 风格（/api/coding/paas/v4）两类 coding-plan 端点：

Header 值 / Value
User-Agent ZCode/<版本> ai-sdk/provider-utils/<4.0.x> runtime/node.js/<主版本>
HTTP-Referer https://zcode.z.ai
X-Title Z Code@electron（桌面身份）或 Z Code@cli（runtime 身份）
X-ZCode-App-Version 与 User-Agent 一致的版本号
X-ZCode-Agent glm
X-ZCode-Session-Type main
X-Platform darwin-arm64（platform-arch）
X-Os-Category macos / windows / linux
X-Os-Version 系统内核版本（os.release()）
X-Client-Language 系统 locale（如 zh-CN）
X-Client-Timezone 系统时区（如 Asia/Shanghai）
X-Release-Channel production
X-Session-Id 每个 pi 会话一个持久 UUID
X-Query-Id / X-Request-Id / X-ZCode-Trace-Id 每次请求新 UUID

同时清除 openai SDK 的 x-stainless-* 指纹头（官方客户端不发这些头），确保 header 层面完全一致。

版本号解析顺序（优先级从高到低）：

  1. 环境变量 ZCODE_APP_VERSION（官方 runtime 同名变量）
  2. 本机安装的官方桌面版 ZCode（读取 Info.plist，此时伪装为桌面身份 Z Code@electron）
  3. 本机安装的 zcode CLI（官方 runtime，此时为 Z Code@cli 身份）
  4. 内置 fallback（随官方发版更新）

环境变量 / Environment Variables

变量 作用
ZCODE_APP_VERSION 覆盖上报的客户端版本
ZCODE_SOURCE_TITLE electron 或 cli，覆盖身份表面
ZCODE_AI_SDK_VERSION 覆盖 User-Agent 中 ai-sdk 版本后缀
ZCODE_ENV test 时上报 X-Release-Channel: test

License

MIT