pi-proactive 0.2.0-beta.6 → 0.2.0-beta.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/BREAKING-CHANGES.md +27 -0
- package/CHANGELOG.md +13 -1
- package/app/app.mjs +1378 -0
- package/manual/USAGE.html +76 -0
- package/package.json +5 -2
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
# 破坏性变更（Breaking Changes）
|
|
2
|
+
|
|
3
|
+
> 与 `CHANGELOG.md` 配套：CHANGELOG 按版本列**全部**变化；本文件只列**会破坏现有用法**的变更 + 迁移做法。
|
|
4
|
+
> **判定标准**：升级后，若不改用户侧配置或用法就可能装不上 / 装上不加载 / 行为改变 ⇒ 属破坏性变更。
|
|
5
|
+
> **约定**：破坏性变更只允许出现在 **beta 版本的 minor 位**（如 `0.2.0-beta.6`），且必须在 CHANGELOG 有对应条目。
|
|
6
|
+
|
|
7
|
+
## 0.2.0-beta.6
|
|
8
|
+
### BC-1：typebox 由 `dependencies` 移出，改为 `peerDependencies` + `bundledDependencies`
|
|
9
|
+
```
|
|
10
|
+
为什么：宿主（Pi）要求宿主提供的包只能出现在 peerDependencies；放在 dependencies 会触发宿主告警
|
|
11
|
+
"typebox 必须在 peerDependencies、不能放 dependencies"，并可能造成运行时重复实例。
|
|
12
|
+
影响：
|
|
13
|
+
· 依赖方（含把 pi-proactive 作为库引入的项目）安装时不再自动安装 typebox 副本 → 需自行保证 typebox 可解析
|
|
14
|
+
· 使用【混合安装目录】（该目录有与本包无关的 peer 冲突）时，安装可能仍需 --legacy-peer-deps
|
|
15
|
+
（这条冲突来自目录里的其它包，不是本包）
|
|
16
|
+
· 【干净空目录不需要 --legacy-peer-deps】（typebox 已随包 bundled）
|
|
17
|
+
迁移：
|
|
18
|
+
1) 直接升级：cd ~/.pi/agent/npm && npm install pi-proactive@latest
|
|
19
|
+
2) 若安装报 peer 冲突 → 加 --legacy-peer-deps（仅混合目录需要）
|
|
20
|
+
3) 若你此前按旧文档"必须 --legacy-peer-deps"操作 → 可以去掉该参数
|
|
21
|
+
影响范围判断：本包自身运行不受影响（typebox 随包 bundled）；主要影响【把本包当库引入】的用法。
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
## 历史
|
|
25
|
+
```
|
|
26
|
+
（beta.5 及更早：无已登记的破坏性变更）
|
|
27
|
+
```
|
package/CHANGELOG.md
CHANGED
|
@@ -8,7 +8,19 @@
|
|
|
8
8
|
---
|
|
9
9
|
|
|
10
10
|
|
|
11
|
-
### 0.2.0-beta.
|
|
11
|
+
### 0.2.0-beta.7 — 补齐交付三件套（HTML 使用手册 + BREAKING CHANGES）
|
|
12
|
+
|
|
13
|
+
**用户可见新增**
|
|
14
|
+
- `docs/USAGE.html`：随包发布的 HTML 使用手册（安装 / 三条入口 / 常驻助理 / 状态一屏三块 / 按成因分性的故障排查 / 开发者向枚举与对拍）
|
|
15
|
+
- `BREAKING-CHANGES.md`：破坏性变更登记与迁移做法（首条 = beta.6 的 BC-1 typebox 声明变更）
|
|
16
|
+
|
|
17
|
+
**判据**
|
|
18
|
+
- 新增门禁段 **G20 交付三件套**：HTML 手册存在且含当前版本 · CHANGELOG 含当前版本 ·
|
|
19
|
+
BREAKING CHANGES 含当前版本节（有破坏性则须含"迁移"）· package.json files 收录三件（否则用户拿不到）
|
|
20
|
+
|
|
21
|
+
0.2.0-beta.6 — 用户可见新增：跨平台常驻安装 + 独立枚举器
|
|
22
|
+
|
|
23
|
+
> ⚠️ **含破坏性变更**（BC-1：typebox 由 dependencies 移出 → peerDependencies + bundledDependencies）⇒ 迁移做法见 `BREAKING-CHANGES.md`
|
|
12
24
|
|
|
13
25
|
**新增能力（可直接用）**
|
|
14
26
|
- `tools/daemon-install.mjs` / `tools/daemon-uninstall.mjs` / `daemon/run-daemon.mjs`：
|