flyai-cli
飞猪酒店、机票查询命令行工具（TypeScript，streamable_http MCP）。
依赖
- Node.js >= 18
- 安装：
npm install
构建配置（profile）
默认凭证与签名字符串在构建时写入 src/build-profile.ts，由 scripts/generate-build-config.mjs 根据 profile 生成。
-
复制模板：
cp profile.example.json profile.json -
编辑
profile.json，填写defaultAuthorization、signSecret等（profile.json已加入.gitignore，勿提交密钥）。 -
运行时可用环境变量
FLYAI_SIGN_SECRET覆盖构建期写入的signSecret（非空则优先），便于分发 bundle 时不把密钥打进产物、改由部署环境注入；须与 MCP 侧配置的密钥一致。 -
可选：通过环境变量指定 profile 路径（相对仓库根目录或绝对路径）：
export FLYAI_PROFILE=/path/to/your-profile.json
未提供 profile.json 且未设置 FLYAI_PROFILE 时：不覆盖仓库里已有的 src/build-profile.ts，直接作为默认配置参与编译。仅当该文件也不存在时，才会用 profile.example.json 生成一份（例如全新克隆且未提交 build-profile.ts 时）。
构建方法
| 命令 | 说明 |
|---|---|
npm run generate:build-config | 有 FLYAI_PROFILE 或 profile.json 时据此写入 src/build-profile.ts；否则若已有 src/build-profile.ts 则跳过 |
npm run build | 先执行 generate:build-config（prebuild），再 tsc 编译到 dist/，并为 dist/index.js 加可执行权限 |
npm run build:bundle | 先 generate:build-config，再用 esbuild 打单文件 dist/flyai-bundle.cjs（含 commander 等依赖） |
npm run build:bundle:obfuscate | 一条指令：先 generate:build-config，再 esbuild 打包并混淆；产出 dist/flyai-bundle.plain.cjs（未混淆中间产物）与 dist/flyai-bundle.cjs（混淆终产物，package.json 的 flyai-bundle 入口） |
npm run build:full | build + build:bundle:obfuscate（完整编译 + 混淆单文件包） |
说明：npm run build 与 npm run build:bundle 会通过 prebuild / prebuild:bundle 自动跑 profile 生成；混淆单文件包请直接用 npm run build:bundle:obfuscate（已内含 generate:build-config，无需再单独执行）。供安全审计时优先使用 npm run build 或 npm run build:bundle（无 obfuscate）；混淆构建请保留并对照 dist/flyai-bundle.plain.cjs。
运行
- 开发（含生成配置、编译、启动）：
npm run dev - 编译产物：
node dist/index.js <command> ... - 单文件包：
node dist/flyai-bundle.cjs（需先执行对应 bundle 构建）；若使用混淆构建，还可直接运行未混淆的node dist/flyai-bundle.plain.cjs便于排查问题 - 全局命令：在仓库根目录执行
npm link后使用flyai <command> ...
隐私与请求头 x-ff-ctx
每个 MCP 请求会携带 x-ff-ctx：内容为 gzip 后的 JSON，若已配置 signSecret（或运行时 FLYAI_SIGN_SECRET）则再经 AES-256-GCM 加密后 Base64。典型用途包括风控、滥用检测与客户端环境一致性校验。CLI 默认不采集主机名、系统用户名、主目录；CPU 仅传核数，不传型号。具体字段实现见 src/machine-info.ts、src/device-id.ts。
在变更默认设备标识之前，请与飞猪 MCP / 风控侧确认，避免影响鉴权、签名或风控策略。
载荷概要
- machine：
platform、arch、CPU 核数、内存档位（粗分档 GB）、osType、nodeVersion、osReleaseMajor（内核/系统主版本号） - fingerprint：主语言标签（不含完整 locale）、UA 风格
platform、User-Agent字符串、硬件并发数、粗设备内存档、clientSurface: cli、时区偏移、deviceId（对随机种子做 SHA256 的 64 位 hex）。种子来自~/.flyai/device-id或临时目录文件；不读取 Linuxmachine-id、macOSIOPlatformUUID、WindowsMachineGuid。
环境变量（隐私相关）
| 变量 | 取值 | 说明 |
|---|---|---|
FLYAI_SIGN_SECRET | 非空字符串 | 覆盖构建期 signSecret，用于 x-ff-ctx 加密与请求 HMAC；须与服务端一致 |
License
MIT