MadoHub Docs

图块

工作空间的构建模块 — 终端、代码、笔记、图片和文件树。

图块是画布的构建模块。每个图块都是一个可调整大小、可拖拽的容器,带有 macOS 风格的标题栏。

终端

主要的图块类型。终端图块运行完整的 PTY(伪终端)会话,支持可选的 tmux 集成。

  • 默认大小:440×540px
  • Agent 检测:MadoHub 监控输出以识别 Claude Code、Codex、Amp、OpenCode 或通用 shell,并追踪 Agent 的状态(工作中、等待中、已停止、空闲、已退出、已完成、失败)。
  • 上下文菜单:右键可复制、粘贴、清屏和终止会话。
  • PID 追踪:每个终端的进程 ID 都会被记录,用于路由时的 JSONL 会话解析。
  • 标题栏功能:Worker 徽章(由聊天派发的 worker 创建的图块上会显示 codex 标签)、Context Gauge(每个图块的上下文窗口占用条 — 低于 70% 为绿色、70% 为琥珀色、90% 为红色 — 仅限 Claude,并带有 Dynamic Workflows 子 Agent token 提示)以及 Resume Session 选择器。

创建终端

  • 在画布上双击
  • Cmd+Shift+P → New Terminal
  • 终端在当前活动工作空间的目录中打开

代码

显示带有语法高亮和行号的代码文件。只读 — 适合查看 Agent 正在处理的内容。

  • 最多显示 500 行
  • 标题栏显示文件名
  • 通过将非图片文件拖拽到画布上创建

笔记

自由文本编辑器,用于规划、文档或记录想法。

  • 默认大小:300×250px
  • 输入时自动保存
  • 可以接收 Agent 路由过来的内容(例如已完成工作的摘要)

图片

在图块中显示图片文件。支持 PNG、JPG、JPEG、GIF、WebP、SVG、BMP、ICO 和 TIFF。

通过从文件树或 Finder 将图片文件拖拽到画布上创建。

文件树

项目目录的层级文件浏览器。

  • 默认大小:440×540px
  • 点击文件夹展开/折叠
  • 从文件树拖拽文件到画布上可创建代码或图片图块
  • 隐藏点文件和常见构建目录(node_modules、.git、dist、target 等)—— 使用固定列表,而非解析 .gitignore

团队面板

显示来自 tmux 会话的远程 Claude Code Agent 终端。用于团队协作中监控团队成员的工作。

消息流(预留)

此图块类型为预留功能,目前尚不可用 — 没有任何代码路径会创建它。团队消息改为显示在 Team Hub 面板(右侧抽屉)中;参见团队协作。

On this page