i18-fe-automator-beta 2.1.6 → 2.1.8

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 命令展示用)
@@ -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");
@@ -2875,6 +2877,8 @@ async function selectPlan(plans, keyword) {
       message: "请选择计划",
       name: "plan",
       type: "rawlist",
+      // 到列表边界停止, 不循环回第一条
+      loop: false,
       choices: plans.map((p) => ({
         name: `#${p.id} ${p.title} [${p.begin} ~ ${p.end}] (${
           p.stories ?? 0
@@ -2950,7 +2954,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 || "-",
@@ -2965,9 +2973,64 @@ async function showPlanDetail(zentaosid, selected) {
   return stories;
 }
 
-// 导出动作(plan收尾交互使用): 按范围过滤需求, 拉详情并产出 .zentao-<计划名>/ + 工作区
+// 按导出范围过滤需求: front=有前端工时 | back=有后端工时 | all=全部
+function filterStoriesByScope(stories, scope) {
+  return stories.filter((s) => {
+    if (scope === "front") return Number(s.webestimate) > 0;
+    if (scope === "back") return Number(s.estimate) > 0;
+    return true;
+  });
+}
+
+// 导出前下一步: 列出范围内需求供勾选(「全选」与子项父子联动, 复用 CheckboxAllPrompt)
+// 返回勾选的需求数组; 未勾选任何项返回[](调用方据此跳过导出)
+async function selectExportStories(stories, scope) {
+  const scoped = filterStoriesByScope(stories, scope);
+  // 工时展示跟随导出范围: front只展示前端工时 / back只展示后端工时 / all全展示
+  const hoursOf = (s) => {
+    const w = Number(s.webestimate) > 0 ? `${s.webestimate}h` : "-";
+    const e = Number(s.estimate) > 0 ? `${s.estimate}h` : "-";
+    if (scope === "front") return `(前端${w})`;
+    if (scope === "back") return `(后端${e})`;
+    return `(前端${w}/后端${e})`;
+  };
+  // prompt 注册幂等, 与 upload.js 各自使用前注册
+  inquirer.registerPrompt("checkbox-all", CheckboxAllPrompt);
+  // 需求选项拼接序号, 与数字键选择对应(按2选第一个需求...); 「全选」不占序号, 固定首项无前缀
+  const choices = [
+    {
+      name: `全选(共${scoped.length}条)`,
+      value: SELECT_ALL,
+      short: "全选",
+      // 默认全选(与全部子项联动一致)
+      checked: true,
+    },
+    ...scoped.map((s, index) => ({
+      name: `${index + 1}. #${s.id} ${s.title} ${hoursOf(s)}`,
+      value: String(s.id),
+      short: `#${s.id}`,
+      checked: true,
+    })),
+  ];
+  const { picked } = await inquirer.prompt([
+    {
+      message: `请勾选要导出的需求(空格选择, 回车确认; 「全选」与单个需求联动)`,
+      name: "picked",
+      type: "checkbox-all",
+      // 到列表边界停止, 不循环回第一条
+      loop: false,
+      choices,
+    },
+  ]);
+  // 全选勾上时返回值含哨兵值, 一并忽略后按ID过滤
+  const ids = new Set(picked.filter((v) => v !== SELECT_ALL));
+  return scoped.filter((s) => ids.has(String(s.id)));
+}
+
+// 导出动作(plan收尾交互使用): 按范围过滤需求(交互勾选时再按pickedIds收窄), 拉详情并产出 .zentao-<计划名>/ + 工作区
 // scope: front=有前端工时的需求 | back=有后端工时的需求 | all=全部
-async function exportPlanStories(zentaosid, selected, scope) {
+// pickedIds: 交互勾选的需求ID集合(Set); 未传(--export直通一键场景)为范围内全量
+async function exportPlanStories(zentaosid, selected, scope, pickedIds) {
   const scopeLabel =
     scope === "front" ? "前端" : scope === "back" ? "后端" : "全部";
   Loading$1.start("拉取计划详情中...");
@@ -2975,12 +3038,10 @@ async function exportPlanStories(zentaosid, selected, scope) {
     zentaosid,
     selected.id
   );
-  // 按导出范围过滤需求
-  const stories = allStories.filter((s) => {
-    if (scope === "front") return Number(s.webestimate) > 0;
-    if (scope === "back") return Number(s.estimate) > 0;
-    return true;
-  });
+  // 按导出范围过滤需求, 再按勾选ID收窄(pickedIds未传=范围内全量)
+  const stories = filterStoriesByScope(allStories, scope).filter(
+    (s) => !pickedIds || pickedIds.has(String(s.id))
+  );
   Loading$1.succeed(
     `拉取计划详情成功(${scopeLabel}${stories.length}/${allStories.length}条)`
   );
@@ -3018,16 +3079,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,
@@ -3053,11 +3121,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);
 }
 
 /**
@@ -4000,7 +4070,7 @@ async function storyMain(action, cliOpts) {
     });
     return;
   }
-  // plan: 产品选择 -> 计划选取 -> 展示 -> 导出(--export直通一键场景, 不传则收尾交互)
+  // plan: 产品选择 -> 计划选取 -> 展示 -> 导出询问(交互场景勾选需求, --export直通一键场景)
   const session = await ensureZentaoSession(cliOpts);
   await session.request(async (zentaosid) => {
     // 位置参数纯数字 = 产品计划ID(productplan-browse-<ID>.html 中的ID), 等同 --product 直通
@@ -4044,7 +4114,17 @@ async function storyMain(action, cliOpts) {
       ]));
     }
     if (exportChoice !== "none") {
-      await exportPlanStories(zentaosid, selected, exportChoice);
+      // 下一步(仅交互场景): 列出范围内需求勾选要导出的(「全选」与单个需求互斥); --export直通为范围内全量
+      let pickedIds = null;
+      if (cliOpts.export === undefined) {
+        const pickedStories = await selectExportStories(stories, exportChoice);
+        if (!pickedStories.length) {
+          console.log(chalk.yellow("未勾选需求, 跳过导出"));
+          return;
+        }
+        pickedIds = new Set(pickedStories.map((s) => String(s.id)));
+      }
+      await exportPlanStories(zentaosid, selected, exportChoice, pickedIds);
     }
   });
 }

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 命令展示用)
@@ -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");
@@ -2853,6 +2855,8 @@ async function selectPlan(plans, keyword) {
       message: "请选择计划",
       name: "plan",
       type: "rawlist",
+      // 到列表边界停止, 不循环回第一条
+      loop: false,
       choices: plans.map((p) => ({
         name: `#${p.id} ${p.title} [${p.begin} ~ ${p.end}] (${
           p.stories ?? 0
@@ -2928,7 +2932,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 || "-",
@@ -2943,9 +2951,64 @@ async function showPlanDetail(zentaosid, selected) {
   return stories;
 }
 
-// 导出动作(plan收尾交互使用): 按范围过滤需求, 拉详情并产出 .zentao-<计划名>/ + 工作区
+// 按导出范围过滤需求: front=有前端工时 | back=有后端工时 | all=全部
+function filterStoriesByScope(stories, scope) {
+  return stories.filter((s) => {
+    if (scope === "front") return Number(s.webestimate) > 0;
+    if (scope === "back") return Number(s.estimate) > 0;
+    return true;
+  });
+}
+
+// 导出前下一步: 列出范围内需求供勾选(「全选」与子项父子联动, 复用 CheckboxAllPrompt)
+// 返回勾选的需求数组; 未勾选任何项返回[](调用方据此跳过导出)
+async function selectExportStories(stories, scope) {
+  const scoped = filterStoriesByScope(stories, scope);
+  // 工时展示跟随导出范围: front只展示前端工时 / back只展示后端工时 / all全展示
+  const hoursOf = (s) => {
+    const w = Number(s.webestimate) > 0 ? `${s.webestimate}h` : "-";
+    const e = Number(s.estimate) > 0 ? `${s.estimate}h` : "-";
+    if (scope === "front") return `(前端${w})`;
+    if (scope === "back") return `(后端${e})`;
+    return `(前端${w}/后端${e})`;
+  };
+  // prompt 注册幂等, 与 upload.js 各自使用前注册
+  inquirer.registerPrompt("checkbox-all", CheckboxAllPrompt);
+  // 需求选项拼接序号, 与数字键选择对应(按2选第一个需求...); 「全选」不占序号, 固定首项无前缀
+  const choices = [
+    {
+      name: `全选(共${scoped.length}条)`,
+      value: SELECT_ALL,
+      short: "全选",
+      // 默认全选(与全部子项联动一致)
+      checked: true,
+    },
+    ...scoped.map((s, index) => ({
+      name: `${index + 1}. #${s.id} ${s.title} ${hoursOf(s)}`,
+      value: String(s.id),
+      short: `#${s.id}`,
+      checked: true,
+    })),
+  ];
+  const { picked } = await inquirer.prompt([
+    {
+      message: `请勾选要导出的需求(空格选择, 回车确认; 「全选」与单个需求联动)`,
+      name: "picked",
+      type: "checkbox-all",
+      // 到列表边界停止, 不循环回第一条
+      loop: false,
+      choices,
+    },
+  ]);
+  // 全选勾上时返回值含哨兵值, 一并忽略后按ID过滤
+  const ids = new Set(picked.filter((v) => v !== SELECT_ALL));
+  return scoped.filter((s) => ids.has(String(s.id)));
+}
+
+// 导出动作(plan收尾交互使用): 按范围过滤需求(交互勾选时再按pickedIds收窄), 拉详情并产出 .zentao-<计划名>/ + 工作区
 // scope: front=有前端工时的需求 | back=有后端工时的需求 | all=全部
-async function exportPlanStories(zentaosid, selected, scope) {
+// pickedIds: 交互勾选的需求ID集合(Set); 未传(--export直通一键场景)为范围内全量
+async function exportPlanStories(zentaosid, selected, scope, pickedIds) {
   const scopeLabel =
     scope === "front" ? "前端" : scope === "back" ? "后端" : "全部";
   Loading.start("拉取计划详情中...");
@@ -2953,12 +3016,10 @@ async function exportPlanStories(zentaosid, selected, scope) {
     zentaosid,
     selected.id
   );
-  // 按导出范围过滤需求
-  const stories = allStories.filter((s) => {
-    if (scope === "front") return Number(s.webestimate) > 0;
-    if (scope === "back") return Number(s.estimate) > 0;
-    return true;
-  });
+  // 按导出范围过滤需求, 再按勾选ID收窄(pickedIds未传=范围内全量)
+  const stories = filterStoriesByScope(allStories, scope).filter(
+    (s) => !pickedIds || pickedIds.has(String(s.id))
+  );
   Loading.succeed(
     `拉取计划详情成功(${scopeLabel}${stories.length}/${allStories.length}条)`
   );
@@ -2996,16 +3057,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,
@@ -3031,11 +3099,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);
 }
 
 /**
@@ -3978,7 +4048,7 @@ async function storyMain(action, cliOpts) {
     });
     return;
   }
-  // plan: 产品选择 -> 计划选取 -> 展示 -> 导出(--export直通一键场景, 不传则收尾交互)
+  // plan: 产品选择 -> 计划选取 -> 展示 -> 导出询问(交互场景勾选需求, --export直通一键场景)
   const session = await ensureZentaoSession(cliOpts);
   await session.request(async (zentaosid) => {
     // 位置参数纯数字 = 产品计划ID(productplan-browse-<ID>.html 中的ID), 等同 --product 直通
@@ -4022,7 +4092,17 @@ async function storyMain(action, cliOpts) {
       ]));
     }
     if (exportChoice !== "none") {
-      await exportPlanStories(zentaosid, selected, exportChoice);
+      // 下一步(仅交互场景): 列出范围内需求勾选要导出的(「全选」与单个需求互斥); --export直通为范围内全量
+      let pickedIds = null;
+      if (cliOpts.export === undefined) {
+        const pickedStories = await selectExportStories(stories, exportChoice);
+        if (!pickedStories.length) {
+          console.log(chalk.yellow("未勾选需求, 跳过导出"));
+          return;
+        }
+        pickedIds = new Set(pickedStories.map((s) => String(s.id)));
+      }
+      await exportPlanStories(zentaosid, selected, exportChoice, pickedIds);
     }
   });
 }

package/package.json

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