dsh-async-job

August 13, 2026 · View on GitHub

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

异步任务协议：后台任务与回执，支持异步作业事件、意图与执行结果的类型化登记。

Async job protocol: background tasks and receipts with typed async-job events, intents and results.

Hermes Async Job Protocol / Hermes 异步任务协议

本仓库实现 Hermes 异步任务协议：HermesAsyncJob.psm1 以 schema 注册表 v0.2 的 async-job-intent / async-job-event 为契约，维护 intent、只追加 Ledger 事件流与最终结果投影；async_job_protocol.ps1 提供 Prepare / Submit / Observe / Reconcile / Inspect 五个命令行 Action。

This repository implements the Hermes async job protocol: HermesAsyncJob.psm1 is bound to the v0.2 async-job-intent / async-job-event schemas and maintains the intent, an append-only Ledger event stream, and the final result projection; async_job_protocol.ps1 exposes five CLI Actions: Prepare / Submit / Observe / Reconcile / Inspect.

Features / 功能

五阶段生命周期：Prepare / Submit / Observe / Reconcile / Inspect / Five-phase lifecycle (Prepare/Submit/Observe/Reconcile/Inspect)
Schema 契约：intent 与 event 双 schema，SHA-256 身份绑定 / Schema-bound intent/event pair with SHA-256 identity
幂等追加：基于 Ledger 的只追加事件流 / Idempotent append-only Ledger event stream
状态推导：从事件流推导 pending→running→succeeded/failed / State derived from the event stream
CLI 协议：async_job_protocol.ps1 直接可调用 / Callable CLI protocol

What's inside / 目录结构

dsh-async-job/
├── README.md
├── LICENSE
├── src/HermesAsyncJob.psm1
├── runner/async_job_protocol.ps1
├── schemas/schema_registry/v0.2/
│   ├── async-job-intent.schema.json
│   └── async-job-event.schema.json
└── .dsh/

Quick start / 快速开始

# Prepare：登记任务意图
pwsh -NoProfile -File .\runner\async_job_protocol.ps1 -Action Prepare -RuntimeRoot .\runtime `
  -TaskId task-001 -ContractSha256 <sha256> -AdapterId my-adapter `
  -ProviderId deepseek -RequestSha256 <sha256> -BudgetCny 1.0

# Observe：回报提供方观测
pwsh -NoProfile -File .\runner\async_job_protocol.ps1 -Action Observe -RuntimeRoot .\runtime `
  -TaskId task-001 -JobPath .\job.json -ProviderJobRef ref-1 `
  -ObservedProviderId deepseek -ObservedIntentSha256 <sha256> -ObservedContractSha256 <sha256>