以证据为准的研究用智能体预设:每一步只能靠系统核验过的观测推进,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:
- 打开
dsh web,点「新建会话」; - 点顶部当前的模式名(默认是「标准模式」),展开预设列表;
- 选 ClearAI——卡片描述就一句:「利用认识论循环构建可信本体。Build a trustworthy ontology through the epistemic loop.」;
- 像平常一样提问。普通问答照常走;一旦立了目标,系统自动进入知识模式:已知送上来,本体随立题写下,结论过证据才准入。过程在「探索」一格看,结论在「本体」一格看。只有你能做的决定才会来问你。
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。立题时的文件基线跨修订和重放保留,与旧审计版本分开;没有基线就保持未知。导出图谱不会被自动导入或认证。
链接
同类插件
FuRongJun-1999/dsh-memory★ 672
白箱AGI架构探索:元认知(自我认知循环)、持续学习(知识飞轮)、世界模型(条件空间+语义时空图)、自我改进(自举纪律)、零LLM白箱管线与可审计信任护栏。
icyaaaww/dsh-soul★ 85
在本地记录重复的任务纠正与工具错误,通过显式启动的演化将经验编译为八类运行组件的改动,经过基线与候选成对验证、影子试用和回滚,并提供预算与审计账本。需要 Node.js 24+ 及兼容的 DSH 0.2.1-rc.2 起的 0.2.x 宿主。
MichengAI/dsh-pua★ 72
提供 /pua,在 Agent 失败后促使其换方法,并在宣称完成前核验收据;含 15 种公司风格、角色模式、全局与会话设置,以及可选验收循环(直到验收命令通过、达到迭代上限或用户取消)。
kenz1117/dsh-engram★ 70
跨会话长期记忆,纯本地 SQLite:双层分库(用户级 + 按 git origin 隔离的项目级)、FTS5 + 本地向量 RRF 融合检索、强制给出充分性判定的证据门、来源审计链、SM-2 间隔重复复习、巩固蒸馏与衰减遗忘,以及九视图「记忆宫殿」侧栏面板。22 个窄参数工具,无外部服务、无 API Key、无 Docker。
pk14742952-AD/dsh-host-rsi★ 39
面向本地 Qwen3.8 27B/3.8 Flash 及线上 API 的反思进化插件:编码循环收敛器针对 Qwen3.8 27B/Flash 的重复验证大思考加速收敛、减少思考时间;五态交付护栏检测并纠正卡住/死循环;model-agnostic 宿主逻辑,线上 API 多数可通用;每次使用持续自进化,带反问式自检、批评升级、倒排索引记忆检索、编码循环收敛提示与五态交付护栏。
Kanadego/dsh-heartbeat★ 30
让 agent 不定期醒来的插件:默认 60 分钟一次,上下浮动 20%(48~72 分钟)。按你设的兴趣范围上网逛逛,看到的东西存进本地素材池,顺手维护一份你的兴趣画像。攒够值得说的,就往你绑定的会话递一份短素材——说不说、说哪条,交给那个会话里的 agent 按眼前处境定。静默时段、忙时窗口、每日上限、冷却都在代码层判;判别说时,闸门之后的决策与表达两相不再调用模型(闲逛相在闸门之前,另算)。支持 Windows、Linux 与 macOS(Linux / macOS 为最小支持)。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。