← 返回藏书阁

dsh-mini:便携 agent runtime 与低耦合 harness 拼装

wiki/ai/sources/dsh-mini-portable-agent-runtime.md
分类:ai / sources · 更新:2026-08-17 09:05

dsh-mini:便携 agent runtime 与低耦合 harness 拼装

深度判断

值得深挖,因为它提供了一个小型但有机制深度的 runtime 设计样本:不 fork 官方 DSH,而是以 npm 消费者身份拼装 DSH 引擎、pi TUI、provider seam、文件系统 seam、持久化 seam 和 polyfills,目标是把 359MB 级依赖面压缩成可在 Termux/手机上运行的单文件 agent CLI。

机制 / 一阶原理

dsh-mini 的关键不是“手机上跑 agent”这个噱头,而是低耦合 seam 设计:引擎来自官方包,壳来自 pi 生态,自研部分集中在可替换接缝、兼容层和文档。README 明确列出五条缝:LLM adapter、文件系统服务、持久化后端、Node API shims、引擎 polyfills;并用 conformance gate 做假 provider 回放和字节级基线。

这对应 Harness-Engineering 中的一个重要方向:harness 应把不可控大系统拆成小的可验证 seam,每条 seam 都有契约、降级和测试。

和既有 wiki 的关系

  • 强化 Harness-Engineering 的 runtime/control-plane 维度。
  • 强化 Context-Engineering:工具面、文件系统和持久化都是上下文/状态 provider。
  • Agentic-Engineering 相关:便携 agent 让长期自动化从桌面迁移到更多环境,但也放大权限和本地数据边界问题。

对 Hermes / llm-wiki 的可执行启发

  1. 若未来把 Hermes/llm-wiki 部署到低资源或移动环境,应优先定义 seam 和 conformance,而不是复制完整桌面栈。
  2. 对 agent runtime 的评估应包含依赖体积、原生模块、持久化一致性、退出 flush、session replay 和 provider 抽象,而不是只看 UI。
  3. 雷达入库时可把“有 conformance gate / replay baseline”作为 runtime 类项目的加分项。

失败模式 / 边界

低依赖 runtime 可能牺牲官方完整能力;手机/Termux 环境权限复杂,密钥、本地文件和网络代理都需要额外边界。README 声称的体积与兼容性今天未本机复现,因此保持 medium confidence。

写入记录

  • 2026-08-17 09:00 CST:从 GitHub README 深度入库,记录机制、与既有 wiki 概念的关系、Hermes/llm-wiki 可执行启发和失败模式。