SuperAPI AI 工具集

bx-sites-ai-features

通用与其它

查看项目

更新于 10-16 10:22

技能介绍

用途:本技能包包含两个相互独立的 AI 面向功能。一是把已发布站点的内容暴露给 AI 智能体(mcp);二是安装该技能包,让 AI 编程助手预先了解 bx-sites 自身的约定。

MCP 服务器(mcp: true):在 bxsites.yaml 中设置 mcp: true 后,每次构建都会在渲染页面之外写出三个文件,bxSites Cloud 读取它们为已发布站点提供公开、只读的 MCP 服务器,使 Claude、ChatGPT 等支持 MCP 的客户端可直接搜索、浏览、检索内容,而无需抓取渲染后的 HTML。仅用 bxSites build 生成这些文件是免费的;真正通过网络作为实时 MCP 服务器提供服务需要付费的 bxSites Cloud 方案。默认值 false 会跳过整个步骤,不产生额外费用,也不写出任何文件。该开关与 search/searchProvider 无关:mcp 不影响面向访客的搜索框,关闭搜索也不会禁用 mcp-index.json。它也无法复用 search-index.json,因为后者仅用于 local 提供方且被刻意截断(每条 400 字符,发送到每个访客浏览器),而 mcp-index.json 由 bxSites Cloud 在服务端获取,保留完整未截断的页面正文。

三个文件:site/mcp-index.json,每个非隐藏页面/文章一条记录,含 title、url、tags、headings(按顺序的全部 h1-h6)、body(完整纯文本,去除 HTML,永不截断)、type(page/post)、categories(仅文章,页面为 [])、updatedAt(ISO-8601,不可用时为 "")。site/mcp-manifest.json,每次构建一份(仅站点根),记录每个拥有独立索引/导航的树(path、label、version、locale、default)。site/mcp-nav.json,每个树一份(main、/next/、各 /versions/<name>/、各语言子树),即该树自身的导航,形状与主题侧边栏渲染所用的嵌套 { title, url, order, icon, children } 相同;没有自身 index.md 的分组标题 url 为空。

安装技能包:ortus-boxlang/bx-sites-skills 是官方技能包,每个技能都是单个自包含的 SKILL.md,适用于任何支持 Agent Skills 格式的助手(Claude Code、Cursor、Codex 等)。可用 npx skills add ortus-boxlang/bx-sites-skills(整包)、npx -y skills add ortus-boxlang/bx-sites-skills -y(非交互,适合 CI/脚本)、npx skills add ortus-boxlang/bx-sites-skills/skills/bx-sites-deployment(单个技能);ColdBox CLI 用 coldbox ai skills install ortus-boxlang/bx-sites-skills/bx-sites-deployment;bx-sites 自带包装器用 bxSites skills install 或 bxSites skills:install --skill=bx-sites-deployment。需 PATH 中有 Node.js/npx。验证安装:查看助手技能目录下新增的 SKILL.md(如 Claude Code 的 .claude/skills/bx-sites-getting-started/SKILL.md),或就技能覆盖的问题提问并核对答案。