Ephemeral-AI-Lab/dsh-plugins

🧩 Mayfly / DSH 插件市场

Mayfly 和
DeepSeek Harness (dsh) 的官方插件市场：
Ephemeral AI Lab 自有的插件（源码就在本仓库中）、精选的 dsh 可选插件，
以及社区提交的插件。

这里包含两部分内容：

1. plugins/ —— Ephemeral AI Lab 官方插件的源码。
2. registry/ —— 插件市场：每个条目对应一个 JSON 清单。CI
会将它们聚合为 dist/index.json，即
Mayfly 的 /plugin 命令和网站目录所消费的文档。

⚡ 安装插件

在 Mayfly（TUI）中：

/plugin                 # 浏览、搜索、查看、安装、移除
/plugin install     # 例如 /plugin install loop

或直接使用 dsh CLI（适用于任何 profile）：

npm 源
dsh plugin --profile mayfly add @deepseek-ai/dsh-terminal-bash @deepseek-ai/dsh-tool-terminal

GitHub 源（支持 monorepo 子目录；建议固定 ref）
dsh plugin --profile mayfly add 'github:Ephemeral-AI-Lab/dsh-plugins#main&path:plugins/loop'

安装后请重启 profile 并开启新会话。带有
activation: profile-patch 的条目还需要在 profile 的
cordis.patch.yml 中添加对应的行——/plugin 命令会为你完成这一步；手动操作方式请参见
docs/market.md。

📦 当前条目

| id | 来源 | 界面 | 功能 |
| --- | --- | --- | --- |
| codex-terminal | 官方 | server | Codex 风格的持久化 shell：exec_command / write_stdin |
| loop | 官方 | server · web | 周期性提示与闹钟：loop_* 工具、/loop、Web 面板 |
| mock | 官方 | server · web | 确定性的模拟模型回合：/mock run / replay（不稳定） |
| sessions | 官方 | server | 多会话编排：session_status/create/send 工具 |
| coding-plan | 官方 | server | 将 codex login / grok login 订阅复用为 provider |
| preset-builder | 官方 | web | dsh Web 设置中的预设详情页 |
| workbench-ui | 官方 | web | 其他面板所停靠的 Web 工作台框架 |
| sidechat | 官方 | server · web | Web 工作台上的侧边聊天面板（需要 workbench-ui） |
| terminal | dsh | server | PTY 终端：terminal_open/send/read/signal/close/list |
| lsp | dsh | server | 只读 lsp 导航工具 |
| mcp | dsh | server | MCP 客户端：mcp__server__tool 外部工具 |
| acp | dsh | server | Agent Client Protocol 服务器 |
| code-runtime-ts | dsh | server | run_code TypeScript 工作线程运行时 |
| code-runtime-py | dsh | server | run_code Python 运行时 |

server 插件可在任何前端中工作（工具以通用方式渲染）；web 添加
dsh Web 客户端模块；tui 添加 Mayfly 原生 UI。如果插件具有 server
或该前端自身的贡献，则它在给定前端中可用。

📥 提交插件

已发布 npm 包（或带有已提交构建产物的 GitHub 仓库）？
提交一个列表项：

1. 阅读 registry/community/README.md。
2. 将 registry/submission-template.json
复制到 registry/community/.json 并打开一个 PR。
3. CI 会对每个声明的源进行临时安装；维护者会对照
审查清单进行审查。

清单规范见 docs/market.md —— 清单
仅用于发现/安装元数据；运行时契约仍然是你的
包及其 cordis.patch.yml。

🛠️ 仓库脚本

node scripts/validate-manifests.mjs   # schema + semantics, zero deps
node scripts/verify-packages.mjs      # npm tarball + GitHub scratch-install checks
node scripts/build-index.mjs          # rebuild dist/index.json + dist/catalog.json

dist/ 是生成的 —— 变更通过 index-publish 工作流的
自动合并 PR 落地，绝不手动修改。

🛠️ 插件开发

plugins/ 下的每个插件都是一个可独立安装的包：

cd plugins/loop
pnpm install
pnpm test
pnpm build

源码树有意保持在 DeepSeek Harness 仓库之外；
dsh 通过按配置文件范围的安装和补丁层来组合插件。
有关代理工作规则，请参见 AGENTS.md，
有关架构说明和操作指南，请参见 docs/。

📚 文档

- 市场与清单规范
- 插件文档 —— 每个插件目录都有自己的 README
- 架构与操作指南
- Mayfly · Mayfly 网站

🤝 贡献

欢迎提出问题、想法和拉取请求。保持插件专注，记录
其运行时契约，并为工具、持久化
或 UI 行为的变更包含测试。

📄 许可证

根据 MIT 许可证发布。