@qs_cli/polaris-cli 0.0.0-stage → 0.2.4

package/README.md

@@ -1,3 +1,185 @@
-# Temporary Holding Version
+# Polaris CLI
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+观星台命令行查询工具。用飞书登录后，可以在终端查询网络请求和 Dev/QA 用户资料，不必打开网页。
+
+`polaris` 和 `polaris_cli` 是同一个程序，下面的命令把 `polaris` 换成 `polaris_cli` 即可。
+
+## 安装
+
+需要 Node.js 18 或更高版本。
+
+```bash
+npm install -g @qs_cli/polaris-cli
+polaris --version
+polaris doctor
+```
+
+卸载只删除命令，不删除本机配置和登录凭证：
+
+```bash
+npm uninstall -g @qs_cli/polaris-cli
+```
+
+从源码安装时，在 `polaris_cli` 目录执行 `./install.sh`；对应的卸载命令是 `./uninstall.sh`。
+
+## 第一次使用
+
+新安装后默认查询线上服务 `https://polaris.yfcenter.com`。本地和线上的登录凭证分开保存。
+
+```bash
+polaris env          # 查看当前环境
+polaris login        # 浏览器完成飞书登录，等待最多 5 分钟
+polaris whoami       # 确认姓名、邮箱、角色和凭证过期时间
+```
+
+登录成功后，凭证写入 `~/.polaris/config.json`，文件权限为 `0600`。可以用 `POLARIS_CONFIG=/其他路径` 换配置文件。
+
+`polaris logout` 只删除当前环境的本地凭证，不会影响另一个环境。凭证过期后重新执行 `polaris login`。
+
+## 全局参数
+
+这些参数对后面的查询命令都有效：
+
+| 参数 | 作用 |
+| --- | --- |
+| `--service-env <local\|online>` | 只对这一次命令切换环境，不改配置文件 |
+| `--base <url>` | 只对这一次命令指定服务地址，覆盖环境地址 |
+| `--json` | 以 JSON 输出，适合脚本处理 |
+| `-V, --version` | 显示版本 |
+| `-h, --help` | 显示帮助 |
+
+```bash
+polaris --json whoami
+polaris --service-env local net list --uid 24842
+polaris --base https://polaris.yfcenter.com net get 100
+```
+
+直接执行 `polaris` 或 `polaris help` 会显示总帮助。`polaris <命令> --help` 显示该命令的参数。
+
+## 环境
+
+| 环境 | 地址 | 用途 |
+| --- | --- | --- |
+| `online` | `https://polaris.yfcenter.com` | 默认环境，查询线上观星台 |
+| `local` | `http://127.0.0.1:8080` | 查询本机后端 |
+
+```bash
+polaris env                 # 查看当前环境、地址和配置文件
+polaris env online          # 切换并保存为线上
+polaris env local           # 切换并保存为本地
+polaris env use online      # 与 polaris env online 相同
+```
+
+已经保存过环境的配置文件会继续使用保存的值。只有没有配置文件，或者配置里没有合法环境时，才使用默认的 `online`。
+
+## 登录和诊断
+
+```bash
+polaris login
+polaris whoami
+polaris whoami --json
+polaris logout
+polaris doctor
+polaris doctor --json
+```
+
+`whoami` 显示当前环境中的姓名、邮箱、角色和凭证过期时间。角色从低到高是 `viewer`、`developer`、`admin`。
+
+`doctor` 检查 CLI 版本、Node.js、配置文件、本地和线上连通性、当前环境的登录凭证，以及用户查询环境是否可用。用户查询环境不可用通常表示还没登录，或者角色低于 `developer`。
+
+登录或查询返回 `401` 时先执行 `polaris login`。返回 `403` 表示当前账号权限不足。
+
+## 查询网络请求
+
+网络请求列表和详情需要已登录。列表不返回请求头、请求体、响应头和响应体，这些内容用 `net get` 查看。
+
+### 列表
+
+```bash
+polaris net list
+polaris net list --uid 24842
+polaris net list --uid 24842 --page 2 --size 50
+polaris net list --method POST --status 500
+polaris net list --success false
+polaris net list --biz-code nonzero --min-duration 1000
+polaris net list --host api-qa.yfcenter.com --keyword financial_calendar
+polaris net list --from 2026-11-10T00:00:00+08:00 --to 2026-11-11T00:00:00+08:00
+polaris net list --uid 24842 --json
+```
+
+| 参数 | 说明 |
+| --- | --- |
+| `--id <number>` | 按记录 ID 精确查询 |
+| `--uid <string>` | 按用户 UID 查询 |
+| `--device <string>` | 按设备 ID 查询 |
+| `--method <method>` | HTTP 方法，会转成大写 |
+| `--host <string>` | 请求 Host |
+| `--keyword <string>` | 匹配 URL 的关键词 |
+| `--status <number>` | HTTP 状态码 |
+| `--success <true\|false>` | 客户端记录的请求是否成功 |
+| `--biz-code <number\|nonzero>` | 精确业务码；`nonzero` 表示业务码不为 0 |
+| `--min-duration <ms>` | 耗时大于等于该毫秒数 |
+| `--app-id <string>` | App ID，例如 `youfi` |
+| `--app-version <string>` | App 版本 |
+| `--from <time>` | 开始时间 |
+| `--to <time>` | 结束时间 |
+| `--page <number>` | 页码，从 1 开始，默认 1 |
+| `--size <number>` | 每页条数，默认 20，最大 200 |
+
+`--from` 和 `--to` 传给服务端时只接受两种格式：RFC3339，例如 `2026-11-10T00:00:00+08:00`；或者毫秒时间戳。其他写法会被忽略，时间条件不会生效。
+
+多个条件同时使用时是“并且”关系。表格按列宽截断长路径，完整 URL 在详情里。
+
+### 详情
+
+```bash
+polaris net get 1593
+polaris net get 1593 --curl
+polaris net get 1593 --resp-headers
+polaris net get 1593 --all --max-lines 200
+polaris net get 1593 --json
+```
+
+| 参数 | 说明 |
+| --- | --- |
+| `--curl` | 根据记录生成可执行的 curl |
+| `--resp-headers` | 额外显示响应头 |
+| `--all` | 同时显示响应头和 curl |
+| `--max-lines <number>` | 响应体最多显示的行数，默认 80，最大 100000 |
+
+详情包含方法、URL、状态码、耗时、业务码、设备与应用信息、Query、请求头和请求体。响应体默认折叠到 80 行。客户端上报时单个 body 大约只保留前 16KB，超长内容末尾会带 `truncated` 标记，因此详情不一定是服务端的完整响应。
+
+## 查询用户资料
+
+用户查询走 Dev 或 QA 的用户中心，不是观星台自己的用户表。调用账号至少要有 `developer` 角色。
+
+每次只能使用一种条件：UID、邮箱或手机号。
+
+```bash
+polaris user 24842
+polaris user 24842 --env qa
+polaris user --uid 1051993 --env dev
+polaris user --email user@example.com --reveal
+polaris user --mobile 13600000000 --nation-code 86 --env qa
+polaris user envs
+polaris user 24842 --json
+```
+
+| 参数 | 说明 |
+| --- | --- |
+| `[uid]` 或 `--uid <uid>` | 按正整数 UID 查询 |
+| `--env <dev\|qa>` | 用户中心环境，默认 `qa` |
+| `--email <email>` | 按邮箱反查 |
+| `--mobile <mobile>` | 按手机号反查 |
+| `--nation-code <code>` | 手机号国家或地区码，只能和 `--mobile` 一起用 |
+| `--reveal` | 显示手机号和邮箱明文；不加时会脱敏 |
+
+`polaris user envs` 查看当前后端配置了哪些用户中心环境。查不到用户时返回 404。
+
+## 常见问题
+
+- 命令提示未登录或 `401`：对当前环境执行 `polaris login`。线上和本地要分别登录。
+- `403`：账号角色不够。网络请求需要登录，用户查询需要 `developer` 或 `admin`。
+- 时间筛选没有效果：改用 RFC3339 或毫秒时间戳。
+- 详情里的响应体不完整：这是客户端上报时的长度限制，不是 CLI 再次截断。
+- 想临时查本地服务：`polaris --service-env local <命令>`。这不改变以后的默认环境。

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+import { Command, CommanderError } from 'commander';
+import { registerAuthCommands } from './commands/auth.js';
+import { registerDoctorCommand } from './commands/doctor.js';
+import { registerEnvCommand } from './commands/env.js';
+import { registerNetCommand } from './commands/net.js';
+import { registerUserCommand } from './commands/user.js';
+import { configureHelp } from './help.js';
+const VERSION = '0.2.4';
+const program = new Command();
+program
+    .name('polaris')
+    .description('观星台命令行查询工具')
+    .version(VERSION)
+    .option('--service-env <local|online>', '单次覆盖 Polaris 服务环境')
+    .option('--base <url>', '单次覆盖服务 Base URL')
+    .option('--json', '以 JSON 输出')
+    .helpCommand('help [command]', '显示命令帮助');
+configureHelp(program);
+registerAuthCommands(program);
+registerEnvCommand(program);
+registerDoctorCommand(program, VERSION);
+registerNetCommand(program);
+registerUserCommand(program);
+program.exitOverride();
+async function main() {
+    if (process.argv.length <= 2) {
+        program.outputHelp();
+        return;
+    }
+    try {
+        await program.parseAsync(process.argv);
+    }
+    catch (error) {
+        if (error instanceof CommanderError) {
+            if (['commander.helpDisplayed', 'commander.version'].includes(error.code))
+                return;
+            process.exitCode = error.exitCode || 1;
+            return;
+        }
+        console.error(`错误: ${error instanceof Error ? error.message : String(error)}`);
+        process.exitCode = 1;
+    }
+}
+await main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAEzC,MAAM,OAAO,GAAG,OAAO,CAAA;AACvB,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAA;AAE7B,OAAO;KACJ,IAAI,CAAC,SAAS,CAAC;KACf,WAAW,CAAC,YAAY,CAAC;KACzB,OAAO,CAAC,OAAO,CAAC;KAChB,MAAM,CAAC,8BAA8B,EAAE,mBAAmB,CAAC;KAC3D,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC;KACzC,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC;KAC7B,WAAW,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAA;AAE1C,aAAa,CAAC,OAAO,CAAC,CAAA;AACtB,oBAAoB,CAAC,OAAO,CAAC,CAAA;AAC7B,kBAAkB,CAAC,OAAO,CAAC,CAAA;AAC3B,qBAAqB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;AACvC,kBAAkB,CAAC,OAAO,CAAC,CAAA;AAC3B,mBAAmB,CAAC,OAAO,CAAC,CAAA;AAE5B,OAAO,CAAC,YAAY,EAAE,CAAA;AAEtB,KAAK,UAAU,IAAI;IACjB,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,UAAU,EAAE,CAAA;QACpB,OAAM;IACR,CAAC;IACD,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IACxC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;YACpC,IAAI,CAAC,yBAAyB,EAAE,mBAAmB,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;gBAAE,OAAM;YACjF,OAAO,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAA;YACtC,OAAM;QACR,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QAC9E,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;IACtB,CAAC;AACH,CAAC;AAED,MAAM,IAAI,EAAE,CAAA"}

package/dist/client.d.ts

@@ -0,0 +1,8 @@
+import type { RequestContext } from './config.js';
+export declare class ApiError extends Error {
+    readonly status: number;
+    readonly body?: unknown | undefined;
+    constructor(message: string, status: number, body?: unknown | undefined);
+}
+export declare function apiRequest<T>(context: RequestContext, path: string, init?: RequestInit, timeoutMs?: number): Promise<T>;
+export declare function queryPath(path: string, params: Record<string, unknown>): string;

package/dist/client.js

@@ -0,0 +1,63 @@
+export class ApiError extends Error {
+    status;
+    body;
+    constructor(message, status, body) {
+        super(message);
+        this.status = status;
+        this.body = body;
+    }
+}
+export async function apiRequest(context, path, init = {}, timeoutMs = 15_000) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    const headers = new Headers(init.headers);
+    headers.set('Accept', 'application/json');
+    if (context.token)
+        headers.set('Authorization', `Bearer ${context.token}`);
+    try {
+        const response = await fetch(`${context.baseUrl}${path}`, {
+            ...init,
+            headers,
+            signal: controller.signal,
+        });
+        const text = await response.text();
+        let body;
+        try {
+            body = text ? JSON.parse(text) : undefined;
+        }
+        catch {
+            body = text;
+        }
+        if (!response.ok) {
+            const serverMessage = body && typeof body === 'object' && 'error' in body
+                ? String(body.error)
+                : response.statusText;
+            const hint = response.status === 401 ? '；请先执行 polaris login' :
+                response.status === 403 ? '；当前账号权限不足' : '';
+            throw new ApiError(`请求失败 (${response.status}): ${serverMessage}${hint}`, response.status, body);
+        }
+        return body;
+    }
+    catch (error) {
+        if (error instanceof ApiError)
+            throw error;
+        if (error instanceof Error && error.name === 'AbortError') {
+            throw new Error(`请求超时: ${context.baseUrl}${path}`);
+        }
+        throw new Error(`无法访问 ${context.baseUrl}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+export function queryPath(path, params) {
+    const search = new URLSearchParams();
+    for (const [key, value] of Object.entries(params)) {
+        if (value !== undefined && value !== null && value !== '') {
+            search.set(key, String(value));
+        }
+    }
+    const query = search.toString();
+    return query ? `${path}?${query}` : path;
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,QAAS,SAAQ,KAAK;IAGf;IACA;IAHlB,YACE,OAAe,EACC,MAAc,EACd,IAAc;QAE9B,KAAK,CAAC,OAAO,CAAC,CAAA;QAHE,WAAM,GAAN,MAAM,CAAQ;QACd,SAAI,GAAJ,IAAI,CAAU;IAGhC,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,OAAuB,EACvB,IAAY,EACZ,OAAoB,EAAE,EACtB,SAAS,GAAG,MAAM;IAElB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;IACxC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAA;IAC7D,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACzC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAA;IACzC,IAAI,OAAO,CAAC,KAAK;QAAE,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,UAAU,OAAO,CAAC,KAAK,EAAE,CAAC,CAAA;IAE1E,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,EAAE,EAAE;YACxD,GAAG,IAAI;YACP,OAAO;YACP,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAA;QACF,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;QAClC,IAAI,IAAa,CAAA;QACjB,IAAI,CAAC;YACH,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QAC5C,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,GAAG,IAAI,CAAA;QACb,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,aAAa,GACjB,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,IAAI;gBACjD,CAAC,CAAC,MAAM,CAAE,IAA2B,CAAC,KAAK,CAAC;gBAC5C,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAA;YACzB,MAAM,IAAI,GACR,QAAQ,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC;gBACjD,QAAQ,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAA;YAC5C,MAAM,IAAI,QAAQ,CAAC,SAAS,QAAQ,CAAC,MAAM,MAAM,aAAa,GAAG,IAAI,EAAE,EAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;QACjG,CAAC;QACD,OAAO,IAAS,CAAA;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,QAAQ;YAAE,MAAM,KAAK,CAAA;QAC1C,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAC1D,MAAM,IAAI,KAAK,CAAC,SAAS,OAAO,CAAC,OAAO,GAAG,IAAI,EAAE,CAAC,CAAA;QACpD,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,QAAQ,OAAO,CAAC,OAAO,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IACvG,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAA;IACrB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,MAA+B;IACrE,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAA;IACpC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;YAC1D,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;QAChC,CAAC;IACH,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAA;IAC/B,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AAC1C,CAAC"}

package/dist/commands/auth.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerAuthCommands(program: Command): void;

package/dist/commands/auth.js

@@ -0,0 +1,144 @@
+import { spawn } from 'node:child_process';
+import { createServer } from 'node:http';
+import { apiRequest } from '../client.js';
+import { loadConfig, resolveContext, saveConfig, } from '../config.js';
+import { printJson } from '../utils/format.js';
+function tokenExpiresAt(token) {
+    if (!token)
+        return null;
+    try {
+        const body = token.split('.')[0];
+        const payload = JSON.parse(Buffer.from(body, 'base64url').toString('utf8'));
+        return payload.exp ? new Date(payload.exp * 1000).toISOString() : null;
+    }
+    catch {
+        return null;
+    }
+}
+function contextOf(command) {
+    return resolveContext(command.optsWithGlobals());
+}
+function openBrowser(url) {
+    const [command, args] = process.platform === 'darwin' ? ['open', [url]] :
+        process.platform === 'win32' ? ['cmd', ['/c', 'start', '', url]] :
+            ['xdg-open', [url]];
+    try {
+        const child = spawn(command, args, { detached: true, stdio: 'ignore' });
+        child.on('error', () => undefined);
+        child.unref();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function callbackPage(ok, message) {
+    const title = ok ? 'Polaris CLI 授权成功' : 'Polaris CLI 授权失败';
+    const safeMessage = message
+        .replaceAll('&', '&')
+        .replaceAll('<', '&lt;')
+        .replaceAll('>', '&gt;')
+        .replaceAll('"', '&quot;')
+        .replaceAll("'", '&#39;');
+    return `<!doctype html><html lang="zh-CN"><head><meta charset="utf-8"><title>${title}</title></head>
+<body style="font-family:-apple-system,sans-serif;padding:48px"><h2>${title}</h2><p>${safeMessage}</p>
+<script>history.replaceState({}, document.title, location.pathname);</script></body></html>`;
+}
+async function login(command) {
+    const context = contextOf(command);
+    let server;
+    try {
+        const listener = await startLoginListener();
+        server = listener.server;
+        const loginUrl = `${context.baseUrl}/api/v1/auth/feishu/login?cli_port=${listener.port}`;
+        console.log(`正在打开浏览器完成 ${context.env} 环境的飞书登录…`);
+        console.log(`若浏览器未自动打开，请访问：\n${loginUrl}`);
+        openBrowser(loginUrl);
+        const token = await listener.token;
+        const config = loadConfig();
+        config.tokens[context.env] = { token, savedAt: new Date().toISOString() };
+        saveConfig(config);
+        const authenticated = { ...context, token };
+        const me = await apiRequest(authenticated, '/api/v1/auth/me');
+        console.log(`登录成功：${me.user?.name || me.user?.email || '未知用户'}（${me.user?.role || '-'}）`);
+    }
+    finally {
+        server?.close();
+    }
+}
+async function startLoginListener() {
+    let resolveToken;
+    let rejectToken;
+    let settled = false;
+    const token = new Promise((resolve, reject) => {
+        resolveToken = resolve;
+        rejectToken = reject;
+    });
+    const server = createServer((request, response) => {
+        const url = new URL(request.url || '/', 'http://127.0.0.1');
+        if (url.pathname !== '/callback') {
+            response.writeHead(404).end('Not found');
+            return;
+        }
+        const value = url.searchParams.get('token');
+        const callbackError = url.searchParams.get('error');
+        if (!value) {
+            response.writeHead(400, { 'Content-Type': 'text/html; charset=utf-8' });
+            response.end(callbackPage(false, callbackError || '没有收到登录凭证，请返回终端重试。'));
+            if (!settled) {
+                settled = true;
+                rejectToken(new Error(callbackError ? `飞书授权失败: ${callbackError}` : '登录回调缺少 token'));
+            }
+            return;
+        }
+        response.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+        response.end(callbackPage(true, '凭证已保存，可以关闭此页面并返回终端。'));
+        if (!settled) {
+            settled = true;
+            resolveToken(value);
+        }
+    });
+    await new Promise((resolve, reject) => {
+        server.once('error', reject);
+        server.listen(0, '127.0.0.1', resolve);
+    });
+    const timer = setTimeout(() => {
+        if (!settled) {
+            settled = true;
+            rejectToken(new Error('登录等待超时（5 分钟）'));
+        }
+    }, 5 * 60_000);
+    token.finally(() => clearTimeout(timer)).catch(() => undefined);
+    return { port: server.address().port, server, token };
+}
+async function whoami(command) {
+    const context = contextOf(command);
+    const me = await apiRequest(context, '/api/v1/auth/me');
+    const expiresAt = tokenExpiresAt(context.token);
+    if (context.json) {
+        printJson({ ...me, token_expires_at: expiresAt });
+        return;
+    }
+    if (!me.user) {
+        console.log('当前服务未启用登录认证。');
+        return;
+    }
+    console.log(`姓名:   ${me.user.name || '-'}`);
+    console.log(`邮箱:   ${me.user.email || '-'}`);
+    console.log(`角色:   ${me.user.role}`);
+    console.log(`过期时间: ${expiresAt ? new Date(expiresAt).toLocaleString('zh-CN', { hour12: false }) : '-'}`);
+    console.log(`环境:   ${context.env}`);
+}
+function logout(command) {
+    const context = contextOf(command);
+    const config = loadConfig();
+    delete config.tokens[context.env];
+    saveConfig(config);
+    console.log(`已清除 ${context.env} 的本地登录凭证。`);
+}
+export function registerAuthCommands(program) {
+    program.command('login').description('通过浏览器完成飞书登录').action((_options, command) => login(command));
+    program.command('logout').description('清除当前环境的登录凭证').action((_options, command) => logout(command));
+    program.command('whoami').description('显示当前登录账号与角色').action((_options, command) => whoami(command));
+}
+//# sourceMappingURL=auth.js.map

package/dist/commands/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/commands/auth.ts"],"names":[],"mappings":"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"}

package/dist/commands/doctor.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerDoctorCommand(program: Command, version: string): void;

package/dist/commands/doctor.js

@@ -0,0 +1,111 @@
+import { accessSync, constants } from 'node:fs';
+import { arch, platform, release } from 'node:os';
+import { apiRequest } from '../client.js';
+import { CONFIG_PATH, ENV_URLS, loadConfig, resolveContext, } from '../config.js';
+import { printJson, table } from '../utils/format.js';
+async function probe(baseUrl) {
+    const started = performance.now();
+    try {
+        const response = await fetch(`${baseUrl}/healthz`, {
+            signal: AbortSignal.timeout(5_000),
+        });
+        return {
+            ok: response.ok,
+            status: response.status,
+            elapsedMs: Math.round(performance.now() - started),
+        };
+    }
+    catch (error) {
+        return {
+            ok: false,
+            elapsedMs: Math.round(performance.now() - started),
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+export function registerDoctorCommand(program, version) {
+    program
+        .command('doctor')
+        .description('检查 CLI、配置、服务连通性和登录权限')
+        .option('--json', '以 JSON 输出')
+        .addHelpText('after', `
+示例:
+  polaris doctor
+  polaris doctor --json`)
+        .action(async (options, command) => {
+        const globals = command.optsWithGlobals();
+        const context = resolveContext({ ...globals, json: options.json ?? globals.json });
+        const config = loadConfig();
+        let configReadable = true;
+        try {
+            accessSync(CONFIG_PATH, constants.R_OK);
+        }
+        catch {
+            configReadable = false;
+        }
+        const [local, online] = await Promise.all([
+            probe(ENV_URLS.local),
+            probe(ENV_URLS.online),
+        ]);
+        let me = null;
+        let meError;
+        if (context.token) {
+            try {
+                me = await apiRequest(context, '/api/v1/auth/me', {}, 5_000);
+            }
+            catch (error) {
+                meError = error instanceof Error ? error.message : String(error);
+            }
+        }
+        let userEnvs = null;
+        if (context.token) {
+            try {
+                userEnvs = await apiRequest(context, '/api/v1/user-lookup/envs', {}, 5_000);
+            }
+            catch {
+                // 角色不足时 doctor 的登录检查仍然有效。
+            }
+        }
+        const result = {
+            cli: {
+                version,
+                node: process.version,
+                os: `${platform()} ${release()}`,
+                arch: arch(),
+                executable: process.argv[1],
+            },
+            config: {
+                path: CONFIG_PATH,
+                exists: configReadable,
+                env: context.env,
+                baseUrl: context.baseUrl,
+                defaultUserEnv: config.defaultUserEnv,
+            },
+            connectivity: { local, online },
+            auth: {
+                hasToken: Boolean(context.token),
+                me,
+                error: meError,
+            },
+            userLookupEnvs: userEnvs,
+        };
+        if (context.json) {
+            printJson(result);
+            return;
+        }
+        console.log(table(['检查项', '结果'], [
+            ['CLI 版本', version],
+            ['Node.js', process.version],
+            ['系统', `${platform()} ${arch()}`],
+            ['命令路径', process.argv[1]],
+            ['配置文件', `${CONFIG_PATH}${configReadable ? '' : '（尚未创建）'}`],
+            ['当前环境', `${context.env} (${context.baseUrl})`],
+            ['用户查询默认环境', config.defaultUserEnv],
+            ['Local 连通性', local.ok ? `正常 HTTP ${local.status} / ${local.elapsedMs}ms` : `失败 / ${local.error || local.status}`],
+            ['Online 连通性', online.ok ? `正常 HTTP ${online.status} / ${online.elapsedMs}ms` : `失败 / ${online.error || online.status}`],
+            ['登录凭证', context.token ? (meError ? `无效：${meError}` : '有效') : '未登录，请执行 polaris login'],
+            ['用户查询环境', userEnvs ? JSON.stringify(userEnvs) : '不可用或权限不足'],
+        ], [24, 100]));
+    });
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"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"}

package/dist/commands/env.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerEnvCommand(program: Command): void;

package/dist/commands/env.js

@@ -0,0 +1,38 @@
+import { CONFIG_PATH, ENV_URLS, loadConfig, saveConfig } from '../config.js';
+function useEnv(name) {
+    if (name !== 'local' && name !== 'online') {
+        throw new Error(`未知环境: ${name}；可选值为 local 或 online`);
+    }
+    const config = loadConfig();
+    config.env = name;
+    saveConfig(config);
+    console.log(`已切换到 ${name}: ${ENV_URLS[name]}`);
+}
+export function registerEnvCommand(program) {
+    const env = program
+        .command('env [env]')
+        .description('查看或切换 Polaris 服务环境')
+        .addHelpText('after', `
+示例:
+  polaris env
+  polaris env local
+  polaris env online
+  polaris env use local
+  polaris env use online`)
+        .action((name) => {
+        if (name) {
+            useEnv(name);
+            return;
+        }
+        const config = loadConfig();
+        console.log(`当前环境:    ${config.env}`);
+        console.log(`Base URL:    ${ENV_URLS[config.env]}`);
+        console.log(`配置文件:    ${CONFIG_PATH}`);
+        console.log('\n切换环境: polaris env local | polaris env online');
+    });
+    env
+        .command('use <env>')
+        .description('切换默认服务环境（local 或 online）')
+        .action(useEnv);
+}
+//# sourceMappingURL=env.js.map

package/dist/commands/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/commands/env.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAwB,MAAM,cAAc,CAAA;AAElG,SAAS,MAAM,CAAC,IAAY;IAC1B,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,sBAAsB,CAAC,CAAA;IACtD,CAAC;IACD,MAAM,MAAM,GAAG,UAAU,EAAE,CAAA;IAC3B,MAAM,CAAC,GAAG,GAAG,IAAuB,CAAA;IACpC,UAAU,CAAC,MAAM,CAAC,CAAA;IAClB,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,KAAK,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;AAChD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,MAAM,GAAG,GAAG,OAAO;SAChB,OAAO,CAAC,WAAW,CAAC;SACpB,WAAW,CAAC,oBAAoB,CAAC;SACjC,WAAW,CAAC,OAAO,EAAE;;;;;;yBAMD,CAAC;SACrB,MAAM,CAAC,CAAC,IAAa,EAAE,EAAE;QACxB,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,CAAC,IAAI,CAAC,CAAA;YACZ,OAAM;QACR,CAAC;QACD,MAAM,MAAM,GAAG,UAAU,EAAE,CAAA;QAC3B,OAAO,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,GAAG,EAAE,CAAC,CAAA;QACrC,OAAO,CAAC,GAAG,CAAC,gBAAgB,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACnD,OAAO,CAAC,GAAG,CAAC,YAAY,WAAW,EAAE,CAAC,CAAA;QACtC,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAA;IAC/D,CAAC,CAAC,CAAA;IAEJ,GAAG;SACA,OAAO,CAAC,WAAW,CAAC;SACpB,WAAW,CAAC,0BAA0B,CAAC;SACvC,MAAM,CAAC,MAAM,CAAC,CAAA;AACnB,CAAC"}

package/dist/commands/net.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerNetCommand(program: Command): void;

package/dist/commands/net.js

@@ -0,0 +1,152 @@
+import { apiRequest, queryPath } from '../client.js';
+import { resolveContext } from '../config.js';
+import { generateCurl } from '../utils/curl.js';
+import { formatDate, limitLines, prettyContent, printJson, table, } from '../utils/format.js';
+function positiveInt(value, name, max) {
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed <= 0 || (max !== undefined && parsed > max)) {
+        throw new Error(`${name} 必须是 1${max ? `-${max}` : ' 以上'}的整数`);
+    }
+    return parsed;
+}
+async function listNet(options, command) {
+    const context = resolveContext(command.optsWithGlobals());
+    const page = positiveInt(options.page, '--page');
+    const size = positiveInt(options.size, '--size', 200);
+    if (options.success && !['true', 'false'].includes(options.success)) {
+        throw new Error('--success 只能是 true 或 false');
+    }
+    if (options.bizCode && options.bizCode !== 'nonzero' && !/^-?\d+$/.test(options.bizCode)) {
+        throw new Error('--biz-code 只能是整数或 nonzero');
+    }
+    const path = queryPath('/api/v1/net', {
+        id: options.id,
+        user_uid: options.uid,
+        device_id: options.device,
+        method: options.method?.toUpperCase(),
+        host: options.host,
+        keyword: options.keyword,
+        status_code: options.status,
+        success: options.success,
+        biz_code: options.bizCode,
+        min_duration: options.minDuration,
+        app_id: options.appId,
+        app_version: options.appVersion,
+        from: options.from,
+        to: options.to,
+        page,
+        size,
+    });
+    const result = await apiRequest(context, path);
+    if (context.json) {
+        printJson(result);
+        return;
+    }
+    console.log(`共 ${result.total} 条，第 ${result.page} 页，每页 ${result.size} 条`);
+    if (!result.items.length) {
+        console.log('没有匹配的网络请求。');
+        return;
+    }
+    console.log(table(['ID', '时间', '方法', '状态', '耗时', 'UID', 'Host', 'Path'], result.items.map((item) => [
+        item.id,
+        formatDate(item.client_time),
+        item.method,
+        item.status_code,
+        `${item.duration_ms ?? 0}ms`,
+        item.user_uid,
+        item.host,
+        item.path,
+    ]), [10, 20, 8, 8, 10, 16, 28, 48]));
+}
+function section(title, content) {
+    console.log(`\n${title}\n${'─'.repeat(Math.max(8, title.length * 2))}`);
+    console.log(content);
+}
+async function getNet(idRaw, options, command) {
+    const id = positiveInt(idRaw, 'id');
+    const maxLines = positiveInt(options.maxLines, '--max-lines', 100_000);
+    const context = resolveContext(command.optsWithGlobals());
+    const item = await apiRequest(context, `/api/v1/net/${id}`);
+    if (context.json) {
+        printJson(item);
+        return;
+    }
+    section('概要', table(['方法', 'URL', '状态码', '耗时', '成功', '业务码'], [[item.method, item.url, item.status_code, `${item.duration_ms}ms`, item.success, item.biz_code]], [8, 80, 8, 10, 8, 10]));
+    if (item.error)
+        console.log(`错误: ${item.error}`);
+    section('基本信息', table(['字段', '值'], [
+        ['Host', item.host],
+        ['Path', item.path],
+        ['平台', item.platform],
+        ['App ID', item.app_id],
+        ['App 版本', item.app_version],
+        ['OS 版本', item.os_version],
+        ['UID', item.user_uid],
+        ['设备 ID', item.device_id],
+        ['IP', item.ip],
+        ['客户端时间', formatDate(item.client_time)],
+        ['服务端时间', formatDate(item.server_time)],
+    ], [16, 100]));
+    try {
+        const url = new URL(String(item.url));
+        const params = [...url.searchParams.entries()];
+        section('Query 参数', params.length
+            ? table(['参数名', '参数值'], params, [30, 100])
+            : '(无 query 参数)');
+    }
+    catch {
+        section('Query 参数', '(URL 无法解析)');
+    }
+    section('请求头', prettyContent(item.request_headers));
+    section('请求体', prettyContent(item.request_body));
+    if (options.respHeaders || options.all) {
+        section('响应头', prettyContent(item.response_headers));
+    }
+    section('响应体', limitLines(prettyContent(item.response_body), maxLines));
+    if (options.curl || options.all) {
+        section('curl', generateCurl(item));
+    }
+}
+export function registerNetCommand(program) {
+    const net = program.command('net').description('查询网络请求');
+    net
+        .command('list')
+        .description('按多种条件查询网络请求列表')
+        .option('--id <number>', '按记录 ID 精确查询')
+        .option('--uid <string>', '按用户 UID 查询')
+        .option('--device <string>', '按设备 ID 查询')
+        .option('--method <method>', 'HTTP 方法')
+        .option('--host <string>', 'Host')
+        .option('--keyword <string>', 'URL/Path 关键词')
+        .option('--status <number>', 'HTTP 状态码')
+        .option('--success <true|false>', '是否成功')
+        .option('--biz-code <number|nonzero>', '业务码')
+        .option('--min-duration <ms>', '最小耗时（毫秒）')
+        .option('--app-id <string>', 'App ID')
+        .option('--app-version <string>', 'App 版本')
+        .option('--from <time>', '开始时间')
+        .option('--to <time>', '结束时间')
+        .option('--page <number>', '页码', '1')
+        .option('--size <number>', '每页条数，最大 200', '20')
+        .addHelpText('after', `
+示例:
+  polaris net list --uid 123
+  polaris net list --method POST --status 500 --from "2026-11-10 00:00:00"
+  polaris net list --biz-code nonzero --min-duration 1000 --json`)
+        .action(listNet);
+    net
+        .command('get <id>')
+        .description('查看一条网络请求详情')
+        .option('--curl', '显示可执行 curl 命令')
+        .option('--resp-headers', '显示响应头')
+        .option('--all', '显示响应头和 curl')
+        .option('--max-lines <number>', '响应体最大行数', '80')
+        .addHelpText('after', `
+示例:
+  polaris net get 100
+  polaris net get 100 --curl
+  polaris net get 100 --all --max-lines 200
+  polaris net get 100 --json`)
+        .action(getNet);
+}
+//# sourceMappingURL=net.js.map

package/dist/commands/net.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"net.js","sourceRoot":"","sources":["../../src/commands/net.ts"],"names":[],"mappings":"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"}

package/dist/commands/user.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerUserCommand(program: Command): void;

package/dist/commands/user.js

@@ -0,0 +1,93 @@
+import { apiRequest, queryPath } from '../client.js';
+import { loadConfig, resolveContext } from '../config.js';
+import { maskEmail, maskMobile, printJson, table } from '../utils/format.js';
+function uidTypeName(value) {
+    if (value === 0)
+        return '普通';
+    if (value === 1)
+        return '特殊';
+    if (value === 2)
+        return '预留';
+    return String(value);
+}
+async function lookupUser(positionalUID, options, command) {
+    const context = resolveContext(command.optsWithGlobals());
+    const uid = options.uid || positionalUID;
+    const queryCount = [uid, options.email, options.mobile].filter(Boolean).length;
+    if (queryCount !== 1) {
+        throw new Error('请且仅请提供一种查询条件：UID、--email 或 --mobile');
+    }
+    if (uid && !/^[1-9]\d*$/.test(uid)) {
+        throw new Error('UID 必须是正整数');
+    }
+    if (options.nationCode && !options.mobile) {
+        throw new Error('--nation-code 只能与 --mobile 一起使用');
+    }
+    const env = options.env || loadConfig().defaultUserEnv;
+    if (!['dev', 'qa'].includes(env)) {
+        throw new Error('--env 只能是 dev 或 qa');
+    }
+    const path = queryPath('/api/v1/user-lookup', {
+        env,
+        uid,
+        email: options.email,
+        mobile: options.mobile,
+        nation_code: options.nationCode,
+    });
+    const result = await apiRequest(context, path);
+    const account = {
+        ...result.account,
+        email: options.reveal ? result.account.email : maskEmail(result.account.email || ''),
+        mobile: options.reveal ? result.account.mobile : maskMobile(result.account.mobile || ''),
+    };
+    const output = { ...result, account };
+    if (context.json) {
+        printJson(output);
+        return;
+    }
+    console.log(table(['字段', '值'], [
+        ['环境', result.env.toUpperCase()],
+        ['UID', account.uid],
+        ['账号类型', uidTypeName(account.uid_type)],
+        ['昵称', account.nickname],
+        ['区号', account.nation_code],
+        ['手机号', account.mobile],
+        ['邮箱', account.email],
+        ['语言', account.language],
+        ['头像', account.avatar],
+    ], [16, 100]));
+    if (!options.reveal)
+        console.log('\n手机号和邮箱已脱敏；需要明文时添加 --reveal。');
+}
+export function registerUserCommand(program) {
+    const user = program
+        .command('user [uid]')
+        .description('在 Dev/QA 用户中心查询账号')
+        .option('--uid <uid>', '按 UID 查询（也可使用位置参数）')
+        .option('--env <dev|qa>', '用户中心环境（默认 qa）')
+        .option('--mobile <mobile>', '按手机号反查')
+        .option('--nation-code <code>', '手机号国家/地区码')
+        .option('--email <email>', '按邮箱反查')
+        .option('--reveal', '显示手机号和邮箱明文')
+        .addHelpText('after', `
+示例:
+  polaris user 123 --env qa
+  polaris user --uid 123 --env dev
+  polaris user --mobile 91234567 --nation-code 852
+  polaris user --email user@example.com --reveal
+  polaris user envs`)
+        .action(lookupUser);
+    user
+        .command('envs')
+        .description('查看后端已配置的用户查询环境')
+        .action(async (_options, command) => {
+        const context = resolveContext(command.optsWithGlobals());
+        const result = await apiRequest(context, '/api/v1/user-lookup/envs');
+        if (context.json) {
+            printJson(result);
+            return;
+        }
+        console.log(table(['环境', '名称'], result.items.map((item) => [item.key, item.label]), [12, 40]));
+    });
+}
+//# sourceMappingURL=user.js.map

package/dist/commands/user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.js","sourceRoot":"","sources":["../../src/commands/user.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,27 @@
+export type EnvironmentName = 'local' | 'online';
+export interface StoredToken {
+    token: string;
+    savedAt: string;
+}
+export interface PolarisConfig {
+    env: EnvironmentName;
+    defaultUserEnv: 'dev' | 'qa';
+    tokens: Partial<Record<EnvironmentName, StoredToken>>;
+}
+export interface GlobalOptions {
+    serviceEnv?: EnvironmentName;
+    base?: string;
+    json?: boolean;
+}
+export interface RequestContext {
+    env: EnvironmentName;
+    baseUrl: string;
+    token?: string;
+    json: boolean;
+}
+export declare const ENV_URLS: Record<EnvironmentName, string>;
+export declare const CONFIG_PATH: string;
+export declare function loadConfig(): PolarisConfig;
+export declare function saveConfig(config: PolarisConfig): void;
+export declare function normalizeBaseUrl(value: string): string;
+export declare function resolveContext(options: GlobalOptions): RequestContext;

package/dist/config.js

@@ -0,0 +1,55 @@
+import { chmodSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+export const ENV_URLS = {
+    local: 'http://127.0.0.1:8080',
+    online: 'https://polaris.yfcenter.com',
+};
+export const CONFIG_PATH = process.env.POLARIS_CONFIG || join(homedir(), '.polaris', 'config.json');
+const DEFAULT_CONFIG = {
+    env: 'online',
+    defaultUserEnv: 'qa',
+    tokens: {},
+};
+export function loadConfig() {
+    try {
+        const parsed = JSON.parse(readFileSync(CONFIG_PATH, 'utf8'));
+        return {
+            env: parsed.env === 'local' || parsed.env === 'online' ? parsed.env : DEFAULT_CONFIG.env,
+            defaultUserEnv: parsed.defaultUserEnv === 'dev' ? 'dev' : 'qa',
+            tokens: parsed.tokens && typeof parsed.tokens === 'object' ? parsed.tokens : {},
+        };
+    }
+    catch {
+        return structuredClone(DEFAULT_CONFIG);
+    }
+}
+export function saveConfig(config) {
+    const dir = dirname(CONFIG_PATH);
+    mkdirSync(dir, { recursive: true, mode: 0o700 });
+    const temp = `${CONFIG_PATH}.${process.pid}.tmp`;
+    writeFileSync(temp, `${JSON.stringify(config, null, 2)}\n`, { mode: 0o600 });
+    renameSync(temp, CONFIG_PATH);
+    chmodSync(CONFIG_PATH, 0o600);
+}
+export function normalizeBaseUrl(value) {
+    const url = new URL(value);
+    if (!['http:', 'https:'].includes(url.protocol)) {
+        throw new Error('--base 只支持 http 或 https URL');
+    }
+    return url.toString().replace(/\/+$/, '');
+}
+export function resolveContext(options) {
+    const config = loadConfig();
+    const env = options.serviceEnv ?? config.env;
+    if (env !== 'local' && env !== 'online') {
+        throw new Error('--service-env 只能是 local 或 online');
+    }
+    return {
+        env,
+        baseUrl: options.base ? normalizeBaseUrl(options.base) : ENV_URLS[env],
+        token: config.tokens[env]?.token,
+        json: Boolean(options.json),
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/help.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function configureHelp(program: Command): void;

package/dist/help.js

@@ -0,0 +1,23 @@
+import { CONFIG_PATH, ENV_URLS, loadConfig } from './config.js';
+export function configureHelp(program) {
+    const config = loadConfig();
+    const loggedIn = Boolean(config.tokens[config.env]?.token);
+    program
+        .showHelpAfterError('(执行 polaris help 查看完整帮助)')
+        .showSuggestionAfterError()
+        .addHelpText('beforeAll', 'Polaris CLI - 观星台命令行查询工具\n')
+        .addHelpText('afterAll', `
+当前状态:
+  环境:   ${config.env} (${ENV_URLS[config.env]})
+  登录:   ${loggedIn ? '已保存凭证' : '未登录'}
+  配置:   ${CONFIG_PATH}
+
+常用示例:
+  polaris env online
+  polaris login
+  polaris net list --uid 123 --status 500
+  polaris net get 100 --curl
+  polaris user 123 --env qa
+  polaris doctor`);
+}
+//# sourceMappingURL=help.js.map

package/dist/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE/D,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,MAAM,MAAM,GAAG,UAAU,EAAE,CAAA;IAC3B,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAA;IAC1D,OAAO;SACJ,kBAAkB,CAAC,0BAA0B,CAAC;SAC9C,wBAAwB,EAAE;SAC1B,WAAW,CAAC,WAAW,EAAE,4BAA4B,CAAC;SACtD,WAAW,CAAC,UAAU,EAAE;;UAEnB,MAAM,CAAC,GAAG,KAAK,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC;UACnC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK;UAC1B,WAAW;;;;;;;;iBAQJ,CAAC,CAAA;AAClB,CAAC"}

package/dist/utils/curl.d.ts

@@ -0,0 +1 @@
+export declare function generateCurl(request: Record<string, unknown>): string;

package/dist/utils/curl.js

@@ -0,0 +1,43 @@
+const MANAGED_HEADERS = new Set([
+    'content-length',
+    'host',
+    'connection',
+    'transfer-encoding',
+    'accept-encoding',
+]);
+function shellQuote(value) {
+    return `'${String(value).replace(/'/g, `'\\''`)}'`;
+}
+function parseHeaders(value) {
+    if (!value)
+        return {};
+    if (typeof value === 'object')
+        return value;
+    try {
+        const parsed = JSON.parse(String(value));
+        return parsed && typeof parsed === 'object' ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+export function generateCurl(request) {
+    const method = String(request.method || 'GET').toUpperCase();
+    const lines = [`curl --request ${method} ${shellQuote(request.url || '')}`];
+    for (const [key, rawValue] of Object.entries(parseHeaders(request.request_headers))) {
+        if (MANAGED_HEADERS.has(key.toLowerCase()))
+            continue;
+        const value = Array.isArray(rawValue)
+            ? rawValue.join(', ')
+            : typeof rawValue === 'object' && rawValue !== null
+                ? JSON.stringify(rawValue)
+                : String(rawValue ?? '');
+        lines.push(`  --header ${shellQuote(`${key}: ${value}`)}`);
+    }
+    const body = request.request_body;
+    if (body !== null && body !== undefined && body !== '') {
+        lines.push(`  --data-raw ${shellQuote(typeof body === 'string' ? body : JSON.stringify(body))}`);
+    }
+    return lines.join(' \\\n');
+}
+//# sourceMappingURL=curl.js.map

package/dist/utils/curl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"curl.js","sourceRoot":"","sources":["../../src/utils/curl.ts"],"names":[],"mappings":"AAAA,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IAC9B,gBAAgB;IAChB,MAAM;IACN,YAAY;IACZ,mBAAmB;IACnB,iBAAiB;CAClB,CAAC,CAAA;AAEF,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAA;AACpD,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAA;IACrB,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAgC,CAAA;IACtE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;QACxC,OAAO,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAiC,CAAC,CAAC,CAAC,EAAE,CAAA;IACtF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAgC;IAC3D,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAA;IAC5D,MAAM,KAAK,GAAG,CAAC,kBAAkB,MAAM,IAAI,UAAU,CAAC,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,CAAC,CAAA;IAC3E,KAAK,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC;QACpF,IAAI,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;YAAE,SAAQ;QACpD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;YACnC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;YACrB,CAAC,CAAC,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI;gBACjD,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;gBAC1B,CAAC,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAA;QAC5B,KAAK,CAAC,IAAI,CAAC,cAAc,UAAU,CAAC,GAAG,GAAG,KAAK,KAAK,EAAE,CAAC,EAAE,CAAC,CAAA;IAC5D,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,CAAC,YAAY,CAAA;IACjC,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;QACvD,KAAK,CAAC,IAAI,CAAC,gBAAgB,UAAU,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAA;IAClG,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;AAC5B,CAAC"}

package/dist/utils/format.d.ts

@@ -0,0 +1,8 @@
+export type TableValue = string | number | boolean | null | undefined;
+export declare function table(headers: string[], rows: TableValue[][], maxWidths?: number[]): string;
+export declare function printJson(value: unknown): void;
+export declare function formatDate(value: unknown): string;
+export declare function prettyContent(value: unknown): string;
+export declare function limitLines(value: string, maxLines: number): string;
+export declare function maskEmail(value: string): string;
+export declare function maskMobile(value: string): string;

package/dist/utils/format.js

@@ -0,0 +1,70 @@
+function text(value) {
+    if (value === null || value === undefined || value === '')
+        return '-';
+    return String(value).replace(/\r?\n/g, ' ');
+}
+function clipped(value, width) {
+    if (value.length <= width)
+        return value;
+    return `${value.slice(0, Math.max(1, width - 1))}…`;
+}
+export function table(headers, rows, maxWidths = []) {
+    const normalized = rows.map((row) => row.map(text));
+    const widths = headers.map((header, index) => {
+        const contentWidth = Math.max(header.length, ...normalized.map((row) => row[index]?.length ?? 0));
+        return Math.min(contentWidth, maxWidths[index] ?? 40);
+    });
+    const line = (row) => row.map((value, index) => clipped(value ?? '', widths[index]).padEnd(widths[index])).join('  ').trimEnd();
+    const separator = widths.map((width) => '─'.repeat(width)).join('  ');
+    return [line(headers), separator, ...normalized.map(line)].join('\n');
+}
+export function printJson(value) {
+    process.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
+}
+export function formatDate(value) {
+    if (value === null || value === undefined || value === '')
+        return '-';
+    const date = typeof value === 'number' ? new Date(value) : new Date(String(value));
+    return Number.isNaN(date.getTime()) ? String(value) : date.toLocaleString('zh-CN', { hour12: false });
+}
+export function prettyContent(value) {
+    if (value === null || value === undefined || value === '')
+        return '(空)';
+    if (typeof value !== 'string')
+        return JSON.stringify(value, null, 2);
+    try {
+        return JSON.stringify(JSON.parse(value), null, 2);
+    }
+    catch {
+        return value;
+    }
+}
+export function limitLines(value, maxLines) {
+    const lines = value.split(/\r?\n/);
+    if (lines.length <= maxLines)
+        return value;
+    return `${lines.slice(0, maxLines).join('\n')}\n…（已省略 ${lines.length - maxLines} 行，使用 --max-lines 调整）`;
+}
+export function maskEmail(value) {
+    if (!value)
+        return '';
+    const [name, domain] = value.split('@');
+    if (!domain)
+        return maskText(value);
+    const visible = name.length <= 2 ? name.slice(0, 1) : name.slice(0, 2);
+    return `${visible}${'*'.repeat(Math.max(2, name.length - visible.length))}@${domain}`;
+}
+export function maskMobile(value) {
+    const plain = value.trim();
+    if (!plain)
+        return '';
+    if (plain.length <= 5)
+        return maskText(plain);
+    return `${plain.slice(0, 3)}${'*'.repeat(plain.length - 5)}${plain.slice(-2)}`;
+}
+function maskText(value) {
+    if (value.length <= 1)
+        return '*';
+    return `${value[0]}${'*'.repeat(Math.max(2, value.length - 1))}`;
+}
+//# sourceMappingURL=format.js.map

package/dist/utils/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/utils/format.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,33 @@
 {
   "name": "@qs_cli/polaris-cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.4",
+  "description": "观星台命令行查询工具",
+  "type": "module",
+  "bin": {
+    "polaris": "dist/cli.js",
+    "polaris_cli": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.json && node -e \"require('fs').chmodSync('dist/cli.js',0o755)\"",
+    "start": "node dist/cli.js",
+    "check": "tsc -p tsconfig.json --noEmit"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "commander": "^13.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.3",
+    "typescript": "^5.8.3"
+  }
+}