Repository navigation
helm-d v0.5.3 — Team 协作 / 证据审计 / Recon / PoC / 工具面
helm-d v0.5.3
发布日期:2026-11-04 · 许可:AGPL-3.0-or-later · Node >= 22.19 · DSH 0.2.x(本版在 0.2.1-rc.2 验证)
完整逐条日志:CHANGELOG.md
v0.5.3 把《参考项目吸收任务书》从设计推进到可运行 MVP:Team 协作、证据审计、recon / PoC / mining、SARIF / 趋势、Toolbox 2.0 全部落地。工具 49 个,检查集 33 项,references 353 篇正文 + 9 个索引。
升级前必读
- 这是 0.5.3 重发:早期 0.5.3 已撤回;如果曾安装过旧 0.5.3,请先移除旧依赖并清理对应 pnpm 缓存,再按下方版本化 URL 重装。新旧 tgz 字节不同,直接复用旧 lockfile 会报
ERR_PNPM_TARBALL_INTEGRITY。 - 安装 URL 必须版本化:使用
releases/download/v0.5.3/...。releases/latest/download/*是滚动地址,不能写进 profile 依赖。Issue #5 已随本版关闭。 - 模型安装工具默认关闭:
toolbox(modelInstall=false);只有操作者可在 WebUI「工具」页安装,或显式打开设置。 - 许可为 AGPL-3.0-or-later:再分发、派生与网络部署需按 AGPL 提供对应源码。
新功能
Team 协作
team_steer:对运行中的 worker 在最近 step 边界实时纠偏;非 orchestrator 拒绝;Team tab 每个 running 角色带输入框。- 任务 DAG:
claimTask原子认领、租约回收、依赖解锁;team_status显示 ready/blocked/claimed/owner。 - 预算与收口:per-ticket
wallTimeMs/maxToolCalls;预算或 stop reason 耗尽 →blocked,空 ready 被 finish gate 拒绝。 - 审批队列:dynamic worker 高风险命令默认 fail-closed;操作者在设置页批准/拒绝;5 分钟超时、单次使用、用后失效。
- 进化 gate:0.1 噪声宽限、最小改善、holdout、编辑预算、父代
score × 1/(1+children)、原子 rollback。
证据与验证
record_finding审计 detail 中的 hash / E-id,必须在 cited evidence 中逐字命中;正负对照 E-id 均视为有效引用。- 独立
negative_evidence_ids+negative_control;负对照必须使用与正例不重叠的证据。 - 证据落盘写
meta.json {sha256, prevHash, tool, ts};篡改后 finding 自动标stale,case_status显示。 - NO_PATH:连续 3 次相同 tool+args 且证据无增长,autonomy packet 顶部硬提示换路径。
end_case生成evidence/manifest.json(链头、证据、finding 摘要)。
Recon / PoC / Mining
- 资产账本
recon/assets.jsonl:kind/value/parent 去重、E-id 关联、六维覆盖。 recon_passive(DoH)、recon_ports(TCP connect,1 rps)、recon_http、recon_crawl、recon_import(nmap XML / httpx JSONL / nuclei JSONL)。- scope 围栏:越界拒绝;私网/loopback/云元数据需显式
lab=true。 - 确定性 PoC recipe:http-diff、sqli-boolean、path-traversal、idor、xss-canary、jwt-none;正例 + 独立负例三态
verified/refuted/inconclusive。 - loopback OOB:
oob_start/oob_poll/oob_stop,单次 token 回调。 - 候选挖掘:HAR / OpenAPI / JS / APK AXML / 二进制 strings →
mining/candidates.jsonl,去重、风险排序、覆盖差集。
报告与工具面
- SARIF 2.1.0 导出、确定性 markdown 报告(缺失字段显式 NOT RUN)、CVSS 3.1 向量算分、按日 severity 趋势。
- Toolbox:catalog 评分排序、MCP 只读发现、command probe TTL 缓存、离线 mirror(sha256 必填)、update 备份→重装→失败回滚。
- Case tab:finding 状态按钮(verified/rejected/duplicate/wontfix)、severity/status 过滤、critical/high 头部、Case 列表计数。
- 工作台:滚动钉底、IME composition 防误发、未定义 design token 检查。
修复
- 负对照证据中的 E-id 被误判为“未引用”,导致合规 finding 被拒;已改为 positive + negative 证据并集(真实会话发现,
1589ef2)。 - 封包时嵌套
dist/**/*.d.ts被留在明文包内;现在只有根入口声明保持明文,其余随 payload 封印。 updateCatalogTool同版本更新时目标目录已存在;现在先备份旧目录,失败恢复 registry + 目录。- Issue #5:版本化安装 URL;不再把
latest/download写入 profile 依赖。
验证
| 门禁 | 结果 |
|---|---|
pnpm build / pnpm typecheck |
通过 |
pnpm test:checks |
33 PASS |
verify-pack --require-sealed |
PASS(252 个封印 payload 文件) |
| 隔离宿主 | health OK,catalog 54 项 |
| 真实模型(opencode-go / glm-5.3-flash) | 证据链 E2E_CASE_DONE;本地 lab recon/PoC/mining E2E_LAB_DONE |
真实会话执行了 begin_case → route_task → read_reference → hash_artifact → hypothesis → finding → case_status → end_case,以及 recon_http → mine_candidates → run_poc(xss-canary) → record_finding(positive/negative evidence) → end_case。
资产
三个 tgz 内容相同,sha256 均为:
37ca74e368ccdf10d5bc44746f6a1ec52a3e4b9430e3c31bba4f485f61aaa933
adwmc-helm-d-0.5.3.tgzhelm-d.tgzhelmd.tgz
安装 / 升级
# 新装
dsh plugin --profile web add https://github.com/ADWMC/helm-d/releases/download/v0.5.3/helm-d.tgz
# 已装旧版:先移除旧依赖,再装版本化 URL
dsh plugin --profile web remove @adwmc/helm-d
dsh plugin --profile web add https://github.com/ADWMC/helm-d/releases/download/v0.5.3/helm-d.tgz遇到 lockfile 完整性错误时见 安装故障排查。
已知限制
- Team steer/DAG/审批的完整链路目前是单元/集成检查;真实模型会话覆盖的是证据链与 recon/PoC/mining。
- APK 为 AXML string-pool 级解析,不做完整资源表语义。
- OOB 仅限本机 loopback lab。
- WebUI 审批/更新按钮尚未做浏览器点击回归。