i18-fe-automator-beta 2.1.5 → 2.1.7

package/dist/commonjs/index.js

@@ -1807,6 +1807,8 @@ const CACHE_KEY = "zentao"; // .cache/zentao: { account, password, zentaosid, pr
 
 // 需求列表展示与pull并发的上限
 const PLAN_STORY_TABLE_LIMIT = 50;
+// 需求列表表格中标题的最大展示长度(console.table单元格不换行, 超长截断)
+const STORY_TITLE_LIMIT = 30;
 const PULL_CONCURRENCY = 5;
 
 // 任务状态中文标签(close 命令展示用)
@@ -2215,7 +2217,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 +2228,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);
@@ -2752,8 +2754,8 @@ function writeCodeWorkspace(zentaoDir, planTitle, frontProjects, backProjects) {
 /**
  * plan --export 产出需求目录 .zentao-<计划名>/(产出契约见 .trae/documents/story-command-zentao.md 第4节):
  * tasks/manifest.json(对象结构: 顶部projects汇总全部涉及项目 + stories数组合并去重, 同storyID覆盖title/taskDir/projects, 按storyID数值排序)
- * + 每条需求 tasks/<taskDir>/task.md(同名taskDir已由 exportPlanStories 先删除, 此处全新写入)
- * plan.md 与 codex-*.md 是 workflow 的产物(重拉同名taskDir会连带删除, 确认关卡后不要再重导)
+ * + 每条需求 tasks/<taskDir>/task.md(同名taskDir的task.md与images/已由 exportPlanStories 先删除, 此处全新写入)
+ * plan.md 与 codex-*.md 是 workflow 的产物(重导时手术式刷新保留不覆盖, 但需求内容变了需AI自行判断是否重排)
  */
 function writeZentaoTasks({ plan, scope, stories, storyDetails, products, failed, storyImages, zentaoDir }) {
   const tasksDir = path.join(zentaoDir, "tasks");
@@ -2854,7 +2856,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 +2901,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([
@@ -2945,7 +2952,11 @@ async function showPlanDetail(zentaosid, selected) {
       );
       return {
         ID: s.id,
-        标题: s.title,
+        // console.table单元格不换行, 超长标题截断(完整标题可用 story detail 查看)
+        标题:
+          s.title.length > STORY_TITLE_LIMIT
+            ? `${s.title.slice(0, STORY_TITLE_LIMIT)}...`
+            : s.title,
         前端工时: isFront ? s.webestimate : "-",
         后端工时: Number(s.estimate) > 0 ? s.estimate : "-",
         poollist: s.poollist || "-",
@@ -2957,6 +2968,7 @@ async function showPlanDetail(zentaosid, selected) {
   console.log(
     chalk.blue("提示: ID 供 fe-it-beta story detail <需求ID> 使用(也可传需求url)")
   );
+  return stories;
 }
 
 // 导出动作(plan收尾交互使用): 按范围过滤需求, 拉详情并产出 .zentao-<计划名>/ + 工作区
@@ -3012,16 +3024,23 @@ async function exportPlanStories(zentaosid, selected, scope) {
   Loading$1.succeed(`拉取需求详情完成(${done}/${stories.length})`);
   // 需求目录: .zentao-<计划名>(多计划互不混目录)
   const zentaoDir = path.join(process.cwd(), zentaoDirNameOf(plan));
-  // 同名taskDir直接删除重导(重拉=全新快照, 连带清掉旧images与旧plan/codex报告; 失败条目保留旧数据)
+  // 同名taskDir手术式刷新: 只删task.md与images/重写, 保留plan.md/codex报告等AI产物; 失败条目保留旧数据
   stories.forEach((story) => {
     if (failed.has(String(story.id))) return;
     const dir = path.join(zentaoDir, "tasks", taskDirOf(story));
     if (isExistPath(dir)) {
-      fs.rmSync(dir, { recursive: true, force: true });
-      console.log(chalk.yellow(`同名任务目录已删除重导: ${taskDirOf(story)}`));
+      const taskMd = path.join(dir, "task.md");
+      if (isExistPath(taskMd)) fs.rmSync(taskMd, { force: true });
+      const imagesDir = path.join(dir, "images");
+      if (isExistPath(imagesDir)) {
+        fs.rmSync(imagesDir, { recursive: true, force: true });
+      }
+      console.log(
+        chalk.yellow(`同名任务目录已刷新(保留plan/报告): ${taskDirOf(story)}`)
+      );
     }
   });
-  // 图片本地化到 tasks/<taskDir>/images/(目录已删全量重下, 失败黄字不阻塞, 引用降级远程url)
+  // 图片本地化到 tasks/<taskDir>/images/(images/已删全量重下, 失败黄字不阻塞, 引用降级远程url)
   const storyImages = await downloadStoryImages({
     stories,
     storyDetails,
@@ -3047,11 +3066,13 @@ async function exportPlanStories(zentaosid, selected, scope) {
     scope === "back" || scope === "all"
       ? collectPoolProjects(stories, "back")
       : [];
-  if (frontProjects.length || backProjects.length) {
-    writeCodeWorkspace(zentaoDir, plan.title, frontProjects, backProjects);
-  } else {
-    console.log(chalk.yellow("本范围无关联项目, 跳过工作区生成"));
+  // 无pool时仍生成单目录工作区(只含需求目录自身, 打开仍能看manifest与task.md), 黄字提示补维护
+  if (!frontProjects.length && !backProjects.length) {
+    console.log(
+      chalk.yellow("本范围需求均未维护poollist, 工作区仅含需求目录, 维护后重跑可补齐项目")
+    );
   }
+  writeCodeWorkspace(zentaoDir, plan.title, frontProjects, backProjects);
 }
 
 /**
@@ -3125,7 +3146,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 +3746,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 +4018,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 +4046,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 +4079,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 +4098,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

@@ -1785,6 +1785,8 @@ const CACHE_KEY = "zentao"; // .cache/zentao: { account, password, zentaosid, pr
 
 // 需求列表展示与pull并发的上限
 const PLAN_STORY_TABLE_LIMIT = 50;
+// 需求列表表格中标题的最大展示长度(console.table单元格不换行, 超长截断)
+const STORY_TITLE_LIMIT = 30;
 const PULL_CONCURRENCY = 5;
 
 // 任务状态中文标签(close 命令展示用)
@@ -2193,7 +2195,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 +2206,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);
@@ -2730,8 +2732,8 @@ function writeCodeWorkspace(zentaoDir, planTitle, frontProjects, backProjects) {
 /**
  * plan --export 产出需求目录 .zentao-<计划名>/(产出契约见 .trae/documents/story-command-zentao.md 第4节):
  * tasks/manifest.json(对象结构: 顶部projects汇总全部涉及项目 + stories数组合并去重, 同storyID覆盖title/taskDir/projects, 按storyID数值排序)
- * + 每条需求 tasks/<taskDir>/task.md(同名taskDir已由 exportPlanStories 先删除, 此处全新写入)
- * plan.md 与 codex-*.md 是 workflow 的产物(重拉同名taskDir会连带删除, 确认关卡后不要再重导)
+ * + 每条需求 tasks/<taskDir>/task.md(同名taskDir的task.md与images/已由 exportPlanStories 先删除, 此处全新写入)
+ * plan.md 与 codex-*.md 是 workflow 的产物(重导时手术式刷新保留不覆盖, 但需求内容变了需AI自行判断是否重排)
  */
 function writeZentaoTasks({ plan, scope, stories, storyDetails, products, failed, storyImages, zentaoDir }) {
   const tasksDir = path.join(zentaoDir, "tasks");
@@ -2832,7 +2834,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 +2879,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([
@@ -2923,7 +2930,11 @@ async function showPlanDetail(zentaosid, selected) {
       );
       return {
         ID: s.id,
-        标题: s.title,
+        // console.table单元格不换行, 超长标题截断(完整标题可用 story detail 查看)
+        标题:
+          s.title.length > STORY_TITLE_LIMIT
+            ? `${s.title.slice(0, STORY_TITLE_LIMIT)}...`
+            : s.title,
         前端工时: isFront ? s.webestimate : "-",
         后端工时: Number(s.estimate) > 0 ? s.estimate : "-",
         poollist: s.poollist || "-",
@@ -2935,6 +2946,7 @@ async function showPlanDetail(zentaosid, selected) {
   console.log(
     chalk.blue("提示: ID 供 fe-it-beta story detail <需求ID> 使用(也可传需求url)")
   );
+  return stories;
 }
 
 // 导出动作(plan收尾交互使用): 按范围过滤需求, 拉详情并产出 .zentao-<计划名>/ + 工作区
@@ -2990,16 +3002,23 @@ async function exportPlanStories(zentaosid, selected, scope) {
   Loading.succeed(`拉取需求详情完成(${done}/${stories.length})`);
   // 需求目录: .zentao-<计划名>(多计划互不混目录)
   const zentaoDir = path.join(process.cwd(), zentaoDirNameOf(plan));
-  // 同名taskDir直接删除重导(重拉=全新快照, 连带清掉旧images与旧plan/codex报告; 失败条目保留旧数据)
+  // 同名taskDir手术式刷新: 只删task.md与images/重写, 保留plan.md/codex报告等AI产物; 失败条目保留旧数据
   stories.forEach((story) => {
     if (failed.has(String(story.id))) return;
     const dir = path.join(zentaoDir, "tasks", taskDirOf(story));
     if (isExistPath(dir)) {
-      fs.rmSync(dir, { recursive: true, force: true });
-      console.log(chalk.yellow(`同名任务目录已删除重导: ${taskDirOf(story)}`));
+      const taskMd = path.join(dir, "task.md");
+      if (isExistPath(taskMd)) fs.rmSync(taskMd, { force: true });
+      const imagesDir = path.join(dir, "images");
+      if (isExistPath(imagesDir)) {
+        fs.rmSync(imagesDir, { recursive: true, force: true });
+      }
+      console.log(
+        chalk.yellow(`同名任务目录已刷新(保留plan/报告): ${taskDirOf(story)}`)
+      );
     }
   });
-  // 图片本地化到 tasks/<taskDir>/images/(目录已删全量重下, 失败黄字不阻塞, 引用降级远程url)
+  // 图片本地化到 tasks/<taskDir>/images/(images/已删全量重下, 失败黄字不阻塞, 引用降级远程url)
   const storyImages = await downloadStoryImages({
     stories,
     storyDetails,
@@ -3025,11 +3044,13 @@ async function exportPlanStories(zentaosid, selected, scope) {
     scope === "back" || scope === "all"
       ? collectPoolProjects(stories, "back")
       : [];
-  if (frontProjects.length || backProjects.length) {
-    writeCodeWorkspace(zentaoDir, plan.title, frontProjects, backProjects);
-  } else {
-    console.log(chalk.yellow("本范围无关联项目, 跳过工作区生成"));
+  // 无pool时仍生成单目录工作区(只含需求目录自身, 打开仍能看manifest与task.md), 黄字提示补维护
+  if (!frontProjects.length && !backProjects.length) {
+    console.log(
+      chalk.yellow("本范围需求均未维护poollist, 工作区仅含需求目录, 维护后重跑可补齐项目")
+    );
   }
+  writeCodeWorkspace(zentaoDir, plan.title, frontProjects, backProjects);
 }
 
 /**
@@ -3103,7 +3124,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 +3724,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 +3996,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 +4024,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 +4057,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 +4076,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.7",
   "description": "i18-fe-automator-beta内测版本,只用于key: ''替换、检测中文规则等",
   "type": "module",
   "bin": {