config.toml 参考

~/.yachiyo/config.toml 保存设置和供应商元数据。模型供应商 API key 与 Vertex 私钥放在本机加密的 provider-credentials.enc 凭据库中。频道凭据则在 channels.toml 里。

可以在应用里改，用 yachiyo config set 改，或者手动改。应用每次保存都会按确定的小节顺序重写这个文件，所以手动编辑会保留，但可能被重新排序。供应商凭据是例外：请通过设置或 yachiyo provider update 更新，不要编辑下方留空的兼容字段。

`enabledTools`

enabledTools = ["read", "write", "edit", "bash", "grep", "glob", "webSearch"]

一次运行起始的工具白名单，由应用写入。它不是一个设置开关 —— 决定某一轮工具列表的是你在输入框里选的运行模式。skillsRead 和 reviewThings 由运行时管理，不会出现在这里。见工具列表。

runMode = "auto"

默认运行模式：auto、explore、plan、chat 或 custom。默认为 auto。见运行模式。

键	类型	默认	说明
`sidebarVisibility`	`"expanded"` \| `"collapsed"`	`expanded`	侧边栏状态
`language`	`"auto"` \| `"en"` \| `"zh-CN"`	`auto`	界面语言；`auto` 跟随系统
`sidebarPreview`	`boolean`	`true`	侧边栏中的消息预览
`toolCallDisplayMode`	`"work-summary"` \| `"tool-deck"`	`tool-deck`	显示紧凑的已完成工作摘要或按时间排列的工具面板
`themeId`	`string`	`mizu`	`mizu`、`sumi`、`ume`、`aoba`、`mint`、`fuji`、`yamabuki`、`gobyou`、`murasaki` 之一
`themeAppearance`	`"system"` \| `"light"` \| `"dark"`	`system`	明暗模式
`uiFontSize`	`number`	——	界面字号
`chatFontSize`	`number`	——	聊天字号
`chatPanelOpacity`	`number`	——	聊天面板不透明度
`updateChannel`	`"stable"` \| `"beta"`	——	从哪个发布通道更新
`demoMode`	`boolean`	`false`	演示/截图模式
`preventSystemSleep`	`boolean`	`false`	运行期间不让机器休眠
`notifyRunCompleted`	`boolean`	`true`	运行结束时通知
`notifyCodingTaskStarted`	`boolean`	`true`	委派任务开始时通知
`notifyCodingTaskFinished`	`boolean`	`true`	委派任务结束时通知
`translatorShortcut`	`string`	`CommandOrControl+Shift+T`	全局翻译器热键
`jotdownShortcut`	`string`	`CommandOrControl+Shift+J`	全局速记热键

键	类型	默认	说明
`activeRunEnterBehavior`	`"enter-steers"` \| `"enter-queues-follow-up"`	`enter-steers`	运行流式输出时回车做什么
`stripCompact`	`boolean`	`true`	压缩过长的线程历史
`stripCompactThresholdTokens`	`number`	——	触发压缩的 token 数
`autoMemoryDistillation`	`boolean`	`true`	运行后蒸馏记忆
`inputBufferEnabled`	`boolean`	`false`	发送前缓冲输入
`recapEnabled`	`boolean`	`true`	恢复时回顾上下文
`imageToTextModel`	`object`	——	`{ providerName, model }`；回落到工具模型

键	类型	说明
`syncDir`	`string`	同步文件夹路径。留空则在本设备停用同步。

键	类型	说明
`enabled`	`string[]`	启用的技能名
`disabled`	`string[]`	显式停用的技能名

键	类型	默认	说明
`mode`	`"default"` \| `"custom"` \| `"disabled"`	`default`	`default` 复用聊天模型；`disabled` 跳过辅助生成
`providerId`	`string`	`""`	`mode = "custom"` 时的供应商 UUID
`providerName`	`string`	`""`	供应商显示名称
`model`	`string`	`""`	模型名

键	类型	说明
`providerName`	`string`	新对话使用的供应商
`model`	`string`	新对话使用的模型

优先用 yachiyo provider set-default 而不是直接改这里。

键	类型	默认	说明
`enabled`	`boolean`	`true`	记忆总开关
`autoRecall`	`boolean`	`true`	把调取到的记忆带进运行

八千代会自动在 Bing、Google、Brave、DuckDuckGo 与 Exa 之间选择并故障转移。这里仅保存浏览器会话信息和可选的 Exa 接入，不再指定搜索供应商。

键	类型	默认	说明
`browserSession.sourceBrowser`	`string`	——	会话是从哪个浏览器导入的
`browserSession.sourceProfileName`	`string`	`""`	来源配置文件
`browserSession.importedAt`	`string`	`""`	导入时间戳
`browserSession.lastImportError`	`string`	`""`	上次导入的错误（如果有）
`exa.apiKey`	`string`	`""`	Exa API key
`exa.baseUrl`	`string`	`""`	自定义 Exa 端点

一个表数组，每个供应商一项。

键	类型	说明
`id`	`string`	稳定 UUID
`presetKey`	`string`	关联到某个内置预设（如 `openai`、`google-vertex`）
`name`	`string`	显示名称
`type`	`string`	`openai`、`openai-responses`、`openai-codex`、`anthropic`、`gemini`、`vertex` 或 `vercel-gateway`
`apiKey`	`string`	留空的兼容字段；凭据实际存放在本机加密凭据库中
`baseUrl`	`string`	API base URL
`thinkingEnabled`	`boolean`	推理是否默认开启
`reasoning`	`table`	强度默认值与按模型的推理配置
`codexSessionPath`	`string`	Codex `auth.json` 的路径，用于 `openai-codex`
`project`、`location`	`string`	仅 Vertex
`serviceAccountEmail`	`string`	Vertex 服务账号邮箱
`serviceAccountPrivateKey`	`string`	留空的兼容字段；私钥实际存放在本机加密凭据库中
`modelList.enabled`	`string[]`	在选择器里显示的模型
`modelList.disabled`	`string[]`	已知但隐藏的模型
`modelList.imageIncapable`	`string[]`	不能接收图片的模型

键	类型	说明
`keycode`	`string`	触发码；必须以字母开头
`text`	`string`	展开成的文本

外部 ACP 智能体档案。已废弃 —— 见子智能体。

键	类型	默认	说明
`mode`	`"worker"` \| `"acp"`	`worker`	子智能体运行后端
`enabledNamedAgents`	`string[]`	全部四个	`explore`、`plan`、`review`、`general` 的任意组合
`preferredModels`	`table`	——	按智能体的 `{ providerName, model }` 覆盖

预设的线程启动器。