控制平面规格文档h565656445/dsh-harness-specs

dsh-harness-specs

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

Harness 核心规格：MVP v1 与受监督 Worker v1，描述控制平面如何生成合同、受监督执行与状态闭环。

Harness 核心规格：MVP v1 与受监督 Worker v1。

Hermes Harness Specifications / Hermes Harness 规格文档

本仓库收录 Hermes Harness 控制平面的两份核心规格：MVP v1 与受监督 Worker v1。MVP 规格定义「自然语言需求 → 可校验 TaskContract → 有界执行 Loop → 可恢复账本」的编译与执行框架；受监督 Worker 规格定义在不扩大权限前提下的业务闭环：人工批准启动、确定性验证、修复一次、人工事实复核。本仓库为纯文档仓库，不包含任何源码。

本仓库收录 Hermes Harness 控制平面的两份核心规格：MVP v1 与受监督 Worker v1。MVP 规格定义将自然语言需求编译为可校验 TaskContract，并通过有界循环与可恢复账本运行的框架；受监督 Worker 规格定义在不扩大权限前提下的业务闭环——人工批准启动、确定性验证、修复一次，以及人工事实复核。纯文档；不包含任何源码。

Features / 功能

- MVP v1：需求编译为 TaskContract；明确 / 模糊 / 敏感需求分别进入 routed / waiting_for_user / waiting_for_approval
MVP v1：将需求编译为 TaskContract；明确、模糊和敏感需求分别进入 routed / waiting_for_user / waiting_for_approval
- 权威注册表：Markdown 为唯一事实源，机器运行镜像可溯源到路径与 SHA-256
权威注册表：Markdown 为唯一事实源，机器运行镜像可通过路径与 SHA-256 溯源
- 有界 Loop：最多执行两次、只允许一次修正，随后 completed 或 failed
有界循环：最多执行两次，只允许一次修正，随后 completed 或 failed
- 受监督 Worker v1：材料快照与哈希、人工批准启动、只读执行、确定性 Verifier 与 source_quote 引文核验
受监督 Worker v1：材料快照与哈希、人工批准启动、只读执行、确定性 Verifier 与 source_quote 引文核验
- 可恢复账本：JSONL 事件可重建状态、终态不重复派发；全程凭据扫描、不自动发布
可恢复账本：JSONL 事件可重建状态，终态不重复派发；全程凭据扫描，不自动发布

What's inside / 目录结构

dsh-harness-specs/
├── README.md              # 双语说明 + DSH 衍生声明
├── LICENSE                # MIT
├── specs/                 # Hermes Harness 控制平面规格（2 份，纯文档）
│   ├── Harness-MVP-v1.md
│   └── Harness-Worker-v1.md
└── .dsh/                  # DeepSeek Harness 衍生包
├── preset.yml
├── agent.cordis.yml
├── README.md
└── skills/dsh-harness-specs/SKILL.md

快速开始 / Quick start

1. 浏览规格清单
$repo = "E:\path\to\dsh-harness-specs"
Get-ChildItem (Join-Path $repo "specs") -Filter *.md | Select-Object Name

2. 阅读 MVP 规格
Get-Content (Join-Path $repo "specs\Harness-MVP-v1.md")

3. 安装 DSH 预设（可选）
$dst = Join-Path $env:DSH_HOME ".agent-presets\harness-specs"
Copy-Item -Recurse -Force (Join-Path $repo ".dsh") $dst

DeepSeek Harness 衍生 / DSH Derivative

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

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