DSH-first · Terminal-native · Cordis 插件

在终端里,完整地看见你的 Agent 在做什么。

Martty 是一个面向 DeepSeek Harness 和其他 ACP-compatible coding agents 的高性能 Agent TUI（Rust / ratatui 渲染），流式呈现推理、工具调用、 subagent、token 用量和持久化会话;图片可从文件或剪贴板加入 prompt。界面、主题、命令与视图都由 Cordis 插件组合,而不是写死在 shell 里。

从 ACP Registry 浏览和配置 Harness，在同一连接内用多会话标签保留草稿与队列。连接、认证和历史恢复能力以 Agent 返回的结果为准。

安装 Martty 看看界面 npm

如何安装

Martty npm 包要求 Node.js 22.19+，所选 Agent 可能有额外运行环境要求。首次启动默认连接 DSH；之后可使用保存的 Harness 默认项。

全局安装(推荐)

$ npm install --global martty
$ martty

不想全局安装

$ npx --yes martty

已有 DSH:装到独立 profile,交给 DSH 管理

$ npm install --global @deepseek-ai/dsh
$ dsh plugin --profile martty add martty@latest
$ dsh --profile martty

只想看界面(不需要 runtime 或 API key)

$ martty --demo
$ martty --demo-skin

`--demo-skin` 使用内置 ember 皮肤展示主题切换。

UI 简介

Martty 在终端中完整呈现 agent 工作过程:流式回复、推理、工具调用、subagent、Plan、 token 用量与持久化会话。以下分别是启动界面、会话恢复与模型选择。

Martty 启动界面 — 启动界面:欢迎页展示品牌、版本、模型、workspace 与 session 信息。

Martty 会话恢复界面 — 会话恢复：`/resume` 浏览近期会话；ACP 远端恢复与本地历史回放取决于 Agent 能力。查看恢复与标签指南。

Martty 模型选择界面 — 模型选择:`/model` 直接选择 agent 宣告的模型,输入前缀即可过滤候选。

完整时间线

推理、回复、工具参数与结果、插件上下文、subagent 生命周期、token/缓存指标,状态行实时显示阶段、耗时与队列深度。

多图 prompt

可从文件、剪贴板或粘贴暂存最多 8 张图片,`[image n]` chip 内联显示,预览包含名称、尺寸、大小与类型。

原生 ACP 能力

直接读取模型的 model、compositions、permissions、认证方式与可用命令;技能与内置命令共用一个可搜索的斜杠菜单。

指南与架构

先按使用指南配置 Agent、管理会话；需要实现细节时，再阅读 ACP、Ratatui 与插件专题。

用 Codex 和 Claude Code，不必换一套终端操作想让另一个 Agent 换个思路排查问题？从一次小任务开始，弄清能复用的习惯与不能自动迁移的上下文。多会话、恢复与消息队列使用标签、/resume 和 Ctrl+Enter，区分草稿、队列、历史与远端任务。DeepSeek Harness TUI三条命令安装 Martty，并从源码理解 Host、Client 与 TTY 边界。ACP terminal client拆解 spawn/stream、initialize、session/update 与取消时序。Ratatui agent TUI状态帧、Unicode composer、滚动锚点与语义插件边界。原生 DSH UI 插件主题、slots、commands、overlays 与 UI 组合。

查看全部 Martty 指南 →

曾经使用 DeepSeek Harness TUI？查看 Martty 更名迁移指南。

如何使用

常用按键与命令:

按键 / 命令	行为
`enter`	发送消息;回合运行时排队 follow-up
`ctrl+enter`	立即 steer 当前 agent（macOS 也可用 ⌘⏎）
`esc`	中断当前回合并保留草稿
`/`	打开命令与参数候选菜单
`/model` · `/agent`	选择模型和 Agent Preset
`/harness` · `/auth`	配置或切换 Harness；按 Agent 提供的方式认证
`/permission` · `shift+tab`	选择或轮换权限模式
`/image <path>` · `/clip`	添加本地图片或剪贴板图片
`/theme` · `ctrl+t`	选择 Theme Plugin 或切换明暗变体
`/ui`	切换整套 UI 组合(如 Martty / DeepSeek)
`/new` · `/resume`	新建或恢复持久化会话
`/session prev` · `/session next`	切换会话标签，各自保留草稿与队列
`/close`	关闭当前标签；不删除历史或取消远端任务
`!cmd`	在 workspace 的会话级本地 shell 中执行命令
`/help` · `/keys`	查看命令与完整快捷键列表

Markdown、代码块与工具输出使用终端原生交互;工具结果默认折叠为最后四行,点击即可展开。图片预览、剪贴板路由与 kitty 图片协议按终端能力自动适配。