description: "dsh Web 客户端插件页上的 Agent 循环设置页：agent-loop 命名空间的并行工具调用上限。" kind: "package-reference"

@deepseek-ai/dsh-client-ui-settings-agent-loop

English | 中文

概述

在侧栏打开插件，在官方分组里选择 Agent 循环，即可设置一步之内最多同时运行多少个可并行的工具调用。页面暂存输入、只在保存时写入，标明用户覆盖过的值，并允许把它重置回部署默认值。页面只在 Host 服务 agent-loop 命名空间期间存在。

目录

• 使用本包
• 理解实现
• 进一步探索
• 模型体验
• 已知限制与延期工作
• 开发备注

使用本包

官方分组里的 Agent 循环卡片打开这一页。并行工具调用数限制循环在一步之内同时运行的调用数；字段显示生效值，一旦被覆盖就带已覆盖标签，旁边是恢复默认。点击保存之前不会写入任何内容；离开页面即丢弃草稿，清空字段并保存等于重置，填了不是数字的文本则保存被阻止，并在字段下说明原因。

理解实现

宿主半侧是一个空的 apply，只为让本包占一条 Loader 行，客户端模块系统据此送出浏览器半侧。浏览器半侧通过 ctx.configForms.get 绑定 agent-loop 命名空间，用 ui-primitives 的共享 SettingsFormModel 在 AgentLoopCardController 里维护暂存表单，并通过 ctx.configForms.whileServed 把 AgentLoopCard 注册进插件页的 plugins.item slot。页面文案在本包的 settings.agentLoop 字典里。

进一步探索

• ui-plugin-manager——插件页以及本页注册进去的 plugins.item slot。
• ui-settings——本页依赖的设置 scope 与"命名空间被服务期间"的监视。
• ui-primitives——本页渲染的设置表单模型与字段。
• agent-loop——注册 agent-loop 命名空间的循环。

模型体验

无，本包是浏览器侧的设置界面，不注册任何模型面。

KV 缓存影响

无；本包既不组装也不发送提供方请求。

已知限制与延期工作

• 只编辑命名空间的一个字段——Host 的这一节只承载并行上限；组合进来的 agents 数组属于启动组合而非用户设置，这里没有对应字段。

开发备注

无。