description: "dsh Web 客户端插件页上的终端执行器设置页：shell 命名空间的命令超时与单流输出上限。" kind: "package-reference"

@x1a0f3n9/dsh-client-ui-settings-shell

English | 中文

概述

在侧栏打开插件，在官方分组里选择终端，即可设置单条命令允许运行多久、每条输出流在内存里保留多少。页面暂存输入、只在保存时写入，标明用户覆盖过的值，并允许把每个值重置回部署默认值。页面只在 Host 服务 shell 命名空间期间存在，没有本地终端执行器的部署看不到它。

目录

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

使用本包

官方分组里的终端卡片打开这一页。命令超时（毫秒）终止运行更久的命令；单流输出上限（字节）把超出的输出转存到临时文件。两个字段都显示生效值，即用户覆盖值叠在组合默认值之上；用户覆盖过的字段带已覆盖标签，旁边是恢复默认。点击保存之前不会写入任何内容；离开页面即丢弃草稿，清空字段并保存等于重置，填了不是数字的文本则保存被阻止，并在字段下说明原因。

理解实现

宿主半侧是一个空的 apply，只为让本包占一条 Loader 行，客户端模块系统据此送出浏览器半侧。浏览器半侧通过 ctx.configForms.get 绑定当前平台组装的 shell 执行器条目（非 Windows 为 bash-sandbox，Windows 为 pwsh-sandbox），用 ui-primitives 的共享 SettingsFormModel 在 ShellCardController 里维护暂存表单，并通过 ctx.configForms.whileServed 把 ShellCard 注册进插件页的 plugins.item slot：Host 服务任一执行器条目时注册，停止服务时注销。页面文案在本包的 settings.shell 字典里；SettingsForm 框架的文案以 props 传入。

进一步探索

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

模型体验

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

KV 缓存影响

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

已知限制与延期工作

• 页面跟随组合进来的执行器——POSIX 与 PowerShell 两个执行器家族共用 shell 命名空间，因为一台主机只组合其中一个，所以服务出来的 schema 因平台而异（PowerShell 多一个 pwshPath），而页面在两个平台上编辑的都是同样两个字段。
• **运行时不变量：**不发布伴生。本页没有自己拥有的关系：它显示的内容派生自设置镜像，它写入的内容由 Host 校验。

开发备注

无。