MadoHub Docs

设置

配置 MadoHub 偏好设置、API 密钥和通知。

从应用右上角打开设置。设置面板共有七个标签页:通用、账户、Agent、记忆、外观、语音 和 日志。

通用

语言偏好、Claude Code 停止通知开关(见下文)、系统通知开关、分析数据退出选项,以及 Companion 配对(通过本地网络将画布镜像到 MadoHub iOS 应用)。

账户

云端登录、当前套餐和账单。当 Agent 的 API 访问由云端托管而非自行提供密钥时,也可以在此查看并刷新该连接。

Agent

与 Agent 相关的配置,归入 AgentApiConfig:

提供方

配置用于 Agent 之间 智能路由 的 AI 模型。

提供方默认模型API key 格式
Anthropic(Claude)claude-haiku-4-5-20251001sk-ant-...
OpenAIgpt-4o-minisk-...
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 间的内容投递事件
  • 系统错误与诊断信息

On this page