设置

/settings 打开设置浮层。Tab 与 Shift+Tab 在 General、Agent、Status line 三个分区之间切换;↑/↓ 移动行,←/→ 修改值。完整浮层按键见键盘与快捷键。

General

行取值默认作用
Themedark、light、midnight、solarized、catppuccin、dracula、nord、gruvbox、rose-pine、monodark配色方案。
Coloron / offonSGR 着色。
Motionfull / reduced / offfullfull 带平滑流式与工作微光;reduced 保留平滑流式、去掉微光;off 直接跟随 provider 分块并使用静态活动标记。
Terminal activityon / offoff支持的终端标签页与任务栏中的忙碌/空闲状态。
Tool detailscompact / expandedcompact展开工具输出与目录说明,与 Ctrl+O 相同。
Update checkson / offon每天检查一次 npm,有新版本时通知。
Release notessummary / expanded / hiddensummary升级后展示一次新版本说明。
Notificationsoff / long-running / alwaysoff回合结束或需要输入时通知。
Long turn15s / 30s / 1m / 2m30s触发长任务通知的最短时长。

Motion 只影响呈现:provider 输出仍会立即进入实时会话,工具边界或已落定的助手消息会立即冲刷可见流,不等待动画。

Agent

行取值默认作用
LanguageAuto / Simplified Chinese / EnglishAuto推理与回复的偏好语言。

非 Auto 的选择从下一个回合开始生效;代码、标识符、命令、工具参数、日志、引用与文件内容保持准确形式,当前任务的显式语言要求仍然优先。该偏好是用户级的,因此恢复的会话使用当前值而不是历史快照。

功能

可选的产品功能,各自消耗上下文、运行时间或转录噪声。每一行关闭一个组合行。

行默认关闭后
改动文件汇总开不再逐回合记录改动文件,也不再在回合起止各做一次 Git 快照。
会话历史工具开模型失去 session_search、session_event_search、session_trace、session_event_trace 与 session_event_read。
Ralph 循环关该循环工具保持缺席,直到你在这里打开。
重复工具提醒开模型不再收到”别重复同一个工具调用”的提醒。

这里的改动在下次启动生效,行内也写明了这一点。disabled 是 Loader 选项而非插件配置,settings 服务无法表达它;因此这些行改为写入 $OMDSH_HOME/profiles/omdsh/cordis.patch.yml 里一个由注释界定的托管块,那正是 Harness 组装组合树时读取的入口。该块之外你手写的内容不会被改动。

支撑某个命令的行(session-query 支撑 /sessions,workspace 支撑 @ 提及)以及会让 agent 不可用的行(tool-fs、tool-bash、todo)刻意不列出。web_search 同样缺席:它与 web_fetch 共用一行,行级开关表达不了”关搜索、留抓取”。

Status line

行取值默认作用
Status lineon / offon显示 composer 下方固定的两行页脚。
Labelscompact / fullcompact紧凑或完整的指标标签。

状态项可以就地重排与换色:Space 显示或隐藏一项,Enter 开始移动(↑/↓ 重排,←/→ 选择列),每一项都有自己的颜色。

第一行默认顺序:Model(deepseek)、Effort(max)、Path(~/project)、Git(main *1)与 Session;Session 默认关闭,因为终端窗口标题无论如何都会显示会话标题。

第二行的遥测分组默认全部显示:Context(Ctx 1.6% · 16.4K/1M)、Cache(Cache 99%)、Tokens(5.9M in)、Latency(TTFT 1.2s)、Time(LLM 16m51s)与 Activity(3 turns)。终端较窄时按优先级从低到高降级:cache、tokens、latency、时长、活动计数。

持久化

设置、模型偏好与登录写入的凭据都是实时插件配置,持久化到当前 Profile 的 Cordis 补丁 $OMDSH_HOME/profiles/omdsh/cordis.patch.yml(home 本身依次回退到 $DSH_HOME、~/.dsh);/settings、/model 与 /login 都写入这里。更早版本留下的 settings.yaml 会在启动时导入一次——每个设置段按同名 id 写入 Profile 行——随后文件被重命名为 settings.yaml.imported;已不再对应任何行 id 的设置段会被记录日志,并且只留在重命名后的文件里。完整文件清单见会话与历史。

插件设置

除浮层的三个分区之外,已挂载的 Harness 插件把设置保存在该插件自己 Profile 行上的 config 中。其中一个决定默认路由是否能工作:llm-deepseek 只支持 Messages,会拒绝 protocol 键,并回复 protocol is not configurable; remove it and use a Messages-compatible baseURL。因此自建 gateway 必须提供 Messages 兼容端点,DeepSeek 端点由 base URL 选择,而不是由协议开关选择。

相关