Skip to content

第 8 章:综合实战——周报生成器完工 ​

本章目标:把前七章的零件组装成一个真正能用的命令行工具,并让它每周五自动运行。

开篇:七个版本,拼成一个 ​

回头看,周报生成器已经长出了七个版本:

版本来自新增的能力
v1第 1 章读 notes.md,交给模型,打印回答
v2第 2 章system 定规矩:不加戏、不写抬头、不超过 300 字
v3第 3 章格式模板,每次结构一致;检查 finish_reason
v4第 4 章流式输出,边写边显示
v5第 5 章默认关掉思考;打印 token 和花费
v6第 6 章.env 存 Key;超时、重试、一行人话的报错
v7第 7 章配置表,换服务商只改环境变量

它们散在七段代码里,各管一摊。这一章把它们合成一个文件,加上命令行参数,做成你每周五真的会用的工具。

学完这一章,你能:

  • 读懂一个完整的、可维护的 AI 小工具长什么样
  • 用 argparse 给脚本加命令行参数
  • 用定时任务让它每周自动跑,还专挑谷时

8.1 成品:一条命令出周报 ​

bash
python weekly.py notes.md

这是我在周一晚上真实跑的结果。前面是流式逐字出来的周报,最后一行是保存位置、模型和花费:

text
【本周完成】
- 修复登录页偶发 500,原因是 Redis 连接池满,已调大到 50
- 与产品对齐月报导出需求,确认支持 Excel
- 评审小王 PR,提出 3 条意见

【进行中】
- 月报导出开发完成一半,Excel 样式待调整
- 线上再次出现 500,日志显示为超时,正在排查

【下周计划】
- 继续排查线上超时导致的 500 问题
- 完成月报导出剩余开发及 Excel 样式调整

已保存到 weekly-2026-11-09.md|deepseek/deepseek-flash|输入 227 · 输出 120 · 约 ¥0.0007(谷时)

python weekly.py -h 能看到全部用法:

text
usage: weekly.py [-h] [-o OUT] [--no-stream] [--think] notes

把一周的零散记录整理成周报

positional arguments:
  notes          本周记录文件,比如 notes.md

options:
  -h, --help     show this help message and exit
  -o, --out OUT  周报保存到哪(默认 weekly-日期.md)
  --no-stream    不边写边显示(定时任务用)
  --think        打开思考模式(更慢、更贵)

几种常用的跑法,我都实际跑过:

命令用途实测
python weekly.py notes.md日常:流式显示,存到 weekly-日期.md输出 120 token,¥0.0007(谷时)
python weekly.py notes.md --no-stream -o out.md定时任务:不用盯着看正常保存
python weekly.py notes.md --think记录很乱、需要它想清楚时先显示「(思考中…)」;输出 323 token,¥0.0015
LLM_MODEL=deepseek-v4-pro python weekly.py notes.md换更强的模型输出 152 token,¥0.0025
python weekly.py nope.md文件名打错找不到记录文件:nope.md

8.2 完整代码 ​

项目目录只有四个文件:

text
weekly/
├── weekly.py      # 下面这份代码
├── notes.md       # 每周的流水账
├── .env           # DEEPSEEK_API_KEY=sk-...(第 6 章)
└── .gitignore     # 里面写 .env

依赖只有两个:

bash
pip install openai python-dotenv

代码 145 行,分四块,读的时候对着看:

部分做什么对应章节
配置(PROVIDERS / PRICES / SYSTEM)服务商、价格、周报模板,改东西只动这里7、5、3
is_peak / cost判断峰谷,按 usage 算钱5
generate调模型;流式或普通两种模式;检查 finish_reason1 ~ 4
main读参数和 .env,调用 generate,处理错误,存文件,打印花费6、8
展开 weekly.py 完整代码(145 行,真实运行通过)
python
"""周报生成器:python weekly.py notes.md"""
import argparse
import os
import sys
from datetime import datetime, timedelta, timezone
from pathlib import Path

import openai
from dotenv import load_dotenv
from openai import OpenAI

# ---------- 配置:换服务商、改价格、改格式,只动这一段 ----------
PROVIDERS = {
    "deepseek": {
        "base_url": "https://api.deepseek.com",
        "key_env": "DEEPSEEK_API_KEY",
        "model": "deepseek-flash",
        "think": lambda on: {"thinking": {"type": "enabled" if on else "disabled"}},
    },
    "qwen": {"base_url": "https://dashscope.aliyuncs.com/compatible-mode/v1",
             "key_env": "DASHSCOPE_API_KEY", "model": "qwen-plus"},
    "kimi": {"base_url": "https://api.moonshot.cn/v1",
             "key_env": "MOONSHOT_API_KEY", "model": "kimi-k3.1-pro"},
}

# 元 / 百万 token,峰时价(2026 年 11 月 DeepSeek 官方定价页);没填的模型不算钱
PRICES = {
    "deepseek-flash":  {"hit": 0.04, "miss": 2.0, "out": 8.0},
    "deepseek-v4-pro": {"hit": 0.30, "miss": 9.0, "out": 27.0},
}

SYSTEM = """你是一名周报助手,帮工程师把一周的零散记录整理成周报。
要求:
- 只根据记录写,记录里没有的事不要补
- 不要写「汇报人」「周期」这类抬头
- 全文不超过 300 字
- 严格按下面的格式输出,不要增减小标题,不要用 Markdown 标题符号:

【本周完成】
- 一件事一行
【进行中】
- 一件事一行
【下周计划】
- 根据「进行中」的事项写 1~3 条"""

BEIJING = timezone(timedelta(hours=8))


def is_peak(now):
    """工作日 9-12 点、14-18 点是峰时;没算法定节假日"""
    return now.weekday() < 5 and (9 <= now.hour < 12 or 14 <= now.hour < 18)


def cost(model, usage, now):
    p = PRICES.get(model)
    if not p or not usage:
        return None
    hit = getattr(usage, "prompt_cache_hit_tokens", 0) or 0
    yuan = (hit * p["hit"] + (usage.prompt_tokens - hit) * p["miss"]
            + usage.completion_tokens * p["out"]) / 1_000_000
    return yuan if is_peak(now) else yuan / 2


def generate(client, model, notes, stream, extra_body):
    """返回 (周报全文, usage)。stream=True 时边写边打印"""
    kwargs = dict(
        model=model,
        messages=[{"role": "system", "content": SYSTEM}, {"role": "user", "content": notes}],
        max_tokens=4000,
        extra_body=extra_body,
    )
    if not stream:
        resp = client.chat.completions.create(**kwargs)
        choice = resp.choices[0]
        if choice.finish_reason != "stop":
            sys.exit(f"周报没写完:finish_reason={choice.finish_reason}")
        print(choice.message.content)
        return choice.message.content, resp.usage

    parts, usage, thinking_shown = [], None, False
    for chunk in client.chat.completions.create(**kwargs, stream=True):
        usage = chunk.usage or usage
        if not chunk.choices:
            continue
        choice = chunk.choices[0]
        if getattr(choice.delta, "reasoning_content", None) and not thinking_shown:
            print("(思考中…)", flush=True)
            thinking_shown = True
        if choice.delta.content:
            print(choice.delta.content, end="", flush=True)
            parts.append(choice.delta.content)
        if choice.finish_reason not in (None, "stop"):
            sys.exit(f"\n周报没写完:finish_reason={choice.finish_reason}")
    print()
    return "".join(parts), usage


def main():
    parser = argparse.ArgumentParser(description="把一周的零散记录整理成周报")
    parser.add_argument("notes", help="本周记录文件,比如 notes.md")
    parser.add_argument("-o", "--out", help="周报保存到哪(默认 weekly-日期.md)")
    parser.add_argument("--no-stream", action="store_true", help="不边写边显示(定时任务用)")
    parser.add_argument("--think", action="store_true", help="打开思考模式(更慢、更贵)")
    args = parser.parse_args()

    load_dotenv()
    name = os.getenv("LLM_PROVIDER", "deepseek")
    cfg = PROVIDERS[name]
    key = os.getenv(cfg["key_env"])
    if not key:
        sys.exit(f"没找到 {cfg['key_env']}:在 .env 里写上 {cfg['key_env']}=你的Key")
    notes_path = Path(args.notes)
    if not notes_path.exists():
        sys.exit(f"找不到记录文件:{notes_path}")

    client = OpenAI(api_key=key, base_url=cfg["base_url"], timeout=60, max_retries=3)
    model = os.getenv("LLM_MODEL", cfg["model"])
    extra_body = cfg["think"](args.think) if "think" in cfg else None

    try:
        report, usage = generate(client, model, notes_path.read_text(encoding="utf-8"),
                                 stream=not args.no_stream, extra_body=extra_body)
    except openai.AuthenticationError:
        sys.exit(f"Key 不对(401):检查 .env 里的 {cfg['key_env']}")
    except openai.APIStatusError as e:
        if e.status_code == 402:
            sys.exit("余额不足(402):去开放平台充值")
        sys.exit(f"请求被拒绝({e.status_code}):{e.message}")
    except openai.APITimeoutError:
        sys.exit("超时:重试了 3 次还是没回应,稍后再试")
    except openai.APIConnectionError:
        sys.exit("连不上服务商:检查网络或代理")

    now = datetime.now(BEIJING)
    out = Path(args.out or f"weekly-{now:%Y-%m-%d}.md")
    out.write_text(report + "\n", encoding="utf-8")

    yuan = cost(model, usage, now)
    tokens = f"输入 {usage.prompt_tokens} · 输出 {usage.completion_tokens}" if usage else ""
    price = f" · 约 ¥{yuan:.4f}({'峰时' if is_peak(now) else '谷时'})" if yuan is not None else ""
    print(f"\n已保存到 {out}|{name}/{model}|{tokens}{price}")


if __name__ == "__main__":
    main()

几处值得多看一眼的设计:

  • 配置集中在文件顶部:换模型、改模板、调价格,都不用往下翻。以后读别人的 AI 项目,也先找这一块
  • 思考开关放进配置:"think" 是 DeepSeek 专属的,qwen、kimi 那两条没有,代码里用 if "think" in cfg 跳过,不会把 DeepSeek 的参数发给别家(第 7 章的坑)
  • 先保存,再算钱:花费只是附加信息。PRICES 里没有的模型(比如换成 Kimi),cost 返回 None,照样出周报,只是不显示价格

8.3 每周五自动跑,还专挑谷时 ​

最后一步:连命令都不用敲。

第 5 章说过,周五下午四点是峰时。DeepSeek 的谷时除了夜里,还有中午 12:00 ~ 14:00。那就让它周五中午 12:30 自动生成,你下午打开文件看一眼、改两句就能交。

macOS / Linux 用 crontab -e,加一行(路径换成你自己的,Python 要写虚拟环境里那个的完整路径):

text
30 12 * * 5 cd /Users/you/weekly && /Users/you/weekly/.venv/bin/python weekly.py notes.md --no-stream >> weekly.log 2>&1

五个字段依次是:分、时、日、月、星期,30 12 * * 5 就是「每周五 12:30」。--no-stream 是因为没人盯着看;>> weekly.log 2>&1 把输出和报错都记进日志,万一哪周没生成,翻日志就知道是 Key、余额还是网络的问题(第 6 章那几句人话,这时候派上用场)。

Windows 用「任务计划程序」,新建任务时触发器选「每周 · 星期五 · 12:30」,操作填同样的命令。

定时任务里的 .env

load_dotenv() 默认从当前目录找 .env。crontab 里先 cd 到项目目录,就是为了让它找得到。漏了这一步,脚本会提示「没找到 DEEPSEEK_API_KEY」。


8.4 Boss 通关:你学会了什么 ​

八章走下来,你做出的不只是一个周报工具。换个任务,比如每天汇总群聊、给会议录音转写稿出纪要、批量给文章打标签,骨架完全一样:

  1. 读输入:文件、命令输出、数据库,什么都行
  2. 定规矩:system 写清角色、要求、格式模板
  3. 调模型:选流式还是普通、开不开思考、设好超时
  4. 处理结果:检查 finish_reason,保存,算钱
  5. 兜住意外:错误分类,临时问题重试,自己的问题说人话

这就是 Lv2「第一次让 AI 替你干活」的全部意思。

接下来去哪:

  • 想让模型输出更准、更听话:同一级的 Prompt 工程
  • 想把周报生成器做成一个别人也能用的网页接口:Lv3 的 FastAPI 实战

试一试 ​

  • [ ] 用你自己这周的真实记录跑一次,把结果直接交上去试试
  • [ ] 加一个 --style 参数,在「给领导」和「给团队」两种语气之间切换(提示:换 SYSTEM 里的一句话)
  • [ ] 不想手写 notes.md?试试把 git log --since="1 week ago" --oneline 的输出当作记录喂进去

本章小结 ​

要点说明
组装配置 / 计价 / 调用 / 主流程四块,改东西只动配置
命令行参数argparse:记录文件、-o、--no-stream、--think
自动运行crontab 每周五 12:30(谷时),先 cd 再运行,输出进日志
通用骨架读输入 → 定规矩 → 调模型 → 处理结果 → 兜住意外

课程到这里结束。周报生成器的每一行代码、每一个数字,都是写课时真实跑出来的;你跑出来的措辞会不同,但结构和量级应该一致。如果哪里对不上,多半是模型或价格又更新了,回到对应章节的官方链接核对一下。

本文阅读--次|全站访问--次|访客--人