nolly-studio/eve-directory

# Eve 目录 使用 shadcn CLI 安装 Eve 代理，无需登录即可浏览所有文件，或者为开放目录贡献一个列表。 Eve 目录是一个开放的 [Eve](https://eve.dev) 代理和扩展注册中心，你可以逐个文件检查它们、将它们安装到项目中，或者组合成一个启动压缩包。在线网站是 [evedirectory.com](https://www.evedirectory.com)。本仓库是其背后的网站和精选目录。 ``` npx shadcn@latest registry add @evedirectory=https://www.evedirectory.com/r/{name}.json npx shadcn@latest add @evedirectory/pr-review-sentinel ``` 这会将一个完整的 Eve 应用（`package.json`、`agent/`、`evals/`）放入你的项目中。将 `pr-review-sentinel` 替换为 `/agents/` 中的任何 slug。 ## 选择如何将代理带走 CLI 安装适用于现有的 Eve 项目（或者在 `npx eve@latest init` 之后）。当你需要一个包含多个代理或扩展的启动压缩包时，请切换到 Composer。仅当你需要贡献目录内容或运行目录网站本身时，才克隆此仓库。 | 你需要 | 使用 | | --- | --- | | 项目中的一个代理 | `npx shadcn@latest add @evedirectory/` | | 多列表启动压缩包 | [Composer](https://www.evedirectory.com/composer) | | 更改目录或网站 | 克隆此仓库 | 指南：[使用 shadcn CLI 安装](https://www.evedirectory.com/docs/install-with-shadcn)，[组合与克隆](https://www.evedirectory.com/docs/compose-vs-clone)。 ## 目录是内容，而非应用代码 列表位于 `catalog/` 下。Next.js 应用通过 `lib/catalog/` 读取它们，并从 `public/r/` 提供安装 JSON。 ``` catalog/ ├── registry.json # Index of agents and extensions ├── agents// # Full Eve apps (agent/, evals/, SETUP.md, …) ├── extensions// # Extension listings ├── integrations.json # Official Eve integration index └── integrations-details.json # Scraped detail dump from eve.dev public/r/ # Built shadcn registry (served at /r/.json) ``` 从 `catalog/agents/` 下的嵌套 Eve 应用以及 `registry.json` 中的一项条目开始。在需要时添加其余的网站界面。 ### 添加精选代理 复制现有列表的布局，例如 `catalog/agents/approval-gate-starter/` 或 `catalog/agents/competitive-intel-scout/`。 1. 创建 `catalog/agents//` 作为嵌套的 Eve 应用（`package.json`、`agent/`、`evals/`、`SETUP.md`、`README.md`）。 2. 在 `catalog/registry.json` 中的 `agents` 下添加一条包含 `name`、`slug`、`path`、`summary`、`version`、`license`、`category` 和 `integrations` 的条目。 3. 在 agent 目录中，验证发现： ``` npm install npx eve info ``` Eve 会打印出它发现的代理结构。在继续之前修复警告。 4. 从仓库根目录，重新构建安装 JSON 并验证索引： ``` pnpm registry:build pnpm catalog:validate ``` `public/r/.json` 是 shadcn CLI 安装的内容。`catalog:validate` 会检查注册表与磁盘的一致性、必需的文件以及环境变量的规范性。 完整清单和扩展路径：[贡献](https://www.evedirectory.com/docs/contributing) 和 [CONTRIBUTING.md](./CONTRIBUTING.md)。 ## 本地运行网站 浏览和大多数目录路由无需身份验证即可运行。GitHub 登录、`/submit` 和社区代理需要 `.env.example` 中的变量。 ``` pnpm install cp .env.example .env.local pnpm dev ``` 在需要这些流程时填充 `.env.local`： - `DATABASE_URL`：Neon Postgres 连接字符串。 - `BETTER_AUTH_SECRET`：用于会话签名的随机密钥。 - `BETTER_AUTH_URL`：在开发环境中为 `http://localhost:3000`。 - `GITHUB_CLIENT_ID` / `GITHUB_CLIENT_SECRET`：带有回调地址 `http://localhost:3000/api/auth/callback/github` 的 GitHub OAuth 应用。 PostHog（`NEXT_PUBLIC_POSTHOG_*`）对于本地工作是可选的。没有它网站也可以运行。 ### 打开 PR 前的质量检查 ``` pnpm lint && pnpm typecheck && pnpm build ``` 更改目录后，还需要运行： ``` pnpm catalog:validate pnpm registry:build ``` 可选的深度检查（将代理暂存在仓库外部；请参阅 `AGENTS.md`）： ``` pnpm agents:check # compile + eve info per agent pnpm registry:smoke # install path into a scratch consumer ``` | 脚本 | 用途 | | --------------------------- | --------------------------------------- | | `pnpm dev` | Next.js 开发服务器 | | `pnpm build` / `pnpm start` | 生产环境构建 / 服务 | | `pnpm lint` / `pnpm format` | Ultracite 检查 / 修复 | | `pnpm typecheck` | Fumadocs MDX + TypeScript | | `pnpm catalog:validate` | 注册表 ↔ 磁盘一致性 | | `pnpm registry:build` | 从 `catalog/` 重新生成 `public/r/` | | `pnpm scrape:integrations` | 刷新抓取的 Eve 集成详情 | ## 面向编程代理的 Prompt ``` Clone https://github.com/nolly-studio/eve-directory.git, run pnpm install, and follow README.md plus CONTRIBUTING.md. Catalog content lives under catalog/ (not app UI). To add a curated agent: create catalog/agents// as a nested Eve app, register it in catalog/registry.json, run npm install && npx eve info inside the agent dir, then pnpm registry:build && pnpm catalog:validate from the repo root. Community prompt agents use https://www.evedirectory.com/submit after GitHub sign-in. Do not invent Eve framework APIs; read node_modules/eve/docs or https://eve.dev/docs/introduction. ``` ## 接下来阅读什么 - [CONTRIBUTING.md](./CONTRIBUTING.md)：PR 清单、精选与社区对比以及本地环境。 - [贡献](https://www.evedirectory.com/docs/contributing)：包含列表元数据规则的目录步骤。 - [安装之后](https://www.evedirectory.com/docs/after-you-install)：代理进入项目后的 `SETUP.md`、Connect UID 和评估。 - [注册表与机器访问](https://www.evedirectory.com/docs/registry-and-llms)：`/r/.json`、`llms.txt` 和 API。 - [AGENTS.md](./AGENTS.md)：编辑此仓库的编程代理的约定。 - [Eve 文档](https://eve.dev/docs/introduction)：框架 API、渠道和连接。 ## 许可证 [MIT](./LICENSE)。除非列表另有说明，网站和目录代理均为 MIT 许可证。

标签：AI智能体, SOC Prime, 包管理器, 开发工具, 开源目录, 统一API, 自动化攻击