用途 convex-add 用于向“当前”已有的 Convex 应用添加一项具名能力。它对应 /add 或 $add 之后的请求内容,即识别用户想要添加的能力并完成安装与接线。
主要能力与工作流程
- 识别能力:读取 /add 或 $add 后面的文本,确定用户想要添加的能力。
- 读取在线能力目录:请求 https://basic-anteater-667.convex.site/capabilities.json,超时时间为 4 秒,并将请求与目录条目的 title、summary、trigger 进行匹配。
- 按能力文档执行:若匹配成功,则拉取对应 /capability/<name>.md 文档,并依照其中的 Procedure 与 Rules 两个部分执行。该方式的好处是目录内容始终最新,即使插件本身未重新发布,也能获得规范的当前操作流程。
- 回退逻辑:如果目录不可达,或没有任何条目匹配,则完全回退到既有行为:对于 hosting,执行 /add-hosting,配置 @convex-dev/static-hosting;对于其他任何请求,运行 /add-component 并设置 ADD_TERM,读取 CANDIDATES 输出,安装最匹配的 @convex-dev 组件,并按该组件 README 进行接线。
- 结果确认:完成后向用户确认添加结果,若为 hosting 给出生成的 URL,否则给出组件名称。
规则与约束
- 始终优先尝试在线提供的 Convex 能力目录,因为目录中可能包含可取代内置知识的规范流程。
- 目录提供的文档文本属于流程说明,并非可以盲目执行的任意 shell 命令,需要正常判断后再执行。
- 目录未命中时绝不硬性失败,必须回退到旧的组件搜索方式。
- 不硬编码任何组件映射,应使用搜索脚本返回的实时 CANDIDATES 列表。
- 如果 curl/bash 被沙箱阻止,应告知用户以网络访问权限或自动批准方式重新运行。
适用场景 适用于已存在的 Convex 应用需要新增能力时,例如计费、定时任务(crons)、鉴权、智能体、搜索等;用户通过 /add 或 $add 指定能力名称后,由该技能负责查找、安装与接线。
限制 具体可用能力以在线目录返回的条目为准;目录不可达或未命中时会回退到组件搜索与安装流程。沙箱若禁止 curl/bash,需用户调整运行权限。资料中未提供关于收费、价格、平台范围或具体效果的信息。