Track team members' OpenSpec proposals and code changes in Git repositories
npm install openspec-stat
用于追踪团队成员在 Git 仓库中的 OpenSpec 提案与代码变更的命令行工具。
English | 简体中文
``bash`全局安装
npm install -g openspec-stat或项目内开发依赖
npm install -D openspec-stat
默认时间窗口：昨天 20:00 → 今天 20:00。
`bash基础运行
openspec-stat
关键特性
- 按时间窗口与分支过滤追踪 Git 提交
- 识别同时包含 OpenSpec 提案与代码变更的提交
- 提案维度聚合，避免 merge commit 统计偏差
- 作者分组与名称映射（合并多个 Git 身份）
- 多分支通配与 多仓库模式（BETA）
- 输出：表格、JSON、CSV、Markdown；语言：en / zh-CN
常用参数（完整见
）-
-r, --repo ：仓库路径（默认当前目录）
- -b, --branches ：逗号分隔分支，支持通配
- -s, --since / -u, --until：时间范围
- -a, --author ：按作者过滤
- -c, --config ：配置文件
- --json | --csv | --markdown：输出格式
- -l, --lang ：en 或 zh-CN
- ：详细模式多仓库模式（BETA）
一次运行分析多个本地/远程仓库。
`bash
openspec-stat init --multi # 交互式初始化
openspec-stat multi -c .openspec-stats.multi.json # 聚合视图
openspec-stat multi -c .openspec-stats.multi.json --show-contributors
`详见 多仓库模式指南。
远程缓存：远程仓库会首次克隆后复用，路径为
。使用 --cache-mode temporary
可改为一次性克隆，或用 在单次运行中强制重新克隆。配置（简版）
在仓库根目录创建
.openspec-stats.json 或 openspec-stats.config.json。`json
{
"defaultBranches": ["origin/master", "origin/main", "origin/release/*"],
"defaultSinceHours": -30,
"defaultUntilHours": 18,
"authorMapping": {"zhangsan@company.com": "张三"},
"openspecDir": "openspec/",
"excludeExtensions": [".md", ".txt", ".png", ".jpg", "..."],
"activeUserWeeks": 2
}
`关键字段：默认分支/时间窗口、作者映射（合并身份）、OpenSpec 目录、排除扩展名、活跃用户窗口。
输出示例
📊 OpenSpec 统计
时间：2024-01-01 00:00:00 ~ 2024-01-31 23:59:59
分支：origin/master
提交总数：8提案汇总
┌──────────────┬─────────┬───────────┬───────────┐
│ 提案 │ 提交数 │ 文件数 │ 净变更 │
├──────────────┼─────────┼───────────┼───────────┤
│ feature-123 │ 5 │ 30 │ +656 │
└──────────────┴─────────┴───────────┴───────────┘
作者汇总
┌─────────┬─────────┬───────────┬───────────┐
│ 作者 │ 提交数 │ 提案数 │ 净变更 │
├─────────┼─────────┼───────────┼───────────┤
│ 张三 │ 8 │ 3 │ +667 │
└─────────┴─────────┴───────────┴───────────┘
更多格式：
、--json、--csv。语言
--lang en（默认）或 --lang zh-CN，支持按系统语言自动选择。开发
`bash
pnpm install
pnpm dev
pnpm build
node dist/cjs/cli.js
``- 参见 CONTRIBUTING.md 获取开发与 PR 规范。
- 参见 RELEASE.md 了解基于 Changesets 的发布流程。
MIT