Martty

面向 DSH 的 Agent 终端界面,支持 ACP 连接与运行中自进化插件。

Star 数
★ 83
最近更新
3 天前
License
MIT
主语言
Rust

30 秒速览

可在哪里用
兼容但需适配
开始前需要
Node.js 22.19+Rust stable(仅从源码构建时需要)pnpm(dsh 插件安装时可能需要)@deepseek-ai/dsh >=0.1.7-rc.2(可选的 profile 宿主)Shell / 命令行网络访问本地文件系统
典型场景
需要在终端内完成长会话编码、带工具调用与 Plan 的开发者。
主要局限
默认体验绑定 DSH 与其 bundled runtime,非默认 Harness 需要自行改 agent/stream 配置。
官网
martty.sh ↗ 来自 GitHub 仓库设置
维护状态
近 30 天有提交最近提交 2026-11-18最新版本 v0.3.3(2026-10-17)

这个 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 安装。

  1. 需要在终端内完成长会话编码、带工具调用与 Plan 的开发者。
  2. 同时使用多个 ACP agent(如 DSH、Pi、Codex 类条目)并想在 TUI 内用 /harness 快速切换的人。
  3. 想为终端界面添加自定义面板、导航或 token 统计插件的 Cordis 插件作者。
  4. 希望 agent 在运行中生成、验证并保存新界面插件的研究或原型团队。
  5. 在 CI 或脚本中通过 martty harness CLI 统一发现与配置 ACP Harness 的自动化场景。

安装与配置要点

摘自下方的安装和使用说明,以项目 README 的最新说明为准。

安装 / 启动命令
  • npm install --global martty
  • npx --yes martty
  • npm 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?

FollowAgents 源码审查 · FARS-2.1
缺口较多
58/ 100 五分制 2.9 / 5
信任安全 16/29
可靠稳定 9/14
适用触发 10/18
规范维护 12/18
有效结果 7/13
证据核验 4/8
查看各维度的扣分理由
信任安全16 / 29 · 2.8/5

最小权限:插件被明确禁止接触 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。

可靠稳定9 / 14 · 3.2/5

自一致性:README、AGENTS.md、agent-install.md 对安装路径、版本下限、profile 名的描述基本一致,但 Node 版本要求出现 ≥18 与 22.19+ 两种说法,属可见矛盾,扣 1。依赖可用性:engines.dsh 下限、bundled ACP 版本、平台可选依赖、npx/uvx 回退均有说明,给 2。失败信息:CLI 对未知参数、缺值、--dsh 误用给出明确报错,TUI 错误面板可重试,安装失败有排查表,给 2。

适用触发10 / 18 · 2.8/5

受众与场景:同时覆盖终端用户、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。

规范维护12 / 18 · 3.3/5

信息架构: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。

有效结果7 / 13 · 2.7/5

输出可用性:TUI 输出、dump-frame 无 TTY 渲染、错误面板与重试路径使结果可直接使用,给 2。边际价值:在 ACP 客户端之上提供插件化 TUI 与自演化 Creator,相对通用终端 agent 有差异化,但价值主张依赖未展示的 Creator 闭环,扣至 2。成本收益:需 Node、pnpm、Rust 工具链与 dsh 生态,安装与迁移成本偏高,收益证据多为自述,给 1。

证据核验4 / 8 · 2.5/5

主张可追溯: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 自演化与插件动态加载是核心卖点,但样本中缺少其实现与测试证据,不应据此推断能力已完备。
证据充分度:低 评估于 2026年11月11日 审查版本 b4dbfa05a049 评估后仓库已有新提交,评分可能未覆盖最新改动
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/martty.svg?lang=zh)](https://followagents.com/zh/agents/martty)
<a href="https://followagents.com/zh/agents/martty"><img src="https://followagents.com/badge/martty.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. v0.3.3
    发布说明摘录
    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 查看 ↗
  2. v0.3.2
    发布说明摘录
    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 查看 ↗
  3. v0.3.1

常见问题

不装 DSH 能用吗?
默认模式会使用内置的 @openma/deepseek-harness-acp 及 bundled dsh runtime,无需事先装全局 dsh;要用别的 ACP agent,可通过 DSH_TUI_AGENT、--agent/--agent-arg 或 config.agent 指定启动命令。
Harness 切换会影响正在运行的会话吗?
CLI 的 add/use 只写配置,切换在下一次 standalone 启动生效;TUI 内 /harness 会替换 standalone ACP 子进程,若当前会话已发过 prompt 或由 /session 恢复会先确认,原会话仍可从 /session 返回。切换只有 initialize 与 session/new 都成功才更新 defaultHarness。
动态插件重启后还在吗?
Cordis 模式创建的 Plugin 默认只属于当前进程。Client-only 插件可经 tui_plugin_save 保存到 $MARTTY_HOME/plugins 并在下次启动被发现;含 code.host 的包需打包后用 dsh plugin --profile martty add 安装,没有一键 promote 命令。
二进制 Harness 会写入系统 PATH 吗?
不会。Registry 的 binary 分发在选择后需确认,下载到 $MARTTY_HOME/bin/<id>/<version>/<platform> 并在校验 SHA-256 后才配置;harness remove --cleanup 只清理独占的私有安装目录,全局程序与共享 npx/uvx 缓存保留。
装过旧的 @openma/deepseek-harness-tui 怎么办?
直接 npm install --global martty 即可,首次运行会清理确属旧包的 martty/dsh-tui/dsb 链接并摘除旧包清单中的 bin 声明;profile 内则先 remove 旧包再 add martty@latest,旧配置与会话数据会复制而非删除。
Martty 官网是什么?
Martty 的 GitHub 仓库填写的官网是 https://martty.sh。这个链接由仓库作者设置;源码在 GitHub(openma-ai/Martty)。
Martty 开源吗?
开源。源码在 GitHub(openma-ai/Martty),许可证是 MIT。
Martty 安全吗?
FollowAgents 的 FARS 评审(2026年11月11日)给 Martty 的“信任与安全”打了 16/29 分。评审检查的 8 项安全措施没有完全缺失的。评审之后仓库已有更新。
Martty 还在维护吗?
在维护。GitHub 上最近一次提交是 2026-11-18,在最近 30 天内。最新版本是 v0.3.3(2026-10-17)。
Martty 是谁开发的?
Martty 由 GitHub 账号 openma-ai 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念