@dreamor/atlas-cli 0.7.20 → 0.7.22

package/dist/adapters/atlas/cli.js

@@ -291,6 +291,7 @@ function registerActualCommands(program) {
         .command('show <staffId>')
         .description('查看单个人员的实际工时明细'))
         .option('--month <yyyymm>', '查询月份（YYYY-MM，默认当前月）')
+        .option('--status <status>', '筛选审批状态: approved | pending | all', 'approved')
         .option('--json', '输出 JSON 信封')
         .action(async (staffId, opts) => {
         try {
@@ -307,7 +308,7 @@ function registerActualCommands(program) {
         .option('--month <yyyymm>', '查询月份（YYYY-MM，与 --from/--to 互斥）')
         .option('--from <yyyymm>', '起始月份（YYYY-MM，包含，与 --month 互斥）')
         .option('--to <yyyymm>', '结束月份（YYYY-MM，包含，与 --month 互斥）')
-        .option('--status <status>', '筛选审批状态: pending | approved | all', 'all')
+        .option('--status <status>', '筛选审批状态: approved | pending | all', 'approved')
         .option('--department <name>', '按团队负责人/部门筛选（子串，不区分大小写）')
         .option('--role <name>', '按角色/备注筛选（子串，不区分大小写）')
         .option('--staff-name <name>', '按姓名/工号筛选（子串，不区分大小写）')
@@ -326,7 +327,7 @@ function registerActualCommands(program) {
         .description('按月/部门/角色汇总实际工时'))
         .option('--by <axis>', 'month | department | role', 'month')
         .option('--month <yyyymm>', '查询月份')
-        .option('--status <status>', 'pending | approved | all', 'all')
+        .option('--status <status>', 'approved | pending | all', 'approved')
         .option('--department <name>', '按部门筛选')
         .option('--role <name>', '按角色筛选')
         .option('--from <yyyymm>', '起始月份')
@@ -347,7 +348,7 @@ function registerActualCommands(program) {
         .requiredOption('--format <fmt>', 'csv | json')
         .requiredOption('--out <path>', '输出文件路径')
         .option('--by <axis>', 'month | department | role', 'month')
-        .option('--status <status>', 'pending | approved | all', 'all')
+        .option('--status <status>', 'approved | pending | all', 'approved')
         .option('--department <name>', '按部门筛选')
         .option('--role <name>', '按角色筛选')
         .option('--from <yyyymm>', '起始月份')
@@ -372,7 +373,7 @@ function registerCompareCommands(program) {
         .option('--month <yyyymm>', '查询月份（YYYY-MM，优先级高于 from/to 用于实际数据 API）')
         .option('--department <name>', '按部门名称/ID 筛选（子串，不区分大小写）')
         .option('--role <name>', '按角色/备注筛选（子串，不区分大小写）')
-        .option('--status <status>', '筛选审批状态: pending | approved | all', 'all')
+        .option('--status <status>', '筛选审批状态: approved | pending | all', 'approved')
         .option('--threshold <n>', '差异绝对值阈值（人月），低于此值不标记', '0')
         .option('--flag-overrun', '用 ⚠️ 标记实际 > 基线的情况')
         .option('--page <n>', '页码（从 1 开始）')

package/dist/adapters/atlas/commands/actual/_logic.js

@@ -4,8 +4,14 @@
  * 与命令解析层（index.ts）分离：这里不做 IO、不调 API、不输出，
  * 只做数据变换。便于单元测试（参见 tests/actual_logic.test.ts）。
  *
- * 单位约定：manpower 字段为人月（API 直接返回人月）。
+ * 单位约定（关键）：
+ * - API detail.manpower 字段单位为**人天**，不是人月。
+ * - 网页"人力汇总"页显示的人月 = Σ(叶子节点 detail.manpower) ÷ WORK_DAYS_PER_MONTH。
+ * - 经 2026-07-01 实测验证：BMW(2548) 2026-03 叶子节点合计 321.9 人天 ÷ 22 = 14.63 人月，
+ *   与网页"各项目显示值:已确认"完全一致。
  */
+/** 每月工作日，用于把 API 返回的人天换算为人月（与网页口径一致） */
+export const WORK_DAYS_PER_MONTH = 22;
 /**
  * expandMonths 已移至 util/months.ts，此处不再导出。
  */
@@ -13,6 +19,21 @@
 export function annotateWithMonth(entries, month) {
     return entries.map((p) => ({ ...p, month }));
 }
+/** 将 CLI 字符串选项规范化为 StatusFilter，默认 approved（与网站默认视图对齐） */
+export function normalizeStatusFilter(raw) {
+    if (raw === 'all' || raw === 'pending' || raw === 'approved')
+        return raw;
+    return 'approved';
+}
+/** 判断单条 detail 记录是否通过状态筛选 */
+function passesStatusFilter(statusRaw, filter) {
+    const status = Number(statusRaw);
+    if (filter === 'approved')
+        return status === 2;
+    if (filter === 'pending')
+        return status !== 2;
+    return true;
+}
 /**
  * 按轴聚合人月。
  * - month：按月份分组（需先用 annotateWithMonth 打标）
@@ -40,42 +61,56 @@ export function filterByStaff(entries, staffId) {
     return entries.filter((p) => p.staffId === staffId || p.staffName?.includes(staffId));
 }
 /**
- * 走查 summaryByTeam 返回的树结构，提取指定项目的实际工时条目。
+ * 走查 summaryByProject 返回的树结构，提取指定项目的实际工时条目（人月）。
+ *
+ * 关键口径（与网页"人力汇总"页一致，2026-07-01 实测验证）：
+ * 1. **只在叶子节点累加**：manager 节点的 detail 是下属汇总的副本，
+ *    若一并计入会把同一笔工时重复累加（实测会把 321.9 人天虚增到 440.6）。
+ *    叶子 = children 为 null 或空数组的节点。
+ * 2. **人天 ÷ 工作日 → 人月**：API detail.manpower 单位是人天，
+ *    需除以 WORK_DAYS_PER_MONTH(22) 才是网页显示的人月。
+ * 3. **状态筛选**：默认 approved 只统计 status===2（已确认），与网页默认视图对齐。
  *
- * 树中同一员工可能出现在 manager 层（汇总下属）和 leaf 层（个人），
- * 采取走最深层的策略：越深的节点 detail 越精确。
+ * 返回按员工去重的条目，manpower 为人月（四舍五入 2 位）。
  */
-export function flattenTree(nodes, targetPid) {
+export function flattenTree(nodes, targetPid, statusFilter = 'approved') {
     const byStaffId = new Map();
-    function walk(items, depth) {
+    function isLeaf(node) {
+        const kids = node.children;
+        return !Array.isArray(kids) || kids.length === 0;
+    }
+    function walk(items) {
         for (const raw of items ?? []) {
             const node = raw;
-            const details = (node.detail ?? []);
-            let projectManpower = 0;
-            for (const d of details) {
-                if (String(d.projectId) === targetPid) {
-                    projectManpower += Number(d.manpower ?? 0);
+            // 只在叶子节点累加 detail，避免 manager 层重复计入
+            if (isLeaf(node)) {
+                const details = (node.detail ?? []);
+                let personDays = 0;
+                for (const d of details) {
+                    if (String(d.projectId) === targetPid && passesStatusFilter(d.status, statusFilter)) {
+                        personDays += Number(d.manpower ?? 0);
+                    }
                 }
-            }
-            if (projectManpower > 0) {
-                const sid = String(node.staffId ?? '');
-                const existing = byStaffId.get(sid);
-                if (!existing || depth > existing.depth) {
+                if (personDays > 0) {
+                    const sid = String(node.staffId ?? '');
+                    const manMonths = personDays / WORK_DAYS_PER_MONTH;
+                    // 同一叶子节点不可能重复出现；若员工跨多节点，按 manpower 累加
+                    const existing = byStaffId.get(sid);
+                    const total = (existing?.manpower ?? 0) + manMonths;
                     byStaffId.set(sid, {
-                        depth,
-                        entry: {
-                            staffId: sid,
-                            staffName: String(node.realname ?? ''),
-                            manpower: Math.round(projectManpower * 100) / 100,
-                            departmentName: String(node.department ?? ''),
-                            role: String(node.role ?? ''),
-                        },
+                        staffId: sid,
+                        staffName: String(node.realname ?? ''),
+                        manpower: Math.round(total * 100) / 100,
+                        departmentName: String(node.department ?? ''),
+                        role: String(node.role ?? ''),
                     });
                 }
             }
-            walk(node.children, depth + 1);
+            else {
+                walk(node.children);
+            }
         }
     }
-    walk(nodes, 0);
-    return [...byStaffId.values()].map((v) => v.entry);
+    walk(nodes);
+    return [...byStaffId.values()];
 }

package/dist/adapters/atlas/commands/actual/index.js

@@ -1,33 +1,32 @@
 import { createClient } from '../../http/client.js';
 import { isJsonMode, jsonOk, log } from '../../util/output.js';
 import { enforceOutputLimit } from '../../util/output-limit.js';
-import { SessionExpiredError } from '../../util/errors.js';
 import { expandMonths, expandMonthsDefault } from '../../util/months.js';
 import { resolveSecureExportPath, secureWriteFile } from '../../util/secure-fs.js';
-import { annotateWithMonth, aggregateByAxis, filterByStaff, flattenTree, } from './_logic.js';
+import { annotateWithMonth, aggregateByAxis, filterByStaff, flattenTree, normalizeStatusFilter, } from './_logic.js';
 import { resolveProjectId } from '../../util/env.js';
 import { readBanmaIdentity } from '../../auth/session.js';
 function getProjectId(opts) {
     return resolveProjectId(opts.projectId);
 }
-async function fetchActual(pid, month) {
+async function fetchActual(pid, month, statusFilter) {
     const client = createClient();
     const identity = await readBanmaIdentity();
     const loginStaffId = identity?.staffId ?? '';
-    // B4: summaryByTeam 请求体需用 projectIds 数组 + 额外字段
-    // 使用 projectIds 时 detail 只返回该项目的数据
-    const raw = await client.post('/yuntu-service/manpower/weekly/summaryByTeam.json', { month, staffIds: [], projectIds: [pid], isConfirm: false, loginStaffId });
+    // 项目视图：使用 summaryByProject 获取全项目维度的实际工时。
+    // API 返回全部状态的数据，statusFilter 在客户端按 status 字段过滤（与网站一致）。
+    const raw = await client.post('/yuntu-service/manpower/weekly/summaryByProject.json', { month, staffIds: [], projectIds: [pid], isConfirm: false, loginStaffId });
     const tree = (Array.isArray(raw) ? raw : []);
     // 根节点为当前用户，children 为团队成员
     if (tree.length > 0 && tree[0].children) {
-        return flattenTree(tree[0].children, pid);
+        return flattenTree(tree[0].children, pid, statusFilter);
     }
     return [];
 }
 export async function showCmd(staffId, opts) {
     const pid = getProjectId(opts);
     const m = opts.month ?? expandMonthsDefault()[0];
-    const data = await fetchActual(pid, m);
+    const data = await fetchActual(pid, m, normalizeStatusFilter(opts.status));
     const filtered = filterByStaff(data, staffId);
     if (opts.json || isJsonMode()) {
         jsonOk({ staffId, month: m, personnel: filtered });
@@ -45,18 +44,19 @@ export async function monthCmd(opts) {
     const pid = getProjectId(opts);
     // 不传月份时默认最近 12 个月，与 baseline month 行为一致
     const months = opts.month ? [opts.month] : (opts.from || opts.to ? expandMonths(opts.from, opts.to) : expandMonthsDefault());
+    const statusFilter = normalizeStatusFilter(opts.status);
     const all = [];
     const failedMonths = [];
     for (const m of months) {
         try {
-            const data = await fetchActual(pid, m);
+            const data = await fetchActual(pid, m, statusFilter);
             all.push(...annotateWithMonth(data, m));
         }
         catch (e) {
-            if (e instanceof SessionExpiredError)
-                throw e;
+            // 实际工时 API 对无数据月份也返回 501（"当前token已失效"），
+            // 不是真正的 token 过期。不 rethrow，只记录到 failedMonths。
             failedMonths.push({ month: m, error: e instanceof Error ? e.message : String(e) });
-            log(`月 ${m} 拉取失败: ${e instanceof Error ? e.message : e}`);
+            log(`月 ${m} 无实际工时数据`);
         }
     }
     // Apply --department / --role filter
@@ -77,17 +77,18 @@ export async function monthCmd(opts) {
 export async function summaryCmd(opts) {
     const pid = getProjectId(opts);
     const months = opts.month ? [opts.month] : (opts.from || opts.to ? expandMonths(opts.from, opts.to) : expandMonthsDefault());
+    const statusFilter = normalizeStatusFilter(opts.status);
     const all = [];
     const failedMonths = [];
     for (const m of months) {
         try {
-            all.push(...annotateWithMonth(await fetchActual(pid, m), m));
+            all.push(...annotateWithMonth(await fetchActual(pid, m, statusFilter), m));
         }
         catch (e) {
-            if (e instanceof SessionExpiredError)
-                throw e;
+            // 实际工时 API 对无数据月份也返回 501（"当前token已失效"），
+            // 不是真正的 token 过期。不 rethrow，只记录到 failedMonths。
             failedMonths.push({ month: m, error: e instanceof Error ? e.message : String(e) });
-            log(`月 ${m} 拉取失败: ${e instanceof Error ? e.message : e}`);
+            log(`月 ${m} 无实际工时数据`);
         }
     }
     // Apply --department / --role filter
@@ -106,18 +107,19 @@ export async function summaryCmd(opts) {
 export async function exportCmd(opts) {
     const pid = getProjectId(opts);
     const months = expandMonths(opts.from, opts.to);
+    const statusFilter = normalizeStatusFilter(opts.status);
     const rows = [];
     const failedMonths = [];
     for (const m of months) {
         try {
-            const data = await fetchActual(pid, m);
+            const data = await fetchActual(pid, m, statusFilter);
             rows.push(...annotateWithMonth(data, m));
         }
         catch (e) {
-            if (e instanceof SessionExpiredError)
-                throw e;
+            // 实际工时 API 对无数据月份也返回 501（"当前token已失效"），
+            // 不是真正的 token 过期。不 rethrow，只记录到 failedMonths。
             failedMonths.push({ month: m, error: e instanceof Error ? e.message : String(e) });
-            log(`月 ${m} 拉取失败: ${e instanceof Error ? e.message : e}`);
+            log(`月 ${m} 无实际工时数据`);
         }
     }
     // Apply --department / --role filter

package/dist/adapters/atlas/commands/baseline/index.js

@@ -36,25 +36,24 @@ function filterBaseline(details, opts) {
 }
 export async function monthCmd(opts) {
     const pid = getProjectId(opts);
+    // 基线 API 一次返回项目全部月份数据，不在月份循环内调用（B1）
     const months = opts.month ? [opts.month] : expandMonths(opts.from, opts.to);
+    const data = await fetchBaselineMonth(pid, months[0]);
     const allDetails = [];
-    for (const m of months) {
-        const data = await fetchBaselineMonth(pid, m);
-        for (const item of (data ?? [])) {
-            const details = (item.linePlanMonthDetailList ?? []);
-            const mpType = String(item.mpType ?? '');
-            const areaCode = item.areaCode;
-            for (const d of details) {
-                if (isMonthKey(d)) {
-                    allDetails.push({
-                        month: d.month ? monthTsToKey(d.month) : m,
-                        manpower: d.manpower ?? 0,
-                        role: item.role,
-                        departmentName: item.departmentName,
-                        mpType,
-                        areaCode,
-                    });
-                }
+    for (const item of (data ?? [])) {
+        const details = (item.linePlanMonthDetailList ?? []);
+        const mpType = String(item.mpType ?? '');
+        const areaCode = item.areaCode;
+        for (const d of details) {
+            if (isMonthKey(d)) {
+                allDetails.push({
+                    month: monthTsToKey(d.month),
+                    manpower: d.manpower ?? 0,
+                    role: item.role,
+                    departmentName: item.departmentName,
+                    mpType,
+                    areaCode,
+                });
             }
         }
     }
@@ -79,17 +78,16 @@ export async function monthCmd(opts) {
 }
 export async function summaryCmd(opts) {
     const pid = getProjectId(opts);
+    // 基线 API 一次返回项目全部月份数据，不在月份循环内调用（B1）
     const months = opts.month ? [opts.month] : expandMonths(opts.from, opts.to);
+    const data = await fetchBaselineMonth(pid, months[0]);
     const allDetails = [];
-    for (const m of months) {
-        const data = await fetchBaselineMonth(pid, m);
-        for (const item of (data ?? [])) {
-            const mpType = String(item.mpType ?? '');
-            const areaCode = item.areaCode;
-            for (const d of (item.linePlanMonthDetailList ?? [])) {
-                if (isMonthKey(d)) {
-                    allDetails.push({ month: monthTsToKey(d.month), manpower: d.manpower ?? 0, role: item.role, departmentName: item.departmentName, mpType, areaCode });
-                }
+    for (const item of (data ?? [])) {
+        const mpType = String(item.mpType ?? '');
+        const areaCode = item.areaCode;
+        for (const d of (item.linePlanMonthDetailList ?? [])) {
+            if (isMonthKey(d)) {
+                allDetails.push({ month: monthTsToKey(d.month), manpower: d.manpower ?? 0, role: item.role, departmentName: item.departmentName, mpType, areaCode });
             }
         }
     }
@@ -113,15 +111,14 @@ export async function summaryCmd(opts) {
 }
 export async function exportCmd(opts) {
     const pid = getProjectId(opts);
+    // 基线 API 一次返回项目全部月份数据，不在月份循环内调用（B1）
     const months = expandMonths(opts.from, opts.to);
+    const data = await fetchBaselineMonth(pid, months[0]);
     const rows = [];
-    for (const m of months) {
-        const data = await fetchBaselineMonth(pid, m);
-        for (const item of (data ?? [])) {
-            for (const d of (item.linePlanMonthDetailList ?? [])) {
-                if (isMonthKey(d)) {
-                    rows.push({ projectId: pid, month: monthTsToKey(d.month), role: item.role ?? '', manpower: d.manpower ?? 0 });
-                }
+    for (const item of (data ?? [])) {
+        for (const d of (item.linePlanMonthDetailList ?? [])) {
+            if (isMonthKey(d)) {
+                rows.push({ projectId: pid, month: monthTsToKey(d.month), role: item.role ?? '', manpower: d.manpower ?? 0 });
             }
         }
     }

package/dist/adapters/atlas/commands/compare/index.js

@@ -6,49 +6,51 @@ import { monthTsToKey } from '../../util/time.js';
 import { groupByAxis, mergeBaselineActual, } from './_logic.js';
 import { resolveProjectId, resolveProjectInfo } from '../../util/env.js';
 import { readBanmaIdentity } from '../../auth/session.js';
-import { flattenTree as flattenActualTree } from '../actual/_logic.js';
+import { flattenTree as flattenActualTree, normalizeStatusFilter } from '../actual/_logic.js';
 function getProjectId(opts) {
     return resolveProjectId(opts.projectId);
 }
 export async function compareCmd(opts) {
     const pid = getProjectId(opts);
     const months = opts.month ? [opts.month] : (opts.from || opts.to ? expandMonths(opts.from, opts.to) : expandMonthsDefault());
+    const statusFilter = normalizeStatusFilter(opts.status);
     const allBl = [];
     const allAc = [];
     const client = createClient();
     const failedMonths = [];
-    for (const m of months) {
-        try {
-            const blData = await client.post('/yuntu-service/line/plan/month/select.json', { projectId: pid, month: m });
-            for (const item of (blData ?? [])) {
-                const details = (item.linePlanMonthDetailList ?? []);
-                for (const d of details) {
-                    if (d && typeof d === 'object') {
-                        const monthVal = d.month;
-                        const monthKey = typeof monthVal === 'number'
-                            ? monthTsToKey(monthVal)
-                            : m;
-                        allBl.push({ month: monthKey, manpower: Number(d.manpower ?? 0), role: item.role, departmentName: item.departmentName });
-                    }
+    // 基线 API 一次返回项目全部月份数据，在循环外只调用一次（B1）
+    try {
+        const blData = await client.post('/yuntu-service/line/plan/month/select.json', { projectId: pid, month: months[0] ?? '' });
+        for (const item of (blData ?? [])) {
+            const details = (item.linePlanMonthDetailList ?? []);
+            for (const d of details) {
+                if (d && typeof d === 'object') {
+                    const monthVal = d.month;
+                    const monthKey = typeof monthVal === 'number'
+                        ? monthTsToKey(monthVal)
+                        : months[0];
+                    allBl.push({ month: monthKey, manpower: Number(d.manpower ?? 0), role: item.role, departmentName: item.departmentName });
                 }
             }
         }
-        catch (e) {
-            if (e instanceof SessionExpiredError)
-                throw e;
-            failedMonths.push({ month: m, error: `基线拉取失败: ${e instanceof Error ? e.message : String(e)}` });
-        }
+    }
+    catch (e) {
+        if (e instanceof SessionExpiredError)
+            throw e;
+        log(`基线数据拉取失败: ${e instanceof Error ? e.message : String(e)}`);
+    }
+    for (const m of months) {
         // 指数退避：避免连续触发限流（B2）
         try {
             const identity = await readBanmaIdentity();
             const loginStaffId = identity?.staffId ?? '';
-            const raw = await client.post('/yuntu-service/manpower/weekly/summaryByTeam.json', {
+            const raw = await client.post('/yuntu-service/manpower/weekly/summaryByProject.json', {
                 month: m, staffIds: [], projectIds: [pid], isConfirm: false, loginStaffId,
             });
             const tree = (Array.isArray(raw) ? raw : []);
             const results = [];
             if (tree.length > 0 && tree[0].children) {
-                const entries = flattenActualTree(tree[0].children, pid);
+                const entries = flattenActualTree(tree[0].children, pid, statusFilter);
                 for (const p of entries) {
                     results.push({ month: m, manpower: p.manpower ?? 0, role: p.role, departmentName: p.departmentName });
                 }
@@ -58,8 +60,10 @@ export async function compareCmd(opts) {
             }
         }
         catch (e) {
-            if (e instanceof SessionExpiredError)
-                throw e;
+            // 实际工时 API 对无数据月份也返回 501（错误信息"当前token已失效"），
+            // 这不是真正的 token 过期——基线 API 正常就说明 token 有效。
+            // 所以不 rethrow SessionExpiredError，只记录到 failedMonths。
+            // 真正的 token 过期会由基线 API 的 catch 块捕获并抛出。
             failedMonths.push({ month: m, error: `实际工时拉取失败: ${e instanceof Error ? e.message : String(e)}` });
         }
     }

package/dist/adapters/atlas/util/version.js

@@ -1 +1 @@
-export const ATLAS_VERSION = '0.7.20';
+export const ATLAS_VERSION = '0.7.22';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dreamor/atlas-cli",
-  "version": "0.7.20",
+  "version": "0.7.22",
   "description": "Atlas CLI - 斑马云图人力基线管理工具",
   "type": "module",
   "bin": {