Martty
面向 DSH 的 Agent 终端界面,支持 ACP 连接与运行中自进化插件。
- Star 数
- ★ 83
- 最近更新
- 3 天前
- License
- MIT
- 主语言
- Rust
- FA 评分
- 58/100 · 缺口较多
30 秒速览
- 可在哪里用
- 兼容但需适配
- 开始前需要
- 典型场景
- 需要在终端内完成长会话编码、带工具调用与 Plan 的开发者。
- 主要局限
- 默认体验绑定 DSH 与其 bundled runtime,非默认 Harness 需要自行改 agent/stream 配置。
- 官网
- martty.sh ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-11-18最新版本 v0.3.3(2026-10-17)
- 源码审查
- 58/100 · 缺口较多
这个 Agent 能做什么,适合哪些场景?
Martty 是一个运行在终端里的 Agent TUI 客户端,内置 ACP 连接层,默认启动并连接 DeepSeek Harness(DSH),也可通过配置连接其他兼容 ACP 的 agent。它由 Rust/ratatui 绘制的 painter 与 Node.js 编写的 Cordis Client 两大部分组成,Client 进程独占用户 TTY,ACP 走 stdin/stdout、用户终端走 fd 3/4,两条通道互不混用。界面本身由 Cordis Plugin 组合而成:UI、主题、Slot、命令、Overlay 与 Session 视图都随 Plugin 生命周期加载和卸载,Client half 可通过 tuiSlots.register 向六个插槽(如 welcome.hero、chrome.right、conversation.composer.dock)提供内容。它还提供 martty harness 系列 CLI 与 /harness 面板,用于浏览 ACP Registry、安装与切换不同的 Harness。作为 dsh 插件安装时(dsh --profile martty),Host half 由当前 Harness 管理,Client half 由 Martty 渲染,形成双进程架构。
启动后 Martty 通过 ACP initialize 与 session/new 连接选中的 Harness,在欢迎页显示 agent 上报的模型与 effort,并把流式回复、推理、工具调用、subagent、Plan、token 用量与持久化会话渲染为终端界面。Composer 支持多行编辑、选区复制、撤销/重做、vim 模式、图片(/image、/clip)与队列消息(enter 发送、ctrl+enter steer、alt+↑ 编辑队列)。Registry 相关流程由 martty harness find/add/use/list/remove 与 TUI 内 /harness、/harness add 驱动:find 默认读取缓存或随包快照,--refresh 才联网取 https://cdn.agentclientprotocol.com/registry/v1/latest/registry.json,binary 分发会下载到 $MARTTY_HOME/bin/<id>/<version>/<platform> 并校验 SHA-256。插件侧,Creator 可先用 cordis_inspect_self 读取已验证的 Package,再生成 code.host / code.client 或双向包;Client-only 产物可经 tui_plugin_save 落到 $MARTTY_HOME/plugins/<artifact-id>/plugin.json,含 code.host 的包则需打包后用 dsh plugin --profile martty add 安装。
- 需要在终端内完成长会话编码、带工具调用与 Plan 的开发者。
- 同时使用多个 ACP agent(如 DSH、Pi、Codex 类条目)并想在 TUI 内用 /harness 快速切换的人。
- 想为终端界面添加自定义面板、导航或 token 统计插件的 Cordis 插件作者。
- 希望 agent 在运行中生成、验证并保存新界面插件的研究或原型团队。
- 在 CI 或脚本中通过 martty harness CLI 统一发现与配置 ACP Harness 的自动化场景。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
npm install --global marttynpx --yes marttynpm install --global @deepseek-ai/dsh
- 运行环境
- Node.js 22.19+
如何安装或部署这个 Agent?
安装要求本机已有 Node.js(22.19+),通过 dsh 安装插件时可能需要 pnpm。
npm install --global martty
martty-cli # 首次启动创建 `martty` 命令,之后直接运行 `martty`不装全局时可直接运行:
npx --yes martty也可以让 DSH 以 profile 方式管理插件与升级:
npm install --global @deepseek-ai/dsh
dsh plugin --profile martty add martty@latest
dsh --profile martty从源码构建需要 Rust stable 与 Node.js 22.19+:
make rust-test
node --test scripts/package-native.test.mjs
bash scripts/build-npm.sh如何使用这个 Agent?
先浏览并配置要连接的 Harness,然后在工作目录启动 TUI:
martty harness find # 浏览 Registry 与本地候选
martty harness add <id> # 安装/保存配置
martty harness use <id> # 设置下次启动的默认 Harness
martty # 在当前工作目录启动 TUI只看界面可用演示模式:
martty --demo
martty --demo-skin连接其他 ACP agent 可在 standalone 模式指定启动命令,或在 TUI 内切换:
DSH_TUI_AGENT="<acp-command> [args...]" martty运行中常用入口为 /model、/agent、/harness [id]、/permission(shift+tab 轮换)、/theme 与 /theme toggle、/plugins、/cordis-plugins、/auth、/status。终端找不到 martty 时,可在仓库根目录用:
node npm/bin/martty.js harness --help这个 Agent 有哪些优点和局限?
- 内置 ACP 连接层,默认接 DSH,同时支持通过 DSH_TUI_AGENT、--agent 或 config.agent 连接其他 ACP agent。
- 界面由 Cordis Plugin 组合,开放 tuiSlots 六个插槽与 tui-node.v0 schema,插件可在运行中创建、观察、更新与回滚。
- martty harness find/add/use/remove 与 TUI 的 /harness 面板共享同一份 ACP Registry,支持 npx/uvx 与校验 SHA-256 的受管 binary 安装。
- 包不声明任何安装脚本,在 pnpm 严格 build-scripts 策略下也能直接安装。
- 自带旧包名 @openma/deepseek-harness-tui 的迁移路径,旧配置与会话数据首次启动时复制不删除。
- 默认体验绑定 DSH 与其 bundled runtime,非默认 Harness 需要自行改 agent/stream 配置。
- dsh 需 >=0.1.7-rc.2,低于下限或 host 缺能力时 ACP 插件不会挂载,需要切换到 npx martty 内置模式。
- 首次安装后只有 martty-cli,必须先运行一次才会生成 martty 命令,容易误解为安装失败。
- 含 code.host 的插件无法一键转常驻,需手工整理成 Cordis npm Package 再用 dsh plugin add 安装。
- 从源码构建依赖 Rust stable,且原生二进制按平台发布,使用 --omit=optional 时需重装可选依赖。
这个 Agent 与同类方案有什么区别?
README 明确定位为 DSH 的 TUI 客户端与插件,并说明可替换为其他兼容 ACP 的 agent;未对其他具体终端 agent 工具做功能对比,故不展开替代品比较。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Martty 当前 | 58 · 缺口较多 | — | ★ 83 | 3 天前 | Rust | — |
| dsh-TUI - DeepSeek Harness 终端界面插件 | 72 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 8k | 今天 | TypeScript | — |
| rpi:Rust 编码代理运行时 | 71 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 287 | 今天 | Rust | OpenAI API · Claude API |
| Zoetrope | 86 · 表现良好 | 命令行工具免费 | ★ 1.2k | 2 个月前 | Rust | Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
最小权限:插件被明确禁止接触 TTY、raw mode、kitty 转义与绝对坐标,只提交 TuiNode 语义树(AGENTS.md、README),但 npm 启动器仍会创建/删除全局 bin 链接并写入 $MARTTY_HOME,权限面不小,故扣至 2。用户确认:harness remove 有预览与确认、--dry-run、非交互需 --yes,会话已有提示时切换需确认,但 --api-key 作为命令行参数直接传入且无遮蔽说明,扣 1。数据流透明:README 说明 Registry 快照来源、下载进度走 stderr、安装输出被捕获,但未系统说明会话 JSONL、凭据存放位置与保留策略,扣 1。敏感数据处理:--api-key 明文入参、凭据仅笼统称“保留”,无加密或权限说明,仅 1。依赖安全:Cargo.toml 依赖版本较新且 CI 用 --locked,但无审计/漏洞扫描证据,二进制下载仅“提供时”校验 SHA-256,扣至 1。外部影响:下载、安装、PATH 不写入、Ctrl-C 清理暂存、失败保留旧默认,处理较完整,给 2。回滚:stop/update/rollback 生命周期、失败保留上一默认、卸载收敛到干净状态均有描述,给 2。来源归属:MIT 与 OpenMA 版权行清晰,但发布者身份未经注册表验证,且项目经历改名与包名迁移,归属链需读者自行拼接,扣至 1。
自一致性:README、AGENTS.md、agent-install.md 对安装路径、版本下限、profile 名的描述基本一致,但 Node 版本要求出现 ≥18 与 22.19+ 两种说法,属可见矛盾,扣 1。依赖可用性:engines.dsh 下限、bundled ACP 版本、平台可选依赖、npx/uvx 回退均有说明,给 2。失败信息:CLI 对未知参数、缺值、--dsh 误用给出明确报错,TUI 错误面板可重试,安装失败有排查表,给 2。
受众与场景:同时覆盖终端用户、AI agent 安装、插件开发者与 dsh 用户,场景清晰,给 2。能力边界:明确 ACP 客户端不导入 harness、插件不得触碰 TTY、Host/Client 分离、动态插件不持久化,边界写得具体,给 2。触发精度:SKILL.md 的触发依赖“先加载 cordis-plugin-development”这一外部技能,且大量依赖 inspect 运行时结果,静态下无法确认触发条件是否精确,扣至 1。环境适配:macOS/Linux/Windows、musl 静态、Windows loopback TCP、PATHEXT 均有覆盖,给 2。
信息架构:README 分中英、docs 目录、website 文档路由有测试,结构清楚,给 2。安装说明:三条安装路径加验证与排查表,质量突出,给 3。命名稳定性:项目与包名从 DeepSeek Harness TUI 迁到 Martty,命令从 dsh-tui 变为 martty-cli/martty,Cargo 包名仍为 deepseek-harness-tui,命名多处不一致,扣至 1。示例与 FAQ:有 demo、截图、dump-frame 冒烟与排查表,但无集中 FAQ,给 2。已知限制:README 与 agent-install 列出迁移注意事项、平台约束、无 clippy/fmt 门禁,给 2。许可证:MIT 全文与 Cargo/README 一致,给 3。版本与变更日志:三处版本需同步、CHANGELOG 采用 Keep-a-Changelog,但 CHANGELOG 本身未在样本中,扣至 2。维护责任:仅“OpenMA contributors”,无治理、联系方式或安全报告渠道,且发布者未验证,给 1。
输出可用性:TUI 输出、dump-frame 无 TTY 渲染、错误面板与重试路径使结果可直接使用,给 2。边际价值:在 ACP 客户端之上提供插件化 TUI 与自演化 Creator,相对通用终端 agent 有差异化,但价值主张依赖未展示的 Creator 闭环,扣至 2。成本收益:需 Node、pnpm、Rust 工具链与 dsh 生态,安装与迁移成本偏高,收益证据多为自述,给 1。
主张可追溯:README 的多数主张指向 docs 与脚本,但 Creator 自演化、性能等关键主张无对应证据文件,扣至 1。跨源印证:CI 工作流、AGENTS.md、agent-install.md 与 website 测试相互印证安装与发布流程,给 2。事实与推断分离:文档混用“已实现”与“长期方向”,如“Current boundary”与目标描述并列,读者需自行区分,扣至 1。
- 项目与包名经历 DeepSeek Harness TUI → Martty 迁移,命令从 dsh-tui 变为 martty-cli/martty,Cargo 包名仍为 deepseek-harness-tui;脚本与文档中混用旧名,自动化流程需按版本核对实际命令。
- Node 版本要求在不同文档中不一致(≥18 与 22.19+),部署前应以 npm/package.json 的 engines 为准。
- --api-key 以明文命令行参数传入,可能出现在 shell 历史与进程列表中;优先使用环境变量或凭据文件。
- 发布者未经 FollowAgents 注册表验证,且无安全报告渠道;安装前应自行核对 npm 包与仓库的对应关系。
- 二进制下载仅在“提供时”校验 SHA-256,未提供校验和的 Registry 条目缺少完整性保证。
- Creator 自演化与插件动态加载是核心卖点,但样本中缺少其实现与测试证据,不应据此推断能力已完备。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
发布说明摘录
Compatibility - Supported @deepseek-ai/dsh is now a floor, >=0.1.7-rc.2, declared as engines.dsh (read by dsh's plugin compatibility check); the exact-version dsh.supported list is gone. Newer dsh releases are attempted; a dsh newer than the newest tested (0.2.1-rc.2) only warns. - Bundles @openma/deepseek-harness-acp 0.4.39, which applies the same floor and feature-detects dsh 0.2.1's subagent teardown API. Added - martty --dsh <profile> (also npx martty --dsh <profile>) attaches to the …在 GitHub 查看 ↗ -
发布说明摘录
Compatibility - Bundles @openma/deepseek-harness-acp 0.4.38 (compatible range >=0.4.38 <0.5.0). - Supported @deepseek-ai/dsh: 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2. - Pi harness launches @openma/pi-acp@latest (0.1.8 at release time). Known issues - #168 ACP auth: choosing another method while an agent auth is pending does nothing; a typed key falls into the prompt queue. What's Changed * Bump @openma/deepseek-harness-acp to 0.4.36 by @hrhrng in https://github.com/openma-ai/Martty/pull/137 …在 GitHub 查看 ↗
常见问题
不装 DSH 能用吗?
Harness 切换会影响正在运行的会话吗?
动态插件重启后还在吗?
二进制 Harness 会写入系统 PATH 吗?
装过旧的 @openma/deepseek-harness-tui 怎么办?
Martty 官网是什么?
Martty 开源吗?
Martty 安全吗?
Martty 还在维护吗?
Martty 是谁开发的?
谢谢反馈,我们会据此改进页面。