跳到主要内容
dsh marketplace

dsh-pack

已验证

@why-daydream/dsh-pack · v0.6.1 · MIT

Portable, reproducible and verifiable runtime artifacts for DeepSeek Harness

安装

dsh plugin add @why-daydream/dsh-pack

用 dsh --profile default --dump-config 确认 layer 已生效 —— 参见安装指南。

源码

标签

作者

说明文档

dsh-pack

为 DeepSeek Harness 打造的可复现、可移植、可签名、可运行、可 OCI 分发的 Agent Artifact。

npm install @why-daydream/dsh-pack

English · 简体中文

npm version GitHub Release GHCR Protocol License

安装

DSH Plugin（推荐）

dsh plugin --profile demo add @why-daydream/dsh-pack

固定版本：

dsh plugin --profile demo add @why-daydream/[email protected]

npm

npm install @why-daydream/dsh-pack

30 秒快速上手

# 安装插件
dsh plugin --profile demo add @why-daydream/dsh-pack

# 把 Profile 打包成可复现的 .dshpack
/pack web --portable

# 查看包内容摘要
/pack inspect web-<date>.dshpack

# 校验完整性与签名
/pack verify web-<date>.dshpack --require-signature

端到端管线

Profile
  ↓ /pack
.dshpack
  ↓ /sign
Trusted Artifact
  ↓ image import
Agent Image
  ↓ /push
GHCR / OCI Registry
  ↓ image lock + trust.yaml
Governed Runtime

Demo

可复现的终端录制，覆盖完整链路（pack → sign → import → lock → verify → run）：

contentHash: sha256:...

Signature: VALID
Trust: VERIFIED

demo/agent:prod
→ ghcr.io/.../agent@sha256:<manifestDigest>

Agent image started
  • 录制脚本：demo/recording/demo.sh（DEMO_MODE=local 默认；DEMO_MODE=ghcr 展示真实 push/lock）
  • 确定性录制：demo/recording/demo.tape（VHS）

版本演进

v0.1   Snapshot      —— 可复现的 Profile 配置快照
  ↓
v0.2   Portable      —— 连本地依赖一起可移植
  ↓
v0.3   Trusted       —— Ed25519 签名 + provenance 校验
  ↓
v0.4   Runnable      —— Agent Image 模型：可命名、可版本化、可运行
  ↓
v0.4.1 Distributed   —— OCI push/pull（GHCR、Docker Hub、任意 Registry）
  ↓
v0.4.2 Governed      —— image lock + trust.yaml + local prune + Real GHCR 8/8 PASS
  ↓
v0.5.0 Verifiable   —— Evidence Chain（provenance / SBOM / capability / attestation）+ Trust Policy v2

架构 —— Artifact Supply Chain

dsh-pack Artifact Supply Chain Architecture

可编辑 Mermaid 源图见 docs/architecture.md（README 默认展示 SVG 以便跨平台渲染一致）。

四层 Identity

configHash
    ↓
Profile 可复现性

contentHash
    ↓
DSH artifact 身份 / 签名锚点

OCI blobDigest
    ↓
传输字节完整性

OCI manifestDigest
    ↓
远程不可变镜像身份

核心不变量（Core Invariants）

Lock ≠ Trust               —— 版本治理 ≠ 运行治理
Cache ≠ Trust              —— 缓存不等于信任
Registry ≠ Trust Authority —— Registry 只是分发通道，不是信任源
VALID ≠ TRUSTED            —— 未知 key 的合法签名仍然不可信
OCI Digest ≠ DSH contentHash —— 传输身份 ≠ 产物身份
CLI can tighten policy, never weaken it —— CLI 只能收紧策略，绝不放松

命令面

命令 作用
/pack [name] 打包当前 Profile（--strict / --out / --allow-secrets / --allow-nonportable）
/pack <name> --portable 连本地 file:/link: 依赖一起 vendoring 打包
/pack inspect <file> 查看包内容摘要（--json）
/pack verify <file> 校验完整性：Manifest / Config / Packages / Checksums / DSH Version / Signature（--json、--require-signature）
/pack install <file> 恢复到 $DSH_HOME/profiles/<name>（staging + 原子 swap + frozen-lockfile）
/pack diff <a> <b> 两包配置漂移对比：Manifest / Bundles / Config / Dependencies + configHash
/pack keygen [--out <dir>] 生成 ed25519 密钥对（v0.3：私钥 chmod 600 + 公钥 + keyId）
/pack sign <file> --key <pem> [--signer <name>] 嵌入签名 + provenance，产出 <name>.signed.dshpack（v0.3）
/pack image import 导入 .dshpack 为本地 Agent Image（tag / digest）
/pack image ls 列出本地 Agent Image 仓库
/pack image tag 为本地 image 添加/移动 tag
/pack image rm 删除本地 image / tag
/pack image lock 将 mutable remote tag 冻结为 immutable manifest digest
/pack image prune Mark-and-sweep GC：清理 unreachable manifest/blob（dry-run 默认，--apply 删除）
/pack push <localRef> <remoteRef> 推送 Agent Image 到 OCI Registry（GHCR / Docker Hub）
/pack pull <remoteRef> 拉取 Agent Image 并验证完整性
/pack run <ref> [--require-trusted] 运行 Agent Image（完整性校验 + 信任策略 + 临时 runtime 或持久 Profile）

分发入口

npm

npm install @why-daydream/dsh-pack

📦 @why-daydream/dsh-pack — v0.5.0

GitHub Release

🔖 v0.5.0 — Verifiable Agent Artifact

OCI / GHCR

已对真实 GHCR 完成协议验收：8/8 项 PASS（run #33292227705）。

① Bearer challenge      ② Token acquisition (pull,push)
③ HEAD blob 404 → 200   ④ POST uploads/ → PUT ?digest → 201
⑤ OCI manifest PUT      ⑥ Tag pull Content-Type + Docker-Content-Digest
⑦ Digest pull identity   ⑧ DSH contentHash + Signature + Trust + run configHash

DSH 社区

📢 DSH Discussion —— 社区讨论与使用交流

验证状态

维度 状态
本地测试套件 140 tests / 21 files —— 全部通过（含 mock OCI registry、signing E2E、trust policy、image lock、GC prune）
typecheck（tsc -b） ✅ 通过
lint（oxlint） ✅ 0 errors
Real GHCR E2E ✅ 8/8 PASS（run 33292227705，2026-08-30）
npm tgz clean-room ✅ 安装 + import 通过
npm registry ✅ 发布 + 安装 + import 通过

已知限制

  1. pnpm v11 虚拟存储布局：--portable 恢复后，传递的 file: 依赖可能位于 .pnpm 虚拟存储而非顶层 node_modules。功能与 frozen install 闭环成立；若要求 node_modules 布局逐字节一致，受 pnpm 行为差异限制，不属于包缺陷。
  2. --portable 实现中修复的三个真实工程坑（均已补回归测试，详见 DESIGN.md Appendix D 与 TRACEABILITY.md）：
    • 异步 staging 竞态；
    • 重写后的 package.json 被 copy 步骤覆盖；
    • pnpm lockfile 的项目相对路径语义。
  3. 不可复现项：floating git 分支（无 #commit 锚点，--strict 下失败）；home 层与 --patch overlay（machine/invocation-local，不打包但记录告警）；--allow-nonportable 产物 installable:false 且 install 默认拒绝。
  4. 安全边界：.dshpack 内禁止真实 secret（组合树扫描 + redact + .env.example，install 永不恢复 secret）；archive 提取防路径逃逸与 symlink/hardlink/device 条目。

文档

  • DESIGN.md —— 协议冻结（格式、哈希算法、安全模型、命令行为）
  • DESIGN-v0.4.2.md —— 四层 Governance 设计（image lock / trust.yaml / local prune / GHCR 8/8）
  • DESIGN-v0.5.0.md —— Evidence Chain + Trust Policy v2（D64–D139）
  • TRACEABILITY.md —— 冻结决策 → 源文件 → 测试用例逐条追踪
  • CHANGELOG.md —— 版本历史
  • LICENSE —— MIT

License

MIT © WHY-Daydream