Ephemeral-AI-Lab/mayfly
Mayfly terminal UI bundle for DeepSeek Harness
Project Overview项目介绍
Mayfly is an interactive terminal UI built specifically for DeepSeek Harness (dsh), packaged as an out-of-tree Cordis bundle over dsh-base and pinned to Harness 0.2.0-rc.2. It deliberately reuses dsh Web's plugin model: plugins register as ordinary Cordis siblings and consume native dsh services such as commands, sessionProjections, and tools directly through their Cordis context, while UI contributions route through the four Mayfly-specific services mayflyPanes, mayflyStatus, mayflyOverlays, and mayflyEditorExtensions. There is no Mayfly-only manifest, capability negotiation, adapter facade, private plugin realm, or separate plugin-author CLI; external plugins and Mayfly's own rows register identically.
The renderer is terminal-native, supporting Markdown tables, closed Mermaid fences inside assistant messages, and renderer-neutral nodes for lines, points, bars, sparklines, and heatmaps with width-safe source or text fallbacks. A single activity row above the editor consolidates live status — spinner, current step such as Thinking or Running commands, turn-elapsed time, estimated token count, and output rate — while the transcript records only settled events: streaming reasoning collapses to a captionless ✻ tail that resolves to one ✻ Thought for 6s row, and file edits surface as diff cards next to the final answer. Side conversations via /btw <question> and the /agents subagent tree render in the same transcript pane; F7 returns to the previous conversation and F8 closes the displayed one, and interrupting the selected conversation interrupts every running continuable descendant without closing those Agents.
Installation runs via npm i -g @ephemeral-ai/mayfly followed by dsh --profile mayfly, or by installing the dependency-free standalone launcher @ephemeral-ai/mayfly-cli and invoking mayfly; users must set DEEPSEEK_API_KEY before first run. The runtime requires Node ^22.19 or >=24 and pnpm 11, while the public npm surface is intentionally limited to three packages — @ephemeral-ai/mayfly-ui (renderer-neutral contracts and registries), @ephemeral-ai/mayfly (runtime areas, composition, and presets), and @ephemeral-ai/mayfly-cli (global launcher) — with frontend, conversation, app, core, transcript, and interaction kept as internal Cordis rows inside @ephemeral-ai/mayfly. Plugins still own their own database and network fetching; token-rate heuristics use four characters per token, exclude first-chunk latency, and disappear after two seconds of output silence, with narrow terminals omitting tips and rates first. The project is MIT-licensed and community support is centered on a Feishu group whose invite links expire weekly.
Mayfly 是面向 DeepSeek Harness(dsh)的交互式终端 UI,以 out-of-tree Cordis bundle 形式构建于 dsh-base 之上,绑定 Harness 0.2.0-rc.2。它复用 dsh Web 的插件模型:插件作为普通 Cordis 兄弟节点,直接消费 commands、sessionProjections、tools 等原生 dsh 服务,UI 贡献走 mayflyPanes、mayflyStatus、mayflyOverlays、mayflyEditorExtensions。终端渲染支持 Markdown 表格、闭合的 Mermaid 栅栏以及行、点、柱、火花线、热力图等渲染中立的节点,并在宽度受限时回退到源码或文本。
编辑器上方单设一行活动状态栏,集中呈现 spinner、当前步骤(如 Thinking、Running commands)、回合耗时与估算 token 数、输出速率;正文流只记录已发生事件。/btw <question> 发起临时侧边 Agent,/agents 浏览子代理树,F7 返回上一会话、F8 关闭当前会话;打断选中会话会一并中断其所有 continuable 后代。安装方式为 npm i -g @ephemeral-ai/mayfly 后执行 dsh --profile mayfly,或直接安装独立启动器 @ephemeral-ai/mayfly-cli 运行 mayfly,首次启动需设置 DEEPSEEK_API_KEY。
依赖方面,运行时要求 Node ^22.19 或 >=24、pnpm 11,公开发布面仅三个 npm 包:@ephemeral-ai/mayfly-ui(渲染中立契约)、@ephemeral-ai/mayfly(运行时区域与预设)、@ephemeral-ai/mayfly-cli(无依赖全局启动器),其余前端、会话、核心等均为包内 Cordis 行。插件无需自写 manifest 或适配层,仍负责数据库与网络拉取;速率按四字符/token 计算、排除首块延迟、空闲两秒后消失,窄终端优先省略提示与速率。项目以 MIT 开源,社区答疑走飞书官方群。
请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】,检查通过再动手。
插件:mayfly(Ephemeral-AI-Lab/mayfly)
仓库:https://github.com/Ephemeral-AI-Lab/mayfly
本站详情页:https://www.yhbd.top/plugins/ephemeral-ai-lab-mayfly/
本站登记:类型 bundle · 归类 原生 DSH 插件 · 许可证 MIT · ⭐ 20 · 最近提交 2026-10-02 · 主语言 TypeScript · 未检测到 DSH 插件清单
按下面顺序执行,每步先把结论告诉我,再进入下一步:
【1 兼容性检查】
① 我这边:DSH 版本、Node 版本、操作系统、当前 profile(web / desktop)。
② 读它的 README、package.json、插件 manifest,列出它要求的 DSH 版本 / Node 版本 / 操作系统 / 外部依赖 / 需要另外先装的运行时。
③ 逐条比对,结论只写「满足 / 不满足 / 未知」三种;不满足的给出可行替代方案。
④ 检查是否和我已装的插件冲突:命令名重复、skill / tool 重名、端口占用、重复注册的 MCP server。
【2 安全性检查】
① 仓库可信度:和上面「本站登记」是否一致;star / fork 数、创建时间、最近提交,是否归档或长期停更。
② 安装脚本:逐行看 package.json 的 preinstall / install / postinstall,以及 install.sh、setup.ps1 之类脚本。出现 curl|bash、下载后直接执行、混淆代码、访问与插件功能无关的域名,立刻停下来告诉我,不要继续装。
③ 依赖:列出新增依赖,标出无人维护、或与知名包拼写近似的可疑包(typosquatting)。
④ 权限与副作用:它会读写哪些目录、访问哪些域名、需要哪些 DSH 权限(filesystem / network / shell / clipboard 等),以及怎么卸载和回滚。
⑤ 如果它要求 sudo / 管理员权限,或权限明显超出功能所需,先停下来问我。
【3 安装】
上面两步没有「不满足」和「高危项」时才执行;用官方推荐方式安装,不要自行提权。
【4 汇报】
用表格输出:检查项 / 结论 / 依据 / 是否需要我决策。拿不准的一律写「未知」并说明要我怎么确认——不要猜,也不要替我决定。
Send this message to DSH in your current session: it verifies compatibility and security first (answering met / not met / unknown item by item) and only installs once everything checks out — it will stop and ask you if it finds a high-risk item. The box scrolls; the copy is the full prompt. CLI install commands may not be accurate across systems, so DSH is the safer route.把上面这条消息直接发给当前会话里的 DSH:它会先核对兼容性与安全性(逐条给「满足 / 不满足 / 未知」),确认没问题再安装,有高危项会停下来问你。框内可滚动,复制到的是完整提示词;安装命令不一定准确,发给 DSH 更稳。
- 20 stars - an early-stage project星标 20,属于早期项目
- No DSH plugin manifest detected - it may only carry the dsh-plugin topic, so the install method must be confirmed on the spot未检测到 DSH 插件清单:可能只是打了 dsh-plugin 话题,安装方式要现场确认
DSH walks through these 9 checksDSH 会逐条核对这 9 项
Compatibility兼容性
- DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
- External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
- Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册
Security安全性
- Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
- Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
- curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
- Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
- Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
- Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式
Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。
Or use CLI install (for developers)或使用命令行安装(适合开发者)
CLI Install命令行安装
dsh plugin --profile mayfly add @ephemeral-ai/mayfly
把 Ephemeral-AI-Lab/mayfly 加入你的 DSH 配置(web profile)即可启用。
READMEREADME
Mayfly
English | 中文
Mayfly is an interactive terminal UI for
DeepSeek Harness (dsh) —
an out-of-tree Cordis bundle over dsh-base, built against Harness
0.2.0-rc.2. Mayfly 0.1.3-rc.2 deliberately uses the same plugin model
as dsh Web: plugins are ordinary Cordis siblings and consume native dsh
services directly.
- Terminal-native rendering: Markdown tables, closed Mermaid fences in assistant messages, and renderer-neutral line, point, bar, sparkline, and heatmap nodes — with width-safe source or text fallbacks.
- One activity row for live status: the spinner, current step, turn elapsed time, estimated token count, and output rate live above the editor; the transcript records only what has happened.
- Side conversations:
/btwand the/agentssubagent tree share the transcript pane;F7returns to the previous conversation andF8closes the displayed one. - An ordinary plugin model: consume
ctx.commands,ctx.sessionProjections,ctx.tools, and other documented dsh services directly; UI contributions go throughmayflyPanes,mayflyStatus,mayflyOverlays, andmayflyEditorExtensions.
Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →
esengine/DeepSeek-Reasonix
strukto-ai/mirage
chuspeeism/dashi-taskboard
Aisland-SJL/dsh-worktable
ccch1mneyyy/working-activity
zhoushoujianwork/easyeda-agent
pulseaiclub/phi
Ikalus1988/MisakaNet