dsh-json-projection

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

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，用于下一次写入