@newbeebox/newbeebox-app-engine-cli 1.1.0 → 1.3.0

package/README.md

@@ -61,6 +61,7 @@ nae apps
 |------|------|
 | `nae whoami` | 当前身份（uid/用户名/角色/命名空间） |
 | `nae quota` | 配额用量（CPU/内存/存储/应用数 的 已用/上限） |
+| `nae llm` | 内置 LLM 网关状态：月度额度/本月用量/令牌前缀/内置环境变量名/按模型明细 |
 | `nae config` | 查看本地配置（密钥脱敏） |
 
 ### 应用

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@newbeebox/newbeebox-app-engine-cli",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "NewBee App Engine 命令行客户端（nae）——参数直达、默认人类可读（加 -o json 出 JSON），便于在终端使用与脚本/管道里解析。",
   "type": "module",
   "bin": {

package/src/index.js

@@ -2,6 +2,7 @@
 // nae —— NewBee App Engine 命令行客户端。
 // 设计：薄壳。每条命令只做「取配置 → 调一个 HTTP 原语 → JSON 出 stdout」，
 // 鉴权/网络/业务错误集中在 run() 归类处理，命令体里不写 try/catch。
+import { readFileSync } from 'fs'
 import { Command } from 'commander'
 import { load, save, configPath } from './config.js'
 import { request, AuthError, NetworkError } from './http.js'
@@ -14,7 +15,7 @@ const program = new Command()
 program
   .name('nae')
   .description('NewBee App Engine CLI —— 默认人类可读，-o json 输出 JSON 供脚本解析')
-  .version('1.1.0')
+  .version('1.3.0')
   .option('--base-url <url>', '覆盖平台地址（也可用环境变量 NAE_BASE_URL）')
   .option('--token <token>', '覆盖访问密钥（也可用环境变量 NAE_TOKEN）')
   .option('-o, --output <format>', '输出格式：text（默认，人类可读）| json', 'text')
@@ -72,6 +73,25 @@ function parseJSONArg(label, s) {
   }
 }
 
+// 环境变量来源：--env-file 优先（从文件读 JSON，绕开 shell 引号），否则 --env 内联 JSON。
+// 两者都没给返回 undefined（create 表示不带 env / update 表示不改 env）。
+function envFromOpts(opts) {
+  if (opts.envFile !== undefined) {
+    let raw
+    try {
+      raw = readFileSync(opts.envFile, 'utf8')
+    } catch (e) {
+      throw new Error(`--env-file 读取失败：${opts.envFile}（${e.message}）`)
+    }
+    try {
+      return JSON.parse(raw)
+    } catch {
+      throw new Error(`--env-file 内容不是合法 JSON：${opts.envFile}`)
+    }
+  }
+  return parseJSONArg('--env', opts.env)
+}
+
 // --- 认证 ---
 
 program
@@ -129,6 +149,15 @@ program
     })
   )
 
+program
+  .command('llm')
+  .description('查询内置 LLM 网关状态：月度额度/本月用量/令牌前缀/内置环境变量名/按模型用量明细')
+  .action(
+    run(async () => {
+      emit(await request(cfg(), 'GET', '/me/llm'))
+    })
+  )
+
 // --- 应用 ---
 
 program
@@ -174,6 +203,7 @@ program
   .option('--storage <size>', '模板应用：持久卷大小，如 10Gi')
   .option('--replicas <n>', '副本数', (v) => parseInt(v, 10))
   .option('--env <json>', '环境变量 JSON，如 \'{"KEY":"val"}\'')
+  .option('--env-file <path>', '从文件读环境变量 JSON（绕开 Windows PowerShell 引号问题；与 --env 二选一，优先 --env-file）')
   .option(
     '--config <json>',
     "模板应用的服务特性参数 JSON。可用字段随模板而定，运行 'nae templates' 看每个模板的 ConfigSchema（key/类型/默认值/可选项）。redis: {\"password\",\"persistence\":\"rdb|aof|none\"}；postgres: {\"database\",\"username\",\"password\"}；milvus: {\"root_password\"}"
@@ -217,7 +247,7 @@ program
         template_key: opts.template,
         storage_size: opts.storage,
         replicas: opts.replicas,
-        env: parseJSONArg('--env', opts.env),
+        env: envFromOpts(opts),
         config: parseJSONArg('--config', opts.config),
         owner_id: opts.owner,
       }
@@ -225,6 +255,48 @@ program
     })
   )
 
+program
+  .command('update <appid>')
+  .description(
+    '修改应用配置（端口/资源/env/跟踪tag/重启上限/路由前缀）。读-改-写：只覆盖你传的字段，其余保持不变。改后需 restart（运行中）或下次 start 才生效。env/端口/tag/前缀仅普通应用可改；AppID/类型/归属/存储/模板不可改（需删除重建）'
+  )
+  .option('--port <n>', '容器端口（仅普通应用）', (v) => parseInt(v, 10))
+  .option('--cpu <limit>', 'CPU 上限，如 1 / 500m')
+  .option('--mem <limit>', '内存上限，如 512Mi / 1Gi')
+  .option('--tag <tag>', '跟踪的镜像 tag（仅普通应用）')
+  .option('--max-restarts <n>', '失败重启上限，0=不封顶（仅普通应用）', (v) => parseInt(v, 10))
+  .option('--keep-path-prefix', '不剥离 /apps/<appid> 前缀（仅普通应用）')
+  .option('--strip-path-prefix', '剥离 /apps/<appid> 前缀（仅普通应用；与 --keep-path-prefix 互斥）')
+  .option('--env <json>', '环境变量 JSON（整体替换，仅普通应用）')
+  .option('--env-file <path>', '从文件读环境变量 JSON（整体替换；绕开 PowerShell 引号；与 --env 二选一，优先 --env-file）')
+  .action(
+    run(async (appid, opts) => {
+      if (opts.keepPathPrefix && opts.stripPathPrefix) {
+        throw new Error('--keep-path-prefix 与 --strip-path-prefix 互斥，只能给一个')
+      }
+      const c = cfg()
+      // 读-改-写：PATCH 是整体替换语义，必须以当前配置为基线，只覆盖本次传入的字段，
+      // 否则没传的字段会被抹成零值。三态 path 前缀：两个 flag 都不传则沿用当前值。
+      const cur = await request(c, 'GET', `/apps/${appid}`)
+      const envOverride = envFromOpts(opts)
+      const body = {
+        cpu_limit: opts.cpu ?? cur.CPULimit,
+        mem_limit: opts.mem ?? cur.MemLimit,
+        container_port: opts.port ?? cur.ContainerPort,
+        tracked_tag: opts.tag ?? cur.TrackedTag,
+        max_restarts: opts.maxRestarts ?? cur.MaxRestarts,
+        keep_path_prefix: opts.keepPathPrefix
+          ? true
+          : opts.stripPathPrefix
+            ? false
+            : cur.KeepPathPrefix,
+        env: envOverride ?? JSON.parse(cur.EnvJSON || '{}'),
+        sensitive_keys: JSON.parse(cur.SensitiveEnvJSON || '[]'),
+      }
+      emit(await request(c, 'PATCH', `/apps/${appid}`, { body }))
+    })
+  )
+
 program
   .command('delete <appid>')
   .description('删除应用（模板级联清子服务/PVC/secret），幂等')