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 [间隔] ` | 启动新循环（间隔 `5m`/`30s`/`1h`/`2d` 或裸数字=分钟；裸 `/loop` 用内置维护 prompt） |
| `/loop list` | 列出当前会话全部循环（含 id） |
| `/loop stop ` / `/loop stop` | 停指定循环 / 停全部 |
**UI**（对话页输入框上方 dock 槽）：
| 功能 | 说明 |
|---|---|
| 活动状态条 | 单循环：`● ⟳ 循环中 · · 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 源不触发构建）：
```sh
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 挂载在启动时合成）；之后可在设置页「插件」面板停用/启用（运行时生效 + 持久化）。
## 使用
```sh
# 用户侧
/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` 一致）。
## 开发
```sh
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 生态示例插件）。