i18-fe-automator-beta 2.1.5 → 2.1.6

package/dist/commonjs/index.js

@@ -2215,7 +2215,7 @@ async function selectProduct(zentaosid, cliOpts) {
             name: `#${p.id} ${p.name}`,
             value: p.id,
           })),
-          { name: "输入其他产品ID...", value: "__INPUT__" },
+          { name: "输入其他产品-计划ID(如: https://zentao.hongxinshop.com/zentao/productplan-browse-29.html 中的29)", value: "__INPUT__" },
         ],
       },
     ]);
@@ -2226,11 +2226,11 @@ async function selectProduct(zentaosid, cliOpts) {
   }
   const { id } = await inquirer.prompt([
     {
-      message: "请输入产品ID",
+      message: "请输入产品计划ID(如: https://zentao.hongxinshop.com/zentao/productplan-browse-29.html 中的29)",
       name: "id",
       type: "input",
       validate: (val) =>
-        /^\d+$/.test(String(val).trim()) || "请输入数字产品ID",
+        /^\d+$/.test(String(val).trim()) || "请输入数字产品计划ID",
     },
   ]);
   return resolveProduct(zentaosid, id);
@@ -2854,7 +2854,7 @@ function writeZentaoTasks({ plan, scope, stories, storyDetails, products, failed
   }
 }
 
-// 计划选取交互: 关键词过滤 > 命中1条自动选中 > rawlist选取
+// 计划选取交互: 关键词过滤(标题) > 命中1条自动选中 > rawlist选取
 async function selectPlan(plans, keyword) {
   if (keyword && String(keyword).trim()) {
     const kw = String(keyword).trim().toLowerCase();
@@ -2899,10 +2899,15 @@ async function loadPlanList(zentaosid, productID) {
   return plans;
 }
 
-// plan动作: 选中计划后展示计划信息 + 关联需求列表(ID供detail用)
+// plan动作: 选中计划后展示计划信息 + 关联需求列表(ID供detail用); 返回关联需求(供调用方判断空计划)
 async function showPlanDetail(zentaosid, selected) {
   Loading$1.start("拉取计划详情中...");
   const { plan, stories } = await fetchPlanDetail(zentaosid, selected.id);
+  // 0条需求时详情/工时统计均无意义, 一句话结束
+  if (!stories.length) {
+    Loading$1.succeed(`计划 #${plan.id} ${plan.title} 无关联需求`);
+    return stories;
+  }
   Loading$1.succeed("拉取计划详情成功");
   console.log(chalk.bold("\n计划信息"));
   console.table([
@@ -2957,6 +2962,7 @@ async function showPlanDetail(zentaosid, selected) {
   console.log(
     chalk.blue("提示: ID 供 fe-it-beta story detail <需求ID> 使用(也可传需求url)")
   );
+  return stories;
 }
 
 // 导出动作(plan收尾交互使用): 按范围过滤需求, 拉详情并产出 .zentao-<计划名>/ + 工作区
@@ -3125,7 +3131,7 @@ async function storyMain(action, cliOpts) {
     if (!match) {
       console.log(
         chalk.red(
-          "请传入项目ID(从禅道项目需求页url复制), 如: fe-it-beta story task 2915 或 fe-it-beta story task https://zentao.hongxinshop.com/zentao/project-story-2915.html"
+          "请传入项目-需求url的ID, 如: fe-it-beta story task 2915 或 fe-it-beta story task https://zentao.hongxinshop.com/zentao/project-story-2915.html"
         )
       );
       process.exit(1);
@@ -3725,7 +3731,7 @@ async function storyMain(action, cliOpts) {
     if (!match) {
       console.log(
         chalk.red(
-          "请传入项目ID(从禅道任务列表url复制), 如: fe-it-beta story close 2915 或 fe-it-beta story close https://zentao.hongxinshop.com/zentao/project-task-2915-myinvolved.html"
+          "请传入项目-任务-由我参与url的ID, 如: fe-it-beta story close 2915 或 fe-it-beta story close https://zentao.hongxinshop.com/zentao/project-task-2915-myinvolved.html"
         )
       );
       process.exit(1);
@@ -3997,10 +4003,26 @@ async function storyMain(action, cliOpts) {
   // plan: 产品选择 -> 计划选取 -> 展示 -> 导出(--export直通一键场景, 不传则收尾交互)
   const session = await ensureZentaoSession(cliOpts);
   await session.request(async (zentaosid) => {
-    const product = await selectProduct(zentaosid, cliOpts);
+    // 位置参数纯数字 = 产品计划ID(productplan-browse-<ID>.html 中的ID), 等同 --product 直通
+    const nameArg = String(cliOpts.name || "").trim();
+    const productIdArg = /^\d+$/.test(nameArg) ? nameArg : "";
+    const product = await selectProduct(zentaosid, {
+      ...cliOpts,
+      product: cliOpts.product || productIdArg,
+    });
     const plans = await loadPlanList(zentaosid, product.id);
-    const selected = await selectPlan(plans, cliOpts.name);
-    await showPlanDetail(zentaosid, selected);
+    // 该产品无计划时后续选取/详情/导出均无意义, 提前结束
+    if (!plans.length) {
+      console.log(chalk.yellow(`产品 #${product.id} ${product.name} 下无计划, 结束`));
+      return;
+    }
+    // 纯数字已用作产品ID, 非数字关键词仍按计划标题过滤
+    const selected = await selectPlan(plans, productIdArg ? "" : cliOpts.name);
+    const stories = await showPlanDetail(zentaosid, selected);
+    // 空计划提示已在showPlanDetail输出, 直接结束不进导出询问
+    if (!stories.length) {
+      return;
+    }
     // 导出范围: --export参数直通(一键场景) > 收尾交互(默认前端)
     let exportChoice;
     if (cliOpts.export !== undefined) {
@@ -4009,14 +4031,14 @@ async function storyMain(action, cliOpts) {
     } else {
       ({ exportChoice } = await inquirer.prompt([
         {
-          message: "是否导出需求文件(按计划生成 .zentao-<计划名>目录)?",
+          message: `是否导出需求文件(按计划生成 .zentao-<计划名>目录, ${chalk.red("目前导出功能只适用于claude code批量建任务")})?`,
           name: "exportChoice",
           type: "list",
           choices: [
-            { name: "导出: 前端需求", value: "front" }, // 默认第一项
+            { name: "否", value: "none" }, // 默认第一项
+            { name: "导出: 前端需求", value: "front" },
             { name: "导出: 后端需求", value: "back" },
             { name: "导出: 全部需求", value: "all" },
-            { name: "否", value: "none" },
           ],
         },
       ]));
@@ -4042,7 +4064,7 @@ function registerStoryCommand(program, { markHandled, addHelpExample }) {
     .option("--username <name>", "禅道账号(story命令用)")
     .option("--password <pwd>", "禅道密码(story命令用, 日常建议用--cache)")
     .option("--cache", "凭据静默走缓存")
-    .option("--product <id>", "禅道产品ID(plan用, 不传则交互选择)")
+    .option("--product <id>", "禅道产品计划ID(plan用, 即productplan-browse-<ID>.html中的ID, 不传则交互选择)")
     .option("--export <scope>", "plan导出范围: front|back|all(传了跳过收尾询问直接导出)")
     .option("--type <t>", "task任务类型: front|back(传了跳过类型询问与确认, 一键创建)")
     .option("--split", "task时创建父任务并自动拆分子任务(>8h, 每个8h末个补余); subtask时跳过确认直接拆")
@@ -4061,6 +4083,7 @@ function registerStoryCommand(program, { markHandled, addHelpExample }) {
   // help示例经 helpers 注入 index.js 的 helpExamples, 自动参与列对齐
   addHelpExample("fe-it-beta story login", "禅道登录, 缓存zentaosid");
   addHelpExample("fe-it-beta story plan --product 87", "选计划看列表, 交互选导出");
+  addHelpExample("fe-it-beta story plan 29", "29=产品计划ID(productplan-browse-29.html), 拉计划列表再选取");
   addHelpExample("fe-it-beta story detail 需求ID", "按需求ID查看详情");
   addHelpExample("fe-it-beta story task 项目ID", "选项目勾选需求, 交互建禅道任务");
   addHelpExample(

package/dist/esm/index.mjs

@@ -2193,7 +2193,7 @@ async function selectProduct(zentaosid, cliOpts) {
             name: `#${p.id} ${p.name}`,
             value: p.id,
           })),
-          { name: "输入其他产品ID...", value: "__INPUT__" },
+          { name: "输入其他产品-计划ID(如: https://zentao.hongxinshop.com/zentao/productplan-browse-29.html 中的29)", value: "__INPUT__" },
         ],
       },
     ]);
@@ -2204,11 +2204,11 @@ async function selectProduct(zentaosid, cliOpts) {
   }
   const { id } = await inquirer.prompt([
     {
-      message: "请输入产品ID",
+      message: "请输入产品计划ID(如: https://zentao.hongxinshop.com/zentao/productplan-browse-29.html 中的29)",
       name: "id",
       type: "input",
       validate: (val) =>
-        /^\d+$/.test(String(val).trim()) || "请输入数字产品ID",
+        /^\d+$/.test(String(val).trim()) || "请输入数字产品计划ID",
     },
   ]);
   return resolveProduct(zentaosid, id);
@@ -2832,7 +2832,7 @@ function writeZentaoTasks({ plan, scope, stories, storyDetails, products, failed
   }
 }
 
-// 计划选取交互: 关键词过滤 > 命中1条自动选中 > rawlist选取
+// 计划选取交互: 关键词过滤(标题) > 命中1条自动选中 > rawlist选取
 async function selectPlan(plans, keyword) {
   if (keyword && String(keyword).trim()) {
     const kw = String(keyword).trim().toLowerCase();
@@ -2877,10 +2877,15 @@ async function loadPlanList(zentaosid, productID) {
   return plans;
 }
 
-// plan动作: 选中计划后展示计划信息 + 关联需求列表(ID供detail用)
+// plan动作: 选中计划后展示计划信息 + 关联需求列表(ID供detail用); 返回关联需求(供调用方判断空计划)
 async function showPlanDetail(zentaosid, selected) {
   Loading.start("拉取计划详情中...");
   const { plan, stories } = await fetchPlanDetail(zentaosid, selected.id);
+  // 0条需求时详情/工时统计均无意义, 一句话结束
+  if (!stories.length) {
+    Loading.succeed(`计划 #${plan.id} ${plan.title} 无关联需求`);
+    return stories;
+  }
   Loading.succeed("拉取计划详情成功");
   console.log(chalk.bold("\n计划信息"));
   console.table([
@@ -2935,6 +2940,7 @@ async function showPlanDetail(zentaosid, selected) {
   console.log(
     chalk.blue("提示: ID 供 fe-it-beta story detail <需求ID> 使用(也可传需求url)")
   );
+  return stories;
 }
 
 // 导出动作(plan收尾交互使用): 按范围过滤需求, 拉详情并产出 .zentao-<计划名>/ + 工作区
@@ -3103,7 +3109,7 @@ async function storyMain(action, cliOpts) {
     if (!match) {
       console.log(
         chalk.red(
-          "请传入项目ID(从禅道项目需求页url复制), 如: fe-it-beta story task 2915 或 fe-it-beta story task https://zentao.hongxinshop.com/zentao/project-story-2915.html"
+          "请传入项目-需求url的ID, 如: fe-it-beta story task 2915 或 fe-it-beta story task https://zentao.hongxinshop.com/zentao/project-story-2915.html"
         )
       );
       process.exit(1);
@@ -3703,7 +3709,7 @@ async function storyMain(action, cliOpts) {
     if (!match) {
       console.log(
         chalk.red(
-          "请传入项目ID(从禅道任务列表url复制), 如: fe-it-beta story close 2915 或 fe-it-beta story close https://zentao.hongxinshop.com/zentao/project-task-2915-myinvolved.html"
+          "请传入项目-任务-由我参与url的ID, 如: fe-it-beta story close 2915 或 fe-it-beta story close https://zentao.hongxinshop.com/zentao/project-task-2915-myinvolved.html"
         )
       );
       process.exit(1);
@@ -3975,10 +3981,26 @@ async function storyMain(action, cliOpts) {
   // plan: 产品选择 -> 计划选取 -> 展示 -> 导出(--export直通一键场景, 不传则收尾交互)
   const session = await ensureZentaoSession(cliOpts);
   await session.request(async (zentaosid) => {
-    const product = await selectProduct(zentaosid, cliOpts);
+    // 位置参数纯数字 = 产品计划ID(productplan-browse-<ID>.html 中的ID), 等同 --product 直通
+    const nameArg = String(cliOpts.name || "").trim();
+    const productIdArg = /^\d+$/.test(nameArg) ? nameArg : "";
+    const product = await selectProduct(zentaosid, {
+      ...cliOpts,
+      product: cliOpts.product || productIdArg,
+    });
     const plans = await loadPlanList(zentaosid, product.id);
-    const selected = await selectPlan(plans, cliOpts.name);
-    await showPlanDetail(zentaosid, selected);
+    // 该产品无计划时后续选取/详情/导出均无意义, 提前结束
+    if (!plans.length) {
+      console.log(chalk.yellow(`产品 #${product.id} ${product.name} 下无计划, 结束`));
+      return;
+    }
+    // 纯数字已用作产品ID, 非数字关键词仍按计划标题过滤
+    const selected = await selectPlan(plans, productIdArg ? "" : cliOpts.name);
+    const stories = await showPlanDetail(zentaosid, selected);
+    // 空计划提示已在showPlanDetail输出, 直接结束不进导出询问
+    if (!stories.length) {
+      return;
+    }
     // 导出范围: --export参数直通(一键场景) > 收尾交互(默认前端)
     let exportChoice;
     if (cliOpts.export !== undefined) {
@@ -3987,14 +4009,14 @@ async function storyMain(action, cliOpts) {
     } else {
       ({ exportChoice } = await inquirer.prompt([
         {
-          message: "是否导出需求文件(按计划生成 .zentao-<计划名>目录)?",
+          message: `是否导出需求文件(按计划生成 .zentao-<计划名>目录, ${chalk.red("目前导出功能只适用于claude code批量建任务")})?`,
           name: "exportChoice",
           type: "list",
           choices: [
-            { name: "导出: 前端需求", value: "front" }, // 默认第一项
+            { name: "否", value: "none" }, // 默认第一项
+            { name: "导出: 前端需求", value: "front" },
             { name: "导出: 后端需求", value: "back" },
             { name: "导出: 全部需求", value: "all" },
-            { name: "否", value: "none" },
           ],
         },
       ]));
@@ -4020,7 +4042,7 @@ function registerStoryCommand(program, { markHandled, addHelpExample }) {
     .option("--username <name>", "禅道账号(story命令用)")
     .option("--password <pwd>", "禅道密码(story命令用, 日常建议用--cache)")
     .option("--cache", "凭据静默走缓存")
-    .option("--product <id>", "禅道产品ID(plan用, 不传则交互选择)")
+    .option("--product <id>", "禅道产品计划ID(plan用, 即productplan-browse-<ID>.html中的ID, 不传则交互选择)")
     .option("--export <scope>", "plan导出范围: front|back|all(传了跳过收尾询问直接导出)")
     .option("--type <t>", "task任务类型: front|back(传了跳过类型询问与确认, 一键创建)")
     .option("--split", "task时创建父任务并自动拆分子任务(>8h, 每个8h末个补余); subtask时跳过确认直接拆")
@@ -4039,6 +4061,7 @@ function registerStoryCommand(program, { markHandled, addHelpExample }) {
   // help示例经 helpers 注入 index.js 的 helpExamples, 自动参与列对齐
   addHelpExample("fe-it-beta story login", "禅道登录, 缓存zentaosid");
   addHelpExample("fe-it-beta story plan --product 87", "选计划看列表, 交互选导出");
+  addHelpExample("fe-it-beta story plan 29", "29=产品计划ID(productplan-browse-29.html), 拉计划列表再选取");
   addHelpExample("fe-it-beta story detail 需求ID", "按需求ID查看详情");
   addHelpExample("fe-it-beta story task 项目ID", "选项目勾选需求, 交互建禅道任务");
   addHelpExample(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "i18-fe-automator-beta",
-  "version": "2.1.5",
+  "version": "2.1.6",
   "description": "i18-fe-automator-beta内测版本,只用于key: ''替换、检测中文规则等",
   "type": "module",
   "bin": {