ability-cli 0.3.0 → 0.3.1

package/dist/index.js

@@ -278,13 +278,19 @@ function registerRawCommand(program2) {
     const res = await apiGet(ctx, agentPath.abilityList, params);
     handleApiResponse(res, opts.json, (data) => printAbilityTable(data));
   });
-  raw.command("app-info").description("GET \u5E94\u7528\u4FE1\u606F").requiredOption("--package-name <pkg>", "\u5E94\u7528\u5305\u540D").option("--json", "JSON \u8F93\u51FA").action(async (opts) => {
+  raw.command("app-info").description("GET \u5E94\u7528\u4FE1\u606F").addHelpText(
+    "after",
+    "\n\u63D0\u793A\uFF1A\u9009\u9879\u8BF4\u660E\u4E2D\u4EE5\u300C\u3010\u5FC5\u586B\u3011\u300D\u5F00\u5934\u7684\u5FC5\u987B\u63D0\u4F9B\uFF0C\u5176\u4F59\u5747\u4E3A\u53EF\u9009\u3002\n"
+  ).requiredOption("--package-name <pkg>", "\u3010\u5FC5\u586B\u3011\u5E94\u7528\u5305\u540D").option("--json", "JSON \u8F93\u51FA").action(async (opts) => {
     const merged = { ...program2.opts(), ...opts };
     const ctx = buildAgentRequestContext(merged);
     const res = await apiGet(ctx, agentPath.appInfo, { packageName: opts.packageName });
     handleApiResponse(res, opts.json, (data) => printJson(data));
   });
-  raw.command("ability-info").description("GET \u80FD\u529B\u8BE6\u60C5").requiredOption("--ability-id <id>", "\u80FD\u529BID").option("--device-id <id>", "\u8BBE\u5907 ID\uFF1B\u7AEF\u4FA7\u80FD\u529B\u5EFA\u8BAE\u586B\u5199").option("--json", "JSON \u8F93\u51FA").action(async (opts) => {
+  raw.command("ability-info").description("GET \u80FD\u529B\u8BE6\u60C5").addHelpText(
+    "after",
+    "\n\u63D0\u793A\uFF1A\u9009\u9879\u8BF4\u660E\u4E2D\u4EE5\u300C\u3010\u5FC5\u586B\u3011\u300D\u5F00\u5934\u7684\u5FC5\u987B\u63D0\u4F9B\uFF0C\u5176\u4F59\u5747\u4E3A\u53EF\u9009\u3002\n"
+  ).requiredOption("--ability-id <id>", "\u3010\u5FC5\u586B\u3011\u80FD\u529B ID").option("--device-id <id>", "\u8BBE\u5907 ID\uFF1B\u7AEF\u4FA7\u80FD\u529B\u5EFA\u8BAE\u586B\u5199").option("--json", "JSON \u8F93\u51FA").action(async (opts) => {
     const merged = { ...program2.opts(), ...opts };
     const ctx = buildAgentRequestContext(merged);
     const params = { abilityId: opts.abilityId };
@@ -292,7 +298,10 @@ function registerRawCommand(program2) {
     const res = await apiGet(ctx, agentPath.abilityInfo, params);
     handleApiResponse(res, opts.json, (data) => printJson(data));
   });
-  raw.command("call").description("POST \u6267\u884C\u80FD\u529B\uFF08Agent API\uFF09").requiredOption("--file <path>", "\u8BF7\u6C42\u4F53 JSON \u6587\u4EF6\u8DEF\u5F84").option("--json", "JSON \u8F93\u51FA").action(async (opts) => {
+  raw.command("call").description("POST \u6267\u884C\u80FD\u529B\uFF08Agent API\uFF09").addHelpText(
+    "after",
+    "\n\u63D0\u793A\uFF1A\u9009\u9879\u8BF4\u660E\u4E2D\u4EE5\u300C\u3010\u5FC5\u586B\u3011\u300D\u5F00\u5934\u7684\u5FC5\u987B\u63D0\u4F9B\uFF0C\u5176\u4F59\u5747\u4E3A\u53EF\u9009\u3002\n"
+  ).requiredOption("--file <path>", "\u3010\u5FC5\u586B\u3011\u8BF7\u6C42\u4F53 JSON \u6587\u4EF6\u8DEF\u5F84").option("--json", "JSON \u8F93\u51FA").action(async (opts) => {
     const merged = { ...program2.opts(), ...opts };
     const ctx = buildAgentRequestContext(merged);
     const data = JSON.parse(fs2.readFileSync(opts.file, "utf-8"));
@@ -358,7 +367,10 @@ function generateTemplate(schema) {
   return result;
 }
 function registerInspectCommand(program2) {
-  program2.command("inspect").description("\u67E5\u770B\u80FD\u529B\u8BE6\u60C5\u4E0E inputSchema").requiredOption("--ability-id <id>", "\u80FD\u529BID").option("--device-id <id>", "\u8BBE\u5907 ID\uFF1B\u7AEF\u4FA7\u80FD\u529B\u5EFA\u8BAE\u586B\u5199").option("--gen-template", "\u751F\u6210\u53C2\u6570\u6A21\u677F JSON").option("--json", "JSON \u8F93\u51FA").action(async (opts) => {
+  program2.command("inspect").description("\u67E5\u770B\u80FD\u529B\u8BE6\u60C5\u4E0E inputSchema").addHelpText(
+    "after",
+    "\n\u63D0\u793A\uFF1A\u9009\u9879\u8BF4\u660E\u4E2D\u4EE5\u300C\u3010\u5FC5\u586B\u3011\u300D\u5F00\u5934\u7684\u5FC5\u987B\u63D0\u4F9B\uFF0C\u5176\u4F59\u5747\u4E3A\u53EF\u9009\u3002\n"
+  ).requiredOption("--ability-id <id>", "\u3010\u5FC5\u586B\u3011\u80FD\u529B ID").option("--device-id <id>", "\u8BBE\u5907 ID\uFF1B\u7AEF\u4FA7\u80FD\u529B\u5EFA\u8BAE\u586B\u5199").option("--gen-template", "\u751F\u6210\u53C2\u6570\u6A21\u677F JSON").option("--json", "JSON \u8F93\u51FA").action(async (opts) => {
     const merged = { ...program2.opts(), ...opts };
     const ctx = buildAgentRequestContext(merged);
     const params = { abilityId: opts.abilityId };
@@ -377,8 +389,33 @@ function registerInspectCommand(program2) {
 // src/commands/exec.ts
 import { randomUUID } from "crypto";
 import fs3 from "fs";
+
+// src/parse-cli-json.ts
+function parseCliJsonString(raw, label) {
+  const s = raw.replace(/^\uFEFF/, "").trim();
+  if (!s) return {};
+  try {
+    return JSON.parse(s);
+  } catch (e) {
+    const msg = e instanceof Error ? e.message : String(e);
+    let hint = "";
+    if (/^\s*\{\s*'/.test(s)) {
+      hint = " JSON \u952E\u540D\u987B\u7528\u82F1\u6587\u53CC\u5F15\u53F7\uFF1B\u5F53\u524D\u5185\u5BB9\u5728 { \u540E\u51FA\u73B0\u4E86\u5355\u5F15\u53F7\u3002\u6700\u7A33\u59A5\uFF1A\u5C06 JSON \u5B58\u4E3A params.json\uFF08UTF-8\uFF09\uFF0C\u518D\u4F7F\u7528 --params params.json\u3002";
+    } else if (/[\u201c\u201d\u2018\u2019]/.test(s)) {
+      hint = ' \u68C0\u6D4B\u5230\u5F2F\u5F15\u53F7\uFF08\u201C \u201D \u2018 \u2019\uFF09\u3002\u8BF7\u6539\u4E3A ASCII \u53CC\u5F15\u53F7 " \u3002';
+    }
+    const preview = s.length > 160 ? `${s.slice(0, 160)}\u2026` : s;
+    throw new Error(`${label} \u89E3\u6790\u5931\u8D25\uFF1A${msg}.${hint}
+\u5B9E\u9645\u6536\u5230\u7684\u5F00\u5934\uFF1A${JSON.stringify(preview.slice(0, 80))}`);
+  }
+}
+
+// src/commands/exec.ts
 function registerExecCommand(program2) {
-  program2.command("exec").description("\u6267\u884C\u80FD\u529B").requiredOption("--ability-id <id>", "\u80FD\u529BID").option("--params <json>", "\u53C2\u6570 JSON \u5B57\u7B26\u4E32\u6216\u6587\u4EF6\u8DEF\u5F84").option("--device-id <id>", "\u8BBE\u5907ID").option("--message-id <id>", "messageId").option("--trace-id <id>", "traceId").option("--timeout <ms>", "\u8D85\u65F6\uFF08\u6BEB\u79D2\uFF09\uFF1B\u4E0D\u4F20\u5219\u7528\u914D\u7F6E\u6587\u4EF6 defaults.timeout\uFF0C\u9ED8\u8BA4 30000").option("--response-type <type>", "\u8FD4\u56DE\u503C\u5904\u7406\u65B9\u5F0F: NONE | MCP | CONVERT").option("--json", "JSON \u8F93\u51FA").action(async (opts) => {
+  program2.command("exec").description("\u6267\u884C\u80FD\u529B").addHelpText(
+    "after",
+    "\n\u63D0\u793A\uFF1A\u9009\u9879\u8BF4\u660E\u4E2D\u4EE5\u300C\u3010\u5FC5\u586B\u3011\u300D\u5F00\u5934\u7684\u5FC5\u987B\u63D0\u4F9B\uFF0C\u5176\u4F59\u5747\u4E3A\u53EF\u9009\u3002\n"
+  ).requiredOption("--ability-id <id>", "\u3010\u5FC5\u586B\u3011\u80FD\u529B ID").option("--params <json>", "\u53C2\u6570 JSON \u5B57\u7B26\u4E32\u6216\u6587\u4EF6\u8DEF\u5F84").option("--device-id <id>", "\u8BBE\u5907ID").option("--message-id <id>", "messageId").option("--trace-id <id>", "traceId").option("--timeout <ms>", "\u8D85\u65F6\uFF08\u6BEB\u79D2\uFF09\uFF1B\u4E0D\u4F20\u5219\u7528\u914D\u7F6E\u6587\u4EF6 defaults.timeout\uFF0C\u9ED8\u8BA4 30000").option("--response-type <type>", "\u8FD4\u56DE\u503C\u5904\u7406\u65B9\u5F0F: NONE | MCP | CONVERT").option("--json", "JSON \u8F93\u51FA").action(async (opts) => {
     const merged = { ...program2.opts(), ...opts };
     const ctx = buildAgentRequestContext(merged);
     const cliCfg = loadConfig();
@@ -386,9 +423,10 @@ function registerExecCommand(program2) {
     let params = {};
     if (opts.params) {
       if (fs3.existsSync(opts.params)) {
-        params = JSON.parse(fs3.readFileSync(opts.params, "utf-8"));
+        const text = fs3.readFileSync(opts.params, "utf-8");
+        params = parseCliJsonString(text, "\u53C2\u6570\u6587\u4EF6");
       } else {
-        params = JSON.parse(opts.params);
+        params = parseCliJsonString(opts.params, "--params");
       }
     }
     const body = {
@@ -462,9 +500,10 @@ function registerDoctorCommand(program2) {
     console.log(chalk3.bold.cyan("\n\u2500\u2500 CLI \u5065\u5EB7\u68C0\u67E5 \u2500\u2500\n"));
     const configPath = getDefaultConfigPath();
     const config = loadConfig();
+    const effectiveEnv = process.env.ABILITY_CLI_ENV ?? merged.env ?? config.env;
     const checks = [
       ["\u914D\u7F6E\u6587\u4EF6", configPath, true],
-      ["\u5F53\u524D\u73AF\u5883", config.env, true],
+      ["\u5F53\u524D\u73AF\u5883", effectiveEnv, true],
       ["baseUrl", ctx.baseUrl || "(\u7A7A)", !!ctx.baseUrl],
       ["Authorization(sk)", ctx.authToken ? "******" : "(\u7A7A)", !!ctx.authToken],
       ["zy-device-id", ctx.deviceId || "(\u7A7A)", !!ctx.deviceId]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ability-cli",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "原子能力平台 CLI 工具",
   "repository": {
     "type": "git",