settings.json 里的六个 Slot 与四个视图怎么配-平芜编程栈

settings.json 里的六个 Slot 与四个视图怎么配

Martty 的配置面比命令表更易记混：一部分在$MARTTY_HOME/settings.json，一部分只能通过 TUI 视图切换，还有启动参数。本文只讲「写在哪里、默认什么、何时生效」。版本口径martty@0.3.3、node >=22.19.0、engines.dsh >=0.1.7-rc.2。

一份文件里的两个键

martty harness add <id>与use <id>写入$MARTTY_HOME/settings.json的harnesses与defaultHarness；同文件里的主题、语言与 UI Plugin 设置会保留。

defaultHarness在下次 standalone 启动时生效：连接选中的 Harness 时只绑定空会话，不启动模型 turn。中文条目见完整插件清单与汉化避坑指南。

四个视图各管什么

视图	显示什么	是否可改
`/ui`	UI Plugin 列表，例如 Martty 与 DeepSeek	切换整套 UI 组合
`/theme`	Theme Plugin 列表	切换配色及该 Plugin 的其他能力
`/plugins`	当前已加载的静态 Plugin	只读
`/cordis-plugins`	Cordis 模式刚创建的临时 Plugin	可随 run 停止或回收

/ui与/theme是视图，不是 Plugin 类型；列表里的 Plugin 可以是 Client-only 或带 Host half 的双向 Plugin。

六个 Slot：single 还是 list

Slot	类型	位置与用途
`welcome.hero`	single · root	欢迎页品牌区
`welcome.info`	single · root	欢迎页版本、模型与 session
`chrome.right`	list · root	主界面右栏，适合监控
`conversation.input.dock`	list · session	输入框上方，适合 Plan 摘要
`conversation.navigation.dock`	list · session	composer 内部，适合 Agent 导航
`conversation.composer.dock`	list · session	composer 外层底部，适合 token 与耗时统计

single 是同一位置只有一个提供者，适合品牌区；list 可并列多个。root 属全局骨架，会话切换时不变；session 随会话挂载、卸载。做「每会话一份的 token 统计」选conversation.composer.dock。Client half 用tuiSlots.register提供内容，只能碰公开 Service 与语义节点。

主题、明暗与预览

/theme选 Theme Plugin，/theme toggle或ctrl+t切 dark/light（/theme候选把toggle与 Theme Plugin 分区）。移动高亮只是即时预览，并未确定；按 Enter 才切换并持久化，Esc 或移开则回滚。

临时与常驻：/liang 与 Artifact

Cordis 的 Plugin 默认只属于当前进程，/liang on//liang off显式控制，缺省关闭。Client-only 走cordis_define → cordis_run → tui_plugin_save，产物存到$MARTTY_HOME/plugins/<artifact-id>/plugin.json，下次启动重新发现。含code.host的 Package 由 Harness 管理，用dsh plugin --profile martty add安装；没有promote命令。

Harness 解析的四级顺序

默认（martty/npx martty）：内置@openma/deepseek-harness-acp及其 bundled runtime；PATH、当前目录、全局 npm 的隐式发现不会覆盖它。
--dsh <profile>：连全局 dsh 的 profile；启动前检查版本，低于下限回退到第 1 种并提示。
作为 dsh 插件启动（dsh --profile martty）：用启动它的 host dsh。
显式--dsh-path/DSH_PATH。

找不到dsh或 profile 不存在时直接报错；--dsh的 profile 装的是martty就把终端交给dsh --profile <profile>，只装@openma/deepseek-harness-acp则让它作为本 Client 的 ACP agent。

陷阱：目录是快照，不是搜索

find看到的是缓存或随包快照，默认不联网；要新条目得加--refresh，它也不是 npm 包搜索。

陷阱：带 code.host 的 Package 写不进 .oma

tui_plugin_save只吃 Client-only；Host-only 或双向 Package 硬走会失败，要先用cordis_inspect_self读源码，整理成普通 Cordis npm Package 或本地 Package，再dsh plugin --profile martty add。

陷阱：Windows 的路径与入口

Registry 的 binary 落在%MARTTY_HOME%\bin\<id>\<version>\<platform>，platform 为windows-x86_64或windows-aarch64，入口靠PATHEXT识别npx.cmd、uvx.exe。两者都提供而本机缺 npx/uvx 时，回落到受管 binary。