本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-plugins（loop / dsh-loop）

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-loop

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• Codex Terminal documentation
• Coding Plan core
• Codex Coding Plan documentation
• Grok Coding Plan documentation
• Loop documentation

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

这个插件装好之后怎么用？

安装后重启 DSH 并新建会话即可，无需额外配置。可以用自然语言告诉 agent「每 10 秒提醒我检查构建」，agent 会调用 loop_create 工具；也可以直接在输入框用 /loop <秒数> <提示> 命令创建。

想改一个已经创建的提醒（改间隔或提示词）怎么办？

v1 版本没有修改接口，必须先 loop_delete 旧的再 loop_create 新的（SPEC.md §1.1 明确说明这是 v1 的非目标）。

关掉 DSH 之后循环还在跑吗？

不在。循环是会话局部、进程局部的（README §5、SPEC.md §1.1）：DSH 进程停掉或系统睡眠期间定时器不触发，也不会补送错过的提醒，下次启动会话时定时器从会话事件日志里重建。

两个会话之间能共享同一个循环吗？

不能。每个循环归属于创建它的那个 session（SPEC.md §2），其它会话既看不到也删不掉它；如果需要同一条规则覆盖多会话，目前只能在每个会话里各自创建一份。

agent 正在跑长任务时收到提醒会不会被打断？

不会直接打断。提醒以 wakeup:true 的用户消息送到 session 收件箱，agent 在跑就投到 next-step，空闲就投到 next-turn（README §5），所以会在「下一个安全的步骤边界」被处理，不会强制中断当前操作。

网页端有可视化界面吗？

有。DSH Web 在对话输入框上方会显示一个紧凑的 Loop dock，展示当前会话里活跃循环的数量、间隔、下次触发倒计时和完整 prompt（src/ui/LoopsView.tsx:83-118），并提供直接的删除按钮。

间隔可以填小数或者分钟、小时单位吗？

不可以。time_in_seconds 必须是正整数秒，loop_create 工具在 schema 层校验（src/tools.ts:45），也允许分钟换算成秒数。

怎么卸载？

跑 dsh plugin --profile web remove 加上对应的安装源即可；卸载后当前会话的活跃循环会停止，新会话里也不再注册 loop_create / loop_list / loop_delete 三个工具。

— 源: plugin_wiki.faq_json

兼容性

• DSH: >=0.1.0-rc.5（peerDependencies 中所有 @deepseek-ai/dsh-* 均要求 >=0.1.0-rc.5，cordis >=4.0.0）
• Node: 未声明（package.json 没有 engines 字段，devDependencies 仅声明 @types/node ^22.20.0）
• Platforms: 跨平台（DSH Web）

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则