第10章 自动化:从一次任务到每天运行

第 10 节 / 共 13 节 课程:DeepSeek Harness 实战课

一次跑通不算自动化。这一章讲 Schedule、headless、Python SDK 和任务计划程序,以及可靠自动化的五条底线。

定时触发cron / Schedule自包含任务来源/筛选/格式Agent 执行headless / SDK产出 + 日志可查、可回滚失败:记录原始错误,停止重试,通知人;不要假装成功
图 10-1 自动化的闭环:触发、执行、产出、日志、失败处理

Schedule 提醒

在对话里直接说:

每天早上 8:30(Asia/Shanghai),帮我整理昨天收藏的 5 篇文章,
按主题归类,输出 300 字摘要,投递到这个对话。

DSH 会创建一条提醒,包含名称、指令、时区、重复规则、投递位置。你也可以在“自动化任务”页面手动创建、修改、暂停、删除。

要点:时区明确;指令自包含(运行时不一定问你);投递到当前对话还是每次新对话要选对;电脑关机/休眠时不会执行,恢复后可能补跑一次;同一提醒有最小投递间隔。

headless

适合放进 cron / Windows 任务计划:

cd /path/to/project
dsh headless "检查今天的构建日志,把失败原因写成 reports/build-$(date +%F).md"

注意:它是非交互的,没人给你点审批;权限策略要提前配好;失败要能留日志;不要让无人值守任务做高风险写操作。

Python SDK

pip install deepseek-harness-sdk

要求 Python ≥ 3.10、Git;支持 Windows x64、Linux x64/arm64、macOS 14+ arm64。

from deepseek_harness import DeepSeekHarness
 
harness = DeepSeekHarness(
    provider="deepseek-official",
    model="deepseek-flash",
    max_tokens=4096,
    cwd="/path/to/project",
    profile="sdk-minimal",
)
 
result = harness.run("阅读 README,列出三个最需要补文档的模块。")
print(result)

SDK 会自动启动 dsh --profile sdk-minimal。官方示例里的 deepseek-v4-flash 是旧名,实际以模型页为准;新代码建议直接用 deepseek-flash。

任务计划程序

Windows:

schtasks /create /tn "DSH 每日简报" /tr "dsh headless \"生成今日简报\"" /sc daily /st 08:30

Linux/macOS cron:

30 8 * * * cd /path/to/project && /usr/local/bin/dsh headless "生成今日简报" >> /var/log/dsh.log 2>&1

要点:绝对路径;先手动跑通再上定时;日志可查;失败有告警。

可靠自动化的五个原则

  1. 幂等:重复跑不产生重复数据;
  2. 可观测:每次运行有日志、有结果文件;
  3. 可回滚:写操作前备份;
  4. 有边界:只碰指定目录/表/接口;
  5. 有停止条件:失败 N 次就停,不要死循环。

成本控制

定时任务用便宜模型(deepseek-flash);限制输入长度,先摘要再处理;复用缓存前缀;记录 token 消耗;非必要不做全量重跑。

本章练习

建一个每天固定时间运行的只读任务(例如汇总昨天的日志错误);观察一次运行记录;故意让任务失败(路径不存在),看日志是否清楚;写一份失败处理说明。