clearai-dsh 0.2.6 → 0.2.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +15 -0
- package/README.md +12 -5
- package/README.zh-CN.md +12 -5
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,21 @@
|
|
|
2
2
|
|
|
3
3
|
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).
|
|
4
4
|
|
|
5
|
+
## [0.2.7] — 2026-09-28
|
|
6
|
+
|
|
7
|
+
**装完显示「成功」,装到的却是上一版——原因不在我们,但句子在我们这边。** pnpm ≥ 11 起 `minimumReleaseAge` 默认 **1440 分钟(一天)**,而这条内置默认是**非严格**的:一天内发布的版本不会被选中,但**不报错**——它静默回退到**一天以前的最新版**。于是刚发完 `0.2.6`,三条路装到的都是 **`0.2.2`**(2026-09-18):`dsh plugin --profile web add clearai-dsh`(裸包名)、`@latest`、以及**设置 → 插件列表**里填包名。一台 Mac 上实测如此,本机也用 pnpm 12.4.1 在干净工作区复现过(裸名 → 0.2.2;`clearai-dsh@0.2.6` → 0.2.6)。
|
|
8
|
+
|
|
9
|
+
这一版**不改包的行为**,只改用户会照抄的那几句,并加一条判据钉住它。
|
|
10
|
+
|
|
11
|
+
### Changed
|
|
12
|
+
|
|
13
|
+
- **README(中英)的推荐安装命令改成钉版本的** `dsh plugin --profile web add clearai-dsh@0.2.7`,并新增一段「为什么要钉版本」:机制、两种解法——写死版本(pnpm 会自己记下例外),或在 profile 的 `pnpm-workspace.yaml` 里 `minimumReleaseAgeExclude: [clearai-dsh]` 按**包名**豁免所有版本。「设置 → 插件列表」那条也改成填 `clearai-dsh@0.2.7`。
|
|
14
|
+
- **「一条命令的安装器」标注清楚**:`npx clearai-dsh install` 自己解析当前版本并钉住它(`bin/clearai.mjs` 一直传的是 `clearai-dsh@<自己的版本>`),本来就不受这条延迟影响。
|
|
15
|
+
- `docs/dsh-integration`(中英)的安装段同步;`docs/known-gaps`(中英)的「跑起来之前」补两条:pnpm 的这条年龄策略,以及**版本切换中途刷新插件列表可能看到的一次 `locale` 元信息错误**——那是宿主读到了换了一半的包(清单已声明 `locale/`、目录还没铺上),装稳后消失(装稳的 0.2.5 读出纯回退值,装稳的 0.2.6 读出中英标题、介绍与图标)。
|
|
16
|
+
- **自检门新增一条**:发行物里的 `README.md` / `README.zh-CN.md` 必须出现钉到**本版版本号**的安装命令,且不许出现教人敲裸包名的命令行。
|
|
17
|
+
|
|
18
|
+
**证据**:pnpm 12.4.1 干净工作区实测——裸名与 `@latest` → `0.2.2`;`clearai-dsh@0.2.6` → `0.2.6`,且 pnpm 自动往 `pnpm-workspace.yaml` 写入 `minimumReleaseAgeExclude: clearai-dsh@0.2.6`;把豁免改成按包名(`- clearai-dsh`)之后,裸名 → `0.2.6`。机制出处:pnpm 文档 `minimumReleaseAge`(默认 `1440`,v11 起)与 `minimumReleaseAgeStrict`(内置默认下为 false)。
|
|
19
|
+
|
|
5
20
|
## [0.2.6] — 2026-09-28
|
|
6
21
|
|
|
7
22
|
**插件列表里终于写了介绍。** 宿主从 `locale/<语言>.json` 的 `meta.title` / `meta.description` 与清单顶层的 `icon` 读一个插件的显示文字和图标;**三样都缺时回退到包名 + npm 的 description + 默认图**——而那正是我们一直显示的东西:标题 `clearai-dsh`(包名)、介绍 "ClearAI: The Epistemic Loop, native to DSH."(README 的 tagline)、一个通用图标。装上它的人在一个「插件市场」式的列表里看到的,是一句没有说清装上得到什么的英文。
|
package/README.md
CHANGED
|
@@ -18,7 +18,7 @@ ClearAI is an **ontology discovery and exploration platform**, built on two core
|
|
|
18
18
|
|
|
19
19
|
```bash
|
|
20
20
|
# Install (npm package, prebuilt — no build step, no allowBuilds prompt)
|
|
21
|
-
dsh plugin --profile web add clearai-dsh
|
|
21
|
+
dsh plugin --profile web add clearai-dsh@0.2.7
|
|
22
22
|
```
|
|
23
23
|
|
|
24
24
|
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)
|
|
@@ -69,17 +69,24 @@ ClearAI does **not** claim recursive self-improvement. It provides the epistemic
|
|
|
69
69
|
|
|
70
70
|
## Install and use
|
|
71
71
|
|
|
72
|
-
**Recommended — install from npm:**
|
|
72
|
+
**Recommended — install from npm, with the version pinned:**
|
|
73
73
|
|
|
74
74
|
```bash
|
|
75
|
-
dsh plugin --profile web add clearai-dsh
|
|
75
|
+
dsh plugin --profile web add clearai-dsh@0.2.7
|
|
76
76
|
```
|
|
77
77
|
|
|
78
78
|
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.
|
|
79
79
|
|
|
80
|
-
**
|
|
80
|
+
> **Why the version is pinned.** pnpm ≥ 11 holds back newly published versions: `minimumReleaseAge` defaults to 1440 minutes, and because that built-in default is non-strict, a bare package name (or `@latest`) **silently falls back to the newest version older than a day**. Right after a release that is the *previous* release, so a bare name can install something a version or two old and look like it worked. Pin the version — pnpm then records the exclusion itself — or exempt the package once in your profile's `pnpm-workspace.yaml`:
|
|
81
|
+
>
|
|
82
|
+
> ```yaml
|
|
83
|
+
> minimumReleaseAgeExclude:
|
|
84
|
+
> - clearai-dsh
|
|
85
|
+
> ```
|
|
81
86
|
|
|
82
|
-
**
|
|
87
|
+
**No terminal needed:** open **Settings → Plugins** and enter `clearai-dsh@0.2.7` (the same reason as above: a bare name is held back); that is the host's own install path. Once the package is listed in the [awesome-dsh-plugin](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin) catalog it also appears in **[dsh-market](https://github.com/dsh-market/dsh-market)**'s search, where it installs in one click — that market installs only what the catalog lists.
|
|
88
|
+
|
|
89
|
+
**Also available — one-command installer** (it resolves the current release and pins that version for you, so it is immune to the delay):
|
|
83
90
|
|
|
84
91
|
```bash
|
|
85
92
|
npx clearai-dsh install
|
package/README.zh-CN.md
CHANGED
|
@@ -18,7 +18,7 @@ ClearAI 是一个**本体发现与探索平台**，核心由两个概念支撑
|
|
|
18
18
|
|
|
19
19
|
```bash
|
|
20
20
|
# 安装（npm 包，预构建——无需构建步骤，不会触发 allowBuilds 授权）
|
|
21
|
-
dsh plugin --profile web add clearai-dsh
|
|
21
|
+
dsh plugin --profile web add clearai-dsh@0.2.7
|
|
22
22
|
```
|
|
23
23
|
|
|
24
24
|
重启 `dsh web`，在新建会话顶部的模式选择器里选 **ClearAI** 即可。这就是全部步骤。[完整安装说明 ↓](#安装与使用)
|
|
@@ -69,17 +69,24 @@ ClearAI **不**声称递归自我改进。它提供的是自我改进系统所
|
|
|
69
69
|
|
|
70
70
|
## 安装与使用
|
|
71
71
|
|
|
72
|
-
**推荐——从 npm
|
|
72
|
+
**推荐——从 npm 安装，并把版本钉住：**
|
|
73
73
|
|
|
74
74
|
```bash
|
|
75
|
-
dsh plugin --profile web add clearai-dsh
|
|
75
|
+
dsh plugin --profile web add clearai-dsh@0.2.7
|
|
76
76
|
```
|
|
77
77
|
|
|
78
78
|
从 npm registry 装预构建产物。本机不跑任何编译，因此不需要批准 `allowBuilds` 授权——命令返回时插件就已经可用。
|
|
79
79
|
|
|
80
|
-
|
|
80
|
+
> **为什么要钉版本。** pnpm ≥ 11 会**压住刚发布的版本**：`minimumReleaseAge` 默认 1440 分钟，而这条内置默认是**非严格**的，于是裸包名（或 `@latest`）会**静默回退到一天以前的最新版**——刚发完新版时，那就是**上一版**，装完还显示成功。钉版本（pnpm 会自己记下例外），或者在 profile 的 `pnpm-workspace.yaml` 里一次性豁免这个包：
|
|
81
|
+
>
|
|
82
|
+
> ```yaml
|
|
83
|
+
> minimumReleaseAgeExclude:
|
|
84
|
+
> - clearai-dsh
|
|
85
|
+
> ```
|
|
81
86
|
|
|
82
|
-
|
|
87
|
+
**不想开终端**：打开**设置 → 插件列表**，填 `clearai-dsh@0.2.7`（原因同上：裸包名会被压住），走的是宿主自己那条安装路径。等它进了 [awesome-dsh-plugin](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin) 目录，也能在 **[dsh-market](https://github.com/dsh-market/dsh-market)** 里搜到并一键安装——那个市场只装目录里有的东西。
|
|
88
|
+
|
|
89
|
+
**也提供——一条命令的安装器**（它自己解析当前版本并钉住，因此不受这条延迟影响）：
|
|
83
90
|
|
|
84
91
|
```bash
|
|
85
92
|
npx clearai-dsh install
|