Dev Workflow - 开发工作流工具
Cross 模式统计报告功能
功能特性
- ✅ 事件记录和统计
- ✅ 多模式支持（cross, normal 等）
- ✅ 敏感数据自动过滤
- ✅ 原子写入保证数据安全
- ✅ 格式化报告输出
使用方法
查看统计报告
python3 dev-workflow/dev_workflow.py stats
筛选特定模式
python3 dev-workflow/dev_workflow.py stats --mode cross
记录事件（用于集成）
python3 dev-workflow/dev_workflow.py record "event_type" --mode cross --description "事件描述"
清空统计数据
python3 dev-workflow/dev_workflow.py clear --confirm
API 使用
Python 代码中记录事件
from stats import record_event, get_stats, format_stats_report
# 记录事件
record_event(
"task_completed",
mode="cross",
metadata={
"task_name": "开发功能",
"duration": 120
}
)
# 获取统计数据
stats = get_stats(mode="cross")
print(format_stats_report(stats))
安全特性
敏感数据过滤
以下字段会被自动过滤（替换为 [REDACTED]）：
- password
- token
- secret
- key
- credential
- auth
示例：
record_event("login", metadata={
"username": "user123", # 正常记录
"password": "secret123" # 记录为 [REDACTED]
})
原子写入
所有数据写入都使用原子操作（临时文件 + 重命名），确保：
- 并发写入不会损坏数据
- 系统崩溃不会丢失数据
- 临时文件自动清理
数据存储
- 位置：
dev-workflow/data/stats_data.json - 格式：JSON
- 结构：
{ "events": [ { "event_type": "string", "mode": "string", "timestamp": "ISO8601", "metadata": {} } ], "metadata": { "created_at": "ISO8601", "last_updated": "ISO8601" } }
统计报告内容
报告包含以下信息：
- 总事件数
- 时间范围（首次和最后事件）
- 按事件类型统计
- 按模式统计
- 按日期统计（最近7天）
开发说明
文件结构
dev-workflow/
├── dev_workflow.py # CLI 工具
├── stats.py # 统计模块
├── README.md # 本文档
└── data/
└── stats_data.json # 数据存储
扩展事件类型
可以在代码中定义新的事件类型，例如：
task_started- 任务开始task_completed- 任务完成code_committed- 代码提交error_occurred- 错误发生stats_viewed- 查看统计
测试
运行测试：
python3 dev-workflow/stats.py