dsh-subagent-admission

English

面向 DeepSeek Harness 子代理的实验性共享生命周期准入协议与参考策略内核。

本项目针对官方仓库 Discussion #131 报告的故障形态：嵌套子代理可以持续扩张，直至一个 Web Host 失去响应。 它不是另一个编排器，而是把“是否允许创建或重新激活子代理”变成所有官方 runtime 调用者共同经过的、原子的、由真实生命周期持有的决策。

长期产品方向是 Agent Runtime Resource Control Plane：每个即将实体化的 agent workload 都应先获得一个显式、可观察、由真实生命周期持有的资源 permit。 v0.1 只验证 DSH subagent 这一条极窄边界。

候选版本状态： 源码已公开在 yha9806/dsh-subagent-admission， 但 0.1.0-rc.1 尚未发布到 npm。这是独立社区项目，不是 DeepSeek 官方组件， 没有 DeepSeek 背书或采纳、外部用户证据、生产部署或 maintainer 回复。

为什么需要共享协议

现有 DSH 插件已经解决了一些真实问题。尤其是 dsh-turn-budget：它完全使用 公开的 agent/pre-step 与 tools/pre-execute hooks，提供可以立即安装、 fail-closed 的 per-turn circuit breaker，限制 step、tool call 和 provider token。 dsh-background-agents 会限制由它自己的工具发起的启动、按 parent 串行化这些 启动，并统计已有 continuable children；AgentTeams 限制团队成员数量；Delegate 对显式依赖进行门控。这些都是应该承认的前例，而不是可以抹掉的空白。

dsh-turn-budget 与本项目处在不同层，且可以组合：前者在原版 DSH 上约束单个 turn 内的工作；本实验针对所有调用者共享、由官方 child lifecycle 持有的原子 process/root admission。两者都不应被描述成取代对方。

剩余的 infra 问题不同：工具内部的锁无法原子约束同时由内置工具、其他插件、 provider、SDK 或直接 ctx.subagents 调用发起的启动。Host 级容量规则还必须 覆盖 one-shot、continuable、cold resume 和官方 cleanup 边界。当前逐项主源 比较记录在生态审计中。

因此本仓库明确分成三层：

• 一个窄而可选的 protocol-v1 admission contract：在 provider 工作或 child materialisation 前请求准入，并报告 bind/release 生命周期边；