clearai-dsh 0.2.2 → 0.2.5

package/CHANGELOG.md

@@ -2,6 +2,55 @@
 
 All notable changes to this project are recorded here. The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.5] — 2026-09-28
+
+**跟上了宿主的会话格式 v4(消息来源改成生产者自有)。** 宿主 `0.1.7-rc.2` 起,`source.kind` 就是**生产者自己的身份**:共享包装 `{ kind: 'plugin', plugin }` 已退役,原生接纳在落账那一步**当场拒绝**它,报 `format v4 message requires a producer-owned source kind`。内核一直用旧包装下发运行态卡与外脑事实(合并目录 / 运行档 / 候选技能 / 世界线回灌),于是**每一轮都在落账那一步整轮失败**——卡片与事实一条都进不去。而单测当时全绿:它们直接调 fold,不经过宿主的接纳。
+
+**为什么是 `plugin:clearai` 这个值**:宿主读取已发布 V3 日志时,未知名插件正是按 `plugin:<插件名>` 抬升的。选同一个值,老会话折得出来、新会话写得进去,两侧只认一个名字;另起一个名字则要永远维护新旧两套(而且旧会话在面板上的署名会和新会话长得不一样)。
+
+### Changed
+
+- **内核署 `plugin:clearai`,不再写 `plugin` 字段**:`MESSAGE_SOURCE_KIND` 一处定义,运行态卡与无卡通知两条通道共用。
+- **折叠层同时认两种署名**:`plugin:clearai`(现在写的)与退役前的 `{ kind: 'plugin', plugin: 'clearai' }`(事件被**直接**喂进来时仍带着它:测试、旧导出、重放工具)。退回到旧形状时身份在 `plugin` 字段上,**只认 `clearai`**——别的插件冒名不进这道门。
+- 形态字段没动:`form: 'snapshot'` + `sections` 照旧,面板的上下文注入行仍按 `form` 渲染(署名只换了个名字,呈现不变)。
+- **e2e 里按 v3 形状找工具结果的地方跟着改到 v4**:`toolCallId` 在 v4 挂在**结果消息本身**上(退役前嵌在第一个 content 块里),旧写法让 `CreatePlan` 的两条断言**永远假红**(进程 exit 0、变更记录也落了,断言却报「契约错误」);`--freeform` 那两场的目标/计划断言也改成随形态跳过——与同一份工具里其余断言的判据对齐。
+- **本地「干净安装」门不再随手挑一份 npx 缓存里的宿主**:这台机器的缓存里躺着 0.1.5-rc.1 与 0.1.7-rc.2 两份,`readdir` 挑到旧的那份时 `--dump-config` 会因为我们的 bundle patch 是数组(宿主 0.1.7-alpha.1 起才支持)当场崩,四条组合断言全红——而真正的原因(验的根本不是要支持的宿主)一个字都不在输出里。现在按版本挑最新的一份,并把「dsh 来自哪里、是哪个版本」念出来(CI 走 `DSH_CLI_PREFIX`,不受影响)。
+
+**证据**:拿宿主真代码(`dsh-session-format-v3-to-v4` 的 `assertV4RowAdmission`)验过——新署名接纳,旧署名以那条原话被拒;并确认转换表里没有 `clearai`(所以旧日志正好抬升成同一个值)。内核侧新增一节断言钉住每一条下发消息的署名(非空、不是 `plugin`、等于 `plugin:clearai`、无 `plugin` 字段、form/sections 照旧);旧署名在 `test/host.test.mjs` 与 `test/invariant.test.mjs` 各留一条「仍折得出来」的正向用例。真跑一场(`node tools/e2e-run.mjs --installed`:真宿主 + 装出来的包 + 真模型 + 真会话日志):运行态卡以 `plugin:clearai` 落在日志里、没有接纳报错,`goal/set` 与 `plan/created` 照旧落账、投影长出计划,跨机制不变量全绿(35 通过 / 0 失败)。干净安装门(真 pnpm + 真 `dsh plugin add` + 真宿主 0.1.7-rc.2)18 通过 / 0 失败:装到的是 `clearai-dsh@0.2.5`,组合里 `clearai-host` 恰好一行,名册里 `clearai` 在列表里且没有 broken。
+
+## [0.2.4] — 2026-09-28
+
+**跟上了宿主的预设换代。** 宿主 `0.1.7-alpha.1` 起把 agent 预设的注册从「root 目录扫描」换成了「组合里的声明行」,而 clearai-dsh 一直靠一条覆盖 `agent-presets` 行的补丁,把名册的 root 指到包内 `presets/`。那行 id 在新宿主里**已经不存在**,补丁没有落点——包照样装得上、宿主行照样起得来,但 **ClearAI 不进模式选择器**。这一版把它接上。
+
+**`0.2.3` 没有发布。** 它以 `v0.2.3` 触发了发布流水线,在「干净安装」那道门被拦下(拦的正是上面这个断裂),publish、registry 回查、建 Release 三步全部 skipped——npm 上半点副作用都没有。它原本要带的三条文档改动(版本号、中英 README)并入本版,所以这一版也包含 0.2.3 的账。
+
+> ⚠️ **宿主支持边界:本版要求宿主 ≥ `0.1.7-alpha.1`。** 在更早的宿主(≤ `0.1.6-alpha.2`,包括曾被当作 `latest` 的 `0.1.5-rc.3`)上,本版会因为找不到 `@deepseek-ai/dsh-agent-preset` 而**让 profile 起不来**。仍留在旧宿主的部署请继续用 `0.2.2`。
+
+### Added
+
+- **预设声明行**:`presets/clearai/clearai.patch.yml` —— 一条 `- id: preset-clearai` 声明行,`config.plugins` 里放整份插件列表。它由 `preset/agent.cordis.yml` **构建期派生**(与 `ui/vendor/*.js` 同一条纪律:生成物进仓库,包 = 源的纯函数),不手抄第二份。`package.json` 的 `dsh.bundle.patch` 随之由单文件改为**数组**。
+- **干净安装验收新增两条运行态断言**:boot 一次 profile,直接读 `agentPresets.list()`,要求 `clearai` 在列表里**且没有 `broken`**。静态的 `--dump-config` 看不出这件事——探针实测过:preset 里放一个**根本不存在的插件**,boot 依然完全正常,只有名册记一条 broken,界面就不显示这个预设。
+
+### Changed
+
+- **包内插件改用包内子路径**:`clearai-kernel` 与 `clearai-commands` 由 `./plugins/*.js` 改为 `clearai-dsh/presets/clearai/plugins/*.js`(`exports` 里加 `"./presets/*"` 放行)。声明行 `plugins` 的相对基准与原来的 `agent.cordis.yml` 不同,不改就会在名册里一直记着「never started」。
+- **workflow 引擎换包**:预设里那条 `@deepseek-ai/dsh-workflow-worker-thread` 在新宿主里**已经下线**,改为同 group 内的 `@deepseek-ai/dsh-workflow-ptc`(与官方 standard 预设同形,且必须与 `tool-workflow` / `tool-ralph` 同处那个 `isolate: { workflowEngine: true }` 的 realm,否则两条工具会一直「waiting for workflowEngine」)。
+- `pack/cordis.patch.yml` 里那段 `- id: agent-presets` 覆盖**已删除**:它在新宿主上没有目标行,留着只会让下一个人以为预设还靠目录扫描。
+- 文档与版本信息:项目版本更新至 `0.2.4`,中英 README 更新(原 0.2.3 的三条改动)。
+
+## [0.2.3] — 2026-09-23(未发布)
+
+> 本版**从未发布到 npm**。它是纯文档版本(版本号 + 中英 README),在发布流水线上被宿主换代造成的断裂拦下——原样发出去的话,用户在新宿主上装到的包不进预设选择器。改动已并入 [0.2.4]。
+
+
+**文档与版本信息更新。**
+
+### Changed
+
+- 更新项目版本至 `0.2.3`。
+- 更新中文 README。
+- 更新 README。
+
 ## [0.2.2] — 2026-09-18
 
 **装的时候不再吓人。** 0.2.1 的 `npx clearai-dsh install` 会打出一串 peer 警告(react / graphology-types …),读起来像装坏了——而它们一个字都不影响运行。这一版把安装面收窄到运行时真正需要的那一个依赖,并让安装侧 CLI 按系统语言出话。

package/README.md

@@ -16,6 +16,14 @@ ClearAI is an **ontology discovery and exploration platform**, built on two core
 
 > Other knowledge graphs pile up edges by extraction and assertion; here every edge has to be earned through the loop.
 
+```bash
+# Install (npm package, prebuilt — no build step, no allowBuilds prompt)
+dsh plugin --profile web add clearai-dsh
+```
+
+Restart `dsh web`, then pick **ClearAI** in the preset picker at the top of a new session. That is the whole setup. [Full install notes ↓](#install-and-use)
+
+
 <picture>
   <source media="(prefers-color-scheme: dark)" srcset="docs/diagrams/ontology-hero-dark.png">
   <img src="docs/diagrams/ontology-hero.png" alt="The epistemic loop (left) growing a domain ontology (right)" width="1200">
@@ -61,10 +69,30 @@ ClearAI does **not** claim recursive self-improvement. It provides the epistemic
 
 ## Install and use
 
+**Recommended — install from npm:**
+
+```bash
+dsh plugin --profile web add clearai-dsh
+```
+
+This installs the prebuilt package from the npm registry. Nothing is compiled on your machine, so there is no `allowBuilds` grant to approve — the plugin is ready the moment the command returns.
+
+**Also available — one-command installer:**
+
 ```bash
 npx clearai-dsh install
 ```
 
+Same install underneath; it resolves the DSH CLI from your PATH (or through npx), installs into the `web` profile, and reads the composed config back so you are not taking "success" on faith. Use this if you prefer a guided path, or `--lang zh|en` to force the installer's output language.
+
+**Install from source (for development, not the normal path):**
+
+```bash
+dsh plugin --profile web add github:Clearailhc/clearai-dsh
+```
+
+Git fetches source rather than build artifacts, so pnpm ≥10 will refuse to run the `prepare` script until you add an `allowBuilds` entry to the profile's `pnpm-workspace.yaml`. That grant means *permission for this package's code to execute on your machine at install time* — grant it only if you have read the source, and pin a commit. If you just want to use ClearAI, use the npm install above.
+
 The installer's output follows your system language (`--lang zh|en` overrides it, `doctor` / `seed` / `unseed` take the same flag). Its only runtime dependency is `zod`; the graph stack is bundled into the client half at build time.
 
 Restart `dsh web` afterwards (`npx @deepseek-ai/dsh web`), then **create a session and switch to the `ClearAI` mode in the picker at the top**:

package/README.zh-CN.md

@@ -16,6 +16,14 @@ ClearAI 是一个**本体发现与探索平台**，核心由两个概念支撑
 
 > 别的知识图谱靠抽取与断言堆边；这里的每一条边都要通过循环挣得。
 
+```bash
+# 安装（npm 包，预构建——无需构建步骤，不会触发 allowBuilds 授权）
+dsh plugin --profile web add clearai-dsh
+```
+
+重启 `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">
@@ -61,11 +69,32 @@ ClearAI **不**声称递归自我改进。它提供的是自我改进系统所
 
 ## 安装与使用
 
+**推荐——从 npm 安装：**
+
+```bash
+dsh plugin --profile web add clearai-dsh
+```
+
+从 npm registry 装预构建产物。本机不跑任何编译，因此不需要批准 `allowBuilds` 授权——命令返回时插件就已经可用。
+
+**也提供——一条命令的安装器：**
+
 ```bash
 npx clearai-dsh install
 ```
 
-安装侧的输出**跟系统语言走**（`--lang zh|en` 可覆盖；`doctor` / `seed` / `unseed` 同样认这个开关）。运行时依赖只有 `zod`——图谱那套栈在构建期就打进客户端半了。
+底层是同一个安装；它会从 PATH（或经 npx）解析出 DSH CLI，装进 `web` profile，再把合成后的配置读回来验证，所以「成功」不是靠信。想走引导式流程就用它，`--lang zh|en` 可指定安装器输出语言。
+
+**从源码安装（开发用，不是常规路径）：**
+
+```bash
+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` / `seed` / `unseed` 同样认这个开关）。运行时依赖只有 `zod`——图谱那套栈在构建期就打进客户端了。
+
 
 装完重启 `dsh web`（`npx @deepseek-ai/dsh web`），然后**新建会话，在顶部的模式选择器里切换到 `ClearAI`**：
 

package/cordis.patch.yml

@@ -12,28 +12,21 @@
     - id: clearai-host
       name: 'clearai-dsh'
 
-# 预设(agent.cordis.yml)不在补丁层 —— 它由名册(roster)从 preset root 扫描。
-# 预设的注册方式有三种候选(补丁层重述名册行 / 播种到用户根 / 打印待粘贴的行),
-# 由 S2 的干净 profile 探针决定,不在这里拍脑袋。
-
-# ── 预设的 root:现场算出来,零安装期写入(S2 探针的结论)──────────────────────
+# ── 预设不在这里声明 root:宿主 ≥0.1.7-alpha.1 起名册不再扫目录 ────────────────
+#
+# 0.2.3 及以前走的是「root 目录」机制:宿主自带 `- id: agent-presets` 行,本文件覆盖它的
+# config,把 root 指到包内 presets/,归属落在 system 信任层。
+#
+# 0.1.7-alpha.1 起宿主把这一整套换成了**组合里的声明行**:
+#   · `- id: agent-preset-registry`(@deepseek-ai/dsh-agent-preset-registry)只剩
+#     default / selectedDefault —— `includeShippedRoot` / `includeUserRoot` / `roots` 全部消失;
+#   · 每个预设是一条 `- id: preset-<id>` 行(@deepseek-ai/dsh-agent-preset),
+#     `config.plugins` 里放整份插件列表。
 #
-# 名册(roster)只从 **root 目录**扫预设,而后端包没法自己声明一个 root —— 这是整个打包里
-# 唯一没有现成通道的一环。S2 在干净 profile 上把三件事都量过了:
-#   · `!!js` 在**补丁行**里确实会被求值(与自带补丁用 `!!js dshHomePath(...)` 同一条路);
-#   · 但 `baseUrl` 在补丁层里是**profile 目录**,不是本包目录(`resolvedRoots` 实测:
-#     `path:"BASEURL=file:///…/profiles/clearai-test/"`)——所以「拿 baseUrl 当包目录」不成立;
-#   · 而包在 profile 里的位置是**可预测的**:`dsh plugin add` 就是把它装进 profile 的
-#     `node_modules/`。于是 root 可以现场算出来:`<profile>/node_modules/clearai-dsh/presets/`。
+# 所以旧的那段 `- id: agent-presets` 覆盖在这里**没有落点**(该 id 已不存在于新宿主),
+# 已于 2026-09-28 删掉 —— 留着只会让下一个人以为预设还靠目录扫描。
+# 依据与实测:`lab/release/0.2.3-release-blocker.md`、`lab/adapter/0.2.4-design.md`。
 #
-# 于是不需要任何安装期写入(不改用户的文件、不需要 bin 先跑一遍),归属也落在 system 信任层。
-# 想改预设的人仍然有两条路:`clearai-dsh seed`(播种到用户根,可改可回滚)或复制成新 id。
-- id: agent-presets
-  config:
-    # ⚠️ 补丁层替换**整份** config:下面这些键要与部署里那份保持一致(上游将来加字段要跟上)。
-    default: standard
-    includeShippedRoot: true
-    includeUserRoot: true
-    roots:
-      - path: !!js "process.getBuiltinModule('node:url').fileURLToPath(new URL('node_modules/clearai-dsh/presets/', baseUrl))"
-        trust: system
+# 预设本体现在由 `presets/clearai/clearai.patch.yml` 承载(构建期由 preset/agent.cordis.yml
+# 生成,经 package.json 的 `dsh.bundle.patch` 数组挂上)。想改预设的人仍有两条路:
+# `clearai-dsh seed`(播种到用户根,可改可回滚)或复制成新 id。

package/lib/fold.js

@@ -849,6 +849,20 @@ function stampAt(mutations, time) {
 	})
 }
 
+/**
+ * ClearAI 自己署名的上下文消息吗。
+ *
+ * 宿主从 session 格式 v4 起把消息来源改成生产者自有:内核署 `plugin:clearai`
+ * (`kind` 就是生产者身份),共享包装 `{ kind: 'plugin', plugin }` 已退役。
+ * 退回到旧形状时**身份在 `plugin` 字段上**——只认 `clearai`,别的插件冒名不进这道门。
+ * 宿主读已发布 V3 日志时把旧形状抬升成 `plugin:clearai`;但事件被**直接**喂进这个纯函数时
+ * (测试、旧导出、重放工具)仍带着旧形状,所以两侧都认。
+ */
+function isClearaiSource(source) {
+	if (source === null || typeof source !== 'object' || !Array.isArray(source.sections)) return false
+	return source.kind === 'plugin:clearai' || (source.kind === 'plugin' && source.plugin === 'clearai')
+}
+
 /**
  * 会话日志事件 → 状态。这是投影的入口:除了工具结果里的变更记录,
  * 还吃三条**关于过程本身的事实**——
@@ -874,7 +888,7 @@ export function applyEvent(state, event) {
 		 * 将来真要消费它,记住一个坑:结论在「closing message:」之后——运行时前面那行摘要是
 		 * **它自己写的**,不是子会话说的话。
 		 */
-		if (source !== null && typeof source === 'object' && source.kind === 'plugin' && Array.isArray(source.sections)) {
+		if (isClearaiSource(source)) {
 			/**
 			 * 一条插件消息里可能**同时**带好几件事实(内核一次 pre-step 把目录、运行档、候选一起发)。
 			 * 所以这里是「逐件折」而不是「找到一件就 return」——早退会漏掉后面的事件:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clearai-dsh",
-  "version": "0.2.2",
+  "version": "0.2.5",
   "description": "ClearAI: The Epistemic Loop, native to DSH.",
   "type": "module",
   "private": false,
@@ -15,7 +15,8 @@
     "./client": "./lib/client.js",
     "./cordis.patch.yml": "./cordis.patch.yml",
     "./package.json": "./package.json",
-    "./invariant": "./lib/invariant.js"
+    "./invariant": "./lib/invariant.js",
+    "./presets/*": "./presets/*"
   },
   "bin": {
     "clearai-dsh": "bin/clearai.mjs"
@@ -39,7 +40,10 @@
   },
   "dsh": {
     "bundle": {
-      "patch": "./cordis.patch.yml"
+      "patch": [
+        "./cordis.patch.yml",
+        "./presets/clearai/clearai.patch.yml"
+      ]
     },
     "client": {
       "platform": "web",
@@ -51,8 +55,11 @@
     }
   },
   "keywords": [
+    "dsh",
     "dsh-plugin",
     "deepseek-harness",
+    "cordis",
+    "plugin",
     "clearai",
     "agent-preset",
     "evidence",

package/presets/clearai/agent.cordis.yml

@@ -132,7 +132,12 @@
 # 达成→收回,触礁/放弃→置阻塞,重启后自动补防。
 # 配置项就是机制的旋钮:
 - id: clearai-kernel
-  name: ./plugins/clearai-kernel.js
+  # 用**包内子路径**而不是 `./plugins/…`:宿主 ≥0.1.7-alpha.1 起,预设是声明行
+  # (presets/clearai/clearai.patch.yml)里的 plugins 列表,相对基准不再是本文件所在目录 ——
+  # 实测 `./plugins/clearai-kernel.js` 会以「never started」出现在名册的 broken 里。
+  # 包名 + 子路径从 profile 的 node_modules 解析,与宿主解析其它插件名同一条路,
+  # 由 package.json 的 `"./presets/*"` 导出放行。
+  name: 'clearai-dsh/presets/clearai/plugins/clearai-kernel.js'
   config:
     # 连拦阈值:同一件事连续冲闸这么多次没过,计划置 blocked、停下等人。
     # 默认 3;这里写 2 是产品立场「人就在旁边,早点回来问」。它是**质量闸,不随运行档变**。
@@ -217,7 +222,8 @@
 # 一个字都不落账) + 一个呈审捷径(plan-review,把「重新呈审」steer 给模型,
 # 授权记号仍走 RequestPlanReview 工具落账——命令处理器没有变更通道,这是权威边界)。
 - id: clearai-commands
-  name: ./plugins/commands.js
+  # 同上:改用包内子路径(见 clearai-kernel 那一行的说明)。
+  name: 'clearai-dsh/presets/clearai/plugins/commands.js'
 
 # ── 工作方式(非权威能力,交还原生) ──────────────────────────────────────────
 
@@ -260,8 +266,13 @@
         toolName: subagent_fork
         backgroundMode: continuable
 
-    - id: workflow-worker-thread
-      name: '@deepseek-ai/dsh-workflow-worker-thread'
+    # 2026-09-28:workflow 引擎换代 —— 旧宿主是 `dsh-workflow-worker-thread`,
+    # 宿主 ≥0.1.7-alpha.1 里换成 `dsh-workflow-ptc`(前者已下线,是另一支实现)。
+    # 它必须与下面两条工具**同处这个 `isolate: { workflowEngine: true }` 的 realm**,
+    # 否则 tool-workflow / tool-ralph 会一直「waiting for workflowEngine」——
+    # 名册会给这个预设记一条 broken(实测实录)。
+    - id: workflow-ptc
+      name: '@deepseek-ai/dsh-workflow-ptc'
       config:
         provider: spawn
 

package/presets/clearai/clearai.patch.yml

@@ -0,0 +1,332 @@
+# 自动生成,不要手改 —— 源是 preset/agent.cordis.yml 与 preset/preset.yml,
+# 由 tools/build-package.mjs 装配(包 = 源的纯函数;verify-package 会现场重建再比对)。
+#
+# 宿主 ≥0.1.7-alpha.1 的 agent-preset-registry 读的就是它:
+# 预设 = 组合里的一条声明行,plugins 是下面这份插件列表。
+# 0.2.3 及以前靠 root 目录扫描,那条路在新宿主上已经不存在了。
+
+- insert:
+    - id: preset-clearai
+      name: '@deepseek-ai/dsh-agent-preset'
+      config:
+        id: clearai
+        name: ClearAI
+        description: |-
+          利用认识论循环构建可信本体。Build a trustworthy ontology through the epistemic loop.
+        order: 10
+        plugins:
+          # The `clearai` agent preset: ClearAI 的「单循环 + 事实边界」认识论,作为一个可挂载的会话组合。
+          #
+          # 这份文件是一份 AGENT-PLANE 组合。名册(roster)把它挂在**一个 standing scope** 下,
+          # 每个选择它的会话以 scope 父子关系加入;因此这里的工具与提示词段覆盖每个加入的 agent,
+          # 而每个会话自己的状态按 Session/Agent 键在插件内部区分。
+          #
+          # 平面规则(为什么这样分):
+          #   · 认识论属于「一个会话的能力集」→ 预设平面(本文件 + ./plugins/clearai-kernel.js)
+          #   · 沙箱、审批、文件策略、模型路由、子代理注册表、持久化 → 宿主平面,**本文件一行都不碰**
+          #     (DSH 的硬约束:预设 exactly as privileged as the plugins it names;让它放宽自己的关押就废掉了关押)
+          #   · 循环面板的浏览器 UI 必须在宿主平面(客户端模块扫描只扫宿主 Loader 的行),
+          #     所以它不在本文件里,而在 profile 的 cordis.patch.yml 一行。
+          #
+          # 本内核**不发布任何服务**(工具、guard、提示词段、web 路由都由同一个插件在自身 fiber 内注册),
+          # 因此这一行可以坦然坐在预设里,不需要 isolate realm。realm 是给「预设真的拥有一个服务」用的。
+
+          # ── 身份 ────────────────────────────────────────────────────────────────────
+
+          # 预设自己的 persona,覆盖部署默认。`{{model}}`/`{{cwd}}` 由 agent 自己的路由与工作区解析。
+          - id: persona
+            name: '@deepseek-ai/dsh-persona'
+            config:
+              prefix: |-
+                你是 ClearAI 的主人格,运行在 DeepSeek Harness 上。
+
+                你以**单循环**工作:计划 → 执行 → 观察 → 反思,一个循环推进,不做多 Agent 编排。子角色(评估者)由系统按触发派生,不是自由委派。
+
+                你的判断是智能的部分:理解材料、提出假设、选择路线、判断哪条证据更可信。事实的部分由系统持有:什么算完成、进度是多少、一个事实能不能写进知识库、谁的裁决有效——这些都不由你声明,只由系统算出来。
+
+                你不靠提示词约束自己:完成要过观测准入,推进只能通过唯一完成动词,L3 以上的裁决由独立评估者写。你要做的是把智能用在判断上,而不是用在描述状态上。
+              suffix: 你的工作目录是 {{cwd}}。工作区就是用户的文件夹;`clear/` 是系统与外脑的目录,其余目录都是用户的。
+
+          - id: agent-instructions
+            name: '@deepseek-ai/dsh-agent-instructions'
+            config:
+              maxBytes: 65536
+              # 项目章程走**原生指令文件**这一条:空工作区铺下的 `PROJECT.md` 会被宿主当作
+              # 工作区指令基线注入(内容变了整份替换、字节有预算),我们一行代码都不用写。
+              # 候选名按 ClearAI 的 `taxonomy.json:special_files.constitution` 补一个。
+              instructionFileCandidates:
+                - PROJECT.md
+                - AGENTS.md
+                - CLAUDE.md
+
+          # ── shell ───────────────────────────────────────────────────────────────────
+
+          - id: tool-bash
+            name: '@deepseek-ai/dsh-tool-bash'
+            disabled: !!js process.platform === 'win32'
+
+          - id: tool-pwsh
+            name: '@deepseek-ai/dsh-tool-pwsh'
+            disabled: !!js process.platform !== 'win32'
+
+          # ── 文件系统 ────────────────────────────────────────────────────────────────
+
+          # 两行都只注册进宿主 `tools` 注册表、不发布任何服务,所以不需要 realm。
+          # `fs` 服务与它的观察策略留在宿主:读前先看(observation policy)是宿主不变量,不是本预设的选择。
+          - id: tool-fs
+            name: '@deepseek-ai/dsh-tool-fs'
+
+          - id: tool-fs-search
+            name: '@deepseek-ai/dsh-tool-fs-search'
+            config:
+              sampleOverCapGlobResults: false
+
+          # ── 后台任务 ────────────────────────────────────────────────────────────────
+
+          # 只挂模型面的控制工具。任务注册表留在宿主(bash 工具用 ctx.get 解析它,预设内部的作用域看不见),
+          # 它本来就按 owning agent 键,一个宿主实例服务所有会话。
+          - id: tool-jobs
+            name: '@deepseek-ai/dsh-tool-jobs'
+
+          # ── 技能(外脑) ─────────────────────────────────────────────────────────────
+
+          # 技能注册表在宿主并按 scope 分层:这两行注册进**本预设的层**,所以不需要 realm。
+          # `customSkillDirs` 指向本预设自己的 skills/ —— 哲学文本随预设走,`baseUrl` 就是预设目录,
+          # 因此整份预设被复制到任何部署,技能都跟着到位。
+          - id: skill-filesystem
+            name: '@deepseek-ai/dsh-skill-filesystem'
+            config:
+              customSkillDirs:
+                - !!js "process.getBuiltinModule('node:url').fileURLToPath(new URL('skills/', baseUrl))"
+
+          - id: tool-skill
+            name: '@deepseek-ai/dsh-tool-skill'
+
+          # ── 压缩(上下文是受控资源) ─────────────────────────────────────────────────
+
+          # `compaction-basic` 通过 ctx.get 读 `toolResultPruner`,所以剪枝器必须与它同一个 realm。
+          # `tokenMeter` 刻意在 realm 之外:它在宿主,按 Session 折叠,拥有浏览器读的上下文计量投影单元。
+          - id: compaction
+            name: cordis:group
+            group: true
+            isolate:
+              compaction: true
+              toolResultPruner: true
+            config:
+              - id: compaction-basic
+                name: '@deepseek-ai/dsh-compaction-basic'
+
+              - id: command-compact
+                name: '@deepseek-ai/dsh-command-compact'
+
+              - id: tool-result-pruner
+                name: '@deepseek-ai/dsh-compaction-tool-result-pruner'
+                config:
+                  thresholdChars: 8192
+                  headChars: 4096
+                  tailChars: 1024
+
+          # ── 认识论内核(本预设的灵魂) ───────────────────────────────────────────────
+
+          # 29 件意图工具(目标 2 + 计划 8 + 世界线 6 + 侦察 2 + 外脑 2 + 账本 2 + 领域语言 7,见 `MECHANISM_TOOLS`)
+          # + 一个 guard + 每回合派生的运行态卡 + 只增不删的台账 + 面板数据路由。
+          # 逐条对照 docs/loop-philosophy.md 的五条哲学,见 ./plugins/clearai-kernel.js 的文件头。
+          #
+          # 外脑:**读侧全走宿主原生**——`./plugins/brain.js` 只把工作区投影成技能条目
+          # (`clear/skills/**` → 目录条目;`clear/memory/**` → 一个**虚拟条目** `project-memory`,
+          # 正文现算所以没有「索引过期」),目录注入与按需加载由宿主的 `tool-skill` 承担(digest 变了才注入)。
+          # 自建的只有写侧两件:`SaveSkill`(默认候选态)与 `WriteMemory`(字段校验 + 标题去重)。
+          #
+          # 世界线(ForkPlan):互斥方案各占一份自己的工作副本,收敛是**算术**——拿事先登记的尺子
+          # 对读数排序,采纳最优的,落选的全部保留。算不出来就停下问人,绝不退化成随便挑一条。
+          # git 世界线已落地(A+B 两档):用户仓库可用就地开分支 + worktree,不可用退到旁路账本仓库。
+          #
+          # 装配是**清单驱动**的:工具面、提示词段、机制开关全部查表,代码里不出现模式名。
+          #
+          # 续跑:需要继续时,内核在宿主 `goals` 服务上布防一枚**续跑令牌**——计划收尾而目标未达成时,
+          # 由宿主的回合驱动自己开下一轮。**要不要继续由门状态决定**(未授权 / 等裁决 / 有人在等 → 停),
+          # 与运行档无关。宿主目标只当**驱动器**,内核从不读它做判断(事实仍然只从投影里算出来);
+          # 达成→收回,触礁/放弃→置阻塞,重启后自动补防。
+          # 配置项就是机制的旋钮:
+          - id: clearai-kernel
+            # 用**包内子路径**而不是 `./plugins/…`:宿主 ≥0.1.7-alpha.1 起,预设是声明行
+            # (presets/clearai/clearai.patch.yml)里的 plugins 列表,相对基准不再是本文件所在目录 ——
+            # 实测 `./plugins/clearai-kernel.js` 会以「never started」出现在名册的 broken 里。
+            # 包名 + 子路径从 profile 的 node_modules 解析,与宿主解析其它插件名同一条路,
+            # 由 package.json 的 `"./presets/*"` 导出放行。
+            name: 'clearai-dsh/presets/clearai/plugins/clearai-kernel.js'
+            config:
+              # 连拦阈值:同一件事连续冲闸这么多次没过,计划置 blocked、停下等人。
+              # 默认 3;这里写 2 是产品立场「人就在旁边,早点回来问」。它是**质量闸,不随运行档变**。
+              #
+              # 注意:同一个键在这个 config 里只能出现一次——YAML 的重复键会让 yaml 包直接抛错,
+              # 而 DSH 的加载器是**静默取值**的,所以重复键会以"另一个值生效"的形式骗过所有人。
+              blockedThreshold: 2
+              # brief 质量门:低于此长度只警告不阻断(brief.py)
+              minBriefChars: 280
+              # L4 必须有人放行:用宿主审批瀑布的 ask 实现(ClearAI 文档写了、代码未实现的那一条)
+              l4RequiresHumanRelease: true
+              # L4 只认外部来源:做的人自己写过的路径不算观测
+              l4RejectSelfWritten: true
+              # 假设数量下限:首次立目标至少登记 2 条候选假设(0 条一样拦)。候选对比是检验的前提——
+              # 只有一个猜想时,「验证」容易退化成找证据支持自己。修订目标不受此限。
+              # 内核缺省是 0(=机制中立);**这里写 2 是产品立场**,所以它是硬门,不是文案。
+              minHypotheses: 2
+              # 知识门:将要升格的命题必须已有断言的形态,否则结案被拒(在派评估者**之前**拦)。
+              # 为什么要有它:断言一直是「加法,不是门槛」,于是模型的最优策略就是
+              # 「检索 → 总结 → 写报告」——本体图、实体图、认识论三张图都长不出来,
+              # 因为**完成函数里没有它们**。让缺口进卡只解决「看得见」,这一道解决「绕不过」。
+              # 它与 minHypotheses 是两条不同的立场(开工要有候选对比 / 结论要有形态),所以是两个键。
+              # 内核缺省 false(= 断言始终是加法);这里写 true 是产品立场。
+              requireTypedPromotion: true
+              # deny_rules 十条里可移植的九条(路径越狱那条不搬:宿主沙箱已经拥有它,ClearAI 自己也说「不重复」)
+              bashDenyRules: true
+              # 独立评估者:spawn = fresh context(fork 会继承历史,做的人与判的人就分不开了)
+              auditProvider: spawn
+              auditTimeoutMs: 240000
+              # 评估者只读:工具面只给 read/glob/grep;provider 不支持时会降级,降级事实写进台账
+              auditToolFilter:
+                - read
+                - glob
+                - grep
+                # 看图也是读:评估者要能核图表类产物(只在挂了 attachments 的部署里存在,
+                # 内核会按工具注册表把它过滤掉,见 resolveToolFace)
+                - read_image
+              # 每回合派生的运行态卡(只在状态变化时注入:前缀稳定是硬约束)
+              runtimeCard: true
+              # 运行档:人在场 / 无人值守。**它只决定一件事**:澄清协议装哪一段
+              # (槽位 clarification 收敛;两套措辞互斥,永不同时在场)。
+              #
+              # 它**不决定**下面这些——写清楚是因为这四处曾经被误认为跟着档走:
+              #   · 计划授权 —— 计划**永远**要人在原生审阅卡上批准(CreatePlan 里没有自动确认分支,
+              #     confirmed_by 只有 'user' 与 'progress');
+              #   · 续跑策略 —— 要不要继续由 turnDemand 从**门状态**算出来(未授权/裁决在飞/门开着 → hold);
+              #   · 续跑轮数 —— 只有一个默认值 128,不按档取;
+              #   · 面板开关 —— 人门动词 set_autonomy 已摘除,当前没有切换入口。
+              #
+              # 所以这里写的是**部署初值**,不是"人此刻在不在场"的表示。
+              # 真正表达"要不要人"的是**门**:计划待确认 / 等裁决 / 有人在等。
+              autonomy: attended
+              # 续跑轮数上限。**刻意不写**:不写就回落到 DEFAULT_MAX_AUTO_TURNS(128),在布防点现算。
+              # 显式写一个数就两档都用它。这个键存在的意义是**保险丝**:够长到能跑完一件真活,
+              # 又短到不会无声烧掉一整夜。
+              # 执行者是**原生**:数字传到宿主目标的 maxGoalRounds,到限由 `dsh-goal-round-driver`
+              # 自己 block(code='round-limit')——上限真的是机制在执行,不是一句嘱咐。
+              # 上下文预算不在这里:那是原生 `dsh-token-meter` + `dsh-compaction-basic` 的活。
+              # 贡献表(ClearAI `composition.py` 的装配语义):装配根遍历清单,清单里出现表外的名字
+              # 当场抛错——未知机制 / 未知工具 / 未知段 / 已关机制却仍列着它的工具,四种错法都在装配期炸,
+              # 而不是静默少装一件工具、等某一轮才发现。
+              #
+              # 这里只写**机制开关**;tools / sections 缺省 = 目录全量(29 件意图工具、24 段提示词定义、
+              # 同一时刻 23 段在场——澄清协议那一段由 autonomy 在两套措辞里收敛)。
+              # 这些数字不靠人眼维持:`node tools/verify-truth-table.mjs` 会拿代码算出来的数核对它们。
+              # 要裁剪就把 tools 或 sections 显式写出来:
+              #   tools: [SetGoal, CreatePlan, AdvancePlan, ...]      # 名字必须都在工具目录里
+              #   sections: [clearai/foundation, clearai/loop-contract, clarification, ...]
+              # `clarification` 是槽位名;直接写两套措辞里的哪一个会被拒绝(同时在场不可表示)。
+              contributions:
+                mechanisms:
+                  goal: true
+                  plan: true
+                  worldline: true
+                  scout: true
+                  brain: true
+                  ledger: true
+
+          # ── 人侧命令(/ 菜单) ────────────────────────────────────────────────────────
+
+          # 五个命令都是**人侧界面**:四个只读状态窗(goal/plan/evidence/worldline,从账本现算,
+          # 一个字都不落账) + 一个呈审捷径(plan-review,把「重新呈审」steer 给模型,
+          # 授权记号仍走 RequestPlanReview 工具落账——命令处理器没有变更通道,这是权威边界)。
+          - id: clearai-commands
+            # 同上:改用包内子路径(见 clearai-kernel 那一行的说明)。
+            name: 'clearai-dsh/presets/clearai/plugins/commands.js'
+
+          # ── 工作方式(非权威能力,交还原生) ──────────────────────────────────────────
+
+          # todo / 子代理 / workflow / ralph 是**工作方式**,不是认识论:它们一件 clearai 变更都
+          # 产不出来(权威边界测试钉死:变更字面量只在内核、入口被标记把守)。模型干活不设限,
+          # 但结论要进权威账本,只能由主线自己过观测准入与唯一完成动词。
+          - id: tool-todo
+            name: '@deepseek-ai/dsh-tool-todo'
+            config:
+              allowParallelInProgress: true
+
+          # `subagents` 注册表与 spawn/fork 后端在宿主平面;`workflows` 是谁都不在外面读的服务,
+          # 所以到达它的行共享这一个 entry-local realm(与 standard 预设同形)。
+          - id: delegation
+            name: cordis:group
+            group: true
+            isolate:
+              workflowEngine: true
+            config:
+              - id: tool-subagent-control
+                name: '@deepseek-ai/dsh-tool-subagent-control'
+
+              - id: tool-subagent-list-agents
+                name: '@deepseek-ai/dsh-tool-subagent-control/list-agents'
+
+              # 执行者自选模型:重活可以换模型跑(modelSelectionSettings 出面板设置)。
+              - id: tool-subagent
+                name: '@deepseek-ai/dsh-tool-subagent'
+                config:
+                  provider: spawn
+                  toolName: subagent
+                  modelSelectionSettings: true
+                  backgroundMode: continuable
+
+              # fork 不开模型选择:provider/model 与父保持一致,继承的历史才能继续吃 KV Cache。
+              - id: tool-subagent-fork
+                name: '@deepseek-ai/dsh-tool-subagent'
+                config:
+                  provider: fork
+                  toolName: subagent_fork
+                  backgroundMode: continuable
+
+              # 2026-09-28:workflow 引擎换代 —— 旧宿主是 `dsh-workflow-worker-thread`,
+              # 宿主 ≥0.1.7-alpha.1 里换成 `dsh-workflow-ptc`(前者已下线,是另一支实现)。
+              # 它必须与下面两条工具**同处这个 `isolate: { workflowEngine: true }` 的 realm**,
+              # 否则 tool-workflow / tool-ralph 会一直「waiting for workflowEngine」——
+              # 名册会给这个预设记一条 broken(实测实录)。
+              - id: workflow-ptc
+                name: '@deepseek-ai/dsh-workflow-ptc'
+                config:
+                  provider: spawn
+
+              - id: tool-workflow
+                name: '@deepseek-ai/dsh-tool-workflow'
+
+              - id: tool-ralph
+                name: '@deepseek-ai/dsh-tool-ralph'
+                config:
+                  subagentProvider: spawn
+                  maxRounds: 64
+
+          # ── 其余模型面 ──────────────────────────────────────────────────────────────
+
+          - id: tool-ask-user
+            name: '@deepseek-ai/dsh-tool-ask-user'
+
+          # `web` 服务与它的搜索提供者在宿主:这里只挂模型面的工具。
+          - id: tool-web
+            name: '@deepseek-ai/dsh-tool-web'
+            config:
+              fetch: true
+              searchTimeoutMs: 60000
+
+          - id: present
+            name: '@deepseek-ai/dsh-tool-present'
+
+          # ── 刻意不挂的行(是决策,不是遗漏) ─────────────────────────────────────────
+          #
+          # · `tool-goal` / `command-goal`:DSH 的 goals 服务已经被内核用作**续跑驱动器**
+          #   (布防/收兵都走它);再挂上模型面的 goal 工具,模型就能自己声明目标状态——
+          #   那是第二本账。ClearAI 的目标账只有一本,由内核持有,面板显示的就是它。
+          # · `plan-mode`:那是 DSH 的计划模式,与本内核的 CreatePlan/AdvancePlan 是两套计划纪律。
+          #   同时挂上就是第二本账。要它就得先决定哪一本是唯一账本。
+          #
+          # 曾经不挂、现在**挂回来了**的(阶段 5,权威边界由 test/authority-boundary.test.mjs 钉死):
+          # · `tool-todo` / `tool-subagent` / `tool-workflow` / `tool-ralph`:这些是**工作方式**,
+          #   产不出一条 clearai 变更。「不挂」当年防的是「自己派一个来判自己」——评估者的派遣
+          #   在内核里(auditProvider),与模型面的 subagent 是两层;后者派出去的只是干活的,
+          #   它的结论要进账本,只能回到主线过观测准入。

package/presets/clearai/plugins/clearai-kernel.js

@@ -248,6 +248,16 @@ export function syncTemplateSkills({ skillsDir, templateDir, record }) {
 /** 变更记录的封套标记:宿主投影只认它。 */
 const MUTATION_KIND = 'clearai'
 
+/**
+ * 内核下发的上下文消息**署名**。
+ *
+ * 宿主从 session 格式 v4 起把消息来源改成生产者自有:共享包装 `{ kind: 'plugin', plugin }`
+ * 已退役,原生接纳当场拒绝它(报 `format v4 message requires a producer-owned source kind`)。
+ * `plugin:clearai` 正是宿主读取已发布 V3 日志时给 clearai 抬升出来的那个值——
+ * 于是老会话折得出来、新会话写得进去,两侧只认一个名字。
+ */
+const MESSAGE_SOURCE_KIND = 'plugin:clearai'
+
 /** 自指检测:账本自指四条 + 对话自指三条。 */
 const SELF_REFERENCE = [
 	[/ClosePlan\s*成功/, '判据不得引用「ClosePlan 成功」——那是系统的动作,不是可核对的产物'],
@@ -5947,7 +5957,7 @@ export function apply(ctx, config = {}) {
 			id: `clearai-brain-${payload.turn}-${payload.step}-${Date.now().toString(36)}`,
 			role: 'user',
 			content: text(note),
-			source: { kind: 'plugin', plugin: 'clearai', form: 'snapshot', sections },
+			source: { kind: MESSAGE_SOURCE_KIND, form: 'snapshot', sections },
 		}
 	}
 
@@ -6768,8 +6778,7 @@ export function apply(ctx, config = {}) {
 					role: 'user',
 					content: text(card),
 					source: {
-						kind: 'plugin',
-						plugin: 'clearai',
+						kind: MESSAGE_SOURCE_KIND,
 						form: 'snapshot',
 						sections: [{ name: 'clearai', text: card }, ...brainSections],
 					},