SuperAPI AI 工具集

nlb-submit

部署与运维

查看项目

更新于 10-26 19:36

技能介绍

NLB Submit(nlb-submit)是一个自治式 AgentSkill,用途是把代码仓库整理成结构化产品文档并提交到 Next Level Builders Directory(主站 https://nextlevelbuilder.io,另有 staging 环境 https://staging.nextlevelbuilder.io)。工具包来自 nextlevelbuilder/nlb-directory-toolkits。

主要能力围绕一条工作流展开:扫描仓库、选择模板、填写 product.json、校验并计算哈希、终端预览、提交并激活。

扫描仓库阶段会分析当前代码库提取元数据,包括从 package.json、Cargo.toml、pyproject.toml 或文件夹名得出项目名与 slug;从 README.md 标题或 package.json description 获取标语与描述;检查依赖、框架配置(next.config、vite.config、drizzle.config)与运行时判断技术栈;用 git remote get-url origin 获取仓库地址;从 package.json homepage 或生产地址获取网站 URL;在 docs/、public/、screenshots/ 中查找截图等视觉素材。

模板方面提供 5 种预配置布局:dev-tool 适合 CLI、终端工具与开发者包,包含 hero、techStack、grid、changelog、cta;ai-agent 适合 AI 代理、LLM、MCP 服务器,包含 hero、mediaGallery、grid、milestones、cta;saas-launch 适合商业应用、Web 平台与微 SaaS,包含 hero、mediaGallery、grid、techStack、faq、cta;community-curated 适合社区、学习中心与精选目录,包含 hero、founder、grid、cta;minimalist 适合单屏作品集与聚焦型工具,包含 hero、mediaGallery、cta。可用 npx @nextlevelbuilder/cli template dev-tool --out product.json 生成起始模板。

product.json 的区块规范来自 @nextlevelbuilder/contracts,每个区块都需要 id 与 props。17 种区块包括:hero(标题、副标题、主 CTA、徽章)、carousel(多页展示)、mediaGallery(多图画廊,含宽高比与说明)、quote(推荐语、作者、头衔、头像)、grid(1–3 列功能卡片)、changelog(版本历史)、roadmap(计划中、进行中、已完成里程碑)、pricing(分层功能列表、价格与 CTA 链接)、faq(折叠问答)、techStack(分类技术徽章与图标)、liveDemo(iframe 嵌入沙箱,含高度与 sandboxTokens)、cta(行动号召横幅)、founder(创始人简介、头像与社交链接)、verification(加密或域名来源验证)、milestones(关键成果时间线)、caseStudy(客户故事,含问题、方案与结果指标)、analytics(NLB 托管产品页的真实流量,props 为 title 与 period,period 可取 7d、30d、90d,默认 30d;发布该区块即同意公开聚合总数与每日序列,不应编造数值或设置产品 ID)。所有者可用 nlb traffic <slug> --json 或 MCP 的 get_product_traffic 查询详细流量,二者使用现有 API 凭据;可选的 from/to 为 UTC ISO 时间戳,选择不超过 90 天且不晚于当前时刻的递增范围,默认最近 30 天;访客数按每日会话统计,标识符每个 UTC 日重置,因此次日再次访问会重复计数;即使发布 Analytics 区块,来源、国家与设备信息仍仅限组织授权可见。

校验阶段可执行 npx @nextlevelbuilder/cli validate product.json,或调用 MCP 工具 validate_listing(document={ ... }),进行 schema 校验并计算确定性的 SHA-256 哈希。预览阶段用 npx @nextlevelbuilder/cli preview product.json 在 stdout 渲染 ASCII/Unicode 盒式预览。

提交阶段把修订放入审核队列,需从 https://nextlevelbuilder.io/studio 获取组织 UUID:npx @nextlevelbuilder/cli submit product.json --org <ORG_UUID> --api-key <YOUR_KEY>;staging 环境加 --url https://staging.nextlevelbuilder.io;可用 --dry-run 模拟。若组织尚无有效的目录发布位资格,响应会返回 Polar 结账会话 URL,资料中的示例提示为 24.50 美元的早鸟位,完成结账后需再次运行提交命令以进入审核队列。另外可用 npx @nextlevelbuilder/cli get <your-product-slug> --markdown 导出面向 AI 优化的 Markdown。

安全与真实性约束包括:确定性哈希按字母顺序排序所有键并计算一致的规范 SHA-256 摘要;提交内容以 contentHash 进行加密锚定;通过 orgId 严格校验组织所有权以防 IDOR;不得提交或记录 API 密钥,应使用 NLB_API_KEY 环境变量或 --api-key 参数。资料未提供其他平台支持、价格变动、处理时延或审核结果的细节。