Repository navigation
helm-d v0.6.0 — DSH 0.2.0-rc.1–0.2.2-rc.1 区间全版本适配 + 桌面 app.asar 自愈
发布日期:2026-11-10 · 许可:AGPL-3.0-or-later · Node >= 22.19 · DSH
0.2.0-rc.1–0.2.2-rc.1区间全部 15 个已发布版本完整逐条日志:CHANGELOG.md
本版把受支持宿主从"单点版本"扩展为整个区间:区间内 15 个已发布版本(含 alpha/rc 全线)全部完成 peer 准入、preset 生成/自愈、UI token 与 API 面回归;并补上桌面版(Electron)宿主探测——桌面树打包在 resources/app.asar 内,此前安装脚本与运行自愈都找不到它。检查集 34 → 37,工具数不变(49)。
升级前必读
- 无破坏性变更。preset 快照按区间最新
0.2.2-rc.1重新生成;装机时 setup 脚本仍按目标机重新生成,快照只是兜底。 - 区间外宿主(
0.2.3+)显式排除;纳入新区间需扩 manifest 与 peer 分段(MAINTENANCE §1.1)。
新功能
宿主区间全版本适配(0.2.0-rc.1 – 0.2.2-rc.1)
- 事实源
scripts/checks/fixtures/dsh-host-manifest.json:15 个版本逐版记录兄弟包钉版(dsh-web-app / dsh-settings / dsh-tools 与宿主锁步)、cordis/schemastery 的 pin 与 floor/resolved、standard内容哈希与前端 token 契约。 - peer 范围按元组分段:dsh-settings / dsh-tools 改四段式,cordis / schemastery 补预发布分支——plain node-semver 只有比较子与版本同
[major,minor,patch]元组且带预发布时才准入预发布,旧宽范围在 plain 语义下漏掉整条 0.2.1 / 0.2.2 预发布线;新增peer-range检查以两种语义逐版判定(旧范围在其上 2 FAILED / 26+18 个准入缺口)。 - 新增
preset-cross-host检查:区间 7 份唯一standard(按内容哈希去重)逐一生成并过运行时结构断言,跨宿主自愈(异代 artifact →HOST_UPGRADED→ 重生成锚定目标指纹)全覆盖。 ui-tokens扩展为同时核对 5 份区间 token 契约(401–415 token/份)。
桌面版 app.asar 支持
locateHostStandard()(根与 bundle 两份生成器、health.ts三处镜像同步)新增桌面安装根探测 + 零依赖 asar 读取器;真实归档实测(含 374MB 带 integrity 归档的五层深路径);DSH_DESKTOP_APP_ASAR可显式钉一个归档。- 新增
host-asar检查:官方@electron/asar4.3.1 生成的 fixture + 经公开健康 API 的端到端 locate/repair。
修复
- 工作台入口 hooks 顺序(React error #300):
HelmdPresetCapsuleButton的全部 hooks 移到条件返回之前;新增client-hooks检查(旧实现在其上 FAIL)。 - preset standdown:与官方 Agent Teams bundle 并存时,预设插入的
tool-agent-team/agent-team两行带!!js条件——宿主根树已运行同名插件时自动让位,顶层服务行改用独立 idhelmd-agent-team,避免already registered in this scope与 agent 创建/销毁循环。 - 检查套件副作用:
preset-heal与api-routes(apply()启动自愈)原本会把 tracked 的preset.generated.patch.yml改写成装机宿主版本;现隔离到临时副本评核,并增加「tracked 产物必须原样幸存」断言。
验证
| 门禁 | 结果 |
|---|---|
pnpm build / pnpm typecheck |
通过(串行执行,exit 0) |
pnpm test:checks |
37 PASS(+3:peer-range / preset-cross-host / host-asar) |
pnpm test:preset |
PASS |
verify-pack --require-sealed |
PASS — npm pack 12 文件、252 封印 payload 文件、无明文 persona/references/scripts |
| 隔离 profile 安装 | PASS — dsh plugin --profile release-check add helmd.tgz(隔离 DSH_HOME,未动机内 dsh) |
| preset 组合行 | --dump-config:preset-helmd / helmd-health / tool-agent-team / helmd / helmd-agent-team(带 standdown 条件)全部就位 |
| 冷启动 | 部分验证:无头启动宿主面挂载成功(仅 preset-helmd pending 于 agentPresets 服务,与 v0.5.3 对照逐字一致,非回归);完整 web profile 激活因本机内存耗尽(0.7 GB free)未执行 |
defineTool API 面 |
区间 15 个 dsh-tools 逐一解包核验,全部导出 |
| 真实模型 E2E | 未验证:缺可用端点 |
资产
三个 tgz 内容相同,sha256 均为:
b76ef5299834c31421d3ba4212b8e85035c42d53306d6d0e633de9bd2b9eae14
adwmc-helm-d-0.6.0.tgzhelm-d.tgzhelmd.tgz
安装 / 升级(版本化 URL,勿用 releases/latest/download/* 作 profile 依赖):
dsh plugin --profile web add https://github.com/ADWMC/helm-d/releases/download/v0.6.0/helm-d.tgz