用途:Manage Settings 是 Muse Code 专属的设置管理技能,用于回答产品设置、配置路径、提醒开关、TUI 设置、provider/model 设置以及工具或策略设置的问题,并在用户明确要求时修改已保存的设置。仓库设置、应用设置界面、库配置和评测任务配置不属于本技能范围。
主要能力:区分“已保存设置”与“当前运行时状态”。读取 settings.json 只能证明已保存配置,不能证明当前 TUI、进行中的运行或 provider 请求状态。写入只改变永久保存值,保证在下次启动 Muse Code 时加载,不声称当前进程已重载。
配置位置:优先 $XDG_CONFIG_HOME/muse/settings.json,否则 $HOME/.config/muse/settings.json。该目录还含 auth.json 与 trust.json,只报告是否存在,不显示内容。解析路径可用只读命令:python3 -c 'import os; print(os.path.join(os.environ.get("XDG_CONFIG_HOME") or os.path.join(os.environ["HOME"], ".config"), "muse", "settings.json"))'。首次读取内容必须用 read_file;仅在文件工具拒绝该路径且启动安全上下文明确处于 YOLO 模式时,才可用结构化 shell JSON 编辑,需用 JSON 解析器加原子替换并重读,禁止文本替换。
稳定键约定:reasoning_effort 为顶层持久档位,Meta 接受 minimal、low、medium、high、xhigh、max、ultra,high 为默认基线,xhigh 为可选高精度档,ultra 保留为已保存选择并在 Meta 线路上使用 max 推理,当前会在该工具面可用时启用主动工作流/委派指导,可能快速增加 token 用量。tui.reasoning_summaries 为布尔值,缺省 true;tui.verbose_output 取 less、edits、more,缺省 edits;tui.terminal_background 取 auto、light、dark,缺省 auto。
使用方式:先分类请求。关于控件、支持档位或时机的问题按稳定约定回答,无需读文件;询问已保存值或明确要求修改时才读文件。修改时先读当前设置,做满足请求的最小 JSON 变更,保留无关键与未知字段,重读验证,并报告旧值、新值、永久性、当前会话不变、下次启动生效。文件缺失是正常首次写入状态,可创建含 schema_version: 1 的最小对象;被拒绝或格式错误的文件不得替换。
限制:不创建 issue、分支、提交、PR、插件或技能;不安装、启用、禁用、信任或运行插件与技能,除非用户明确要求。不打印密钥,若设置可能含令牌、密钥或凭据,只说明是否存在。不模拟渲染器行为(如推理摘要、详细输出重绘)。不编造推理档位、预算、比例或效果。不因编辑设置而建议关闭沙箱、审批或其他安全控制。当前会话的 /models、/effort、/settings 是用户侧控件,不得声称已执行。会话状态、日志、崩溃等问题应交给 doctor 技能。