状态投影冻结dongsheng123132/dsh-2origin

dsh-2origin

CI
MIT 许可证
Node.js 22+
Awesome DSH Plugins

面向 DeepSeek Harness 的证据优先 2Origin 状态投影、语义差异与不可变冻结插件。v0.2 同时是正式 Codex 插件，并提供独立的、只输出证明的 MCP 表面。

聊天记录不是交接信物，task.origin.json 才是。插件让 DSH agent 检查学历、区分语义内容与来源元数据、比较完整候选，并凭刚观测到的乐观锁指纹冻结精确版本。

安装

dsh plugin --profile  add github:dongsheng123132/dsh-2origin

显式配置工作区：

- id: dsh-2origin
name: dsh-2origin
config:
workspaceRoot: C:/absolute/project/path
stateFile: demo/my-task/task.origin.json
freezeDir: .2origin/frozen

文件路径都必须相对于 workspaceRoot；目录穿越和符号链接逃逸会被拒绝。

DSH 工具

- dsh_2origin_status：紧凑投影、各类事实计数、已验证事实数、记录指纹与重算指纹一致性。
- dsh_2origin_diff：只读比较完整候选 JSON；版本、时间、actor、存储指纹不会制造虚假语义变化。
- dsh_2origin_freeze：必须提交刚从 status 看到的指纹；状态过期立即拒绝，使用排他创建生成内容寻址快照并回读验证，相同请求可安全重放。

CLI

dsh-2origin status --root C:/project --state demo/task/task.origin.json
dsh-2origin diff --root C:/project --state demo/task/task.origin.json --candidate next.json
dsh-2origin freeze --root C:/project --state demo/task/task.origin.json --expect

内容指纹兼容 2origin/0.2：对稳定键序 JSON 做 SHA-256，同时排除 version、updated_at、content_hash、actor。

Codex 与 MCP

仓库包含 .codex-plugin/plugin.json 和独立 stdio MCP server：

- state_proof 校验一份有界的内联状态文档，仅返回完整性、哈希、计数和违例。
- state_diff_proof 比较两份内联文档，返回变更字段及内容寻址哈希，不回显标量正文。

MCP 不读写文件系统，拒绝秘密形字段，单文档上限 1 MiB，也不暴露 freeze。文件写入仍只存在于已显式配置 workspace 边界的 DSH/CLI 表面。

边界

插件刻意不修改实时学历。唯一写动作是向独立快照目录冻结。实时状态写入必须服从所属系统的 schema 与事实生命周期；在插件里复制一套较弱写入器，只会制造第二个真相。它也不是通用记忆库、插件信任扫描器或活动日志。

验证

npm test
npm run check
npm run smoke:plugin
npm run smoke:mcp
python C:/Users/ZhuanZ/.codex/skills/.system/plugin-creator/scripts/validate_plugin.py .

MIT