speccore 5.25.2 → 5.26.3

package/README.md

@@ -1,93 +1,135 @@
 # SpecCore — Code by Spec, Not by Vibe
 
-**SpecCore 是一套面向 AI 原生团队的规范驱动工具链。** 它用「Spec 先行」的方式把需求、拆分、计划、执行、交付串成一个闭环——人和 AI 在每个关键节点预览、调整、确认，生成的代码自然对齐需求。
-
-> v5.25.1 | [更新日志](CHANGELOG.md) | [English](README.en.md)
-
-```
-  init → iteration create → doc2spec → analyze → split → plan → execute → pr → done
-  🚀初始化  📅创建期次  📝导入需求  🧠AI分析  📦智能拆分  📋计划  💻执行  🔀提交  ✅收尾
-```
-
-## 🚀 5 分钟体验
+🖥️ 规范驱动开发 CLI · 20 命令（55 全量）· 人机协同闭环 · 三层 AI 架构
 
 ```bash
-npm install -g speccore                       # 安装
-speccore init                                 # 初始化（CONSTITUTION+Git配置）
-speccore iteration create -n Q1 --owner=张三   # 创建期次（自动生成STAFFING.md）
-speccore doc2spec -f PRD.docx -I Q1            # 导入需求到 00-产品需求/
-speccore analyze -I Q1                         # AI分析（改动范围+风险+变更预测）
-speccore iteration split -i Q1 --interactive   # 智能拆分（复杂度+优先级+人员分配）
-speccore plan -I Q1                            # 生成执行计划
-speccore execute -t Task-001                   # 执行（自动建分支+依赖感知）
-speccore done --task=Task-001                  # 收尾归档
+speccore ask "我想做一个登录功能，计划晚8点分批执行"
 ```
 
-## 📂 目录结构 (v5.25)
+---
+
+## 架构概览
 
 ```
-项目根/
-├── .speccore/CONSTITUTION.md           ← 项目信息 + 技术栈 + Git分支策略
-└── 期次-Q1/
-    ├── STAFFING.md                     ← 人员排期（每期可不同）
-    ├── 00-产品需求/                     ← 产品原始需求（按端分目录，只读）
-    │   ├── backend/                    ←   后台端
-    │   ├── frontend/Web/               ←   Web端
-    │   ├── frontend/小程序/            ←   小程序端
-    │   └── _shared/                    ←   跨端共用
-    ├── 00-需求文档/                     ← Analyzer 生成（ANALYSIS+TECH+TEST+...）
-    ├── 00-期次总览/PROJECT_GRAPH.md    ← 任务总览 + 默认分支
-    └── Task-001~004/                   ← 拆分后任务
+speccore ask ←── 万能 AI 入口 ──→ speccore dev (智能级联)
+    │                                     │
+    ├─ 📖 命令解释 "dashboard 怎么用"      ├─ 🏗️ 初始化
+    ├─ 🗺️ 任务指引 "我想做登录"           ├─ 📝 导入需求
+    ├─ 🎯 意图匹配 "查看进度"              ├─ 🧠 AI 分析
+    └─ ⚡ 复杂编排 "计划→定时→分批"        ├─ 📦 拆分任务
+                                          ├─ ⚡ 执行开发
+    ┌─────────────────────────────┐        ├─ 🔀 提交 PR
+    │  speccore dashboard         │        └─ ✅ 归档收尾
+    │  ─ 全局仪表盘 (7 大维度)     │
+    │  ─ 9 主题 / 中英文 / 字号   │
+    │  ─ F 键全屏 / 四边扫描线    │
+    └─────────────────────────────┘
 ```
 
-## 🎯 我想...
+## 快速开始
 
-| 我想... | 用这个 |
-|:---|:---|
-| **新建项目** | `speccore init --interactive` |
-| **导入 PRD 文档** | `speccore doc2spec -f PRD.docx -I Q1` |
-| **分析需求 + 代码健康** | `speccore analyze -I Q1` / `--scope global` |
-| **拆分需求为 Task** | `speccore iteration split -I Q1 --interactive` |
-| **生成执行计划** | `speccore plan -I Q1 --interactive` |
-| **查看计划历史** | `speccore plan --list` / `plan --show plan-xxx` |
-| **修复一个 Bug** | `speccore task new -n "登录超时" --type=bugfix` |
-| **批量修复 Bug** | `speccore task new --batch-file=bugs.xlsx --type=bugfix` |
-| **定时自动执行** | `speccore schedule create --at "02:00" --all -I Q1` |
-| **AI 自动开发** | `speccore execute -t Task-001` / `--plan=plan-xxx` |
-| **创建 Pull Request** | `speccore pr --task=Task-001 --interactive` |
-| **收尾归档** | `speccore done --task=Task-001` / `done --all -I Q1 --interactive` |
-| **查看到哪了** | `speccore status-panel` 或直接 `speccore` |
-| **自然语言说需求** | `speccore ask "帮我分析当前需求"` |
-
-> 📋 全部 44 个命令 → [命令参考手册](docs/命令参考.md)
+```bash
+npm install -g speccore
+speccore init              # 初始化项目
+speccore welcome           # 查看项目名片
+speccore ask "查看进度"    # AI 万能入口
+speccore dev --auto        # 智能级联一键推进
+```
 
-## 🤝 协作模式
+## 核心能力
+
+### 🧠 ask — AI 万能入口
+4 种模式自动识别，无需记忆命令：
+- **📖 命令解释**：`speccore ask "dashboard 怎么用"`
+- **🗺️ 任务指引**：`speccore ask "我想做一个支付功能"` → 8 步全流程
+- **🎯 意图匹配**：`speccore ask "查看进度"` → 自动匹配 dashboard
+- **⚡ 复杂编排**：`speccore ask "计划任务，晚8点分批执行"` → plan→schedule→execute
+
+### 📊 dashboard — 全局仪表盘
+`speccore dashboard --scope global` 生成 Jira 标准 7 维度 HTML 看板：
+- 需求状态分布（饼图）+ 项目需求分布（柱状图）+ Created vs Resolved
+- 项目健康度评分 + 期次进度条 + 需求详情表（按期次倒序）
+- 9 套主题、中英文切换、字体/字号调节、F 键全屏、四边脉冲扫描线
+
+### 🔄 dev — 智能级联
+自动检测项目阶段，一键推进：`speccore dev --auto`
+
+### 🚀 全量流水线
+| 阶段 | 命令 | AI 模式 |
+|------|------|------|
+| 导入需求 | `doc2spec -f PRD.docx` | 📖 命令解释 |
+| AI 分析 | `analyze --audit` | 🗺️ 任务指引 |
+| 拆分任务 | `split` | 🎯 意图匹配 |
+| 执行计划 | `plan --all` | ⚡ 复杂编排 |
+| 开发执行 | `execute --batch-size 3` | ⚡ 复杂编排 |
+| 提交 PR | `pr --auto` | 🎯 意图匹配 |
+| 归档收尾 | `done --all` | 🎯 意图匹配 |
+
+## 安装 & 环境
 
-6 个命令支持 `--interactive` 人机协作，预览变更后才确认执行：
+```bash
+npm install -g speccore
+speccore --version   # v5.26.2
+```
 
-| `🧠 analyze --interactive` | `🧠 split --interactive` | `🧠 plan --interactive` |
-|:---|:---|:---|
-| `🧠 pr --interactive` | `🧠 change --interactive` | `🧠 done --interactive` |
+## 命令列表
+
+| 命令 | 别名 | 功能 |
+|------|------|------|
+| `ask` | — | 🧠 万能 AI 入口（4 模式） |
+| `welcome` | — | 🏷️ 项目名片 + 使用引导 |
+| `dashboard` | `db` | 📊 期次/全局仪表盘 |
+| `dev` | `d` | 🔄 智能级联流水线 |
+| `init` | `in` | 🏗️ 项目初始化 |
+| `doc2spec` | `d2s` | 📝 PRD→SpecCore MD |
+| `spec2doc` | `s2d` | 📤 SpecCore MD→Word/PDF/HTML |
+| `analyze` | `al` | 🧠 AI 需求分析 |
+| `split` | — | 📦 需求拆分 |
+| `plan` | `pl` | 📐 执行计划 |
+| `execute` | `ex` | ⚡ 执行开发 |
+| `pr` | `mr` | 🔀 Pull Request |
+| `done` | `dn` | ✅ 归档收尾 |
+| `change` | `ch` | 🔄 需求变更 |
+| `sync` | `sy` | 🔄 双向同步 |
+| `validate` | `vl` | ✅ 合规验证 |
+| `track` | `trk` | 🔗 REQ→Task→Code 全链路 |
+| `search` | `sh` | 🔍 跨 Spec 全文搜索 |
+| `rename` | `rn` | ✏️ 重命名 |
+| `ops` | `op` | 📜 操作历史 |
+
+## TTY 智能适配
+
+所有 AI 命令 (`ask`, `welcome`, `dev`, `dashboard`, `help`) 自动检测环境：
+- **终端**：Unicode 框线美化输出
+- **AI 调用**：自动生成 Ocean 主题 HTML 页面（四边脉冲扫描线）
+
+## 🤖 三层 AI 架构
 
-## ⏰ 调度执行
+```
+speccore ask "..." / speccore dev
+  ├─ 🧠 自有 LLM   → OpenAI / Ollama（SPECCORE_LLM_KEY 环境变量）
+  ├─ 🤖 宿主 AI    → WorkBuddy / TRAE / Qoder（自动检测）
+  └─ 📐 规则引擎   → 18 条命令 KB + 4 预定义工作流（永远可用）
+```
 
-指定时间自动执行。`--all` 会按依赖排序、分批执行当期次所有任务：
+零配置：没配 Key 自动降级，功能不受影响。
 
-```bash
-speccore schedule create --at "2026-08-10 02:00:00" --all -I Q1       # 全部任务，自动排序
-speccore schedule create --at "2026-08-10 21:00:00" -t Task-001         # 单个任务
-speccore schedule create --at "02:00" --all -I Q1 -a 张三 --type=bugfix  # 筛选后执行
-speccore schedule daemon start                                           # 启动守护进程
-```
+## 📖 文档
 
-> 不需要手动 `plan`——`execute` 自动分析 Task 依赖，按拓扑顺序分批执行。`--batch-size=3` 控制每批数量。
+| 文档 | 说明 |
+|------|------|
+| [快速开始](docs/快速开始.md) | 5 分钟上手，安装 → 完整流程 |
+| [命令参考](docs/命令参考.md) | 全部 20 命令 + 子命令 + 示例 |
+| [总览](docs/总览.md) | 核心概念 + 工作流 + 三种使用方式 |
+| [场景实战](docs/场景实战.md) | 35 个真实开发场景 |
+| [SDD 方法论](docs/SDD方法论.md) | 规范驱动开发理念 |
+| [工作空间组织](docs/工作空间组织.md) | 目录结构与文件规范 |
+| [工具适配说明](docs/工具适配说明.md) | Qoder/TRAE 等 AI 工具集成 |
+| [三层加载机制](docs/Spec三层加载机制.md) | GLOBAL/ITERATION/TASK 加载原理 |
+| [CI-CD 集成](docs/CI-CD与spec注释集成指南.md) | CI/CD 流水线 + Spec 注释 |
+| [迁移指南](docs/migration-guide.md) | 从旧版本升级 |
+| [CHANGELOG](CHANGELOG.md) | 版本历史 |
 
-## 📚 了解更多
+## 许可
 
-| 文档 | 内容 |
-|:---|:---|
-| 🚀 [快速开始](docs/快速开始.md) | 完整安装与使用教程 |
-| 🔧 [命令参考](docs/命令参考.md) | 44 个命令完整说明 |
-| 🎬 [场景实战](docs/场景实战.md) | 34 个真实开发场景 |
-| 🗺 [总览](docs/总览.md) | 架构概览与设计理念 |
-| 📝 [SDD 方法论](docs/SDD方法论.md) | 规范驱动开发介绍 |
+MIT © 2026 SpecCore Team

package/dist/cli.js

@@ -39,7 +39,11 @@ const fs_1 = require("fs");
 const path_1 = require("path");
 const init_1 = require("./commands/init");
 const validate_1 = require("./commands/validate");
+const archive_1 = require("./commands/archive");
+const progress_1 = require("./commands/progress");
+const report_1 = require("./commands/report");
 const config_1 = require("./commands/config");
+const create_1 = require("./commands/iteration/create");
 const split_1 = require("./commands/iteration/split");
 const new_1 = require("./commands/task/new");
 const plan_1 = require("./commands/plan");
@@ -57,9 +61,10 @@ const dev_1 = require("./commands/dev");
 const welcome_1 = require("./commands/welcome");
 const status_panel_1 = require("./commands/status-panel");
 const doc2spec_1 = require("./commands/doc2spec");
+const spec2doc_1 = require("./commands/spec2doc");
 // 全量层命令
 const iteration_from_global_1 = require("./commands/iteration-from-global");
-const global_status_1 = require("./commands/global-status");
+const sync_global_1 = require("./commands/sync-global");
 // P0/P1/P2 新增命令
 const impact_1 = require("./commands/impact");
 const baseline_1 = require("./commands/baseline");
@@ -118,8 +123,8 @@ function readMode() {
 const MODE = readMode();
 /** 简洁模式下在 help 中显示的命令 */
 const SIMPLE_COMMANDS = new Set([
-    'ask', 'init', 'doc2spec', 'analyze', 'split', 'execute',
-    'pr', 'done', 'status-panel', 'dev',
+    'ask', 'welcome', 'init', 'doc2spec', 'spec2doc', 'dashboard', 'analyze', 'split', 'execute',
+    'pr', 'done', 'dev', 'sync', 'search', 'track',
     'iteration', 'task', 'plan', 'ops', 'change', 'validate', 'rename',
 ]);
 /** 简洁模式下过滤 help 命令列表 */
@@ -139,25 +144,31 @@ commander_1.program
 // 👋 引导与体验
 // ================================================================
 commander_1.program
-    .command('status-panel')
-    .alias('sp')
-    .description('项目状态总览：进度+健康度+生命周期（合并 status/health/lifecycle）')
+    .command('dashboard')
+    .alias('db')
+    .description('项目仪表盘：期次状态+进度+健康度（--scope global 全量视图）')
     .option('--export <format>', 'Export: json | md | html')
     .option("--assignee <name>", "导出指定人员的统计")
     .option("--platform <platform>", "导出指定平台: backend | frontend | web | h5 | miniapp")
     .option("--type <type>", "导出指定类型: feature | bugfix | research")
     .option('--health', '项目健康度报告')
     .option('--lifecycle', '任务生命周期看板（等效 lifecycle --all）')
+    .option('--scope <scope>', '视图: iteration(默认/当前期次) | global(全量)', 'iteration')
     .action(status_panel_1.statusPanelCommand);
+commander_1.program
+    .command('status-panel')
+    .alias('sp')
+    .description('→ dashboard（同一命令）')
+    .action((opts) => (0, status_panel_1.statusPanelCommand)(opts));
 commander_1.program
     .command('dev')
     .alias('d')
     .description('智能级联：--auto 全自动流水线，--from/--to 指定起止阶段')
     .option('-i, --iteration <iteration>', 'Target iteration')
     .option('--force', 'Auto-execute without confirmation')
-    .option('--auto', '全自动流水线：init→doc2spec→analyze→split→plan→execute→pr→done')
-    .option('--from <phase>', '从指定阶段开始（init/doc2spec/analyze/split/plan/execute/pr/done）')
-    .option('--to <phase>', '到指定阶段结束（init/doc2spec/analyze/split/plan/execute/pr/done）')
+    .option('--auto', '全自动流水线：init→doc2spec→analyze→split→plan→execute→pr→done→spec2doc')
+    .option('--from <phase>', '从指定阶段开始（init/doc2spec/analyze/split/plan/execute/pr/done/spec2doc）')
+    .option('--to <phase>', '到指定阶段结束（init/doc2spec/analyze/split/plan/execute/pr/done/spec2doc）')
     .action(dev_1.devCommand);
 commander_1.program;
 // ================================================================
@@ -166,9 +177,9 @@ commander_1.program;
 commander_1.program
     .command('init')
     .alias('in')
-    .description('初始化 SpecCore（17命令/44全量，--interactive 引导式）')
+    .description('初始化 SpecCore（17命令/58全量，--interactive 引导式）')
     .option('--mode <mode>', 'Initialization mode: fresh or migration', 'fresh')
-    .option('--full', 'Full mode: all 45 commands (default: simple)')
+    .option('--full', 'Full mode: all 58 commands (default: simple)')
     .option('--force', 'Force overwrite existing configuration')
     .option('--interactive', 'Interactive guided setup: mode → confirm → init')
     .option('--auto', '全自动流水线：无人干预级联执行全部阶段')
@@ -180,8 +191,16 @@ commander_1.program
 const iterationCmd = commander_1.program
     .command('iteration')
     .alias('it')
-    .description('Iteration management commands');
-iterationCmd;
+    .description('期次管理：创建/拆分/列表');
+iterationCmd
+    .command('create')
+    .alias('c')
+    .description('创建新期次')
+    .option('-n, --name <name>', '期次名称（必填）')
+    .option('--from <phase>', '从指定阶段开始')
+    .option('--to <phase>', '到指定阶段结束')
+    .option('--owner <name>', '负责人')
+    .action(create_1.iterationCreateCommand);
 iterationCmd
     .command('split')
     .alias('sp')
@@ -203,8 +222,23 @@ iterationCmd
 const taskCmd = commander_1.program
     .command('task')
     .alias('tk')
-    .description('Task management commands');
-taskCmd;
+    .description('任务管理：创建/列表/状态');
+taskCmd
+    .command('new')
+    .alias('n')
+    .description('创建新任务')
+    .option('-n, --name <name>', '任务名称（必填）')
+    .option('-t, --type <type>', '任务类型: feature|bugfix|research', 'feature')
+    .option('-d, --desc <desc>', '任务描述')
+    .option('--platforms <platforms>', '前端平台: web,h5,miniapp')
+    .option('--backend-only', '仅后端')
+    .option('--frontend-only', '仅前端')
+    .option('-i, --iteration <iteration>', '目标期次')
+    .option('--batch <tasks>', '批量创建')
+    .option('--batch-file <path>', '从文件批量导入')
+    .option('--interactive', '交互式创建')
+    .option('--schedule <mode>', '调度模式: night|now', 'now')
+    .action(new_1.taskNewCommand);
 // 完整需求交付
 commander_1.program;
 // Bug 修复
@@ -313,7 +347,7 @@ commander_1.program
 commander_1.program
     .command('validate')
     .alias('vl')
-    .description('Validate Spec compliance and integrity')
+    .description('合规验证：检查 Spec 完整性与一致性')
     .option('-i, --iteration <iteration>', 'Target iteration')
     .option('-t, --task <task>', 'Validate specific task')
     .option('--type <type>', 'Filter by task type')
@@ -340,6 +374,27 @@ commander_1.program
     .description('项目健康度 → status-panel --health')
     .option('-i, --iteration <iteration>', 'Target iteration')
     .action((opts) => (0, status_panel_1.statusPanelCommand)({ ...opts, health: true }));
+commander_1.program
+    .command('progress')
+    .alias('pg')
+    .description('查看期次进度：任务完成率 + 各阶段统计')
+    .option('-i, --iteration <iteration>', 'Target iteration')
+    .option('-a, --assignee <assignee>', 'Filter by assignee')
+    .option('-t, --type <type>', 'Filter by task type')
+    .option('--detail', 'Show per-task detail')
+    .option('--format <format>', 'Output format: text, json', 'text')
+    .action(progress_1.progressCommand);
+commander_1.program
+    .command('report')
+    .alias('rp')
+    .description('生成项目报告：团队/风险/趋势分析')
+    .option('-i, --iteration <iteration>', 'Target iteration')
+    .option('--format <format>', 'Output format: md, html, pdf', 'md')
+    .option('-o, --output <path>', 'Output file path')
+    .option('--team', 'Include team performance report')
+    .option('--risk', 'Include risk analysis')
+    .option('--trend', 'Include trend analysis')
+    .action(report_1.reportCommand);
 // ================================================================
 // 📦 归档与交接
 // ================================================================
@@ -352,7 +407,17 @@ commander_1.program
     .option('-o, --output <path>', 'Output file path')
     .option('--format <format>', 'Output format: md', 'md')
     .action(handover_1.handoverCommand);
-commander_1.program;
+commander_1.program
+    .command('archive')
+    .alias('ar')
+    .description('归档任务：移至 archive/ 或从归档恢复')
+    .option('-t, --task <task>', 'Target task')
+    .option('-i, --iteration <iteration>', 'Target iteration')
+    .option('--all', 'Archive all completed tasks')
+    .option('--list', 'List archived tasks')
+    .option('--restore <task>', 'Restore from archive')
+    .option('--force', 'Skip confirmation')
+    .action(archive_1.archiveCommand);
 // ================================================================
 // ⚙️ 配置与工具
 // ================================================================
@@ -411,12 +476,26 @@ commander_1.program
 commander_1.program
     .command('doc2spec')
     .alias('d2s')
-    .description('导入 PRD 文档 → SpecCore Markdown（支持 Word/PDF/MD/HTML/PPTX）')
+    .description('导入 PRD/文档 → SpecCore MD（双路验证：AI + Pandoc）')
     .option('-f, --file <path>', '源文件路径')
     .option('--iter <name>', '目标期次（必填）')
     .option('-p, --platform <name>', '平台标识（backend / frontend-web / frontend-h5）')
+    .option('--task <task>', '导入到指定 Task 目录')
     .option('--files <files>', '批量: "a.docx=平台1,b.pdf=平台2"')
+    .option('--no-ai', '纯 pandoc 机械转换（终端快速模式）')
     .action(doc2spec_1.doc2specCommand);
+commander_1.program
+    .command('spec2doc')
+    .alias('s2d')
+    .description('SpecCore MD → Word/PDF/HTML/PPTX 导出')
+    .option('-i, --iteration <name>', '目标期次')
+    .option('-t, --task <task>', '导出指定任务文档')
+    .option('-f, --file <path>', '直接导出指定 .md 文件（相对/绝对路径）')
+    .option('--format <format>', '输出格式: docx|pdf|html|pptx', 'docx')
+    .option('-o, --output <path>', '输出文件路径')
+    .option('--all', '导出期次全部文档（合并）')
+    .option('--no-ai', '纯 pandoc 导出（终端快速模式）')
+    .action(spec2doc_1.spec2docCommand);
 // ================================================================
 // 📦 模式保存
 // ================================================================
@@ -449,13 +528,22 @@ commander_1.program
 commander_1.program
     .command('global-status')
     .alias('gs')
-    .description('View global layer status: all projects, requirements, architecture')
-    .option('--project <name>', 'Filter by project name')
-    .action(global_status_1.globalStatusCommand);
+    .description('→ dashboard --scope global')
+    .action(() => (0, status_panel_1.statusPanelCommand)({ scope: 'global' }));
+commander_1.program
+    .command('sync-global')
+    .alias('syg')
+    .description('期次 ↔ 全量层双向同步')
+    .option('-i, --iteration <iteration>', 'Target iteration')
+    .option('-d, --direction <dir>', 'Sync direction: to_global | from_global', 'to_global')
+    .option('--auto', 'Auto-apply without confirmation')
+    .option('--dry-run', 'Preview without modifying')
+    .option('--force', 'Skip confirmation')
+    .action(sync_global_1.syncGlobalCommand);
 commander_1.program
     .command('ops')
     .alias('op')
-    .description('View operation history (command log)')
+    .description('操作历史：查看命令执行日志')
     .action(history_1.opsCommand);
 commander_1.program;
 // ================================================================
@@ -505,7 +593,7 @@ commander_1.program
 commander_1.program
     .command('rename')
     .alias('rn')
-    .description('Rename iteration or task, auto-update all references')
+    .description('重命名期次/任务，自动更新所有关联引用')
     .option('--target <name>', 'Current name (required for single rename)')
     .option('--new-name <name>', 'New name (required for single rename)')
     .option('--batch', 'Batch rename mode')
@@ -516,25 +604,6 @@ commander_1.program
     .option('--from <phase>', '从指定阶段开始（init/analyze/split/plan/execute/pr/done）')
     .action(rename_1.renameCommand);
 // ================================================================
-// 🆕 v4.0.0 新增命令
-// ================================================================
-commander_1.program
-    .description('快捷创建 Task（同 task new）')
-    .option('-n, --name <name>', 'Task name (required)')
-    .option('-t, --type <type>', 'Task type', 'feature')
-    .option('-d, --desc <desc>', 'Task description')
-    .option('--platforms <platforms>', 'Frontend platforms: web,h5,miniapp')
-    .option('--backend-only', 'Create backend only')
-    .option('--frontend-only', 'Create frontend only')
-    .option('-i, --iteration <iteration>', 'Target iteration')
-    .option('--batch <tasks>', '批量：换行分隔的多个任务描述')
-    .option('--batch-file <path>', '从 Excel/CSV 文件批量导入')
-    .option('--interactive', 'Preview → edit → confirm → create')
-    .option('--schedule <mode>', '调度模式：night / now', 'now')
-    .action(new_1.taskNewCommand);
-commander_1.program;
-commander_1.program;
-// ================================================================
 // 快捷别名（顶层别名）
 // ================================================================
 // 为常用命令提供顶层快捷访问
@@ -624,6 +693,15 @@ commander_1.program
     .option('--task <id>', 'Trace from task ID')
     .option('--full', 'Full project trace')
     .action(trace_1.traceCommand);
+// v5.25 — 统一追踪入口
+commander_1.program
+    .command('track')
+    .alias('trk')
+    .description('合并 trace + tracker: REQ→Task→Code 全链路追踪')
+    .option('--req <id>', 'Trace from requirement ID')
+    .option('--task <id>', 'Trace from task ID')
+    .option('--full', 'Full project trace')
+    .action(trace_1.traceCommand);
 // v5.5.0 新增命令
 commander_1.program
     .command('delete')
@@ -639,7 +717,7 @@ commander_1.program
 commander_1.program
     .command('search <query>')
     .alias('sh')
-    .description('Search across all Spec files for a keyword (v5.6)')
+    .description('全文搜索：跨所有 Spec 文件关键词检索')
     .option('--task <id>', 'Limit search to a task')
     .option('--iteration <name>', 'Limit search to an iteration')
     .action((query, opts) => (0, search_1.searchCommand)({ ...opts, query }));
@@ -774,7 +852,7 @@ if (process.argv.length <= 2) {
     const names = { init: '未初始化', require: '待导入需求', analyze: '待分析', split: '待拆分', dev: '开发中', done: '已完成' };
     logger.info('');
     logger.info('┌──────────────────────────────────────────┐');
-    logger.info('│    SpecCore · v' + pkg.version + ' · 68 commands              │');
+    logger.info('│    SpecCore · v' + pkg.version + ' · 58 commands              │');
     logger.info('├──────────────────────────────────────────┤');
     if (iteration)
         logger.info('│  期次: ' + iteration.padEnd(33) + '│');
@@ -790,7 +868,7 @@ if (process.argv.length <= 2) {
     logger.info('│     ' + nextDesc.padEnd(41) + '│');
     logger.info('│                                          │');
     logger.info('│  💡 speccore --help   查看全部命令        │');
-    logger.info('│  📊 speccore status-panel  状态面板       │');
+    logger.info('│  📊 speccore dashboard  仪表盘（期次/全局）       │');
     logger.info('└──────────────────────────────────────────┘');
     logger.info('');
     process.exit(0);