Home / gzx2211 / dsh-visual-workflow · GitHub

AGENTS.md@src/host/schedulerA

AGENTS.md@src/host/scheduler from gzx2211/dsh-visual-workflow is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned

mdr add gzx2211/dsh-visual-workflow/src/host/scheduler/AGENTS.md@git:20260928.0bc633c

Pins git:20260928.0bc633c in mdr.lock. Pin the fingerprint instead.

Audit grade: A, 14 of 14 checks passed
Kind: AGENTS.md file
Repository: gzx2211/dsh-visual-workflow
Path: src/host/scheduler/AGENTS.md
Versions recorded: 4
Latest version: git:20260928.0bc633c, committed Sep 28, 2026
First version recorded: Sep 22, 2026
Size: 2,764 bytes
Repository stars: 65
License: MIT

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Scheduler Module Rules

## 范围与职责

适用于 `src/host/scheduler/`。

按用户配置的**执行窗口**与**触发策略**，驱动既有编排运行时运行所选工作流模板的实例：

- 任务配置的校验、规范化与持久化；
- 时间语义：时区换算、触发点推算、窗口判定；
- 决策与推进：何时触发、何时挂起、何时续跑、何时跳过；
- 触发时的实例化语义（模板 → 实例）与会话策略分派。

判断归属：该修改是否改变**定时任务的配置契约、时间语义或触发/挂起/续跑决策**？若主要属于时间基元之外的其他领域，应放到对应模块。

## 时间语义契约

时间语义必须确定、可测、与时区显式绑定：

- 时间的解析/格式化/换算/推算一律为**纯函数**：相同输入 → 相同输出，不读系统时钟、不读环境时区、不依赖全局状态；需要"当前时刻"时经参数传入；
- 绝对时间在存储与比较层面统一用 UTC 毫秒；用户可见的时刻（"HH:mm"、日期）一律按任务自身声明的时区解释——**禁止**使用进程本地时区或隐式时区；
- 跨天区间（结束不晚于开始）必须与跨天触发点、跨日期窗口扫描的语义一致，不得各处自行解释；
- 调度语义分两层且语义固定：「执行窗口」决定何时允许运行，「触发策略」决定何时应当触发；**触发成立的条件是两层同时满足**。

## 子域边界

模块内部存在变化原因不同的子域：

- 子域之间只通过明确的输入输出协作，不得互相承担对方职责；
- 时间基元不理解"任务"；窗口判定与触发计算不理解持久化；配置契约不读盘、不决策；决策引擎不重复实现时间算法；
- 新增能力先判断属于哪个子域，再放到该子域的职责中，不得为就近而堆进已有位置。

## 依赖边界

- 只允许依赖共享契约层（任务实体与窗口/触发配置的形状）与本模块内部；
- 对外部能力的依赖必须是抽象缝（接口 + 注入）。

## 验证补充

- 时间相关断言全部使用**固定日期与时区**，不依赖运行机器的本地时区与当前时间；
- 窗口边界、跨天区间、跨日期扫描、无解配置（永不触发）等边界行为均有测试锁定；
- 决策路径的关键分支均有测试锁定；
- 重叠扫描、重复启动、终止后再启动等并发与生命周期行为有测试锁定；

## 核心原则

1. 时间语义确定且时区显式，纯计算不读时钟。
2. 窗口与触发两层语义固定，缺一不触发。
3. 收敛、校验、规范化各有唯一实现且顺序固定。
4. 扫描可重入安全，终止后不复活。

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint

mdr add gzx2211/dsh-visual-workflow/src/host/scheduler/AGENTS.md@sha256:d7e27d74c15c97c0

The line at the top of this page pins the label git:20260928.0bc633c, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

[![mdr](https://markdownregistry.com/badge/art_df4xjrqmb4qogxqm.svg)](https://markdownregistry.com/a/art_df4xjrqmb4qogxqm)

0 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 4 versions of this file, between Sep 22, 2026 and Sep 28, 2026, about one every 2 days.

version	committed	commit	size	audit
git:20260928.0bc633c latest	2026-09-28	0bc633c	2,764 B	A	view · diff
git:20260923.4575b13	2026-09-23	4575b13	3,176 B	A	view · diff
git:20260922.cf8e5a9	2026-09-22	cf8e5a9	9,499 B	A	view · diff
git:20260922.109483f	2026-09-22	109483f	9,502 B	A	view

Audit of the latest version

A 14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.

pass: Size between 200 bytes and 200 KB (2764 bytes)
pass: No zero-width or bidi control characters
pass: No instruction hidden inside an HTML comment
pass: No link to an exfiltration or paste host
pass: No credential-shaped string
pass: No instruction to send local credentials anywhere
pass: No text hidden with inline styles
pass: No prompt-injection phrasing
pass: No curl or wget piped into a shell
pass: No recursive delete of root, home or parent
pass: No instruction to read or print local credentials
pass: No base64 blob over 200 characters
pass: No link to a raw IP address
pass: No script tag

Source

GitHub

gzx2211/dsh-visual-workflow · 65 stars · license MIT · pushed 2026-10-29 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_df4xjrqmb4qogxqm
GET https://markdownregistry.com/api/v1/resolve?ref=gzx2211/dsh-visual-workflow/src/host/scheduler/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/d7e27d74c15c97c020b003a44a43a3d4bc3f99c5ff9fba4e456f75a57d502f32

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: how to write a good AGENTS.md · AGENTS.md vs CLAUDE.md · which agent file does what.