clearai-dsh：为 DeepSeek Harness 带来认知循环的原生 DSH plugin

它是做什么的？

ClearAI 是 DeepSeek Harness（DSH）的认知循环（Epistemic Loop）插件，把「模型给出答案」升级为「结论必须靠证据赢得地位」。它解决的是普通 Agent 循环只关心任务是否完成、却无法说明结论凭什么可信的问题。插件把框架、假设、计划、观察、验证、评估、修正七个阶段做成机制而非建议，状态直接从会话记录推导，模型手里的工具没有任何可以自行宣布「完成」的字段。它由 Clearailhc 维护，采用 Apache-2.0 协议，最近更新于 2026-09-15。

核心功能

• 七阶段认知循环：把提问边界、候选假设、可执行计划、观察记录、证据验证、评估与修正串成一条可追溯的链路，运行时压缩为计划、执行、观察、反思四个节拍。
• 完成度由证据计算：任务是否结束不由模型声明，而由系统根据已交付的证据推导，判断者与执行者分离，超过一定层级执行者不能评判自己的结果。
• 失败被保留而非丢弃：被证伪的假设作为结果留存，不会像普通循环那样删除重试、当作噪声遗忘。
• 状态单一来源：所有状态从会话记录派生而非重复存储，进度与阶段均为计算得出，避免记录与事实脱节。
• 预设选择器集成：作为原生 DSH 插件提供 ClearAI 预设，在会话中直接选用即可进入该工作节奏。

怎么使用这个插件？

在 DSH 中启用后，打开一个会话，在预设选择器里选中 ClearAI，模型就会按认知循环的节奏推进工作。插件两部分能力都缓存在运行进程中，因此启用后需要重启 dsh web 服务，仅刷新浏览器不够。使用时你会在界面上看到范围与假设、假设列表、可检查的计划、观察与产物等阶段性输出；需要调整时，在会话中给出新的框架或约束即可。若安装过程因缺少 pnpm 而中断，按官方说明先补上 pnpm 再重试，不要用 corepack 替代。

报错怎么排查？

安装中断并提示 pnpm 不在 PATH 上时，说明 DSH 通过驱动 pnpm 管理 profile，需要先按官方说明安装 pnpm，而不是用 corepack 启用——corepack 装的是版本路由器，当前 Node 自带的 corepack 可能拉取到无法启动的 pnpm。启用后界面没有变化时，按官方说明重启 dsh web 服务，因为插件两部分都缓存在运行进程中，刷新浏览器不生效。