插件市场 Ephemeral-AI-Lab/dsh-plugins

🧩 Mayfly / DSH 插件市场

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

这里有两样东西：

1. plugins/ —— Ephemeral AI Lab 官方插件的源码。
2. registry/ —— 市场本体：每个条目一份 JSON manifest。CI 会把它们汇总成 dist/index.json，也就是 Mayfly 的 /plugin 命令和官网目录所读取的文档。

⚡ 安装插件

在 Mayfly（TUI）里：

/plugin # browse, search, inspect, install, remove
/plugin install <id> # e.g. /plugin install loop

或者直接用 dsh 命令行（任何配置档都能用）：

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

GitHub source (monorepo subdirectories work; pinned refs preferred)
dsh plugin --profile mayfly add 'github:Ephemeral-AI-Lab/dsh-plugins#main&path:plugins/loop'

安装后重启配置档，再开一个新会话。activation: profile-patch 的条目还需要在配置档的 cordis.patch.yml 里补上对应行——/plugin 命令会帮你做这件事；手动做法见 docs/market.md。

📦 当前条目

| id | source | surfaces | what it adds |
| codex-terminal | official | server | Codex 风格常驻 shell：exec_command / write_stdin |
| loop | official | server · web | 定时提示词与闹钟：loop_* 工具、/loop、Web 面板 |
| mock | official | server · web | 确定性的 mock 模型回合：/mock run / replay（不稳定） |
| sessions | official | server | 多会话编排：session_status/create/send 工具 |
| coding-plan | official | server | 把 codex login / grok login 订阅当作服务商复用 |
| preset-builder | official | web | dsh Web Settings 里的预设详情页 |
| workbench-ui | official | web | Web 工作台框架，其他面板都嵌在里面 |
| sidechat | official | server · web | Web 工作台上的侧边聊天面板（依赖 workbench-ui） |
| herdr-agent-state | official | server | 把 pane 智能体状态、会话引用以及标题/模型/ctx 元数据上报到 Herdr 的 pane socket |
| 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 worker-thread 运行时 |
| 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/<slug>.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 网站

🤝 参与贡献

欢迎提 issue、想法和 pull request。插件要保持聚焦，写清运行时契约，改动工具、持久化或 UI 行为时要带上测试。

📄 许可证

基于 MIT 许可证 发布。