AI 就绪

巴克励步
AI Ready 在 Baklib 中指:站点内容以 结构化 文档编辑器/Markdown 维护,并可通过平台提供的 LLM 可访问端点llms.txt、页面 .mdllms-full.txt 等)及 多格式响应(v1.37 页面 HTML/JSON/XML/Markdown)被外部大模型、爬虫或 RAG 管线读取。核心思想是 内容即 AI 资产——目录清晰、版本可控的知识库,同时服务人类阅读与机器消费。

是什么

能力 说明
结构化正文 Wiki 使用文档编辑器块级语法(标注框、分栏、链接卡片等),利于人机共读
LLM Markdown 访问 域名配置中开启后,自动生成 /llms.txt、页面 URL 追加 .md 得 Markdown 正文
llms-full.txt 整站或精选文档合并输出;大站可重定向到 /index.md
多格式响应 主题页面可按访问方式输出 HTML、JSON、XML 或 Markdown,便于 API 与 AI 抓取
llms.txt 定制 可通过站点首页自定义变量灵活控制 AI 索引输出内容
MCP / API / CLI 程序化读写组织内知识库、站点与 DAM,供 Agent 与自动化使用
robots.txt 面向搜索引擎爬虫;llms.txt 面向将站点交给模型阅读时的 导航索引。二者策略应一致:公开文档站放行,内网或涉密站关闭收录与 LLM 访问。

为什么需要

  • 避免为 AI 单独维护一份「影子文档」:Wiki 定稿即是对外与对模型的同一事实源。
  • 降低外部 Agent(ChatGPT、Claude、自研 RAG)接入成本:.md 端点比抓取复杂 HTML 更稳定。
  • 站内 AI 搜索 / Chat 共用内容底座;内容质量直接决定 AI 回答上限。
##
开启 LLM 端点 不等于 自动实现高质量 RAG。当前站内 AI 检索仍以 全文索引 + 大模型总结 为主;外部工具读取 .md 后如何分块、嵌入与溯源,由调用方架构决定。Baklib 提供的是 可读取、可索引的结构化输出,而非承诺逐句归因的完整 RAG 产品。

边界与限制

  • LLM Markdown 访问按 域名 开关;多域名站点需分别确认策略。
  • 访问控制下的私密内容 不应 开启对外 LLM 端点;与 访问控制与授权 和合规策略一致。
  • 主题 {% schema %} 中字段需设 "to_markdown": true 才会进入 .md 输出(模板相关细节见模板开发文档)。
  • 多格式响应 依赖主题与路由约定,并非所有历史页面默认可用四种格式。

与谁组合

  • 知识库 / 文档编辑器:内容生产;块级结构影响 .md 可读性。
  • 域名管理 · SEO 设置:收录开关、robots.txt、LLM Markdown 访问总开关。
  • 站点 AI 智能搜索 / Chat:同一知识源的不同消费方式(站内 vs 站外 Agent)。
  • MCP 开放集成:IDE 内直连线上数据,与静态 .md 抓取互补。
  • SEO / GEO 策略:公开站可见性与 AI 可见性一并规划,见最佳实践专章。

相关操作