设置
配置 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 停止通知
在 Claude Code 完成任务时切换通知。此开关位于 通用 标签页。
启用后，MadoHub 会：
- 在
~/.madohub/hooks/claude-stop-notify.sh安装一个 shell 脚本，并将其注册到~/.claude/settings.json的hooks.Stop['*']下。 - 在 Stop 时，该脚本会向
~/.madohub/notifications/{tile}_{timestamp}.json写入一个 JSON 标记文件。 - MadoHub 通过扫描该目录，并读取（随后删除）任何 300 秒以内的新标记文件来检测完成状态。
- 当 Claude Code 停止时显示 edge glow 动画并播放 sound。
- 15 秒后自动关闭。
这需要对 ~/.claude/settings.json 和 ~/.madohub/hooks/ 具有写入权限。
日志
查看 MadoHub 日志文件最后 200 行（~/.madohub/logs/madohub.log）。这对排查路由问题、Agent 检测问题或会话解析失败很有用。
点击 Refresh 可重新加载日志内容。
记录内容
- Agent 状态变化和检测事件
- 完成关键词匹配
- 空闲计时器触发
- JSONL 会话解析（PID → sessionId → file）
- 路由转换执行
- 内容投递事件
- 错误和警告