dsh-2origin
面向 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