工作汇报(work-report)
将聊天记录归档为会话汇报,按需合并为全天/本周汇总。存放位置与模板通过 init 配置。
命令
scripts/report.py init— 交互式初始化scripts/report.py status— 查看当前配置scripts/report.py merge daily <日期>— 合并日报scripts/report.py merge weekly <日期/周范围>— 合并周报scripts/report.py week-range <日期>— 计算周起止
配置(~/.work-report.yaml)
root: 工作汇报根目录(默认~/Documents/工作汇报/)week_start:monday|sundaytemplates: 自定义模板路径(可选,缺失回退仓库默认模板。3 份:session会话、daily日报汇总、weekly周报汇总)
默认结构:
root/日报/YYYY-MM-DD/ ← 日报
root/周报/YYYY-MM-DD~/ ← 周报
root/模板/ ← 用户模板副本
模式
- 会话摘要 → 「写日报」「总结这次工作/记录本会话」
- 汇总 → 「全天汇总/合并今日日报」「本周汇总/周报汇总」
- 初始化 → 「初始化汇报设置」「/work-report 初始化」「重置模板」
- 默认 → 汇报目录内无明确词则汇总,其他路径则会话
依赖的脚本
scripts/config.py— 零依赖 YAML 配置解析scripts/init_config.py— 写配置 + 复制默认模板(幂等)scripts/report.py— 统一操作入口(init / merge / week-range)scripts/merge_reports.py— 日报去重合并(后向兼容,新用 report.py)
⚠️ 完成动作(必执行)
- 写入
.md到配置根目录树 - 告知用户文件完整绝对路径
- 有预览则打开预览
示例与配置字段说明见 references/。