尧图网络 高端网站定制 · 原创设计
免费咨询热线
400-888-6620
免费获取方案
程序员量化交易实战 42:每日运行 artifact 落盘
第 41 篇把每日运行计划压成了一行摘要适合日志和命令行。但日志只能回答“当时看起来是什么状态”。如果要排查一次运行为什么 blocked还需要更完整的证据输入股票、失败检查、失败动作、生成时间。这就是 artifact 的作用。artifact 存什么第 42 章新增app/daily_run_artifacts.py。dataclass(frozenTrue) class DailyRunArtifact: path: Path payload: dict[str, Any]payload不是把 dataclass 直接粗暴序列化而是写成稳定的调试格式。字段说明trade_date运行对应的交易日statusready、dry_run_ready 或 blockedrequired_symbols本次运行请求的股票列表failed_checks未通过的检查项actions每个失败检查对应的处理动作generated_at请求生成时间executable是否允许真实执行构造 JSON payload核心函数是daily_run_artifact_payload()。def daily_run_artifact_payload(plan: DailyRunPlan) - dict[str, Any]: summary build_daily_run_summary(plan) return { trade_date: summary.trade_date, status: summary.status, dry_run: summary.dry_run, symbol_count: summary.symbol_count, required_symbols: list(plan.request.required_symbols), failed_checks: list(plan.result.failed_checks), actions: [ { check_name: action.check_name, action: action.action, severity: action.severity, } for action in plan.failure_actions ], action_summary: summary.action_summary, executable: summary.executable, generated_at: plan.request.generated_at.isoformat(), }这里刻意把 tuple 转成 list。artifact 是给外部读取的不应该暴露 Python 内部对象习惯。写入文件文件名按交易日生成def write_daily_run_artifact(plan: DailyRunPlan, *, directory: Path) - DailyRunArtifact: payload daily_run_artifact_payload(plan) directory.mkdir(parentsTrue, exist_okTrue) path directory / fdaily-run-{payload[trade_date]}.json path.write_text(json.dumps(payload, ensure_asciiFalse, indent2) \n, encodingutf-8) return DailyRunArtifact(pathpath, payloadpayload)blocked 场景下artifact 会保留这样的动作信息{ actions: [ { check_name: run_health, action: inspect_run_health, severity: blocker } ] }这比只在日志里看到blocked有用得多。接到可运行示例第 42 篇继续使用同一个命令复现 artifact 落盘uv run python -m scripts.chapter_examples paper-command本章对应的输出如下这张图里有三个排查时真正有用的点。artifactdaily-run-2026-03-07.json说明文件名稳定按交易日定位。值班时不需要在日志目录里猜哪个文件是当天结果。payload_keys说明 artifact 里同时保留了请求、状态、失败检查、动作和生成时间。它不是一行摘要的备份而是更完整的运行证据。failed_checks[data_gaps] actions[repair_market_data] executableFalse把失败原因和处理方向放在一起。看到这行就知道不是策略信号问题也不是运行窗口问题而是行情数据缺口挡住了执行。生产系统里我会把日志、artifact 和后续 runbook 分开看日志用于第一眼判断artifact 用于复盘证据runbook 用于下一步动作。三者互相引用但不要互相替代。测试本章测试覆盖payload 是否包含调试所需上下文。写入后的 JSON 是否能完整读回。blocked 场景下动作是否保留check_name、action和severity。运行命令uv run pytest tests/test_daily_run_artifacts.py tests/test_daily_run_summary.py tests/test_daily_run_plan.py本批次补充paper-command后全量测试通过276 passed, 2 warnings本章更新与代码仓库本章更新内容新增app/daily_run_artifacts.py。新增DailyRunArtifact。实现daily_run_artifact_payload()。实现write_daily_run_artifact()和read_daily_run_artifact()。新增tests/test_daily_run_artifacts.py覆盖 payload 与 JSON round trip。在scripts/chapter_examples.py中接入 artifact 写入与读回文章截图来自该命令输出。代码仓库https://github.com/ax2/zi-quant-platform本章代码git clone https://github.com/ax2/zi-quant-platform.git cd zi-quant-platform git checkout chapter-41-45-paper-command uv sync --extra dev uv run python -m scripts.chapter_examples paper-command uv run pytest tests/test_daily_run_artifacts.py tests/test_daily_run_summary.py tests/test_daily_run_plan.py tests/test_chapter_examples.py第 41-45 篇共用 tagchapter-41-45-paper-command。当前全量测试通过276 passed只有既有 FastAPI deprecation warning。本篇小结artifact 是生产系统里的证据文件。第 42 篇把每日运行计划落成 JSON让后续命令、告警和排查都能指向同一个文件而不是各自拼一份上下文。
RELATED

相关推荐

jitword 协同文档 3.3 发布:打造word级修订/审阅/批注功能

jitword 协同文档 3.3 发布:打造word级修订/审阅/批注功能

很高兴和大家分享我们 JitWord 协同AI文档的第 91 个版本。Github:https://github.com/jitOffice/jitword-sdkJitWord 是一款可本地部署集成的专业 Word 协同AI文档,不仅具备了企业级的Word 解析渲染能力,同时还能多人协同编辑,提…

📅 2026/10/20 21:51:45
我的面试复盘总结(亚信科技)

我的面试复盘总结(亚信科技)

2年经验,面初级开发 这次面试下来,我整体感觉还是比较稳的。面试官问的问题覆盖了Java基础、集合框架、项目经验、数据库、缓存、异常处理、AI工具使用等几个维度,我基本都能答得上来,而且大部分问题回答得还算准确和深入。 做得比…

📅 2026/10/5 9:20:47
如果25年前就能用容度原理的视角来审视“氢键全量子效应”,这趟持续20多年的科学苦旅,完全可以走一条截然不同的捷径。这不仅是理论上的推演,更是对科学研究范式的一次深刻反思

如果25年前就能用容度原理的视角来审视“氢键全量子效应”,这趟持续20多年的科学苦旅,完全可以走一条截然不同的捷径。这不仅是理论上的推演,更是对科学研究范式的一次深刻反思

如果25年前就能用容度原理的视角来审视“氢键全量子效应”,这趟持续20多年的科学苦旅,完全可以走一条截然不同的捷径。这不仅是理论上的推演,更是对科学研究范式的一次深刻反思。⏳ 历史回顾:一条充满艰辛的“发现”之路王恩哥院士…

📅 2026/10/18 12:28:23
MORE NEWS

更多资讯

📰

于洪电工证学校怎么报名才不交冤枉钱

于洪电工证学校怎么报名才不交冤枉钱 怕考不过白交培训费?你不是一个人。在焦作,越来越多的电工想通过【于洪电工证学校】考取低压电工证,但总担心钱花了证没拿到,甚至还有人因报名流程不熟悉被坑。其实,只要掌握正确的方法, 怎么报名…

📰

安建电工证通过率揭秘:外省证能转吗?洛阳从业者必看干货

安建电工证通过率揭秘:外省证能转吗?洛阳从业者必看干货 之前考的证在外省能不能转过来?这个问题几乎是每个特种作业人员,尤其是像你我这样的洛阳市政公用工程从业者最关心的事。很多人手里拿着外地的【安建电工证】,到了新城市却用不上,甚至被认定为“…

📰

重庆电工证培训考试通过率揭秘:证书过期了不知道怎么复审延期?

重庆电工证培训考试通过率揭秘:证书过期了不知道怎么复审延期? 你是不是也遇到过这种情况,电工证快到期了,不知道怎么复审,一拖再拖,结果耽误了工作?别急,今天咱们就来聊聊重庆电工证培训考试的那些事,特别是怎么 通过率揭秘…

📰

考电工证在哪里培训好 值不值得考别交冤枉钱

考电工证在哪里培训好 值不值得考别交冤枉钱 怕考不过白交培训费?你不是一个人。很多第一次报考电工证的朋友,都担心花了几千块培训费,结果考试挂了,钱打水漂,时间也浪费了。今天我就从平顶山一位初次报考人员的真实经历出发,详细说说【考电工证在哪里…

📰

电工证图怎么拍保姆级教程:实操考试心里没底怕挂科?看完这篇全搞定

电工证图怎么拍保姆级教程:实操考试心里没底怕挂科?看完这篇全搞定 实操考试心里没底怕挂科?你不是一个人。很多河南劳务班组负责人在报考电工证的时候,最担心的就是实操考试环节,尤其是拍“电工证图”这个流程,很多人一头雾水,不知道该怎么拍、拍什么…

📰

黄南州考电工证在哪考?实操考试心里没底怕挂科怎么办

黄南州考电工证在哪考?实操考试心里没底怕挂科怎么办 实操考试心里没底怕挂科?别急,黄南州考电工证的流程其实比你想象中更清晰,关键是要掌握正确的报考路径和备考方法。今天就从 黄南州考电工证…

TODAY

今日更新

THIS WEEK

本周精选

THIS MONTH

本月热门

读完文章,想聊聊您的网站?

告诉我们您的行业与需求,资深顾问一对一梳理方案与报价,全程免费。

📞 💬