JSON 投影写入器h565656445/dsh-json-projection

dsh-json-projection

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

JSON 投影模块：把权威 Markdown/JSON 投影为结构化数据视图，供下游消费。

JSON projection module: projects authoritative Markdown/JSON into structured data views.

Hermes JSON Projection / Hermes JSON 投影

进程安全的 JSON 投影写入原语：HermesJsonProjection.psm1 实现读-校验（SHA-256 token）-写 的 compare-and-replace、按规范化路径的进程级命名互斥锁、16 MiB 大小上限与可选 JSON Schema 校验；是多个 Hermes 模块状态文件的唯一写入通道。

Process-safe JSON projection write primitives: HermesJsonProjection.psm1 implements read-verify(write SHA-256 token)-write compare-and-replace, per-canonical-path named mutexes, a 16 MiB size cap, and optional JSON Schema validation; it is the single write channel for state files across Hermes modules.

Features / 功能

- 乐观并发：SHA-256 token compare-and-replace / Optimistic concurrency via SHA-256 token compare-and-replace
- 进程互斥：按规范化路径的命名 Mutex 串行化 / Named-mutex serialization per canonical path
- 边界防护：16 MiB 上限与路径安全检查 / 16 MiB size cap and path safety checks
- Schema 校验：可选 -SchemaPath 校验写入文档 / Optional JSON Schema validation via -SchemaPath

What's inside / 目录结构

dsh-json-projection/
├── README.md
├── LICENSE
├── src/HermesJsonProjection.psm1
└── .dsh/

Quick start / 快速开始

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

$snap = Get-HermesJsonSnapshot -Path '.\state.json' -AllowMissing
$written = Set-HermesJsonProjection -Path '.\state.json' -Document @{ seq = 1 } -ExpectedToken $snap.token_sha256
$written.token_sha256   # 新 token，用于下一次写入

DeepSeek Harness 衍生 / DSH Derivative

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

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