Hyperionjust/dsh-tool-underseal
30最近提交 2026年8月14日
dsh-tool-underseal DSH 插件
dsh-tool-underseal 是一个 DSH 插件，实现了 Underseal 协议 —— 一种基于哈希密封的文件授权系统，用于在 AI 代理之间委托有界任务。它包含两个子插件（tool-underseal 和 underseal-guard），提供八个面向模型的工具和一个工作进程签入锁，并附带一个记录委托工作流的技能。插件在启动时执行三个字节级别的供应链哨兵检查，防止篡改包激活。
如何安装 dsh-tool-underseal DSH 插件
dsh plugin add dsh-tool-underseal复制不会执行命令。安装 dsh-tool-underseal DSH 插件前请核对仓库和版本。
dsh-tool-underseal DSH 插件数据来源
dsh-tool-underseal DSH 插件快照日期：2026年8月16日
discovered
dsh-tool-underseal DSH 插件能做什么
- 提供八个类型化工具，包装冻结的 Underseal 适配器，用于安全的任务委托。
- 包含单调执行守卫（underseal-guard），在缺少 READY 证据时阻止修改工具执行。
- 启动时执行三个字节级防篡改检查（E1、E2、E3），验证 vendored 验证器、技能正文和包补丁的完整性。
- 附带一个 DSH 技能（underseal-delegation），包含工作流文档和参考文件。
- 支持三种安装方式：npm、Git checkout 和 tarball。
dsh-tool-underseal DSH 插件适合哪些场景
- 通过哈希密封分配，安全地将有界编码任务委托给 AI 子代理。
- 在多代理工作流中审计并强制执行不可否认的证据链。
- 通过要求工作进程签入后再执行修改，防止未授权的工具调用。
- 与 DSH 配置文件集成，运行密封仪式（doctor、seal、start、event、audit、retire）。
dsh-tool-underseal DSH 插件适合谁
- 使用 DeepSeek Harness (DSH) 构建多代理系统的 AI 开发者和研究人员。
- 需要为 AI 代理任务提供加密可验证授权层的团队。
dsh-tool-underseal DSH 插件的限制
- 需要主机系统上安装 Python 解释器（Windows 默认 python，POSIX 默认 python3）。
- 仅在 DSH 0.1.0-rc.5 上测试过，不保证与其他版本的兼容性。
- Git checkout 安装方式需要在配置文件的 pnpm-workspace.yaml 中允许构建，这会授予安装时在沙箱外的代码执行权限。
- 本地路径包含空格时需用双引号包裹，因为 CLI 的引号处理问题。
dsh-tool-underseal DSH 插件的仓库 README 摘录
以下文字摘自 dsh-tool-underseal DSH 插件的上游仓库 Hyperionjust/dsh-tool-underseal 的 README，版权归原作者，仅作引用。
**English** | [中文](README.zh.md)    > **The one-breath pitch:** chat is transport, not authorization. Authority is a > hash-sealed assignment file; evidence is append-only and re-derivable by any > third party; and every boundary fails closed — sealed tools, a worker > check-in lock, and byte-pinned supply-chain sentinels — behind a single > `dsh plugin add dsh-tool-underseal`. > **Tested on DSH 0.1.0-rc.5** — runtime mounting smoke test passed: `dsh plugin > add` + `dsh --dump-config` mounts both layers (`underseal` and > `underseal-guard`), and the full ceremony chain > (doctor → seal → start → event → audit → retire) ran end to end through the > vendored adapter in a real Git repository. Two field notes: when `dsh plugin > add` takes a **local path containing spaces**, wrap it in literal double > quotes (`dsh plugin --profile p add '"D:\Project Hyperion\A_Deepseek Harness Workspace\underseal-dsh"'`) — > the CLI joins pnpm args through a shell without quoting; and after seal
阅读完整 README仓库许可: Apache-2.0
dsh-tool-underseal DSH 插件常见问题
如何安装 dsh-tool-underseal？
可以通过 npm 安装：`dsh plugin --profile <name> add dsh-tool-underseal`。或者使用 Git checkout 并固定提交：`dsh plugin --profile <name> add github:you/dsh-tool-underseal#<sha>`，或通过 `pnpm pack` 打 tarball 后本地添加。npm 方式更推荐，因为预编译了 lib/ 目录，无需构建权限。
插件在 Windows 上能正常工作吗？
可以，但要注意 Windows 上默认 Python 解释器是 `python`。如果本地路径包含空格，运行 `dsh plugin add` 时必须用双引号包裹，因为 CLI 在拼接 pnpm 参数时不会自动加引号。例如：`dsh plugin --profile p add '"D:\Project Hyperion\A_Deepseek Harness Workspace\underseal-dsh"'`。
供应链哨兵是什么，为什么重要？
插件在启动时执行三个字节级检查（E1、E2、E3），验证 vendored 验证器、技能正文和包补丁的完整性。如果任何检查失败，插件会记录错误并拒绝注册工具（E1、E3），或记录警告但继续加载技能（E2）。这防止了篡改包静默激活，确保只使用经过审查的字节。
我可以自定义适配器路径或 Python 解释器吗？
可以。插件提供了 `adapterPath` 和 `pythonPath` 配置字段。默认使用 vendored 的 `python/underseal_adapter.py`，解释器为 `python`（Windows）或 `python3`（POSIX）。如果将 `pythonPath` 设为空字符串，则 `adapterPath` 直接作为可执行文件使用。也可以将 `adapterPath` 指向单独安装的控制台脚本。
密封过程对性能有多大影响？
根据在 DSH 0.1.0-rc.5 和 deepseek-v4-flash 上的基准测试，密封增加约 10.4K 未缓存令牌的固定开销，而非百分比税。对于简单的单文件任务，这占输入总量的 42%；对于实际编码任务（Python 模块加 16 个测试套件），占比降至 13.8%。墙钟时间增加约 10 秒（简单任务）到 54 秒（实际任务）。详情见 BENCHMARK.md。