worklog-ai — 工作记录 + AI 周报生成

让 Claude Code、Codex、Codebuddy 等 AI 工具能直接调用的工作助手 CLI。

功能

• 📝 自然语言记录：每天在 notes/YYYY-MM-DD.txt 随手记工作
• 🤖 AI 生成周报/日报：基于本周/今日记录自动生成结构化报告
• 🖥️ CLI + 对话双模式：既能交互，也能脚本调用
• 🔌 AI 工具友好：subprocess 可直接调用，返回纯文本结果

安装

方式 1：从 PyPI 安装（推荐）

pip install worklog-ai

方式 2：从源码安装

git clone https://github.com/yourname/worklog-ai
cd worklog-ai
pip install -e .

安装后即可使用 todo 命令。

快速开始

1. 配置 AI（首次使用）

todo config --key sk-你的deepseek-key --provider deepseek
# 或交互式：
todo config

2. 记录工作

todo add "完成了用户登录模块开发"
todo add "修复了3个P0 bug"
todo open  # 用记事本打开今日笔记

3. 生成报告

todo report weekly              # 本周周报
todo report daily               # 今日日报
todo report weekly -d 2026-06-17  # 指定日期所在周
todo report weekly -q           # 只输出报告内容（去掉元信息）

CLI 完整指令

让 AI 工具调用

Claude Code / Codex / Cursor 等

直接通过 subprocess 调用：

import subprocess
# 记录工作
subprocess.run(["todo", "add", "完成了用户登录模块"])
# 生成周报
result = subprocess.run(["todo", "report", "weekly", "-q"], capture_output=True, text=True)
weekly_report = result.stdout

Shell 方式

# 读取周报内容
WEEKLY=$(todo report weekly -q)
# 把内容发给 AI
echo "$WEEKLY" | claude

AI 提供方支持

数据存放

~/.worklog-ai/  (或当前目录的 notes/, reports/)
├── config.json
├── notes/YYYY-MM-DD.txt
└── reports/周报_xxx.md

License

MIT