定时任务页面显示“已启用”，我知道计划已经配好了。但第二天打开输出目录，里面有一份报告，还需要再问一句：这是本次任务生成的，还是昨天留下来的？

这件事在知识库周检查、目录盘点、日报汇总里都很常见。任务看起来在工作，实际验收却缺少一段证据。

我把检查分成三个问题：有没有安排执行，有没有运行记录，本次产物有没有通过检查。每个问题都需要自己的证据。

## 一、计划、运行、产物分别看

| 要确认的事情 | 可以检查的证据 | 仍然不能据此推出什么 |
|---|---|---|
| 计划配置完成 | 时间、时区、输入和输出范围 | 不能推出已经运行 |
| 本次执行发生 | 开始与结束时间、退出状态、运行编号 | 不能推出产物内容正确 |
| 本次报告有效 | 本次独立目录里的文件、格式和内容检查 | 不能推出报告已经送达别人 |

如果还有上传、消息提醒或用户验收，就继续记录对应状态。报告生成、文件上传和收件人确认，都有各自的失败方式。

我不会把它们全部压成一个“成功”。排查问题时，知道卡在哪一步，比看到一个绿色标志更有用。

## 二、先解决旧报告被当成新报告的问题

最容易误判的写法，是让任务每次都输出 report.md，然后验收脚本检查这个文件存不存在。

昨天的文件还在，今天的任务即使失败，存在性检查也会通过。

我更倾向于每次新建一个运行目录，名字包含时间和随机编号。报告和回执都放在这个目录内；成功与否只看这个目录，不去借用上一次的文件。

这样还有一个好处：失败现场容易保留。任务出错时，不必覆盖上一份有效报告，也不用靠人的记忆去分辨版本。

## 三、用一个小例子演示回执如何生成

下面代码保存为 receipt_demo.py，使用 Python 3。它在当前目录的 demo_runs 下新建一次运行目录，生成一份演示 Markdown，然后校验标题和必要小节。

它只演示本地验收记录，不创建 WorkBuddy 定时计划，也不代表已经验证了平台的定时触发。

```python
import hashlib
import json
import sys
from datetime import datetime, timezone
from pathlib import Path
from uuid import uuid4

def now():
    return datetime.now(timezone.utc).isoformat()

run_id = uuid4().hex
run_dir = Path('demo_runs') / run_id
run_dir.mkdir(parents=True, exist_ok=False)
receipt = {'run_id': run_id, 'started_at': now(), 'status': 'running'}
report = run_dir / 'report.md'
try:
    mode = sys.argv[1] if len(sys.argv) > 1 else 'ok'
    if mode == 'missing':
        raise FileNotFoundError('模拟本次没有报告')
    text = '# 演示报告\n\n## 检查结果\n\n未发现演示异常。\n'
    if mode == 'invalid':
        text = '内容不完整'
    report.write_text(text, encoding='utf-8')
    raw = report.read_bytes()
    if not raw.decode('utf-8').startswith('# 演示报告\n'):
        raise ValueError('报告标题不符合约定')
    if '\n## 检查结果\n' not in raw.decode('utf-8'):
        raise ValueError('缺少检查结果小节')
    receipt.update(status='ok', artifact='report.md',
                   bytes=len(raw), sha256=hashlib.sha256(raw).hexdigest())
except Exception as error:
    receipt.update(status='failed', error_type=type(error).__name__)
finally:
    receipt['finished_at'] = now()
    (run_dir / 'receipt.json').write_text(
        json.dumps(receipt, ensure_ascii=False, indent=2), encoding='utf-8')
print(run_dir)
raise SystemExit(0 if receipt['status'] == 'ok' else 1)
```

分别运行“python3 receipt_demo.py”、“python3 receipt_demo.py missing”和“python3 receipt_demo.py invalid”，就能看到成功、缺报告和格式错误三种结果。每次打印出的目录都不同。

## 四、成功条件要写到业务能理解的程度

示例只检查了标题和必要小节，真实任务需要更具体的规则。

例如知识库检查，要确认扫描范围非空、报告包含本次扫描时间、指标字段齐全。表格汇总则可能需要检查必需工作表、关键列和行数范围。

内容摘要可以帮助发现文件后来有没有变动，却不能证明数据正确。两次报告内容相同，也可能是业务确实没有变化。不能单凭哈希相同就判失败。

同样，退出码为零只能说明程序按自己的规则正常结束。程序没有认真检查产物，零退出码也可能配上一份空报告。验收条件必须进入代码，而不是只写在对话里。

## 五、失败也要留下回执

我希望失败记录至少告诉我：哪次运行、什么时候开始、什么时候结束，以及属于哪类错误。

示例只记录错误类型，避免把原始报错里可能包含的路径或业务内容直接传播出去。实际排错日志可以另存到本地，并按任务需要限制可见范围。

这个例子还有明确限制：如果进程被强制结束、机器突然断电，finally 也不保证执行。正式使用时，应在启动阶段先保存 running 回执，设置超时，并由外层运行器识别长期未结束的任务。

多个运行可能并发时，还要约定是否允许重叠，以及谁有权更新“最近一次成功”的索引。不能因为有回执文件，就认为并发问题自动解决了。

## 六、接入 WorkBuddy 前，先手动走通

我会先手动执行同一个任务，确认工作目录、输入范围、依赖和输出权限都正确。本文示例的三种模式已经分别验证：正常模式生成报告并返回零；缺报告、格式错误两种模式返回非零，且各自留下 failed 回执。

之后再把经过检查的命令或操作说明放进 WorkBuddy 的定时任务。检查具体时间与时区，在实际计划运行后，用新回执和新产物验收一次。

如果要发消息提醒，成功通知应包含运行时间和可打开的产物位置；失败通知说明卡在哪一步，以及是否保留了上次有效结果。只报“任务完成”，使用者还得重新追问。

下次看到“已启用”时，我会继续找到那次运行的目录。那里有新报告、有检查结果、有结束状态，我才把这一轮记作完成。

参考：[Python datetime](https://docs.python.org/3/library/datetime.html)、[hashlib](https://docs.python.org/3/library/hashlib.html)。


定时任务页面显示“已启用”，我知道计划已经配好了。但第二天打开输出目录，里面有一份报告，还需要再问一句：这是本次任务生成的，还是昨天留下来的？

【征文】WorkBuddy 定时任务配好以后，怎样确认它真的交出了新报告

把定时任务拆成计划、运行、产物三步验收。通过可运行的Python示例，为每次运行保留独立目录和JSON回执，验证成功、缺报告及格式错误，并说明接入WorkBuddy前后该查什么。

开发工具

运维

测试

定时任务"已启用"不代表实际产出有效，需区分计划、运行与产物三层证据。每次运行应生成独立时间戳目录，内含报告与JSON回执，记录状态、哈希及错误类型。验收条件须覆盖业务规则，失败时保留现场并返回非零退出码。手动验证通过后，再配置到WorkBuddy定时执行。

代码解释

WorkBuddy 

Markdown

Python

JSON

2026上云采购 | AI焕新·智启新局

workbuddy

lexiang

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

【征文】WorkBuddy 定时任务配好以后，怎样确认它真的交出了新报告-腾讯云开发者社区-腾讯云

【征文】WorkBuddy 定时任务配好以后，怎样确认它真的交出了新报告

【征文】WorkBuddy 定时任务配好以后，怎样确认它真的交出了新报告

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐