flyai-cli

飞猪酒店、机票查询命令行工具（TypeScript，streamable_http MCP）。

依赖

• Node.js >= 18
• 安装：npm install

构建配置（profile）

默认凭证与签名字符串在构建时写入 src/build-profile.ts，由 scripts/generate-build-config.mjs 根据 profile 生成。

1. 复制模板：cp profile.example.json profile.json

2. 编辑 profile.json，填写 defaultAuthorization、signSecret 等（profile.json 已加入 .gitignore，勿提交密钥）。

3. 运行时可用环境变量 FLYAI_SIGN_SECRET 覆盖构建期写入的 signSecret（非空则优先），便于分发 bundle 时不把密钥打进产物、改由部署环境注入；须与 MCP 侧配置的密钥一致。

4. 可选：通过环境变量指定 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 或临时目录文件；不读取 Linux machine-id、macOS IOPlatformUUID、Windows MachineGuid。

环境变量（隐私相关）

| 变量 | 取值 | 说明 | |------|------|------| | FLYAI_SIGN_SECRET | 非空字符串 | 覆盖构建期 signSecret，用于 x-ff-ctx 加密与请求 HMAC；须与服务端一致 |

License

MIT