clearai-dsh

dsh plugin --profile web add clearai-dsh

<p align="center">

<picture>

<source media="(prefers-color-scheme: dark)" srcset="brand/logo-lockup-dark.png">

<img src="brand/logo-lockup.png" alt="ClearAI" width="360">

</picture>

</p>

<p align="center"><a href="README.md">English</a> · <b>中文</b></p>

<p align="center">

<a href="https://trendshift.io/repositories/248415?utm_source=trendshift-badge&amp;utm_medium=badge&amp;utm_campaign=badge-trendshift-248415" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/trendshift/repositories/248415/weekly?language=JavaScript" alt="Clearailhc%2Fclearai-dsh | Trendshift" width="250" height="55"/></a>

</p>

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

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

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

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

0.5.9 使用 DSH 官方行内研究事件，研究与本体保留独立页签。[发布验收](docs/optimization/0.5.9-release/README.md)记录真实端到端任务、费用与限制。

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

重启 dsh web，在新建会话顶部的模式选择器里选 ClearAI 即可。这就是全部步骤。[完整安装说明 ↓](#安装与使用)

<picture>

<source media="(prefers-color-scheme: dark)" srcset="docs/diagrams/ontology-hero-dark.zh-CN.png">

<img src="docs/diagrams/ontology-hero.zh-CN.png" alt="认识论循环（左）长出领域本体（右）" width="1200">

</picture>

0.5.8 生产界面回放已归档的 JEPA 真实会话。图中是历史研究数据，不是本版新增模型结果；结构定义与已核验断言分开呈现。[截图来源](docs/shots/0.5.8/jepa-provenance.json)。

---

你得到什么：领域本体

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

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

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

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

· 任务循环 · 认识论循环

驱动问题 · 下一步做什么？ · 我们现在知道什么，依据是什么？

完成 · 模型宣布完成 · 系统按交付的证据算出来

裁决 · 谁做的谁说了算 · 分离——超过一定等级，做的人不能判自己

失败 · 删掉、重来、忘掉 · 留下：被推翻的命题是结果，不是噪声

停止 · 模型觉得差不多了 · 会改变答案的候选与反常都已处理，或写进「尚未确定的事项」

沉淀 · 一段聊天记录 · 一个本体：结构定义与有依据的断言并列呈现

<picture>

<source media="(prefers-color-scheme: dark)" srcset="docs/diagrams/epistemic-loop-hero-dark.zh-CN.png">

<img src="docs/diagrams/epistemic-loop-hero.zh-CN.png" alt="认识论循环" width="1000">

</picture>

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

循环里本体在前，不在后：

• 立题时写本体。 答案涉及哪些量、各由什么测量、读数如何核对、量之间如何相互影响，随立题一次写入。缺测量方式的度量，不能立题。
• 本体给出候选。 探索问题建议比较多个候选并注明来源关系；至少两个候选是指导原则，并非所有任务的硬门槛；每一步动手前按候选分别写预测，预测都一样的步骤会被指出无法区分它们。
• 反常要有去处。 和预测或本体对不上的读数记成未解释项：被解释、写明理由排除，或写进结论；指向已确立事实的未解释项会让那条事实回到「待核验」。
• 结论按问题交付。 每个问题四部分：结论 / 依据 / 尚未确定的事项 / 待您决策。仍在考察中的候选和开着的未解释项没写进结论，就不能以「达成」结案。

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

ClearAI 不声称递归自我改进。它提供的是自我改进系统所需要的认识论底座。详见[定位](docs/positioning.zh-CN.md)与[OpenRSI 调研](docs/research-openrsi.md)。

---

安装与使用

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

推荐——在应用里装，并把版本钉住：

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

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

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

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

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

- 把版本钉住（上面两条命令都是）——pnpm 会自己记下例外。

- 或者一次性豁免这个包，写在 profile 的 pnpm-workspace.yaml 里；之后裸包名也能装：

```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. 像平常一样提问。普通问答照常走；一旦立了目标，系统自动进入知识模式：已知送上来，本体随立题写下，结论过证据才准入。过程在「探索」一格看，结论在「本体」一格看。只有你能做的决定才会来问你。

<picture>

<img src="docs/shots/zh/jepa-ontology.png" alt="ClearAI 模式下的「本体」一格" width="820">

</picture>

[JEPA 世界模型](docs/cases/jepa-world-model.zh-CN.md)那场会话之后的「本体」一格（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 集成](docs/dsh-integration.zh-CN.md)。

---

它长什么样

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

探索——当前在回答什么、还有哪些可能未被排除、下一步做什么。页眉是课题与阶段（广度调研 / 定向求解）、当前问题、计划进度；下面依次是待您处理的事项、调研板块（广度调研时）、每个问题的候选假设（考察中 / 已排除 / 已采纳 / 暂不考察，点开看提出依据、推翻条件、预测与关联记录）、下一步及各候选的预测（预测相同时说明此步骤无法区分它们）、未解释的现

…(truncated)