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 搭配使用，也可独立使用。

This project is a personal adaptation for DeepSeek Harness, and is NOT an official DeepSeek Harness file, bundled with features, documentation, and personal artifacts. It can be used alongside DeepSeek Harness or standalone.

作者 / Author: h565656445

合作 / Collaboration: 如有项目可以一起合作，欢迎联系。微信：wohaishihenshuaide。If you have projects, let's collaborate. WeChat: wohaishihenshuaide.

用途 / What this is for

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

Agent OS task-graph scheduler & recovery: issues worker tickets for a legal DAG by dependency and concurrency budget, with bounded retry, pause and lease recovery.

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

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

The Agent OS Task Graph Scheduler (AOS-003) provides controlled DAG scheduling, concurrency limits, bounded retries, pausing, and crash recovery on top of the AOS-001 runtime kernel and AOS-002 worker protocol. The scheduler only issues and receives local structured tickets — it never calls model, network, publishing, deletion, payment, or account interfaces directly.

Features / 功能

• 受控 DAG 调度：只有全部依赖为 succeeded 的 pending 节点可派发，running 数不超过 max_concurrency（上限 16）。

• 有界重试：max_attempts 硬上限 2，第 N 次派发只使用 work_refs[N-1]。

• 不可变票据：以 CreateNew 落盘派发票据，票据文件名绑定尝试次数，不能覆盖已有票据。

• 崩溃恢复：Recover 从 Ledger、票据与已落盘结果重建状态；不可逆节点进入人工对账。

• 不可逆节点人工门：不可逆派发必须附带 approval_ref，任何“是否已经发生”不确定的派发都不会自动重试。

• 哈希与凭据检查：工作输入、票据、结果与 Worker 回执使用前复算 SHA-256；疑似密钥命中后不复制、不写 Ledger。

• Controlled DAG dispatch: only pending nodes whose dependencies all succeeded dispatch; running count never exceeds max_concurrency (cap 16).

• Bounded retries: max_attempts hard-capped at 2; the Nth dispatch uses only work_refs[N-1].

• Immutable tickets: dispatch tickets are written with CreateNew; ticket filenames bind to the attempt index and never overwrite.

• Crash recovery: Recover rebuilds state from Ledger, tickets, and on-disk results; irreversible nodes go to human reconciliation.

• Human gate for irreversible nodes: irreversible dispatch requires an approval_ref; uncertain irreversible actions never auto-retry.

• Hash & credential checks: worker inputs, tickets, results, and receipts have SHA-256 recomputed before use; suspected secrets block copying and ledger writes.

What's inside / 目录结构

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 "<graph_path>" -AsJson

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

# Pause / Resume / Inspect / Recover
pwsh -File .\runner\agent_os_scheduler.ps1 -Action Pause -GraphPath "<graph_path>" -Reason "manual" -AsJson
pwsh -File .\runner\agent_os_scheduler.ps1 -Action Inspect -GraphPath "<graph_path>" -AsJson
pwsh -File .\runner\agent_os_scheduler.ps1 -Action Recover -GraphPath "<graph_path>" -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