关于 eve-compat
eve-compat 是将 eve-layout 项目编译并部署为 Zavu Agent 的技能，面向希望在 Zavu 上运行 eve 项目的开发者。它映射指令、模型和工具，同时生成兼容性提示，指出不会在 Zavu 上运行的功能。
主要功能
- 01从 GitHub 导入并部署项目
- 02部署本地 eve 项目
- 03映射指令、模型与工具
- 04将输入 schema 转为 JSON Schema
- 05生成兼容性报告与警告
适用场景
- 01把 GitHub 上的 eve 项目部署到 Zavu
- 02在 Zavu 部署本地 eve 项目
- 03检查工具和 schema 的映射结果
- 04识别需改用 eve 运行时的项目功能
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/eve-compat确认已加载。
详细介绍
在 Zavu 上部署 eve 项目
Zavu 会将 eve-layout 项目编译为一等 Zavu Agent。用户的文件不会被编辑：agent/instructions.md 会成为系统提示词，每个 agent/tools/<name>.ts 都会成为名为 <name> 的工具，Zod inputSchema 对象会自动转换为 JSON Schema。
命令
# Import from GitHub and deploy in one step (also works for Zavu-native repos):
npx zavudev import owner/repo --sender sndr_123
npx zavudev import owner/repo#branch --root apps/agent # monorepo / branch
# Private repos: set GITHUB_TOKEN in the environment (sent only to GitHub).
# Deploy a local eve project (detected by agent/instructions.md):
cd my-eve-agent && npx zavudev deploy --sender sndr_123
发送方可以通过 --sender 指定（在编译时内联），也可以使用 SENDER_ID 函数密钥（npx zavudev fn secrets set SENDER_ID sndr_123）。如果两者都未设置，Agent 仍会部署，但在控制面板中关联发送方之前会保持未连接状态。
映射关系
| eve | Zavu |
|---|---|
agent/instructions.md | 系统提示词（必需） |
agent/agent.ts 字符串 model | Agent 模型；非字符串配置（provider 实例、defineDynamic）会回退到默认值并发出警告 |
agent/tools/*.ts（默认导出 defineTool） | 工具，名称取自文件名主体 |
Zod / JSON Schema inputSchema | JSON Schema parameters |
package.json 依赖项 | 在服务端安装；eve 包本身会在编译时移除 |
在 Zavu 上无法运行的内容（务必告知用户）
部署时会输出兼容性报告；以下内容会触发明确警告：
agent/channels/— 不需要：Zavu 发送方就是渠道。agent/schedules/— Zavu Functions 暂不支持 cron。agent/skills/— 运行时不会加载；请将内容合并到instructions.md或知识库中。agent/subagents/、agent/sandbox/、agent/connections/、evals/— 不受支持。依赖这些内容的 Agent 应运行在 eve 自己的运行时上。- 工具的
approval门控和toModelOutput— 会针对每个工具忽略，并发出警告。 agent.ts选项reasoning、compaction、limits、modelOptions、outputSchema— 会被忽略并发出警告。
工具会在所有渠道运行 — 纯文本（SMS/WhatsApp/Telegram）、语音以及 flow tool 步骤 — 每次回复最多运行 5 轮工具调用。唯一的例外是
agents test：试运行不会执行工具（否则会触发真实的 Webhook），并会在警告中说明这一点。
要求与故障排查
- 编译 eve 布局需要项目中可解析的
esbuild（npm install -D esbuild）。npx zavudev import会自动添加并安装它；只有--no-install会跳过此操作。 inputSchema必须是对象架构 —z.object({...})或type: "object"的 JSON Schema。特殊的 Zod 类型会回退到宽松架构，并在构建日志中发出警告。- 部署后：运行
npx zavudev agents list获取 Agent ID，然后运行npx zavudev agents test <agentId> --message "hi"进行试运行；该操作不会发送任何内容，也不会产生费用。 - 修改后运行
npx zavudev deploy重新部署 — 对账摘要（+/~/=/-）是判断更改内容的依据。
评论
支持 Markdown