@page.su/ai-blog-cli 0.1.0-beta.4 → 0.1.0-beta.5

package/dist/tools/syntax-capabilities.js

@@ -1,859 +0,0 @@
-import { toolReplyHelpers } from "./posts.js";
-/**
- * 语法能力描述工具：post.describe_syntax_capabilities
- *
- * 设计目的：
- *  - 让 Agent 在一次调用中获取 ai-blog 全部 12 类高级 Markdown 语法的精确描述
- *  - 包含每种语法的：功能说明、精确格式、参数约束、完整示例
- *  - Agent 读完此输出即可正确生成任意高级 Markdown 内容，无需再逐个读取 resource
- *
- * 与 syntax-spec resource 的关系：
- *  - resource 是按章节拆分的详细规范文档（需逐个读取，适合深入查阅）
- *  - 本 tool 是一份"一次获取全景"的结构化速查表（适合 Agent 快速上手）
- */
-export function registerSyntaxCapabilitiesTools(server) {
-    server.registerTool("post.describe_syntax_capabilities", {
-        title: "Describe all advanced Markdown syntax capabilities",
-        description: "返回 ai-blog 支持的全部 14 类高级 Markdown 语法的完整结构化描述。" +
-            "包含每种语法的功能定义、精确格式模板、参数约束、完整示例。" +
-            "Agent 应在首次写文章前调用一次，即可掌握所有非标准语法的正确写法。",
-        inputSchema: {},
-    }, async () => {
-        const capabilities = buildSyntaxCapabilitiesDocument();
-        return toolReplyHelpers.toToolText(capabilities);
-    });
-}
-/**
- * 构建完整的语法能力描述文档。
- *
- * 每条能力包含：
- *  - id: 唯一标识符
- *  - name: 人类可读名称
- *  - summary: 一句话功能描述
- *  - syntax: 精确的语法模板（可直接套用）
- *  - parameters: 参数/属性的详细说明（含类型、约束、默认值）
- *  - example: 完整可用的示例代码
- *  - notes: 使用注意事项和边界条件
- */
-function buildSyntaxCapabilitiesDocument() {
-    return {
-        version: "1.0.0",
-        totalCapabilities: 14,
-        capabilities: [
-            buildFrontmatterCapability(),
-            buildCalloutCapability(),
-            buildMermaidCapability(),
-            buildLiveDemoCapability(),
-            buildMathCapability(),
-            buildImageAttributesCapability(),
-            buildImageGalleryCapability(),
-            buildImageWhitelistCapability(),
-            buildUrlWhitelistCapability(),
-            buildReferenceCapability(),
-            buildFootnoteCapability(),
-            buildSitePostReferenceCapability(),
-            buildCodeGroupCapability(),
-            buildDetailsCapability(),
-            buildTimelineCapability(),
-        ],
-    };
-}
-// ─── 各能力构造函数 ──────────────────────────────────────────────────────────
-function buildFrontmatterCapability() {
-    return {
-        id: "frontmatter",
-        name: "Frontmatter（YAML 元数据）",
-        summary: "文章顶部的 YAML 块，定义标题、状态、标签等元信息。必须位于文件最开头。",
-        syntax: [
-            "---",
-            "title: \"文章标题\"",
-            "slug: my-post-slug",
-            "excerpt: \"文章摘要，最长400字符\"",
-            "status: draft",
-            "publishedAt: 2026-01-15T10:00:00.000Z",
-            "coverImage: /api/assets/oss/path/to/image.webp",
-            "tags:",
-            "  - tag-slug-1",
-            "  - tag-slug-2",
-            "seoTitle: \"SEO标题，最长255字符\"",
-            "seoDescription: \"SEO描述，最长320字符\"",
-            "canonicalUrl: https://example.com/original",
-            "---",
-        ].join("\n"),
-        parameters: [
-            { name: "title", type: "string", required: true, description: "文章标题，1-255字符" },
-            { name: "slug", type: "string", required: false, description: "URL路径标识符；为空时后端根据标题自动生成" },
-            { name: "excerpt", type: "string", required: false, description: "文章摘要，最长400字符" },
-            { name: "status", type: "enum", required: true, description: "文章状态", allowedValues: ["draft", "published"] },
-            { name: "publishedAt", type: "ISO 8601 string", required: false, description: "发布时间；status=published且未传时后端置为当前时间" },
-            { name: "coverImage", type: "string", required: false, description: "封面图URL。必须是站内 /api/assets/oss/... 路径或合规https外链" },
-            { name: "tags", type: "string[]", required: false, description: "标签slug数组" },
-            { name: "seoTitle", type: "string", required: false, description: "SEO标题，最长255字符" },
-            { name: "seoDescription", type: "string", required: false, description: "SEO描述，最长320字符" },
-            { name: "canonicalUrl", type: "string", required: false, description: "规范链接URL" },
-        ],
-        example: [
-            "---",
-            "title: \"React Server Components 深度解析\"",
-            "slug: react-server-components-deep-dive",
-            "excerpt: \"从原理到实践，全面理解RSC的运行机制\"",
-            "status: draft",
-            "coverImage: /api/assets/oss/covers/rsc.webp",
-            "tags:",
-            "  - react",
-            "  - frontend",
-            "seoTitle: \"React Server Components 深度解析 | My Blog\"",
-            "---",
-        ].join("\n"),
-        notes: [
-            "frontmatter 必须是文件的第一个内容，前面不能有空行或其他字符",
-            "字段顺序：title → slug → excerpt → status → publishedAt → coverImage → tags → seoTitle → seoDescription → canonicalUrl",
-            "推荐使用 post.build_frontmatter 工具自动生成，确保格式正确",
-        ],
-    };
-}
-function buildCalloutCapability() {
-    return {
-        id: "callout",
-        name: "Callout（提示框）",
-        summary: "基于 blockquote 的彩色提示卡片，支持5种语气类型。用于强调关键信息、警告或提示。",
-        syntax: [
-            "> [!TYPE] 标题或首行内容",
-            "> 后续内容行",
-            "> 支持多行",
-        ].join("\n"),
-        parameters: [
-            {
-                name: "TYPE",
-                type: "enum",
-                required: true,
-                description: "提示框类型，决定颜色和语义",
-                allowedValues: ["NOTE", "TIP", "WARNING", "DANGER", "INFO"],
-            },
-        ],
-        example: [
-            "> [!TIP] 性能优化建议",
-            "> 使用 `React.memo` 包裹纯展示组件可避免不必要的重渲染。",
-            "> 配合 `useMemo` 缓存计算结果效果更佳。",
-            "",
-            "> [!WARNING] 破坏性变更",
-            "> 从 v2.0 开始，`createStore` API 签名已变更，旧写法将抛出运行时错误。",
-            "",
-            "> [!DANGER] 安全风险",
-            "> 永远不要在客户端代码中硬编码 API 密钥。",
-            "",
-            "> [!NOTE] 补充说明",
-            "> 本功能需要 Node.js 18+ 环境。",
-            "",
-            "> [!INFO] 背景知识",
-            "> RSC 的核心思想是将渲染拆分为服务端和客户端两个阶段。",
-        ].join("\n"),
-        notes: [
-            "TYPE 必须大写，紧跟 [! 和 ] 之间，不能有空格",
-            "[!TYPE] 后面的同一行文字会作为callout的首行/标题显示",
-            "每行必须以 > 开头（标准 blockquote 语法）",
-            "颜色映射：NOTE=天蓝、TIP=翡翠绿、WARNING=琥珀黄、DANGER=玫红、INFO=靛蓝",
-            "callout 内部不支持嵌套其他 callout",
-        ],
-    };
-}
-function buildMermaidCapability() {
-    return {
-        id: "mermaid",
-        name: "Mermaid（图表）",
-        summary: "使用 Mermaid 语法渲染流程图、时序图、类图等可交互图表。支持拖拽平移。",
-        syntax: [
-            "```mermaid",
-            "<mermaid 图表代码>",
-            "```",
-        ].join("\n"),
-        parameters: [],
-        example: [
-            "```mermaid",
-            "graph TD",
-            "  A[用户请求] --> B{路由匹配}",
-            "  B -->|匹配| C[Server Component]",
-            "  B -->|未匹配| D[404页面]",
-            "  C --> E[数据获取]",
-            "  E --> F[HTML流式传输]",
-            "  F --> G[客户端水合]",
-            "```",
-            "",
-            "```mermaid",
-            "sequenceDiagram",
-            "  participant Browser",
-            "  participant Server",
-            "  Browser->>Server: HTTP Request",
-            "  Server-->>Browser: RSC Payload",
-            "  Browser->>Browser: Hydration",
-            "```",
-        ].join("\n"),
-        notes: [
-            "语言标识必须是小写 mermaid",
-            "支持 Mermaid 的所有图表类型：graph/flowchart、sequenceDiagram、classDiagram、stateDiagram、gantt、pie 等",
-            "渲染后的图表支持鼠标拖拽平移浏览（容器有固定最大高度）",
-            "图表过于复杂时注意可读性，建议拆分为多个小图",
-        ],
-    };
-}
-function buildLiveDemoCapability() {
-    return {
-        id: "live-demo",
-        name: "Live Demo（多文件交互式代码沙箱）⭐ 核心能力",
-        summary: "在文章中嵌入可运行的多文件代码沙箱。支持 HTML/CSS/JS/JSX/TSX，在隔离的 iframe 中实时执行。" +
-            "支持 Tailwind CSS、外部 CDN 注入、React 运行时转译。" +
-            "读者可全屏查看、切换源码Tab、查看Console输出、切换亮暗色主题。",
-        syntax: [
-            "```live-demo title=\"标题\" tailwind cdn=\"https://cdn.example.com/lib.js\"",
-            "/* @file index.html */",
-            "<HTML内容>",
-            "",
-            "/* @file style.css */",
-            "<CSS内容>",
-            "",
-            "/* @file app.jsx */",
-            "<JSX内容>",
-            "```",
-        ].join("\n"),
-        parameters: [
-            {
-                name: "title",
-                type: "string",
-                required: false,
-                description: "代码块右上角显示的标题。格式：title=\"标题文字\"（必须双引号包裹）",
-                defaultValue: "空（显示默认标签）",
-            },
-            {
-                name: "tailwind",
-                type: "boolean flag",
-                required: false,
-                description: "是否在 iframe 内注入 Tailwind Play CDN。无需赋值，独立单词出现即为启用",
-                defaultValue: "false（不启用）",
-            },
-            {
-                name: "cdn",
-                type: "string (可重复)",
-                required: false,
-                description: "外部 CDN URL，必须 https:// 开头。可多次声明：cdn=\"url1\" cdn=\"url2\"，按声明顺序注入",
-                defaultValue: "空数组",
-            },
-            {
-                name: "height",
-                type: "integer",
-                required: false,
-                description: "iframe 初始高度（像素值），范围 80-720。格式：height=\"数字\"（双引号包裹）。设置后 iframe 一开始就以该高度渲染，避免内容加载后从默认 80px 跳到实际高度导致页面抖动",
-                defaultValue: "80（MIN_FRAME_HEIGHT）",
-            },
-        ],
-        example: [
-            "```live-demo title=\"React Counter\" tailwind cdn=\"https://unpkg.com/react@18/umd/react.production.min.js\" cdn=\"https://unpkg.com/react-dom@18/umd/react-dom.production.min.js\"",
-            "/* @file index.html */",
-            "<div id=\"root\"></div>",
-            "",
-            "/* @file app.tsx */",
-            "function Counter() {",
-            "  const [count, setCount] = React.useState(0);",
-            "  return (",
-            "    <div className=\"flex flex-col items-center gap-4 p-8\">",
-            "      <h1 className=\"text-2xl font-bold\">Count: {count}</h1>",
-            "      <button",
-            "        className=\"rounded-lg bg-blue-500 px-4 py-2 text-white hover:bg-blue-600\"",
-            "        onClick={() => setCount(c => c + 1)}",
-            "      >",
-            "        Increment",
-            "      </button>",
-            "    </div>",
-            "  );",
-            "}",
-            "",
-            "ReactDOM.createRoot(document.getElementById('root')!).render(<Counter />);",
-            "",
-            "/* @file style.css */",
-            "body {",
-            "  margin: 0;",
-            "  font-family: system-ui, sans-serif;",
-            "}",
-            "```",
-        ].join("\n"),
-        notes: [
-            "【文件分隔符格式】必须是 /* @file 文件名.扩展名 */，独占一行，前后可有空行",
-            "【支持的文件类型】.html/.htm → HTML；.css → CSS；.js/.mjs → JavaScript；.jsx → React JSX；.tsx → React TSX；其他 → 只读文本",
-            "【运行机制】HTML/CSS/JS 直接合成到 iframe srcdoc 中运行；JSX/TSX 通过 Babel standalone 在 iframe 内实时转译后执行",
-            "【fence 标识】语言标识必须是小写 live-demo，反引号数量 >= 3 且开闭匹配",
-            "【tailwind flag】必须是独立单词（前后为空白或行尾），不能写成 tailwind=true",
-            "【cdn 顺序】多个 cdn 按声明顺序注入 <script>，有依赖关系时注意先后顺序",
-            "【React 项目】使用 JSX/TSX 时无需手动引入 Babel——运行时自动注入 @babel/standalone",
-            "【安全隔离】iframe 使用 srcdoc + sandbox 属性隔离，无同源访问权限",
-            "【推荐】使用 post.build_live_demo 工具自动生成代码块，确保格式正确",
-            "【首个文件】源码必须以 /* @file xxx */ 标记开始；无标记的内容会被视为无效",
-        ],
-    };
-}
-function buildMathCapability() {
-    return {
-        id: "math",
-        name: "Math（KaTeX 数学公式）",
-        summary: "使用 LaTeX 语法渲染数学公式，支持行内公式和块级公式。基于 KaTeX 引擎。",
-        syntax: [
-            "行内公式：$LaTeX表达式$",
-            "块级公式：$$LaTeX表达式$$",
-        ].join("\n"),
-        parameters: [],
-        example: [
-            "爱因斯坦质能方程 $E = mc^2$ 揭示了质量与能量的等价关系。",
-            "",
-            "贝叶斯定理的完整形式：",
-            "",
-            "$$",
-            "P(A|B) = \\frac{P(B|A) \\cdot P(A)}{P(B)}",
-            "$$",
-            "",
-            "矩阵运算示例：",
-            "",
-            "$$",
-            "\\begin{bmatrix}",
-            "a & b \\\\",
-            "c & d",
-            "\\end{bmatrix}",
-            "\\times",
-            "\\begin{bmatrix}",
-            "e \\\\ f",
-            "\\end{bmatrix}",
-            "=",
-            "\\begin{bmatrix}",
-            "ae + bf \\\\",
-            "ce + df",
-            "\\end{bmatrix}",
-            "$$",
-        ].join("\n"),
-        notes: [
-            "行内公式：单个 $ 包裹，$ 与内容之间不能有空格",
-            "块级公式：$$ 独占一行，公式内容在中间行，结束 $$ 也独占一行",
-            "使用 KaTeX 引擎渲染，支持绝大部分 LaTeX 数学命令",
-            "块级公式悬停时有柔和高亮动画效果",
-            "不支持的命令会静默忽略（strict: ignore 模式）",
-        ],
-    };
-}
-function buildImageAttributesCapability() {
-    return {
-        id: "image-attributes",
-        name: "Image Attributes（图片扩展属性）",
-        summary: "通过 Markdown 图片语法的 title 字段编码宽度、对齐、圆角、宽高比等扩展属性。" +
-            "无需引入 HTML，纯 Markdown 语法实现图片排版控制。",
-        syntax: "![alt文字](图片URL \"w=宽度百分比 align=对齐方式 ratio=宽:高 no-rounded\")",
-        parameters: [
-            {
-                name: "w",
-                type: "integer",
-                required: false,
-                description: "图片宽度百分比，取值范围 1-100。预设步长：25/33/50/66/75/100",
-                defaultValue: "100（占满容器宽度）",
-            },
-            {
-                name: "align",
-                type: "enum",
-                required: false,
-                description: "图片水平对齐方式",
-                allowedValues: ["left", "center", "right"],
-                defaultValue: "center",
-            },
-            {
-                name: "ratio",
-                type: "string",
-                required: false,
-                description: "图片真实宽高比，格式为 宽:高（如 16:9、4:3、1:1）。用于骨架屏占位防止布局偏移",
-            },
-            {
-                name: "rounded / no-rounded",
-                type: "flag",
-                required: false,
-                description: "圆角控制。默认有圆角(rounded)；写 no-rounded 则移除圆角",
-                defaultValue: "rounded（有圆角）",
-            },
-        ],
-        example: [
-            "<!-- 50%宽度，居中，默认圆角 -->",
-            "![架构图](/api/assets/oss/diagrams/arch.webp \"w=50\")",
-            "",
-            "<!-- 33%宽度，左对齐，无圆角 -->",
-            "![Logo](/api/assets/oss/logos/brand.svg \"w=33 align=left no-rounded\")",
-            "",
-            "<!-- 全宽，指定宽高比用于骨架屏 -->",
-            "![封面](/api/assets/oss/covers/hero.webp \"ratio=16:9\")",
-            "",
-            "<!-- 66%宽度，右对齐 -->",
-            "![截图](/api/assets/oss/screenshots/demo.png \"w=66 align=right\")",
-        ].join("\n"),
-        notes: [
-            "属性写在 title 字段中（图片URL后的双引号内），多个属性用空格分隔",
-            "只输出非默认值的属性：w=100、align=center、rounded 都无需显式写出",
-            "属性顺序不敏感，可以任意排列",
-            "推荐使用 post.build_image 工具自动生成，确保格式正确",
-            "编辑器中支持鼠标拖拽调整图片宽度（自动更新 w= 值）",
-        ],
-    };
-}
-function buildImageGalleryCapability() {
-    return {
-        id: "image-gallery",
-        name: "Image Gallery（图片宫格）",
-        summary: "连续排列的多张图片自动检测为宫格布局，以网格形式展示。无需额外语法标记。",
-        syntax: [
-            "![图片1](url1)",
-            "![图片2](url2)",
-            "![图片3](url3)",
-        ].join("\n"),
-        parameters: [],
-        example: [
-            "![截图1](/api/assets/oss/gallery/shot1.webp)",
-            "![截图2](/api/assets/oss/gallery/shot2.webp)",
-            "![截图3](/api/assets/oss/gallery/shot3.webp)",
-            "![截图4](/api/assets/oss/gallery/shot4.webp)",
-        ].join("\n"),
-        notes: [
-            "连续的图片段落（中间无其他内容）会被自动检测为宫格",
-            "图片之间不能有空行或其他文本，否则会打断宫格检测",
-            "宫格内的图片会自动等高排列，点击可放大查看",
-            "单张图片不会触发宫格模式，至少需要2张连续图片",
-        ],
-    };
-}
-function buildImageWhitelistCapability() {
-    return {
-        id: "image-whitelist",
-        name: "Image Whitelist（图片源白名单）",
-        summary: "前台严格模式下对图片 src 进行安全校验，只允许可信来源的图片加载。",
-        syntax: "（非语法特性——属于安全策略约束）",
-        parameters: [],
-        example: [
-            "<!-- ✅ 允许：站内 OSS 路径 -->",
-            "![photo](/api/assets/oss/uploads/photo.webp)",
-            "",
-            "<!-- ✅ 允许：合规 https 外链 -->",
-            "![外部图](https://images.unsplash.com/photo-xxx)",
-            "",
-            "<!-- ❌ 拒绝：http 协议 -->",
-            "![不安全](http://example.com/img.png)",
-            "",
-            "<!-- ❌ 拒绝：data: URI -->",
-            "![内联](data:image/png;base64,...)",
-            "",
-            "<!-- ❌ 拒绝：blob: 协议（仅 admin 模式允许） -->",
-            "![本地预览](blob:http://localhost:3000/xxx)",
-        ].join("\n"),
-        notes: [
-            "前台 public 模式：只允许 /api/assets/oss/ 站内路径 + https:// 外链",
-            "后台 admin 模式：额外允许 blob: 协议（资源面板本地预览用）",
-            "不合规的图片 src 会被清空，浏览器显示 broken image 占位，保留 alt 文案",
-            "推荐所有图片先通过 upload_image_from_url 或 upload_image_from_base64 工具上传到站内 OSS",
-        ],
-    };
-}
-function buildUrlWhitelistCapability() {
-    return {
-        id: "url-whitelist",
-        name: "URL Whitelist（链接协议白名单）",
-        summary: "对 Markdown 中所有超链接的协议进行安全校验，阻止危险协议。",
-        syntax: "（非语法特性——属于安全策略约束）",
-        parameters: [],
-        example: [
-            "<!-- ✅ 允许的协议 -->",
-            "[链接](https://example.com)",
-            "[邮件](mailto:test@example.com)",
-            "[相对路径](../posts/other-article)",
-            "[锚点](#section-id)",
-            "",
-            "<!-- ❌ 拒绝的协议 -->",
-            "[危险](javascript:alert(1))",
-            "[数据](data:text/html,...)",
-        ].join("\n"),
-        notes: [
-            "前台允许的协议：https、http、ircs、mailto、xmpp",
-            "后台额外允许：blob（本地预览）",
-            "相对路径、锚点链接（无协议前缀）直接放行",
-            "不在白名单内的协议会被替换为空字符串，链接失效",
-        ],
-    };
-}
-function buildReferenceCapability() {
-    return {
-        id: "reference",
-        name: "Reference（结构化参考文献 / 引用）⭐ 推荐用于引用论文·文档·仓库",
-        summary: "在文章中引用论文、博客、官方文档、开源仓库、视频、规范等外部资料。" +
-            "正文用 [ref:key] 行内标记渲染成可 hover 的上标角标（按出现顺序自动编号），" +
-            "用 ```ref 代码块定义引用的结构化元数据。" +
-            "鼠标悬停角标弹出引用卡片（标题/作者/出处/说明/原文链接），文章末尾自动生成结构化参考文献区。" +
-            "这是引用外部资料的首选语法，体验远优于 GFM 脚注。",
-        syntax: [
-            "正文行内标记（渲染成上标角标）：",
-            "Transformer 由 Vaswani 等人提出 [ref:vaswani]，BERT [ref:bert] 在此基础上扩展。",
-            "",
-            "引用定义块（每个引用一个 ```ref 块，块本身不渲染为可见内容）：",
-            "```ref",
-            "key: vaswani",
-            "title: Attention Is All You Need",
-            "authors: Vaswani et al.",
-            "source: NeurIPS 2017",
-            "url: https://arxiv.org/abs/1706.03762",
-            "type: paper",
-            "note: 提出了 Transformer 架构。",
-            "```",
-        ].join("\n"),
-        parameters: [
-            {
-                name: "key",
-                type: "string",
-                required: true,
-                description: "引用唯一标识，仅允许字母/数字/连字符/下划线（如 vaswani、bert-2019）。正文 [ref:key] 与 ```ref 块的 key 字段必须一致才能关联。",
-            },
-            {
-                name: "title",
-                type: "string",
-                required: true,
-                description: "引用资料的标题，会作为卡片与文末参考文献区的主标题。",
-            },
-            {
-                name: "authors",
-                type: "string",
-                required: false,
-                description: "作者 / 团队，如 'Vaswani et al.' 或 'Harvard NLP'。",
-            },
-            {
-                name: "source",
-                type: "string",
-                required: false,
-                description: "出处 / 发表 venue / 站点名，如 'NeurIPS 2017'、'pytorch.org'。",
-            },
-            {
-                name: "url",
-                type: "string",
-                required: false,
-                description: "原文链接。提供后卡片与文末区会显示「查看原文」并把标题变成可点击链接。",
-            },
-            {
-                name: "type",
-                type: "enum",
-                required: false,
-                description: "引用类型，决定卡片 / 文末区的图标与中文标签。",
-                allowedValues: ["paper", "blog", "doc", "repo", "video", "spec", "link"],
-                defaultValue: "link（通用链接）",
-            },
-            {
-                name: "note",
-                type: "string",
-                required: false,
-                description: "补充说明，会显示在卡片和文末区。支持单行；多行需在 ```ref 块内缩进续写。",
-            },
-        ],
-        example: [
-            "## Transformer 架构",
-            "",
-            "Transformer 架构由 Vaswani 等人提出 [ref:vaswani]，彻底改变了 NLP 领域。",
-            "工程实现可参考官方文档 [ref:pytorch-doc] 与开源实现 [ref:annotated]。",
-            "",
-            "```ref",
-            "key: vaswani",
-            "title: Attention Is All You Need",
-            "authors: Vaswani et al.",
-            "source: NeurIPS 2017",
-            "url: https://arxiv.org/abs/1706.03762",
-            "type: paper",
-            "note: 提出了 Transformer 架构，奠定了现代大模型的基础。",
-            "```",
-            "",
-            "```ref",
-            "key: pytorch-doc",
-            "title: PyTorch Transformer 官方文档",
-            "source: pytorch.org",
-            "url: https://pytorch.org/docs/stable/nn.html",
-            "type: doc",
-            "```",
-            "",
-            "```ref",
-            "key: annotated",
-            "title: The Annotated Transformer",
-            "authors: Harvard NLP",
-            "url: https://github.com/harvardnlp/annotated-transformer",
-            "type: repo",
-            "note: 逐行注释的 Transformer 实现。",
-            "```",
-        ].join("\n"),
-        notes: [
-            "【正文标记】[ref:key] 中 key 只能含字母/数字/连字符/下划线，不能有空格",
-            "【自动编号】角标编号按正文 [ref:key] 首次出现顺序分配（从 1 开始）；同一 key 多次引用复用同一编号",
-            "【块字段格式】```ref 块内每行 'field: value'，key 与 title 必填，其余可选；不识别的字段会被忽略",
-            "【type 枚举】paper=论文 / blog=博客 / doc=文档 / repo=仓库 / video=视频 / spec=规范 / link=通用链接（默认）",
-            "【块隐身】```ref 块只用于定义元数据，不会在正文渲染出可见内容",
-            "【文末区】文章末尾自动生成「参考文献」区，按角标顺序列出所有被引用的条目",
-            "【容错】正文引用了未定义的 key 时，该标记会保留为字面文本，便于发现拼写错误",
-            "【与脚注的区别】引用论文/资料请用本语法（[ref:key]），它有 hover 卡片和结构化文末区；GFM 脚注 [^id] 仅用于普通补充说明，不再渲染成引用卡片",
-            "【推荐】使用 post.build_reference 工具自动生成 ```ref 块，确保字段格式正确",
-        ],
-    };
-}
-function buildFootnoteCapability() {
-    return {
-        id: "footnote",
-        name: "Footnote（GFM 脚注，仅用于普通补充说明）",
-        summary: "在文章底部定义脚注，正文中通过引用标记链接。支持双向跳转、自动编号。" +
-            "注意：引用论文 / 文档 / 仓库等外部资料请改用 Reference 语法（[ref:key]），脚注仅用于普通补充说明。",
-        syntax: [
-            "正文中引用：[^脚注ID]",
-            "文章底部定义：[^脚注ID]: 脚注内容",
-        ].join("\n"),
-        parameters: [
-            {
-                name: "脚注ID",
-                type: "string",
-                required: true,
-                description: "脚注唯一标识符。可以是数字、单词或短语（内部会做标准化处理）。大小写不敏感。",
-            },
-        ],
-        example: [
-            "React Server Components[^rsc] 通过将渲染拆分到服务端来减少客户端 bundle 大小。",
-            "这一架构灵感来自 PHP 的请求处理模型[^php-model]。",
-            "",
-            "[^rsc]: Dan Abramov, \"RFC: React Server Components\", 2020.",
-            "[^php-model]: 参见 Laravel 的 Blade 模板引擎如何将 HTML 生成完全放在服务端。",
-        ].join("\n"),
-        notes: [
-            "脚注引用 [^id] 可以出现在正文任意位置，会渲染为上标数字链接",
-            "脚注定义 [^id]: 必须放在文章末尾（通常是最后几行），独占一行开头",
-            "同一个 [^id] 可以在正文中多次引用，编号相同",
-            "脚注ID 的大小写和空白会被标准化处理（如 'RSC' 和 'rsc' 视为同一脚注）",
-            "定义行的 [^id]: 后面必须跟至少一个空格再写内容",
-            "渲染后脚注区域会有分割线，引用和定义之间支持双向点击跳转",
-        ],
-    };
-}
-function buildSitePostReferenceCapability() {
-    return {
-        id: "site-post-reference",
-        name: "Site Post Reference（站内文章引用）",
-        summary: "通过相对路径引用本站其他文章，形成站内互链。需确保 slug 真实存在。",
-        syntax: "[显示文字](../posts/<slug>)",
-        parameters: [
-            {
-                name: "slug",
-                type: "string",
-                required: true,
-                description: "目标文章的 slug 标识符。必须是已存在的文章 slug。",
-            },
-        ],
-        example: [
-            "关于 RSC 的基础概念，请参考 [React Server Components 入门](../posts/react-server-components-intro)。",
-            "",
-            "本文是 [v1.3.0 变更说明](../posts/changelog-v1-3-0) 中提到的新功能的详细教程。",
-        ].join("\n"),
-        notes: [
-            "路径格式固定为 ../posts/<slug>，不支持其他相对路径形式",
-            "引用前必须先调用 post.list_for_reference 工具确认 slug 存在且有效",
-            "前台渲染时会正确解析为文章详情页 URL",
-            "如果 slug 对应的文章被删除，链接将失效（404）",
-            "slug 区分大小写，必须与目标文章的实际 slug 完全匹配",
-        ],
-    };
-}
-function buildCodeGroupCapability() {
-    return {
-        id: "code-group",
-        name: "Code Group（多语言代码 Tab 切换）",
-        summary: "在同一个代码块区域中展示多个语言版本的代码，读者通过 tab 切换查看。" +
-            "适用于展示同一 API 调用的不同语言实现、同一概念的多种写法等场景。" +
-            "同一页面内多个 code-group 的 tab 选择会自动同步。",
-        syntax: [
-            "```code-group",
-            "/* @tab Label1 */",
-            "代码内容1",
-            "",
-            "/* @tab Label2 lang=xxx */",
-            "代码内容2",
-            "```",
-        ].join("\n"),
-        parameters: [
-            {
-                name: "Label",
-                type: "string",
-                required: true,
-                description: "Tab 的显示标签，如 'Python'、'JavaScript'、'cURL'。" +
-                    "常见语言名会自动推断语法高亮语言（如 'Python' → python、'JavaScript' → javascript）",
-            },
-            {
-                name: "lang",
-                type: "string",
-                required: false,
-                description: "显式指定语法高亮语言（如 lang=python）。当 Label 无法自动推断时使用。" +
-                    "支持的语言：python、javascript、typescript、bash、go、rust、java、json、yaml、sql、" +
-                    "csharp、cpp、php、ruby、swift、kotlin、dockerfile、markdown、scss、graphql 等",
-            },
-        ],
-        example: [
-            "```code-group",
-            "/* @tab Python */",
-            "import requests",
-            "",
-            "response = requests.get(\"https://api.example.com/data\")",
-            "data = response.json()",
-            "print(data)",
-            "",
-            "/* @tab JavaScript */",
-            "const response = await fetch(\"https://api.example.com/data\");",
-            "const data = await response.json();",
-            "console.log(data);",
-            "",
-            "/* @tab cURL lang=bash */",
-            "curl -X GET https://api.example.com/data \\",
-            "  -H \"Content-Type: application/json\"",
-            "```",
-        ].join("\n"),
-        notes: [
-            "语言标识必须是小写 code-group",
-            "每个 tab 以 /* @tab Label */ 标记开始，标记必须独占一行",
-            "Label 后可选 lang=xxx 显式指定高亮语言；不指定时从 Label 自动推断",
-            "自动推断支持的 Label：Python、JavaScript、TypeScript、Bash、Shell、Go、Rust、Java、JSON、YAML、SQL、cURL 等",
-            "同一页面内多个 code-group 的 tab 选择会自动同步（如选了 Python，其他 code-group 也切到 Python）",
-            "每个 tab 独立做语法高亮，支持 20+ 种编程语言",
-            "tab 栏支持键盘左右方向键切换",
-        ],
-    };
-}
-function buildDetailsCapability() {
-    return {
-        id: "details",
-        name: "Details（折叠块）",
-        summary: "使用 :::details 容器语法创建可折叠的内容块，基于 HTML5 <details>/<summary> 原生标签。" +
-            "支持默认展开、平滑高度过渡动画、键盘导航和屏幕阅读器友好。" +
-            "适用于补充说明、FAQ、技术细节等可选内容。",
-        syntax: [
-            ":::details[标题文本]",
-            "折叠内容（支持完整 Markdown）",
-            ":::",
-            "",
-            "默认展开：",
-            ":::details[标题文本]{open}",
-            "默认展开的内容",
-            ":::",
-        ].join("\n"),
-        parameters: [
-            {
-                name: "标题文本",
-                type: "string",
-                required: true,
-                description: "折叠块的标题，显示在 summary 区域，点击可展开/收起",
-            },
-            {
-                name: "{open}",
-                type: "flag",
-                required: false,
-                description: "可选标记，添加后默认展开内容；不添加则默认收起",
-                defaultValue: "默认收起",
-            },
-        ],
-        example: [
-            ":::details[点击查看详细配置说明]",
-            "以下是完整的配置参数说明：",
-            "",
-            "- **timeout**: 请求超时时间（毫秒）",
-            "- **retries**: 重试次数",
-            "- **baseUrl**: API 基础路径",
-            "",
-            "```json",
-            "{",
-            "  \"timeout\": 5000,",
-            "  \"retries\": 3",
-            "}",
-            "```",
-            ":::",
-            "",
-            ":::details[常见问题 FAQ]{open}",
-            "**Q: 如何调试？**",
-            "A: 开启 debug 模式即可查看详细日志。",
-            "",
-            "**Q: 支持哪些浏览器？**",
-            "A: 支持所有现代浏览器（Chrome 90+、Firefox 88+、Safari 14+）。",
-            ":::",
-        ].join("\n"),
-        notes: [
-            "开标记 :::details[标题] 和闭标记 ::: 必须各占一行",
-            "标题文本放在方括号 [] 内，不能包含 ] 字符",
-            "内容区域支持完整 Markdown 语法（列表、代码块、图片、表格等）",
-            "基于 HTML5 <details>/<summary> 原生标签，语义化最佳",
-            "支持键盘导航（Space/Enter 切换展开状态）",
-            "使用 ResizeObserver 监听内容变化，平滑高度过渡动画",
-            "可以嵌套使用（在折叠块内再放一个折叠块）",
-            "推荐用于补充说明、FAQ、技术细节等非核心内容",
-        ],
-    };
-}
-function buildTimelineCapability() {
-    return {
-        id: "timeline",
-        name: "Timeline（时间轴）",
-        summary: "使用 :::timeline 容器语法创建单侧时间轴，展示项目里程碑、版本历史、事件发展等。" +
-            "每个事件用列表项格式定义，支持激活状态标记。" +
-            "左侧竖线 + 圆点节点，激活项实心高亮，hover 时圆点放大。",
-        syntax: [
-            ":::timeline",
-            "- 时间 | 标题",
-            "  事件描述内容（支持多行）",
-            "",
-            "- 时间 | 标题 [active]",
-            "  激活状态的事件描述",
-            ":::",
-        ].join("\n"),
-        parameters: [
-            {
-                name: "时间",
-                type: "string",
-                required: true,
-                description: "事件发生的时间，如 '2024-01'、'2024-Q1'、'2024-03-15'",
-            },
-            {
-                name: "标题",
-                type: "string",
-                required: true,
-                description: "事件的简短标题，用 | 与时间分隔",
-            },
-            {
-                name: "[active]",
-                type: "flag",
-                required: false,
-                description: "可选标记，添加在标题末尾表示激活状态（实心圆点 + 高亮）",
-            },
-            {
-                name: "描述",
-                type: "string",
-                required: false,
-                description: "事件的详细描述，缩进写在标题行下方，支持多行",
-            },
-        ],
-        example: [
-            ":::timeline",
-            "- 2024-01 | 项目启动",
-            "  团队组建完成，确定技术栈和架构方案。",
-            "",
-            "- 2024-03 | 第一版上线",
-            "  完成核心功能开发，包括用户认证、数据管理、API 接口。",
-            "",
-            "- 2024-06 | 性能优化 [active]",
-            "  数据库查询优化，API 响应时间从 800ms 降至 120ms。",
-            "  引入 Redis 缓存，QPS 提升 5 倍。",
-            "",
-            "- 2024-09 | 国际化支持",
-            "  支持中文、英文、日文三种语言。",
-            ":::",
-        ].join("\n"),
-        notes: [
-            "开标记 :::timeline 和闭标记 ::: 必须各占一行",
-            "每个事件用 `- ` 列表项开头，`|` 分隔时间和标题",
-            "标题末尾的 [active] 标记表示激活状态，解析后从标题中移除",
-            "事件描述缩进写在标题行下方（至少 2 个空格），支持多行",
-            "事件之间可以用空行分隔，提高可读性",
-            "激活状态的事件会显示实心圆点 + 高亮颜色",
-            "hover 时圆点会放大 1.2 倍，提供视觉反馈",
-            "适用于项目里程碑、版本历史、团队发展、产品演进等场景",
-        ],
-    };
-}
-//# sourceMappingURL=syntax-capabilities.js.map