DeepSeek Harness 插件

Clearailhc/clearai-dsh

Star 数 ★ 696 下载量(近 30 天) 6,526 分类 AGI 架构探索 收录于 2026-10-08 npm clearai-dsh

以证据为准的研究用智能体预设:每一步只能靠系统核验过的观测推进,L3 以上的结论交给独立评估者,整场会话折成一份可重放的账本,并长成可浏览的领域本体。需要 DSH >=0.1.7-alpha.1。

安装

# npm 包(预构建)

dsh plugin --profile web add clearai-dsh

# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)

dsh plugin --profile web add github:Clearailhc/clearai-dsh

装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。

README

0.6:按需探索与协作核验

使用普通工具和原生子任务探索,按需核验影响答案的主张。ReviewClaims 与 Conclude 共用本体准入检查;独立核验保留证据、范围与反证,整体交付未通过也可保留与缺口独立的合格事实。见流程与限制。

**0.6.0 验收:**六场最终真实模型配对任务全部完成,DSH 0.2.2-rc.1 全新安装兼容性通过。结果不支持提速或省 token 的声明;独立核验的价值在于证据、范围、反证和可复用本体。保留失败轮次及最后一场的同会话恢复记录。最终结果与限制。 修复前的复杂案例对照记录。 同一供应链三阶段任务,原生 DSH 完成3/3阶段、累计20.30分钟;ClearAI 完成2/3阶段、累计109.91分钟。已知处理token分别为1136万与7864万(下界,多数为缓存读取)。两组当前暴露量均算对,但 ClearAI 因同一异常重复派评未能结案,导出图还有一条旧关系。沉淀15个概念、63条实体记录、跨历史范围49条断言,不等于整个源图已获认证。案例、截图与录屏 · 结果与成本 · 原始复盘。

**修复后复验:**定向真实任务现已成功结案。同一目标的异常由独立评估关联原身份,未声明的经验范围以 null 返回;原始图与更正后的有效图分开。失败尝试和未知用量预留全部保留,不据此宣称普遍提速。修复证据与限制。

你的研究,长成一个本体。

ClearAI 是一个本体发现与探索平台,核心由两个概念支撑:

  • 领域本体(你得到什么)——项目自己的词汇、经循环确立的知识条目、以及它们的图。研究结束时你拿到一个持续生长的知识结构,下一轮按概念检索。
  • 认识论循环(你怎么得到它)——问题 → 本体(相关的量如何测量、如何相互影响)→ 候选假设与各自的预测 → 一次可能失败的检验 → 证据 → 带范围的结论 → 长进本体。L3/L4 支持性裁决需要独立评估、材料引用和逐项判据结果;词汇与结构边是定义,并不代表已验证的主张。

结构定义与有证据支持的断言分开呈现;引用存在不等于内容真实。

0.6.0 使用 DSH 官方行内研究事件,研究与本体保留独立页签。发布验收记录真实端到端任务、费用与限制。

# 安装(npm 包,预构建——无需构建步骤,不会触发 allowBuilds 授权)
dsh plugin --profile web add clearai-dsh@0.6.0
# 或在应用里:侧栏「插件」→ 添加插件 → clearai-dsh@0.6.0

重启 dsh web,在新建会话顶部的模式选择器里选 ClearAI 即可。这就是全部步骤。完整安装说明 ↓

生产界面在官方 DSH 中回放本轮真实供应链任务。平台图展示已沉淀对象与带范围的断言,完整源数据导出图另行计量。案例与限制 · 截图来源。


你得到什么:领域本体

一个领域本体,它在你研究的过程中生长:

  • 词汇——你的项目用什么语言说话:概念、谓词、值形态、单位。约定本身没有对错,有对错的是用这些词写下的句子。
  • 已确立条目——通过了循环的知识:每条带边界、支持等级、证据链。每条都写明适用边界,否则无法安全引用。
  • 本体图与实体图——你的领域长什么样(结构),你已经验证出了什么(战况)。
  • 冲突读数——两条互相矛盾的结论自动亮出来;系统只报出冲突,撤回或维持由你决定。

你怎么得到它:认识论循环

多数 agent loop 只跟踪一件事:任务做完没有。认识论循环还跟踪一个结论凭什么被信任:

任务循环 认识论循环
驱动问题 下一步做什么? 我们现在知道什么,依据是什么?
完成 模型宣布完成 系统按交付的证据算出来
裁决 谁做的谁说了算 分离——超过一定等级,做的人不能判自己
失败 删掉、重来、忘掉 留下:被推翻的命题是结果,不是噪声
停止 模型觉得差不多了 会改变答案的候选与反常都已处理,或写进「尚未确定的事项」
沉淀 一段聊天记录 一个本体:结构定义与有依据的断言并列呈现

环内是这台仪器的读数面:横轴是 L0–L4 七个等级,那条虚线是事先登记进判据的阈值;五个观测各带误差棒——被支持的填实、无法判定的画虚圈、被推翻的留在原位打一道斜杠(什么都不删)。开口处那颗 emerald 是唯一越过判据、落定成事实的读数。

本体随着研究逐步形成,进入可信知识前检查结构与证据:

  • 先定目标,再按需建模。 先登记目标与可检查的完成标准,假设和本体可以逐步补充。选中主张进入独立核验前,补齐它实际使用的概念、关系、实体、单位和断言;ReviewClaims 与 Conclude 使用相同准入。
  • 候选有明确边界。 为有价值的主张登记命题、推翻条件和适用范围,保留替代解释与反例。普通读取、计算和探索无需逐步派评,也不必先创建自定义计划;旧计划保留原契约。
  • 反常要有去处。 和预测或本体对不上的读数记成未解释项:被解释、写明理由排除,或写进结论;指向已确立事实的未解释项会让那条事实回到「待核验」。
  • 结论按问题交付。 每个问题四部分:结论 / 依据 / 尚未确定的事项 / 待您决策。仍在考察中的候选和开着的未解释项没写进结论,就不能以「达成」结案。

任务状态从会话记录派生,文件完整性凭据由宿主另外持久化;模型的工具里没有可以宣告某一步完成的字段,目标也只能在独立评估通过后完成。ClearAI 只做宿主做不了的那部分——认识论契约、领域本体、呈现;目标续跑、子代理、问人、交付卡片、文件历史都用 DSH 原生的。

ClearAI 不声称递归自我改进。它提供的是自我改进系统所需要的认识论底座。详见定位与OpenRSI 调研。


安装与使用

要求: DSH ≥ 0.2.2-rc.1,这是 0.5.8 的目标宿主。评估者仅使用 startActivation 和独立评估者预设,不保留旧派遣 API 分支。

推荐——在应用里装,并把版本钉住:

侧栏打开**「插件」→ 添加插件**,填 clearai-dsh@0.6.0,安装。这就是 DSH 自己的插件管理器:它把你填的东西交给 pnpm,校验这个包声明了组合包、与当前宿主兼容,然后当场生效。(设置里的插件列表是只读清单;安装入口在侧栏那个「插件」页。)

或者开终端——同一次安装:

dsh plugin --profile web add clearai-dsh@0.6.0

从 npm registry 装预构建产物。本机不跑任何编译,因此不需要批准 allowBuilds 授权——命令返回时插件就已经可用。

为什么要钉版本。 pnpm ≥ 11 会压住刚发布的版本:minimumReleaseAge 默认 1440 分钟,而这条内置默认是非严格的,于是裸包名(或 @latest)会静默回退到一天以前的最新版——刚发完新版时,那就是上一版。DSH 的插件管理器把你填的 spec 原样转给 pnpm,而且不比对装到的是不是你要求的,所以这次降级会显示成安装成功;它的预览卡也帮不上忙:预览走 pnpm view,不受这条策略过滤,于是可能出现「预览显示最新版、装下去是上一版」。两种写确切版本的办法:

  • 把版本钉住(上面两条命令都是)——pnpm 会自己记下例外。

  • 或者一次性豁免这个包,写在 profile 的 pnpm-workspace.yaml 里;之后裸包名也能装:

    minimumReleaseAgeExclude:
      - clearai-dsh
    

也提供——一条命令的安装器(它自己解析当前版本并钉住,因此不受这条延迟影响):

npx clearai-dsh install

底层是同一个安装;它会从 PATH(或经 npx)解析出 DSH CLI,装进 web profile,再把合成后的配置读回来验证,所以「成功」不是靠信。想走引导式流程就用它,--lang zh|en 可指定安装器输出语言。

社区市场(第三方):dsh-market 只列 awesome-dsh-plugin 目录里的条目,并且会替你钉住版本;ClearAI 的条目正在那边评审。它不属于 DSH,也不是装本插件的必要步骤。

从源码安装(开发用,不是常规路径):

dsh plugin --profile web add github:Clearailhc/clearai-dsh

Git 拉的是源码而不是构建产物,所以 pnpm ≥10 会拒绝运行 prepare 脚本,直到你在该 profile 的 pnpm-workspace.yaml 里加上 allowBuilds 条目。那条授权的含义是允许该包代码在安装时于你机器上执行——只在你读过源码后再授权,并且固定 commit。如果你只是想用 ClearAI,请用上面的 npm 安装。

安装侧的输出跟系统语言走(--lang zh|en 可覆盖;doctor 同样认这个开关)。运行时依赖只有 zod——图谱那套栈在构建期就打进客户端了。

装完重启 dsh web(npx @deepseek-ai/dsh web),然后新建会话,在顶部的模式选择器里切换到 ClearAI:

  1. 打开 dsh web,点「新建会话」;
  2. 点顶部当前的模式名(默认是「标准模式」),展开预设列表;
  3. 选 ClearAI——卡片描述就一句:「利用认识论循环构建可信本体。Build a trustworthy ontology through the epistemic loop.」;
  4. 像平常一样提问。普通问答照常走;一旦立了目标,系统自动进入知识模式:已知送上来,本体随立题写下,结论过证据才准入。过程在「探索」一格看,结论在「本体」一格看。只有你能做的决定才会来问你。

JEPA 世界模型那场会话之后的「本体」一格(0.5.0 布局;0.5.1 起,进度轨与全部判断移到「探索」一格的过程记录,「本体」一格改为结论卡、图、已确立的事实与经验)。

如果 PATH 上没有 pnpm:npm install -g pnpm(别用 corepack enable——它装的是版本转发器,可能下载一个自己启动不了的 pnpm)。

从仓库开发:

npm test                       # 17 份套件
node tools/build-package.mjs   # 由源装配 dist/
node tools/verify-package.mjs  # 现场重建并逐字节比对
node docs/diagrams/build-hero.mjs   # 重画产品主图(需 google-chrome)

dist/ 是生成物,不进版本库。见 DSH 集成。


它长什么样

中栏两格:探索与本体。探索记录过程,本体只放结果。计划进度同步到 DSH 原生的 todo 停靠栏。

探索——当前在回答什么、还有哪些可能未被排除、下一步做什么。页眉是课题与阶段(广度调研 / 定向求解)、当前问题、计划进度;下面依次是待您处理的事项、调研板块(广度调研时)、每个问题的候选假设(考察中 / 已排除 / 已采纳 / 暂不考察,点开看提出依据、推翻条件、预测与关联记录)、下一步及各候选的预测(预测相同时说明此步骤无法区分它们)、未解释的现象。新发现的问题带「立为问题 / 暂缓」两个按钮,按下即替您向模型发一句话,由模型修订立题。最下面是默认折叠的过程记录:判断的计数与进度轨、全部判断、计划的步骤与门。

本体——先读知识地图,再看结论与依据,最后是已确立知识。结构定义与实体断言分层展示;用搜索或列表选择对象,查看邻域、完整名称和证据。图谱保留用户视口与拖动位置。

交付——结案时,各步收下的产物以 DSH 原生交付卡片出现;每轮改了哪些文件,看 DSH 原生的改动卡片。

语言——系统自己写的话(工具结果、运行态卡、问你的话、clear/ 下的文件)都跟着你说话的语言走,中文或英文。面板跟着界面语言。

当前本体面板:默认保持可读缩放,概览按钮可查看全图;节点不因图谱密集而被截断。数据来自有来源记录的 JEPA 历史会话。

研究面板:JEPA 历史会话回放。另见深色、窄屏与实体详情、窄屏详情。


和裸模型比

同一个模型、同样的工具和预算,一边开 ClearAI、一边不开,做同一批埋了陷阱的题,盲评。这是 0.5.0 在开发集上的初步结果(题目是开发方出的,样本小),不是正式的有效性结论;0.5.1 后续开发对照未通过止损线。

实验 ClearAI 裸模型
反应器题:控温热电偶中途漂移 8 °C,各 4 组 3/4 发现并按实际温度纠正 1/4
同一装置连做 3 条线:漂移每条都换方向和起点,各 3 个序列 后两题纠正 5/6,第 3 题均分 1.5 / 4 1/6,1.17 / 4
电解液题:没有数据陷阱,各 4 组 2.25 / 5 2.25 / 5

两边都看到了参考读数对不上,差别在看到之后:ClearAI 动手前写下预测,落空的地方不能被解释过去,只能被解释、写明理由排除或交给人;独立评估者再查一遍原始数据。前一题留下、经评估者核过的经验,下一题写预测时会被点名用上。

两边都没变好的是探索深度:配方离真最优一样远,都没找到温度与另一个因素的耦合。代价是约 2.2 倍 token。0.5.1 的候选假设、按候选预测与结案前的停止检查,针对的正是这一项。过程与原话见案例:和裸模型对照,全部记录在 docs/optimization/sim-runs/。


原生 DSH 全部展开全景:本体图 · 实体图。历史回放包含 24 个本体节点、72 个实体与取值节点。

0.5.8 完整性与验证边界

宿主持久记录事实、经验、负向条目、评估卡和目标文件的内容摘要与权威写入来源,在工作区同步、知识沿用、交付、结案及审计恢复时核对。异常会停止相关信任和推进,原文件保留。未登记的历史知识可以查看,必须重新核验后才能可信沿用;可恢复已登记内容,或在干净工作区重新核验,修改凭据本身不算核验。

这属于指定边界上的完整性检测,不是操作系统沙箱。任意 shell 仍可能写盘,检查前“修改后恢复”可能无法发现,工作区外部副作用不在保证范围内。评估者使用过滤后的副本复跑;副本失败不能让要求复跑的判据通过。落账字符限制、模型生成预算与运行时长限制是三项不同控制。

研究面板以问题与候选为主栏,下一步与异常为侧栏,窄屏单列;本体面板按知识地图、结论与依据、已确立知识阅读。概念为空心菱形、实体为实心圆点,取值使用轻量标签。搜索、列表、邻域、拖动、概览和键盘操作共享选择状态;Escape 退出全屏,窄屏详情显示为底部抽屉。

0.5.8 的真实验收与发布门槛状态见验收记录。工程检查与小规模模型样本不能证明普遍正确性或效率优势。

后续 0.5.1 开发对照未通过止损线:计入独立评估者后,总处理 token 为裸模型的 4.8–7.2 倍。上面的 0.5.0 正面结果与这份负面结果属于不同版本和样本。主模型、评估者及其他模型调用都应计入成本;token 合计不是美元账单。0.5.8 按用户要求收缩为首场配对验收:裸模型评分 99.98/100、ClearAI 99.99/100;计入两次提前停止与续跑,ClearAI 的处理 token 为裸模型约 20 倍、按峰值价估算的费用约 14.6 倍、运行时间约 12.7 倍。其余两场 ClearAI 对照暂缓。这份小样本未显示效率优势;见完整记录。

案例

前两个是真模型从头跑到尾、中途没问人的会话,截图是在真 DSH 里回放它们拍的;第三个是和裸模型的模拟对照。

  • JEPA 世界模型:文献综述、交给独立评估者判的玩具实验,以及 21 个概念、8 种关系、27 个实体的本体
  • Navier–Stokes 被解决了吗?:两条流行说法被推翻并保留,一次准入被拦后如实处理,以及 24 个概念、13 种关系、59 个实体的本体
  • 和裸模型对照:同一台会漂的小试装置上,ClearAI 与裸模型各自怎么对待一个对不上的参考读数(开发集,盲评)

文档

它落在 DSH 的哪一层

ClearAI 把认识论层加在 DSH 的组合面上——一个宿主包、一个 agent 预设、一个客户端模块,DSH 引擎一行都没改。工作方式不设限,但它们写不进权威账本(权威边界由测试钉死)。

工作署名

本项目的工作署名单位为基点起源。

Star 曲线

许可证

Apache-2.0,见 LICENSE。

状态

一个通过 DSH 交付的本地优先本体发现与探索平台。哪些还没实现、哪些还没在真浏览器里验过,都写在已知缺口里。

证据读取与知识计数

主代理通过原生工具读取和修改工作材料。ReadEvidence 批量读取有界原文;普通读取始终返回文本。仅检查本会话已读范围有无变化时设 ifUnchanged:true;字节或范围变化仍返回原文,上下文压缩后可普通读取恢复。指纹一致不证明结论成立或当前适用。独立评估者有独立读取记录,须将原工作区视为只读,在隔离副本中修改和复跑。评估者向主代理返回问题和修复建议,副本修改不回写主工作区;外部文件变化不视为主代理上下文已经包含的信息。

知识概览分别显示本目标事实、已加载事实、待复核事实、事实内断言及实体文件记录。定义和实体记录的存在不代表独立认证;计数展示不新增模型调用。复用声明须区分此前实际读取/执行的既有产物与本阶段新建快照。

读取结果的 sourceOrigin 还区分会话首次用工具前已观察到的文件、记录基线之后新建的文件和无法确定的来源(包括没有完整基线的恢复会话)。这只记录文件来源,不证明内容被正确复用。

评估者限制属于工具与裁决权限边界,不等于文件系统沙箱:直接写工具禁用,结算校验发现引用材料变化时拒绝落账。操作系统层面的只读强制约束取决于宿主沙箱;复跑副本的改动不会回写成主代理已完成的修复。

Conclude 与 ReviewClaims 使用相同的主张本体准入。最终交付未通过时,只有覆盖完整、结构有效且评估者明确确认不受缺口影响的主张才能保存,目标仍开放;修复缺口后直接 Conclude。立题时的文件基线跨修订和重放保留,与旧审计版本分开;没有基线就保持未知。导出图谱不会被自动导入或认证。

内容来自项目 README(GitHub)↗

链接

同类插件

查看整个分类 →

社区评论

评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。