任务图调度器h565656445/dsh-agent-os-scheduler

dsh-agent-os-scheduler

DeepSeek Harness 个人适配声明（Personal Adaptation Notice）

本项目是 DeepSeek Harness 的个人适配产物（personal adaptation），并非 DeepSeek Harness 官方文件（not an official DeepSeek Harness file），随附功能、使用说明与个人产物（bundled with features, documentation, and personal artifacts），可与 DeepSeek Harness 搭配使用，也可独立使用。

本项目是 DeepSeek Harness 的个人适配产物，并非 DeepSeek Harness 官方文件，随附功能、使用说明与个人产物。它可与 DeepSeek Harness 搭配使用，也可独立使用。

作者 / Author：h565656445

合作 / Collaboration：如有项目可以一起合作，欢迎联系。微信：wohaishihenshuaide。如果你有项目，让我们合作吧。微信：wohaishihenshuaide。

用途 / What this is for

Agent OS 任务图调度与恢复：合法 DAG 按依赖与并发额度签发 Worker 票据，支持有界重试、暂停、租约恢复与不可逆动作人工对账。

Agent OS 任务图调度与恢复：为合法 DAG 按依赖与并发额度签发 Worker 票据，支持有界重试、暂停与租约恢复。

Agent OS 任务图调度与恢复 v0.1 / Agent OS 任务图调度与恢复 v0.1

Agent OS 任务图调度与恢复（AOS-003）在 AOS-001 运行内核与 AOS-002 Worker 协议之上，提供受控 DAG 调度、并发限制、有界重试、暂停和崩溃恢复。调度器只签发和接收本地结构化票据，不直接调用模型、网络、发布、删除、付款或账号接口。

Agent OS 任务图调度器（AOS-003）在 AOS-001 运行内核与 AOS-002 Worker 协议之上，提供受控 DAG 调度、并发限制、有界重试、暂停和崩溃恢复。调度器只签发和接收本地结构化票据——它从不直接调用模型、网络、发布、删除、付款或账号接口。

功能 / 功能

- 受控 DAG 调度：只有全部依赖为 succeeded 的 pending 节点可派发，running 数不超过 max_concurrency（上限 16）。
- 有界重试：max_attempts 硬上限 2，第 N 次派发只使用 work_refs[N-1]。
- 不可变票据：以 CreateNew 落盘派发票据，票据文件名绑定尝试次数，不能覆盖已有票据。
- 崩溃恢复：Recover 从 Ledger、票据与已落盘结果重建状态；不可逆节点进入人工对账。
- 不可逆节点人工门：不可逆派发必须附带 approval_ref，任何“是否已经发生”不确定的派发都不会自动重试。
- 哈希与凭据检查：工作输入、票据、结果与 Worker 回执使用前复算 SHA-256；疑似密钥命中后不复制、不写 Ledger。

- 受控 DAG 派发：只有全部依赖为 succeeded 的 pending 节点才可派发；running 数量永不超过 max_concurrency（上限 16）。
- 有界重试：max_attempts 硬上限为 2；第 N 次派发只使用 work_refs[N-1]。
- 不可变票据：派发票据以 CreateNew 写入；票据文件名绑定尝试索引，且永不覆盖。
- 崩溃恢复：Recover 从 Ledger、票据和磁盘结果重建状态；不可逆节点进入人工对账。
- 不可逆节点人工门：不可逆派发需要 approval_ref；不确定的不可逆动作永不自动重试。
- 哈希与凭据检查：Worker 输入、票据、结果和回执在使用前重新计算 SHA-256；疑似密钥会阻止复制和 Ledger 写入。

包含内容 / 目录结构

dsh-agent-os-scheduler/
├── README.md                      # 双语说明（本文件）
├── LICENSE                        # MIT
├── src/AgentOSScheduler.psm1      # 调度器模块（DAG、票据、恢复、幂等）
├── runner/agent_os_scheduler.ps1  # 唯一公开入口（Initialize/Dispatch/Accept/Pause/Resume/Inspect/Recover）
├── schemas/                       # 图规格/合同/票据/结果 Schema（4 个）
├── specs/Agent-OS-Task-Graph-Scheduler-v0.1.md # AOS-003 规格
├── tests/AgentOSScheduler.Tests.ps1            # Pester 5 测试
└── .dsh/                          # DeepSeek Harness 衍生包

快速开始 / Quick start

Initialize：验证 DAG 并创建不可变图合同
pwsh -File .\runner\agent_os_scheduler.ps1 -Action Initialize
-GraphSpecPath ".\graph-spec.json" -RuntimeRoot ".\runtime\agent_os_graphs" -AsJson

Dispatch：在依赖与并发额度内签发派发票据
pwsh -File .\runner\agent_os_scheduler.ps1 -Action Dispatch -GraphPath "" -AsJson

Accept：校验 Worker 回执、幂等键与哈希后提交节点终态
pwsh -File .\runner\agent_os_scheduler.ps1 -Action Accept
-GraphPath "" -ResultPath "" -AsJson

Pause / Resume / Inspect / Recover
pwsh -File .\runner\agent_os_scheduler.ps1 -Action Pause -GraphPath "" -Reason "manual" -AsJson
pwsh -File .\runner\agent_os_scheduler.ps1 -Action Inspect -GraphPath "" -AsJson
pwsh -File .\runner\agent_os_scheduler.ps1 -Action Recover -GraphPath "" -AsJson

运行测试（Pester 5）
Invoke-Pester .\tests\AgentOSScheduler.Tests.ps1

DeepSeek Harness 衍生 / DSH Derivative

本项目附带 DeepSeek Harness 衍生包，位于 .dsh/ 目录：

- preset.yml — Agent 预设元数据
- agent.cordis.yml — Cordis 组装（基于 standard 预设，persona 已定制）
- skills/dsh-agent-os-scheduler/SKILL.md — 项目专属技能（skill）

安装与接入方式见 .dsh/README.md（双语）。

许可证 / License

MIT

相关项目 / Related Projects

这是 DeepSeek Harness 个人适配系列（共 31 个仓库）的完整导航。 / This is the complete navigation for the DeepSeek Harness personal-adaptation series (31 repos).

Agent OS 内核 / Kernel

dsh-agent-os-runtime · dsh-agent-os-planning · dsh-agent-os-scheduler（本仓库 / this repo） · dsh-agent-os-worker-protocol · dsh-agent-os-observability · dsh-agent-os-specs

Harness 基础设施 / Infrastructure
dsh-harness-core · dsh-graph-entry · dsh-async-job · dsh-file-identity · dsh-json-projection · dsh-manual-approval · dsh-observation-writer · dsh-provider-control · dsh-schema-negotiator · dsh-upgrade-governance

规格与文档 / Specs & Docs

dsh-harness-specs · dsh-novel-specs · dsh-architecture-guide · dsh-powershell-patterns · dsh-json-schema-driven-dev · dsh-llm-agent-harness-guide

适配器 / Adapters

dsh-short-story-engine · dsh-tutorial-video-state-machine · dsh-governance-kernel · dsh-sports-pipeline · dsh-motion-grammar

DSH 总集成 / Integration

dsh-integration · dsh-presets-pack · dsh-skills-pack · dsh-starter-kit