dsh-fast-loop

English | 中文

为 DeepSeek Harness (DSH) 开发的实验性 Agent Loop 插件，现保留供参考。

维护状态

本项目已于 2026 年 10 月 28 日停止主动维护，仓库已归档。 最后正式 GitHub Release 为 v0.5.2，不再保证与后续 DSH 版本兼容。

官方 loop 持续演进，独立维护完整替代实现需要较高的兼容性成本，目前也没有证据证明本项目在真实任务中普遍更快。后续使用推荐回归 DSH 官方 agent-loop。 源码、发布历史和实验成果继续保留，供研究与 Fork。

如果已安装本插件，可为对应配置恢复官方 loop：

dsh-fast-loop disable --profile web
dsh-fast-loop status --profile web

将 web 替换为实际配置名称，然后重启 DSH。下方安装与配置说明仅作为历史参考保留。

v0.5.2 版本核心特性

• 步骤级指标：导出 StepMetrics，提供 agent.lastStepMetrics 与运行时 agent/step-metrics 事件，记录步骤耗时、最后一次模型尝试耗时、首 chunk 延迟、工具耗时、尝试次数及 token 用量。
• 结构化软中断：使用 Symbol 分类与调用索引跟踪替换错误文本子串匹配，保留轮询兜底。
• DSML 快速路径：对不含 < 的文本跳过 DSML 正则扫描。
• 扩展兜底重试分类：新增 PROTOCOL_DRIFT、RATE_LIMIT 和 SERVER。
• 接口注意事项：TRANSIENT_RETRYABLE_CODES 从 Set 改为只读对象表；外部调用者应使用 isTransientRetryableFailure(code) 替代 .has()。
• 指标边界：指标仅通过运行时提供；先前失败尝试和重试等待会计入剩余开销。现有并发 Benchmark 不能证明比当前官方 loop 更快。

核心特性与架构设计

1. 高并发工具调度器

• 有界并发池：根据步骤指令动态发起最多 maxParallelToolCalls 路并行工具调用，并严格按照 FIFO 顺序完成与落盘，兼顾并发吞吐与数据确定性。
• 独占工具同步屏障：当遇到需要独占控制台或文件系统的工具（如持久化执行等）时，自动等待在飞并发任务清空并有序执行。
• 工具崩溃容错自愈：捕获单次工具调用的非预期异常，确保前序及同批次其余工具调用结果完整落盘，杜绝 Agent 状态悬挂。

2. 底层架构与 Cordis 规范接入

• 运行时依赖持有机制：彻底隔绝外部调用方 Context 影子代理，确保 sessionProjections、systemPrompt、tools、llm 等核心服务在任何调用栈下均可安全触达。
• 持久化轮次投影对齐：通过 turnBoundary 投影在冷启动与会话恢复时精确对齐历史最后轮次，杜绝轮次跳变与意外终止。
• 断点续跑补全机制：会话恢复时自动扫描并补全未闭合的异常中断事件（interruptedTurnClosers），保证事件流合规。

安装与快速上手（历史参考）

通过 DSH 插件命令安装

dsh plugin --profile web add dsh-fast-loop@latest

通过 npm / pnpm 安装

npm install dsh-fast-loop@latest
# 或
pnpm add dsh-fast-loop@latest

方式一：命令行一键切换

内置 CLI 自动安全更新 cordis.patch.yml，彻底杜绝手写 YAML 缩进错误：

# 启用 dsh-fast-loop 并禁用官方 agent-loop
dsh-fast-loop enable
# 或使用 npx 免安装直接执行：
npx dsh-fast-loop enable

# 一键回退至官方原生 agent-loop
dsh-fast-loop disable
# 或
npx dsh-fast-loop disable

# 查看当前激活模式
dsh-fast-loop status
# 或
npx dsh-fast-loop status

方式二：手动在 cordis.patch.yml 中配置

在 ~/.dsh/profiles/web/cordis.patch.yml 中禁用默认的 agent-loop 并插入 dsh-fast-loop：

# 禁用原生 Agent Loop
- id: agent-loop
disabled: true

# 接入高性能 Fast Loop
- insert:
- id: fast-loop
name: dsh-fast-loop
config:
maxParallelToolCalls: 10
enableStreamingTools: true
enablePathAwareBarrier: true
enableSteeringSoftInterrupt: true

配置项说明

开源协议

MIT © dsh-fast-loop contributors