# daily-report **Repository Path**: strawhat2y/daily-report ## Basic Information - **Project Name**: daily-report - **Description**: 用来记录日报的小程序,完全由claude自动生成代码 - **Primary Language**: Python - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-05-21 - **Last Updated**: 2026-05-21 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Daily Report CLI 一个轻量级的本地 CLI 工具,用于记录每日工作内容并生成结构化日报。 ## 功能特性 - 添加工作记录(支持多条) - 查看今日/指定日期的工作记录 - 一键生成结构化 Markdown 日报 - 本地 JSON 文件持久化存储 - 支持简单分类(开发、会议、沟通、其他) ## 安装 ```bash # 从源码安装 pip install -e . # 安装后可直接使用 daily 命令 daily --help ``` ## 快速开始 ```bash # 1. 添加工作记录 daily add "完成登录接口开发" --category dev daily add "参加每日站会" -c meeting # 2. 查看今日记录 daily today # 3. 生成日报 daily report # 4. 导出日报到文件 daily report --output report.md ``` ## 命令使用指南 ### 添加工作记录 ```bash # 基本用法(默认分类为 other) daily add "工作内容描述" # 指定分类 daily add "完成登录接口" --category dev daily add "参加站会" -c meeting # 支持的分类: # dev - 开发工作(编码、调试、Code Review) # meeting - 会议(站会、评审、讨论) # communication - 沟通(跨团队沟通、邮件、IM) # other - 其他(默认,文档、学习、行政) ``` ### 查看记录 ```bash # 查看今日记录 daily today # 查看指定日期 daily view 2026-05-21 ``` 输出示例: ``` === 2026年05月21日 工作记录 === 1. [14:26] [开发工作] 完成登录接口开发 2. [14:26] [会议] 参加需求评审会议 3. [14:26] [沟通] 与前端同事对接接口 4. [14:26] [其他] 整理项目文档 ``` ### 生成日报 ```bash # 打印到控制台 daily report # 生成指定日期的日报 daily report --date 2026-05-20 # 导出到 Markdown 文件 daily report --output report.md daily report -o /path/to/daily-report.md ``` 日报输出示例: ```markdown # 2026年05月21日 工作日报 ## 开发工作 - [14:26] 完成登录接口开发 ## 会议 - [14:26] 参加需求评审会议 ## 沟通 - [14:26] 与前端同事对接接口 ## 其他 - [14:26] 整理项目文档 ``` ### 帮助信息 ```bash daily --help # 查看所有命令 daily add --help # 查看 add 命令详情 daily view --help # 查看 view 命令详情 daily report --help # 查看 report 命令详情 ``` ## 数据存储 - **存储位置**: `~/.daily-report/records/` - **文件格式**: JSON Lines (每行一条记录) - **文件命名**: `YYYY-MM-DD.jsonl` (按日期分文件) - **权限控制**: - 目录权限: 700 (仅所有者可读写执行) - 文件权限: 600 (仅所有者可读写) ## 项目结构 ``` daily-report/ ├── daily_report/ # 主包目录 │ ├── __init__.py │ ├── models.py # 数据模型 (Record, Category) │ ├── storage.py # 数据持久化 │ └── cli.py # CLI 命令接口 ├── tests/ # 测试目录 │ ├── test_models.py │ └── test_storage.py ├── pyproject.toml # 项目配置 └── README.md # 本文件 ``` ## 开发 ```bash # 运行测试 python -m pytest tests/ -v # 直接运行(不安装) python -m daily_report.cli --help ``` ## 许可证 MIT License