zhimeng-agent 自动化任务技能

个人自动化任务集合，通过 macOS launchd 定时调度，自动执行日常任务并同步到多个平台。

概览

code

zhimeng-agent/
├── tasks/
│   ├── config.py              # 统一配置
│   ├── sync_utils.py          # 多平台同步工具
│   ├── daily_report/          # 日报生成（0:00）
│   ├── email_organizer/       # 邮箱整理（2:00）
│   ├── desktop_organizer/     # 桌面整理（4:00）
│   ├── tech_news/             # 科技新闻（7:00）
│   └── launchd/               # macOS 定时任务配置
├── logs/                      # 运行日志
└── SKILL.md                   # 本文档

任务列表

任务	调度时间	功能	输出目标
daily-report	每天 00:00	生成每日工作报告	Git, Notion, Feishu, Obsidian
email-organizer	每天 02:00	自动归档邮件	Obsidian
desktop-organizer	每天 04:00	整理桌面和下载目录	Obsidian
tech-news	每天 07:00	聚合科技新闻	Obsidian, Feishu

1. 日报生成 (daily-report)

功能

•从 Git 仓库提取当日提交记录
•整合 Claude Code 会话摘要
•生成结构化的工作日报

数据源

•Git commits（指定仓库目录）
•Claude Code sessions（~/.claude/projects/）

输出

markdown

# 2026-01-07 工作日报

## 代码提交
- feat(plan): 实现方案生成核心流程

## Claude Code 会话
- 4 个会话，总交互 23 轮

## 统计
- 提交数: 5
- 会话数: 4

手动运行

bash

cd /Users/qitmac001395/workspace/QAL/ideas/apps/zhimeng-agent
poetry run python -m tasks.daily_report.main --dry-run  # 仅生成不同步
poetry run python -m tasks.daily_report.main            # 生成并同步

2. 邮箱整理 (email-organizer)

功能

•使用 himalaya CLI 连接 Gmail
•自动归档通知类邮件
•按发件人分类统计

归档规则

优先归档以下类型：

•社交平台通知（LinkedIn, Twitter, Reddit 等）
•技术平台通知（GitHub, Stack Overflow 等）
•新闻简报（newsletter, digest 等）
•自动邮件（noreply, mailer 等）

前置条件

•安装 himalaya CLI：brew install himalaya
•配置 Gmail App Password
•创建配置文件 ~/.himalaya-config/himalaya/config.toml

手动运行

bash

poetry run python -m tasks.email_organizer.main --dry-run  # 仅分析
poetry run python -m tasks.email_organizer.main            # 执行归档

3. 桌面整理 (desktop-organizer)

功能

•扫描桌面和下载目录
•按文件类型分类移动
•清理超过30天的旧文件

整理规则

文件类型	目标目录
图片 (.png, .jpg, .gif)	~/Pictures/Desktop-Archive/
文档 (.pdf, .doc, .md)	~/Documents/Desktop-Archive/
压缩包 (.zip, .tar)	~/Downloads/Archives/
代码 (.py, .js, .java)	~/Documents/Code-Archive/
其他	~/Documents/Desktop-Other/

安全特性

•不删除任何文件，仅移动
•保留最近7天的文件在原位
•生成详细的移动日志

手动运行

bash

poetry run python -m tasks.desktop_organizer.main --dry-run  # 仅预览
poetry run python -m tasks.desktop_organizer.main            # 执行整理

4. 科技新闻 (tech-news)

功能

•抓取 Hacker News 热门文章
•获取 GitHub 24小时热门仓库
•生成每日科技早报

数据源

•Hacker News Top Stories（默认15条）
•GitHub Trending（默认10个仓库）

输出格式

markdown

# 2026-01-07 (周二) 科技早报

## Hacker News 热门
1. [Article Title](url) (320分, 45评论)

## GitHub 热门仓库
- **[owner/repo](url)** ⭐ 1234 `Python` `AI`
  > Repository description

手动运行

bash

poetry run python -m tasks.tech_news.main --dry-run           # 仅生成
poetry run python -m tasks.tech_news.main --hn-count 20       # 自定义数量
poetry run python -m tasks.tech_news.main                     # 生成并同步

安装与管理

安装定时任务

bash

cd /Users/qitmac001395/workspace/QAL/ideas/apps/zhimeng-agent/tasks/launchd
./install.sh install

查看任务状态

bash

./install.sh status

立即执行任务

bash

./install.sh run daily-report
./install.sh run tech-news

卸载定时任务

bash

./install.sh uninstall

查看运行日志

bash

# 标准输出
tail -f logs/daily-report.log
tail -f logs/tech-news.log

# 错误日志
tail -f logs/daily-report.error.log

配置

环境变量

在 .env 文件中配置：

bash

# 飞书配置
FEISHU_APP_ID=your_app_id
FEISHU_APP_SECRET=your_app_secret

# OpenAI（用于摘要生成，可选）
OPENAI_API_KEY=your_api_key

# Notion（可选）
NOTION_TOKEN=your_token

核心配置文件

tasks/config.py 包含所有可调整参数：

python

@dataclass
class TaskConfig:
    # 调度时间（小时）
    DAILY_REPORT_HOUR: int = 0
    EMAIL_ORGANIZE_HOUR: int = 2
    DESKTOP_ORGANIZE_HOUR: int = 4
    TECH_NEWS_HOUR: int = 7

    # 路径配置
    IDEAS_ROOT: Path = Path("/Users/qitmac001395/workspace/QAL/ideas")
    OBSIDIAN_VAULT: Path = Path("/Users/qitmac001395/Documents/Obsidian Vault")

    # 飞书接收者
    FEISHU_RECIPIENT_OPEN_ID: str = "ou_18b8063b232cbdec73ea1541dfb74890"

同步平台

Obsidian

•直接写入 Markdown 文件到 Obsidian Vault
•按任务类型分目录：Journal/, News/, Reports/

飞书

•通过飞书 API 发送消息
•支持富文本和 Markdown 格式

Notion

•通过 Notion API 创建页面
•支持父页面指定

Git

•自动提交日报到指定仓库
•Commit message 包含日期和摘要

故障排查

任务未执行

bash

# 检查任务是否加载
launchctl list | grep zhimeng

# 手动触发测试
launchctl start com.zhimeng.tech-news

# 查看系统日志
log show --predicate 'subsystem == "com.apple.launchd"' --last 1h | grep zhimeng

Python 环境问题

bash

# 确认 Poetry virtualenv 路径正确
poetry env info --path

# 测试模块导入
poetry run python -c "from tasks.config import config; print(config)"

权限问题

bash

# 确保脚本可执行
chmod +x tasks/launchd/install.sh

# 确保 Python 可执行
ls -la /Users/qitmac001395/Library/Caches/pypoetry/virtualenvs/zhimeng-agent-ORFMGT-6-py3.12/bin/python

开发指南

添加新任务

bash

mkdir -p tasks/new_task
touch tasks/new_task/__init__.py
touch tasks/new_task/main.py

•实现主逻辑（参考现有任务结构）：

python

# tasks/new_task/main.py
from tasks.config import config
from tasks.sync_utils import create_syncer

class NewTaskRunner:
    def run(self):
        # 执行任务逻辑
        content = self.generate_content()

        # 同步到平台
        syncer = create_syncer()
        syncer.sync_content(
            title="report-title",
            content=content,
            targets=["obsidian", "feishu"],
        )

def main():
    runner = NewTaskRunner()
    runner.run()

if __name__ == "__main__":
    main()

•创建 launchd plist 文件并安装

测试同步

python

from tasks.sync_utils import create_syncer

syncer = create_syncer()
syncer.sync_content(
    title="test-sync",
    content="# Test\nThis is a test.",
    targets=["obsidian"],
    obsidian_folder="Test",
)

版本历史

•
v1.0.0 (2026-01-07): 初始版本
- •4个定时任务：日报、邮箱、桌面、新闻
- •多平台同步支持
- •macOS launchd 调度