项目概览

backlog overview 命令提供项目级任务统计的纯文本输出，适合在终端中快速查看项目状态，或用于脚本和 CI 流水线。

启动概览

交互式 TUI

在支持 TTY 的终端中直接运行：

backlog overview

系统会输出一个 ANSI 彩色的终端界面，包含状态分布、优先级分布、最近活动和项目健康度。使用终端原生滚动条或鼠标滚轮浏览全部内容。

纯文本输出

在非交互式环境或需要管道处理时，使用 --plain 模式：

backlog overview --plain

纯文本模式不输出 ANSI 颜色代码，适合重定向到文件或通过管道传递给其他命令：

backlog overview --plain > project-status.txt
backlog overview --plain | grep "Overdue"

输出内容

overview 命令的输出包含以下维度：

状态概览

Status Overview
===============
  To Do: 12 tasks (40%)
  In Progress: 8 tasks (27%)
  Done: 10 tasks (33%)

  Total Tasks: 30
  Completion: 33%

展示各状态任务数量及占比，以及总任务数和整体完成率。

优先级分布

Priority Breakdown
==================
  high     5  17%
  medium   15 50%
  low      7  23%
  none     3  10%

按高 / 中 / 低 / 无优先级统计任务分布。

最近活动

Recent Activity
===============
Recently Created
----------------
  TASK-32 - 添加用户认证模块

Recently Updated
----------------
  TASK-28 - 优化数据库查询

列出最近 7 天内创建和更新的任务。

项目健康度

Project Health
==============
  Average Task Age: 12 days
  At Risk: 2   Overdue: 1   Stale: 3   Blocked: 1

At Risk Tasks: (due soon, require immediate attention)
------------------------------------------------------
  TASK-15 - 完成 API 文档

Overdue Tasks: (passed the due date)
------------------------------------
  TASK-7 - 修复登录超时问题

Stale Tasks: (No updates for 30+ days, no due date set)
--------------------------------------------------------
  TASK-3 - 调研第三方库

Blocked Tasks: (waiting on dependencies)
----------------------------------------
  TASK-11 - 集成支付网关

健康度区域与 Web 统计页面对齐，展示：

• 平均任务年龄：所有任务的平均存在天数
• 任务平均耗时：规范终态任务的平均完成耗时（分钟）与样本量。跨度定义与甘特图 Actual Start / Actual End 完全一致；完成只认规范终态——Done 计入样本，Dropped 这类放弃终态不算完成。耗时分布强烈右偏，故同时显示样本量
• 临期（At Risk）：今天或明天截止的任务
• 逾期（Overdue）：已过截止日期的任务
• 停滞（Stale）：无截止日期且超过 30 天未更新的任务
• 阻塞（Blocked）：依赖未完成的任务

每个分类下列出具体任务 ID 和标题。

统计语料范围

overview 默认仅统计活跃任务（backlog/tasks/ 下非空状态）。与 Web 统计页的「已完成语料」开关一致，加 --completed 可将历史完成记录（backlog/completed/）纳入样本——任务平均耗时等指标随之切换语料：

backlog overview --plain --completed

纯日期的截止日期按本地时区的当天解析与展示：在任意时区下，dueDate: 2026-09-20 都显示为 9 月 20 日，不会因 UTC 换算偏移到前一天或后一天；带时间的 created/updated 时间戳仍按 UTC 存储、本地显示。

与 Web 统计页面的关系

两者使用同一套底层统计逻辑（src/core/statistics.ts），数据完全一致。