前言¶
DeepSeek Harness (DSH) 提供了模型路由、沙箱和子代理注册表等底层能力。在实际构建复杂工作流时，状态管理混乱、审计困难、执行不可控是常见问题。dsh-humanize 是一个 agent 预设，它将“围绕流构建”的纪律原生移植进 DSH 的 agent 环境。
该插件由 Guard42 维护，旨在通过阶段图、锁机制、评审门禁和事件回放，把“Lean accepts it, or it does not”的验证原则落地。
核心机制¶
以下是 dsh-humanize 提供的核心能力：
-
多阶段目标与裁判命令
将多阶段目标转化为显式的流——阶段图。每个阶段挂载裁判命令，只有当裁判命令的 exit code 为 0 时，该阶段才算数。 -
流锁与防篡改
通过语义规范化 + SHA-256 生成不可变锁，格式为flk_<digest>。系统在加载时重验锁的哈希值，防止文件被篡改。 -
HMAC 评审门禁
绑定 HMAC 签名，将评审流程前置。approved、rejected、bypassed为不可变终态。若被拒绝，理由会折回草案供代理重新提交。 -
事件回放恢复
events.l（append-only）是唯一权威。中断后，使用flow_resume从回放继续，已完成的阶段绝不重跑。 -
执行留痕
每次运行留痕，支持导出 Markdown 时间线，或导出可导入ui.perfetto.dev的 Chrome-JSON。 -
哈希锚定编辑
在进行字面替换前，先校验整文件的 SHA-256 锚点。这杜绝了“凭记忆改错文件”的可能性。
安装¶
使用官方命令一键安装：
dsh plugin --profile web add github:Guard42/dsh-humanize
安装完成后重启 DSH，在预设选择器中选中 「Humanize 模式」 即可。
注意：本仓库声明了 dsh.bundle 清单并自带安装器桥。直接 dsh plugin add 一个只含预设文件的仓库并不会激活它。
典型用法¶
假设需要将测试套件从 Jest 迁移到 Vitest，流程如下：
- 代理起草：
flow_draft生成三个阶段：迁移配置 → 全量替换 → 测试全绿门禁。 - 结构校验：
flow_check检查结构，确保零错误。 - 生成锁：
flow_lock生成规范化 + SHA-256 锁，获得flk_xxxxxxxx。 - 生成评审：
flow_review_prepare生成review.md供你过目。 - 决策与执行：你给出
approve，代理执行flow_run，各阶段子代理干活，裁判命令把关。 - 恢复：若运行中断，可直接
flow_resume从events.l回放继续。
15 个模型工具¶
插件提供了 15 个模型工具，包括：
flow_draft：写入完整 FlowDraftflow_check：结构校验，产出诊断flow_lock：生成不可变锁flow_list：列出工作区全部 flowsflow_show：渲染 flow 为可读图flow_review_prepare：生成评审绑定与 review.mdflow_review_decide：唯一决策工具（approved/rejected/bypassed）flow_run：调度就绪节点flow_status：重放单次运行状态flow_resume：中断后恢复flow_stop：取消运行trace_export：导出 trace（md / chrome-json / jsonl）edit_anchored：哈希锚定编辑hash_file：计算文件 SHA-256model_catalog：列出可用 provider 路由与模型
注意事项与设计红线¶
- 零 npm 依赖：实现只依赖
node:内置模块。 - 无官方关系：这是独立社区开源项目，与深度求索及 humanfia 团队均无隶属、合作、授权或背书关系。
- 权限问题：若安装或同步时报
ACCESS_DENIED，目标目录多半在杀软/HIPS 文件防护范围内。 - 定制化：支持通过请求向
humanize模式中加入新的领域变体工具，并保存为独立预设。
结语¶
dsh-humanize 通过流锁、评审门禁和事件回放机制，为 DeepSeek Harness 的 agent 提供了严谨的执行纪律。如果你需要构建高可靠、可审计的工作流，该插件是一个值得尝试的工具。
