loop

中文 | English

定时循环插件：/loop 命令 + loop 工具（模型自调节）+ 对话页活动状态条，支持多循环并行

按固定间隔向当前 agent 重复投递 prompt——适合轮询、PR 看护、build-fix-test 循环。对齐 Claude Code 的 /loop 语义，一个会话可同时跑多个循环。形态：官方 bundle 插件（dsh.bundle + dshClient 通道），0 patch。

效果

能力

工具（defineTool 注册，模型每轮可自调节）：

工具	说明
loop	start（启动新循环）/ stop（停指定或全部）/ status / list（列出当前会话循环）

命令（用户侧）：

命令	说明
/loop [间隔] <prompt>	启动新循环（间隔 5m/30s/1h/2d 或裸数字=分钟；裸 /loop 用内置维护 prompt）
/loop list	列出当前会话全部循环（含 id）
/loop stop <id> / /loop stop	停指定循环 / 停全部

UI（对话页输入框上方 dock 槽）：

功能	说明
活动状态条	单循环：● ⟳ 循环中 · <prompt> · 5m · 下次 23s；多循环折叠为计数条「N 个循环运行中 · 展开」，点击展开列表

设置

插件自带设置卡片，位于 设置 → 插件（官方 ctx.settings 命名空间 dsh-loop，经 settings.plugin.item 槽渲染，与官方插件卡片同列表）。每个工具一行独立的官方质感开关（Switch）：

设置项	默认	效果
是否向模型注入 loop 工具	开	关闭后本进程不再注册 loop 工具：agent 的 tools.schemas 中没有 loop，模型看不到也调不动；/loop 命令（用户侧）与状态条不受影响

卡片字段由客户端 LOOP_TOOL_FIELDS 表驱动，Node half 的工具定义表与之一一对应——新增工具时在两端各加一条，设置页自动多出一行开关。

改动在保存后立即生效（applies: 'live'）——插件 watch 该命名空间，按工具表动态注册/注销对应工具，新会话无需重启即可用上新设置。工具 schemas 在每次会话/每轮 prompt 组装时实时解析（架构上没有按 session 的快照）：存量会话的下一轮也会读到新工具集；关闭时对应工具会立即从 tools.schemas 消失，之前调用过它的模型下一轮起无法再调用（只能通过轮次记录对账）。/loop 命令（用户侧）与状态条不受影响。

安装

推荐：git 源一行安装（构建产物已入库，git 源不触发构建）：

dsh plugin --profile web add "github:vlln/dsh-loop#main"   # git 源一行（构建产物已入库）
# 或 npm 源：dsh plugin --profile web add @vlln/dsh-loop@0.3.0

或本地目录（有源码时）：git clone 后 cd dsh-loop && dsh plugin --profile web add .。

装完 重启 web 生效（bundle 挂载在启动时合成）；之后可在设置页「插件」面板停用/启用（运行时生效 + 持久化）。

使用

# 用户侧
/loop 5m 检查 deploy 分支的 PR      # 每 5 分钟投递一次
/loop list                           # loop-1: every 5m — 检查 deploy 分支的 PR
/loop stop loop-1                    # 停指定
/loop stop                           # 停全部

# 模型侧（loop 工具）
loop action=start prompt="修 flaky test" interval="2m"
loop action=status
loop action=stop loop_id="loop-2"

循环活在当前 harness 进程，随进程退出消失（不跨重启持久化，与 Claude Code /loop 一致）。

开发

pnpm install
pnpm run build      # tsdown：Node half (lib/index.mjs) + client bundle (lib/client.js)

• Node half：src/index.mjs（命令/工具/loops 状态路由 /plugins/dsh-loop/loops）
• client：src/client/index.tsx（dock 槽状态条）

许可

MIT License（DSH 生态示例插件）。