dsh-schema-negotiator

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

Schema 协商模块：多版本契约兼容与凭据/提供商清单的 schema 校验。

Schema negotiator module: multi-version contract compatibility and schema validation.

Hermes Schema Negotiator / Hermes Schema 协商

Schema 身份协商原语：HermesSchemaNegotiator.psm1 以 schema_id|version|sha256 三元组为身份键做精确匹配与稳定读取；本仓库随附 schema_registry 的 registry.json 索引、registry.schema.json 以及 v0.2 全部 10 个契约 schema。

Schema identity negotiation primitives: HermesSchemaNegotiator.psm1 uses schema_id|version|sha256 triples as identity keys for exact matching and stable reads. This repository bundles the schema_registry registry.json index, registry.schema.json, and all ten v0.2 contract schemas.

Features / 功能

身份键：schema_id|version|sha256 三元组 / Identity key triples
精确匹配：Test-HermesExactSchemaIdentity 逐字节比对 / Byte-exact identity matching
稳定读取：Assert-HermesSchemaPath 防逃逸稳定读取 / Escape-safe stable artifact reads
注册表索引：registry.json + registry.schema.json / Registry index and its schema
v0.2 全量：随附 10 个 schema / All ten v0.2 schemas bundled

What's inside / 目录结构

dsh-schema-negotiator/
├── README.md
├── LICENSE
├── src/HermesSchemaNegotiator.psm1
├── schemas/schema_registry/
│   ├── registry.json
│   ├── registry.schema.json
│   └── v0.2/                    # 10 个契约 schema
│       ├── adapter-matrix.schema.json
│       ├── async-job-event.schema.json
│       ├── async-job-intent.schema.json
│       ├── cost-projection.schema.json
│       ├── observation-event.schema.json
│       ├── provider-registry.schema.json
│       ├── provider-worker-manifest.schema.json
│       ├── secrets-policy.schema.json
│       ├── upgrade-audit.schema.json
│       └── upgrade-checklist.schema.json
└── .dsh/

Quick start / 快速开始

Import-Module .\src\HermesSchemaNegotiator.psm1 -Force

# 按注册表解析 schema 身份
Invoke-HermesSchemaNegotiator -Action Resolve -SchemaId hermes.provider_registry -Version 0.2 `
  -RegistryPath .\schemas\schema_registry\registry.json