Worker 协议适配h565656445/dsh-agent-os-worker-protocol

dsh-agent-os-worker-protocol

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 统一 Worker 协议：Agent/Skill/本机工具通过同一 Prepare/Accept/Inspect seam 接单，结果必须带可复算证据哈希。

Agent OS 统一 Worker 协议：Agent、Skill 和本机工具通过同一 Prepare/Accept/Inspect seam 接单；结果必须携带可复算证据哈希。

Agent OS Worker Protocol v0.1 / Agent OS Worker 协议 v0.1

Agent OS Worker 协议（AOS-002）用统一协议让 Agent、Skill 和本机工具接收受控工作包，并把结构化状态与可复算证据交回 Agent OS。协议不负责选择模型、自动创建 Agent、发布内容、修改核心规则或绕过 AOS 运行任务的人工门。

Agent OS Worker 协议（AOS-002）使用统一协议，让 Agent、Skill 和本机工具接收受控工作包，并把结构化状态与可复算证据交回 Agent OS。该协议不负责选择模型、自动创建 Agent、发布内容、修改核心规则或绕过 AOS 运行任务的人工门。

Features / 功能

- 三动作公开接口：Prepare / Accept / Inspect，Prepare 只接受 state=running 且 Ledger 完整的 AOS 运行任务。
- 能力与权限适配器：适配器声明 agent/skill/local_tool 类型、上下文槽位、允许根目录、字节与数量上限。
- 最小上下文规则：请求只绑定能力声明中的槽位，Worker 输入不含源文件路径，只含作业内快照。
- 结构化结果与证据：结果必须通过 Schema 并至少提交一份证据，证据绑定内容模式与 SHA-256。
- 两段式 Worker Ledger：prepared → succeeded|failed|blocked，事件绑定前序哈希、输入哈希与请求哈希。
- 0.1→0.2 迁移兼容：旧链经 legacy_0.1 严格 Schema 只读兼容，拒绝 0.2 → 0.1 降级。

- 三动作 seam：Prepare / Accept / Inspect；Prepare 只接受 state=running 且 Ledger 完整的 AOS 运行任务。
- 能力与权限适配器：适配器声明 agent/skill/local_tool 类型、上下文槽位、允许根目录、字节与数量上限。
- 最小上下文规则：请求只绑定已声明的槽位；Worker 输入不携带源路径，只携带作业内快照。
- 结构化结果与证据：结果必须通过 schema，并至少提交一份绑定内容模式与 SHA-256 的证据。
- 两段式 Worker ledger：prepared → succeeded|failed|blocked，每个事件绑定前序哈希、输入哈希与请求哈希。
- 0.1→0.2 迁移：旧链通过严格 legacy_0.1 schema 只读兼容；0.2 → 0.1 降级会被拒绝。

What's inside / 目录结构

dsh-agent-os-worker-protocol/
├── README.md                      # 双语说明（本文件）
├── LICENSE                        # MIT
├── src/AgentOSWorkerProtocol.psm1 # Worker 协议模块（准备、接收、检查）
├── runner/agent_os_worker.ps1     # 唯一公开入口（Prepare/Accept/Inspect）
├── schemas/                       # 适配器/请求/输入/结果/回执 + legacy_0.1 Schema（9 个）
├── specs/Agent-OS-Worker-Protocol-v0.1.md     # AOS-002 规格
├── tests/AgentOSWorkerProtocol.Tests.ps1      # Pester 5 测试
└── .dsh/                          # DeepSeek Harness 衍生包

快速开始 / Quick start

Prepare：为运行中的 AOS 任务创建最小 Worker 快照与 prepared 作业
$prepared = pwsh -File .\runner\agent_os_worker.ps1 -Action Prepare
-RuntimeTaskPath "" -AdapterManifestPath ".\adapter.json"
-RequestPath ".\request.json" -AsJson

Accept：复算权限与证据哈希，接受一个终态结果
pwsh -File .\runner\agent_os_worker.ps1 -Action Accept
-JobPath "" -ResultPath "\output\worker_result.json" -AsJson

Inspect：从 Worker Ledger 恢复状态并复验输入、回执与证据
pwsh -File .\runner\agent_os_worker.ps1 -Action Inspect -JobPath "" -AsJson

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

DeepSeek Harness 衍生 / DSH Derivative

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

- preset.yml — Agent 预设元数据
- agent.cordis.yml — Cordis 组装（基于 standard 预设，persona 已定制）
- skills/dsh-agent-os-worker-protocol/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 · dsh-agent-os-worker-protocol（本仓库 / this repo） · 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