Skip to content

helm-d v0.6.0 — DSH 0.2.0-rc.1–0.2.2-rc.1 区间全版本适配 + 桌面 app.asar 自愈

Latest

Choose a tag to compare

@ADWMC ADWMC released this 10 Nov 13:58
· 2 commits to main since this release

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/asar 4.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 条件——宿主根树已运行同名插件时自动让位,顶层服务行改用独立 id helmd-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.tgz
  • helm-d.tgz
  • helmd.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