@kira905/dsh-ecosystem-panel 0.0.0-stage → 0.4.4

package/CHANGELOG.md

@@ -0,0 +1,71 @@
+# Changelog
+
+本仓遵循 [SemVer](https://semver.org/lang/zh-CN/)：使用者可见的行为变化才升主版本/次版本，纯内部重构走修订号。
+
+## [0.4.4] - 2026-10-16
+
+### Changed
+
+- 🔴 **许可**：**自本版起为 `AGPL-3.0-only` + 商业授权（双许可）**。README 中英双份的「许可」段此前只讲 AGPL，本版补**商业授权**段（`LICENSE` 与 `package.json#license` 不变）。⚠️ 术语必须读准：**AGPL 本身不禁商用**（AGPL / MIT / Apache 本身都不禁商用，AGPL 只要求**衍生作品也开源**）；「+ 商业授权」= **双许可** —— 「要么按 AGPL 衍生开源、要么取得商业授权」。
+- **宿主兼容区间据实补齐 + 端到端实测**：此前 `peerDependencies` 是**空对象**（不声明 ⇒ 宿主不校验也不保证）；本版补为 **`>=0.2.0-rc.2 <0.3.0`**。依据 = **隔离实例（端口 3090，主包 `0.2.0-rc.2`）上的真装真跑**：本仓 `scripts/verify-state.mjs`（只读六类体检）对运行中的实例 **rc=0 跑通**；客户端半 `client.js` 出现在实例启动 HTML 的插件资源清单里。README 同步写明「**实测过的宿主版本**」与「**未实测不作承诺**」。
+- **本轮无代码与行为改动**（推送内容为 `package.json` + `README.md` / `README.en.md` + 本文件）。
+
+## [0.4.3] - 2026-10-12
+
+### Changed
+
+- **本轮文档更新（本次发版内容）**：新增**英文 README**（`README.en.md`，与中文 `README.md` 内容对等、章节 1:1）—— 补齐文档仓《发布说明》§4.8「组件仓 README 英文必备」的语言政策欠账（开源主档待办 24）；中文 README 顶部加英文版互链。本轮**无代码与行为改动**（推送内容为改动后的 `README.md` + 新增 `README.en.md`）。
+
+## [0.4.2] - 2026-09-28
+
+### Changed
+
+- **本轮文档更新（本次发版内容）**：README 新增**「设计依据」节**（回链文档仓的具体章节，补齐文档仓 §4.2 / §4.3 规定的组件仓必备节）；「相关组件」互链节补入两件新发布的伴生组件。本轮**无代码与行为改动**（推送内容仅 `README.md`）。
+
+## [0.4.1] - 2026-09-22
+
+### Changed
+
+- **本轮文档更新（本次发版内容）**：README 新增「相关组件」互链节（回链同系已发布组件）；「宿主版本兼容区间」按 2026-09-21 静态兼容性审计更新（未实测项已如实标注）。本轮**无代码与行为改动**（推送内容仅 `README.md`）。
+
+## [0.4.0] - 2026-09-21
+
+首个开源形态版本（通用化改造）。
+
+### Added
+
+- **配置层 `lib/config.js`**：所有路径 / 清单 / 白名单 / 文案统一走
+  `显式传入 > 环境变量 > 配置文件 > 自动探测 > 内置默认`，并输出「配置来源自证」（每个键从哪读到的）。
+- **清单外置**：补丁清单、升级规则表、断裂符号表、包名简介字典默认全空，由使用者用配置文件提供；
+  字符串里支持 `${HOME}` / `${PROFILE_NM}` / `${MAIN_NM}` / `${MAIN_PKG_DIR}` 占位符。
+- **`lib/host-protocol.js`**：自带的宿主服务名常量（本插件只用 `webServer` 一个），
+  可经 `DSH_ECOSYSTEM_PANEL_WEBSERVER_SERVICE` 覆盖；发布集不再携带宿主适配层生成副本。
+- **`examples/`**：五份可直接抄的配置示例（总览 / 补丁清单 / 升级规则 / 断裂符号 / 简介字典）。
+- **`scripts/verify-source.mjs`**：发布前静态验证（语法 + 配置层行为断言 + 脱敏扫描，标识靠 `BUILD_*` 注入）。
+- **`scripts/test-fixture.mjs`**：干净临时路径上的端到端夹具，现场造最小数据根与四个外部工具 stub。
+- **`scripts/verify-state.mjs`**：不依赖 GUI 的只读状态验证器（打印六类结果 + 配置来源自证）。
+- **停用类目**：`disabledGroups` 可把某一类整组标为「已按配置停用」（显式提示，且不计入汇总）。
+- **文案可覆盖**：`text.title` / `text.note` / `text.tabs` 经服务端 `meta.ui` 下发给前端。
+
+### Changed
+
+- 数据根解析口径改为 `DSH_ECOSYSTEM_PANEL_HOME` > `DSH_HOME` > `~/.dsh`（不再读取其它内部变量名）。
+- 前端类目名中性化：`patch insert`、`补丁健康`（原为更口语化的内部说法）。
+- 面板版本号改为从自身 `package.json` 读（原来写死在源码里）。
+- 外部脚本路径全部改为配置层解析（原来部分写死在源码里）。
+
+### Fixed
+
+- **boot 清单不可用时会假绿**：宿主未响应或基址配错时，声明了 client 能力的插件原来仍显示 🟢；
+  现在判 🟡 并说明「加载状态未知」（读不到 ≠ 已加载）。
+- **档位 CLI 路径不随配置层解析**：有配置覆盖（隔离实例 / 夹具 / 使用者自定义路径）时，
+  原来会静默退回默认路径；现在按当前配置取。
+- **`disabledGroups` 只认字符串形态**：显式传数组时被静默忽略（当成了"未设置"）；现在数组 /
+  逗号分隔字符串 / 不设三种形态都认，并在来源自证里标明来自哪一层。
+- 清单文件坏 JSON 时不再有任何副作用：回落空表并把原因记入 `meta.configErrors`。
+
+### Breaking
+
+- 环境变量前缀统一为 `DSH_ECOSYSTEM_PANEL_*`；旧的内部变量名不再读取。
+- 补丁清单 / 升级规则表 / 断裂符号表**默认空**：从内嵌清单的旧版迁移时，需要把原来的清单导出成
+  JSON 并用 `*_FILE` 配置项指过来（否则 ③ 显示「未配置 ⇒ 不可判定」）。