设置
配置 MadoHub 偏好设置、API 密钥和通知。
从应用右上角打开设置。设置面板共有七个标签页:通用、账户、Agent、记忆、外观、语音 和 日志。
通用
语言偏好、Claude Code 停止通知开关(见下文)、系统通知开关、分析数据退出选项,以及 Companion 配对(通过本地网络将画布镜像到 MadoHub iOS 应用)。
账户
云端登录、当前套餐和账单。当 Agent 的 API 访问由云端托管而非自行提供密钥时,也可以在此查看并刷新该连接。
Agent
与 Agent 相关的配置,归入 AgentApiConfig:
提供方
配置用于 Agent 之间 智能路由 的 AI 模型。
| 提供方 | 默认模型 | API key 格式 |
|---|---|---|
| Anthropic(Claude) | claude-haiku-4-5-20251001 | sk-ant-... |
| OpenAI | gpt-4o-mini | sk-... |
| Custom(OpenAI-compatible) | 用户指定 | 取决于提供方 |
对于自定义提供方,你也可以设置 API 端点的 Base URL。
测试连接
使用 Test Connection 按钮验证你的 API key 和模型配置。状态指示器会显示当前提供方和模型,若尚未配置则显示 "No API key set"。
什么时候需要 API key?
只有在连接中使用 ai-routing 或 summary 转换类型时才需要。prompt-wrap、full-output 和 raw 不需要 API key。
其他 Agent 选项
Agent 提示词的自动提交、关闭 tile 时的确认提示,以及 Resume Session 开关(控制已关闭的 Agent tile 是否提供恢复此前会话的选项)。审批模式选择器用于控制如何处理 Agent 发出的权限请求。
记忆
切换自动记忆提取与注入功能,并查看候选队列:等待批准、尚未被提升为活跃记忆条目的记忆候选项。
外观
主题(深色或浅色)与终端字体大小。
语音
启用或禁用语音输入,并选择其目标(语音听写发送到哪个 Agent 或 tile)。也可以从命令面板(Cmd+Shift+P)切换语音输入。
Claude Code 停止通知
在 Agent 完成任务或需要用户交互时触发实时多感官通知。此开关位于 通用 标签页。
启用后,MadoHub 会监控 Agent 生命周期并提供即时反馈:
- 边缘微光动效:当任务完成时,相应 tile 边缘会亮起柔和的环境光脉冲动画。
- 清脆提示音:播放清晰悦耳的提示音,方便你在切换其他窗口时不错过 Agent 的就绪状态。
- 智能自动消除:通知状态在 15 秒后或在你与 tile 交互后自动清除,保持画布清爽。
日志
查看 MadoHub 本地系统日志最后 200 行(~/.madohub/logs/madohub.log)。这对排查工作区事件、审计 Agent 交接流或验证连接配置非常有用。
点击 Refresh 可重新加载日志内容。
记录内容
- Agent 状态流转与生命周期事件
- 完成信号与空闲状态更新
- 路由转换执行与会话交接
- 画布 tile 间的内容投递事件
- 系统错误与诊断信息